LootManager
[General]
This plugin currently has 2 key features: handling mob loot and handling chest/inventory loot with advanced options and timer settings. I will only give a very brief description of the features in this section. Loot can consist of items and money, and is defined trough configs that allow a lot of customization. For items, this includes but is not limited to: custom item names, custom lore, enchantments and randomized quantity). Once loot is configured it can be used for mob drops, dungeon loot, ... As extra features, this plugin can also be used to fill chests once for drop parties, and to keep chests stocked forever. All messages that are sent to players can be configured in a seperate config.
Important:
- If you want to use the money features of this plugin, you need Vault (and an enconomy plugin that supports Vault).
- This plugin was previously known as ChestFiller. Because so many things have changed (config files, database structure) the old ChestFiller configs and database are incompatible. You have to relink all your chests if you want to upgrade.
Some eye candy:
Latest noteworthy additions:
- Money loot is now possible (requires vault).
- Mob loot can now be configured.
- New messages to provide feedback to the player upon loot attempts.
- All interaction with the player can now be configured.
Made a youtube video reviewing this plugin? Send me a pm. If i like it, i'll add it in the description.
[Configuration]
This section describes in detail, all that can be configured in the configs. If you run this plugin for the first time, a map named resources will be created. Inside this map you should find seperate maps for chest configs and loot configs, each containing a default example file. If you want to quickly test the plugin, take a look at the Guide section and link the default file ingame.
config.yml
- auto_update: When set to true, the plugin will connect to curse upon server startups to possibly download newer versions of this plugin.
- mob_drops
- enabled: enable or disable this feature. Default is disabled.
- links:
- mobname:
- config: specify the loot config to be used for drops.
- clear_drops: Default is false
- ...
- mobname:
- worlds: May be used to specify mob drops for specific worlds. This overrides global settings.
- wordname:
- links: Same as above
- ...
- wordname:
Loot config:
- items:
- name: [Optional] The in-game name for this item
- lore: [Optional] The lore for this item.
- id: The minecraft id of the item to spawn.
- dmg: [Optional] The damage to be applied to this item. Can also be used for special items such as a creeper eg (380:50 -> Put the 50 in dmg). The default value is 0.
- dmg_randomness: [Optional] The actual dmg is somewhere between dmg-randomness and dmg+randomness. The default value is 0.
- chance: Determines the chance for this item to spawn.
- amount: Determines the amount of this item to spawn.
- amount_randomness: [Optional] The actual amount of items is somwhere between amount - amount_randomness and amount + amount_randomness. Default value is 0.
- enchantments: [Optional] A list of enchantments that should be added to the item (Enchantments that may not be possible in standard minecraft). Take a look at the default file for the required names and values. The default is no enchantments.
- money:
- amount: The amount of money to give to a player upon looting.
- randomness: The actual amount given to the player is somewhere between amount - randomness and amount + randomness.
Chest Config:
- time: The time (in the format HH:MM:SS) that should pass to fill the chest.
- randomness: [Optional] (in the format HH:MM:SS) The actual trigger time is somewhere between time-randomness and time+randomness. In the default case, there is no randomness.
- empty_on_trigger: [Optional] Indicates whether the chest should be emptied before being filled. The default value is true.
- message: [Optional] Message that should be broadcasted when the chest is filled. The default value is "" (no message).
- players_required: [Optional] Amount of players that need to be online in order for the chest to be filled. The default value is 0.
- trigger_on_looted: [Optional] If set to true, the timer will only trigger when someone accesses the loot. The default value is false.
- Itemsets: A list of different Itemsets (names) to use for this config.
- items: Exactly the same as in loot configs (see above).
- money: Exactly the same as in loot configs (see above).
[Commands]
- /lm help: Show the list of commands and their description ingame.
- /lm configlist: Show a list of config names that are available for linking.
- /lm reload: Reload changes to config files + detect new config files.
- /lm link config: Link the inventory block you are looking at with the given config.
- /lm fill [chestconfig/lootconfig] config: Fill the inventory block you are looking at with the items and chances specified in the config file (Useful for drop parties). If both a loot config and a chest config with the same name exist, the optional parameter is mandatory.
- /lm autorefill : Link the inventory block you are looking at to autorefill mode. No need to specify a config, this command uses the items currently in the chest.
- /lm remove: Remove any links/autorefills from the inventory block you are looking at.
[permissions]
If you want to give users acces to all commands (except for the help command, which should always be available) use lootmanager.*. A server op automatically gains access to all commands.
For finer control use the following permissions:
- lootmanager.help
- lootmanager.link
- lootmanager.fill
- lootmanager.remove
- lootmanager.autorefill
- lootmanager.configlist
- lootmanager.reload
[Guide]
The parameters of config files are explained above. Hava a look at the default configs for a concrete example. This guide explains how to link chest configs ingame and how to fill a chest once with the items in either a chest config or a loot config. The configuration of the language.yml config has been omited because it is straightforward.
Full linking procedure:
First check if the chest config you want to link is available using /lm configlist. Make sure to check your console for possible errors in the config file. If there are errors fix them. After fixing the errors a simple /lm reload should do the trick.
In order to link a config to a chest, type the following command ingame: /lm link configname while looking at a chest/furnace/whathever block that holds an inventory. You should receive a message that the linking process has succeeded.
Filling a chest once
Same procedure as the linking process above, except that you should now use /lm fill config.
Making a chest that's always filled
Simply use /lm link autorefill while looking at the chest you want to maintain stocked.
[Work in progress / Planned]
- Individual chest loot! (25/100)
- Add a particle effect option to chest configs, that is played above the chest to indicate that it hasn't been looted yet (0/100)
- Allow customization of loot standardly generated in dungeons(0/100)
- Provide a more convenient/flexible way to maintain loot (Ingame with GUI?) + allow any current and future item (tipped arrows) to be added.(0/100) - should have priority if i work on this again.
[Addons]
This plugin uses an update-checker (made by Gravity) that makes a connection to Curse to inform you of plugin updates. You can disable this feature in the config.yml file in this plugin's data folder.
This plugin uses PluginMetrics, a plugin to that sends data to mcstats.org to give feedback on usage. If you wish to disable this feature, please set 'opt-out' to 'true' in the 'config.yml' file in the PluginMetrics folder.
[Donating]
If you are feeling extremely generous, you can reward me for my work on this (and possibly future) plugins by donating.
[Donator list (paypal donations)]
- jonny999999 : 7,50 euros
@afronights
I am hoping to release a new version in a few days. At this moment my plugin poorly handles config loading and saving of links, which can result in errors. I am rewriting these parts of the plugin. I haven't encountered this error at startup, could you send me a pm with the details from your server console?
@cakyman
Could you see if there are any errors in your server console? If there is an error in your yml file the plugin is not able to load it. If you don't see any errors, send me the config file so i can have a look myself.
Hi fantasm ! How long before the next version?
I get at startup a null pointer exception !
I use a spigot 1.8.8 and version 1.5 plugin.
Thank you for the patience !!!
I am trying to use this plugin to make a bunch of chests load in the same items every time (I added all the chests to the auto refill), but whenever I try to use the command to refill the chests, I can't use the auto refill, only the default config. Is there a way that to work? I'm probably being really stupid and unable to understand the guide, but I hope you can help.
@Scarletomato
This is indeed not supported atm, not that hard to fix, i'll add it to my Todo list for the next version.
@Capri205
Thanks for reporting this. I'm probably going to change the way my plugin saves linked chests , it's kind of messy atm.
I find the /cf commands continually corrupt the config.yml. Using /cf link often removes all entries in the file except for the last one or two chests linked. I get NullPointer exceptions and array index out of range errors using /cf reload or /cf configlist because the config,yml is getting trashed in the process of using the /cf link command. I am running on the latest spigot 1.8.8.
Does this plugin support spawning enchanted books? I tried adding this into my config
and it creates the book, but I can't use it in the anvil.
Edit: Nope, it doesn't look like it. My suggestion... in ConfigTask.addItems() you need to add a check for Material.ENCHANTED_BOOK and if it checks out you have to addStoredEnchant() on the stack instead of addUnsafeEnchantments(). See here for a solution
Hello, your downloading link is broken !
*EDIT*
Ok, I've just setup my proxy to USA and it's works, thank you !
:-) Sorry, my mistake. I've typed commands into creative mode anejak I did not realize it and when I left button chest broke, so I subconsciously used the latter (unfortunately right) button. Plugin now it works correctly and of course super
I apologize again for false alarms
Sincerely Zion
@ZionZangar
Did you left click on the chest? If you don't get any errors in the console it seems like you just did a right click to open the chest instead of a left click.
Hello I have a problem with the plugin after installation as the default config files are not able to set the ark, command / cf link default, although I WRITE instructions to proceed but when you click on the chest to chest opened and nothing happens. After a while, chat displays a message that the input command timed out.
The log file does not list any errors, and even when the server will not appear any error message.
I use a spigot 1.8.8 and version 1.5 plugin, Java 8
Thank you for your early reply and I sincerely Zion Zangar
P.S. Sorry for my bad English :-)
For some reason the name and lore options don't work for me.
For the record this is the pastebin of the config I'm using. This is just a test, but when I use it, the chest restocks with just a regular tripwire hook.
The fillall command is filling dispensers as well as chests. Can I specify only chests?
Using spigot 1.8.8.
@ergenta
There is a default config file included that is pretty self explanatory, your complaint right now is the first one i get about this. As mentioned in the description: "This plugin uses custom yml config files. These files determine what to spawn under which conditions. They can be linked to an inventory block ingame.".
Now if you run the plugin, a map (named chestconfigs) is created in which you can find a default config file (Is this not happening for you?). This config file has comments added to it to explain what each parameter does. You can test this default config by linking it ingame to a chest. If you want to create a new config, add a new yml file in the chestconfigs map. If you have done all of this, and looked at the default file, then please let me know what exactly is unclear, so i can edit this page.
Nvm, this plugin is too much of a question mark. You explained how to fill and link, but not how to acquire those items to fill and link. It's as if you skipped the entire first part, arguable the most important part, and went to the end.
I deleted it. Moving on.
Like how to add items to the chests would be a nice start.
All I'm seeing is commands for filling and linking and no way to actually make what you're filling and linking.
IS there a way for someone to post their config? Giving me an empty config and saying "figure it out" isn't helping me at all. The description gives me "times, randomness, empty_on_triger, etc," but it doesn't show how to implement these into the config.
You gave me 'link' and 'autofill' and basically said "figure it out."
I figured out there's a default chest but there's no "default chest" or anything for that matter in the config to go by.
@Stumpy_hd
Depends, if the custom enchantment works with lore you can put it there and it should work. If not it won't work.
does the enchament side of the plugin allow customenchants