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
@KokeCacao
The plugin is designed for (and should work on) any block that holds an inventory. For example you can use trapped chests, dispensers, droppers...
@KokeCacao
The plugin is designed for (and should work on) any block that holds an inventory. For example you can use trapped chests, dispensers, droppers...
Can I open this 'Chest' when I click other block?(such as trap-chest)
@ChillerKraft
As in refill every chest in the world?
could there be an /cf autorefillall command?
@KJDoesGaming
ATM this plugin is self standing, if you add chests to your dungeons you can define the loot. I see LootPlus has an API but it doesn't seem that interesting to hook into. May i ask what exactly you want to be compatible?
@KJDoesGaming
Hi, i'm returning home from vacation tonight, so i'll look into it soon (i'm not familiar with lootplus). For epicboss, does that plug-in handle anything chest related?
Hi, Im currently working on a whitelisted server and i'm wondering if this works with LootPlus,and EpicBoss Gold Edition because I'm doing/working on building the dungeons and adding the spawners and other crap and with loot plus it adds extra stuff and with your plugin, it refills chests ( using your plugin, lootplus to give better loot chances, and EpicBoss to spawn a Boss Mob ) Please Respond ASAP
good plugin! :D
I have implemented support for special item ids such as 383:50 for a creeper egg. You can also give certain items durability now (if the item supports it). This will be available in the next update.
@caneKing
This means that there is a semicolon somewhere that shouldn't be there. If it's a small file, you can send me a pm and copy paste your config. Alternatively you can upload it to some file sharing site and give me a link.
@VictoriousSnake
The link i provided in the default config is inacurate. Walker already pointed this out to me, so i have updated this for the next version. The enchantment you want is PROTECTION_EXPLOSIONS. This link should provide the correct names with some descriptions: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/enchantments/Enchantment.html
@VictoriousSnake
Try to put a "_" instead "space" in your enchantment name ;)
-> BLAST_PROTECTION
I have an error when I use an enchantment of my choice it comes up with an error saying that its an invalid enchantment
Is this correct?:
id: 311 chance: 0.5 amount: 1 enchantments: PROTECTION: 10 BLAST PROTECTION: 3
@_fantasm0_ [19:20:16 INFO]: [ChestFiller] The yml file Ultimate.yml contains errors: mapping values are not allowed here in 'reader', line 11, column 19: id: 267 # The minecraft id of the ... ^
This is the first error i get when i run the file
I don't know how to send the file otherwise i would
@caneKing
Could you give me the exact error you are getting? If you want me to take a look at what's wrong, pm me your config file.
Hey I'm kinda a noob at this kinda stuff but i made a file that i just wanted to link to one chest in my world but it keeps telling me the file has errors but the formatting is the exact same as the default file so i guess i'm just confused about what's going on. It starts with telling me i need to get rid of the colon on my item id line then an issue with the i in item and it just continues
well, nothing specific because i already use http://www.spigotmc.org/resources/chestregen.4921/chestregen for regenerating default worlds chests etc, so i dont really just want to tell you to add those same things<sub>, i was more wondering what i can do just with all default world chests etc, if anything..
i felt like i wasn't really able to grasp everything i can do with this plugin can do yet
nbd jw tc</sub>
@ChillerKraft
At this moment the plugin is mostly focussed on linking/filling chests seperately. There is a /fillall command that detects all chests within the radius of a worlds spawn and fills them once. It is currently limited to a rather small radius because of the lag it creates. I'm planning on expanding on this, but i don't have a lot of time in the coming weeks.
Could you provide a specific example on what you want the plugin to do? (an example command and what you expect it to do)? If it is useful and doable, i'll add it on my todo list.
is there any options for auto-refilling the default chests that are already in a world etc??
somethin like that? jw ty(:
i don't wanna have to do them all seperately, and also let me know if theres anything else in that area of function that would possibly be of some interest to me (:
i just really like the idea of making use of those default world chests in some of my servers
@_fantasm0_
Thanks for your help i've sent you my config in mp.
With my problem, i thought something. As you know i want use lot of items. It is possible to make items groups for the plugin choose only one of them? This could lighten the plugin and put more items in the file :)
exemple: http://prntscr.com/76wd9v
It's an idea and if you say no.. ok it's no :D