ItemCollector
ItemCollector is a plugin that makes it easy to track which items and which animals are in a certain region. The goal is to help Minecraft player who want to collect every items/animals in the game and bring them back to their base. The configuration file allows the admin the choose which animals and items should be collected, set the region boundaries and change other settings.
The Goal
When using this plugin, the player's goal is to collect at least 1 of every item in the game and bring it back to their base as well as capturing at least 1 of every creatures in their base.
It's possible to disable one of the collection in the configuration. The list of collectible items and collectible creature can also be changed in the configuration.
Mechanic
ItemCollector will look in every chest in the player's base and look for at least 1 of every item. It will also look for at least 1 of every creature in the player's base.
The player's base location is defined in the configuration file (this can also be changed via a command).
Every time a chest is closed, the plugin will do an inventory of the chests in the base. This feature can be turned off if it cause lag on your server because you have too many chests in the base. An inventory of the creatures is also done when right clicking on a creature inside the base, again this can be turned off.
The current status of the collection is updated on signs. Any sign in the base with the first line "[Items]" will display the number of collected items and the total number of collectible items and the same logic goes for signs with "[Creatures]"
Right-clicking on one of those signs will force a re-count of the collection and will update all signs.
When a player place an item in a chest that was not collected yet but that is part of the collectible items, a message is broadcast to everyone to announce the progression. This message can be changed in the configuration, it and can also be disabled.
The same goes of creature.
Installation
- Copy "ItemCollector.jar" inside the folder /plugin
- Launch the server, this will generate a default configuration file
- Stop the server and edit the config file located at /plugins/ItemCollector/config.yml
- Change the worldName to yours
- Change minX, minZ, maxX, maxZ and make your base is within the boundaries.
- (Optional) Set to FALSE any item you don't want to be collectible
- (Optional) Set to FALSE any creatures you don't want to be collectible
- Launch the server and play !
Commands
- /itemcollector count
- /itemcollector list <items|creatures> <all|missing|collected>
- /itemcollector refresh <items|creatures>
- /itemcollector add <item|creature> <id|name>
- /itemcollector remove <item|creature> <id|name>
- /itemcollector set <region|option|message|outputfile> value
- /itemcollector set region minX-value maxX-value minZ-value maxZ-value
Permissions
- itemcollector.refresh
- itemcollector.count
- itemcollector.add.creature
- itemcollector.add.item
- itemcollector.remove.creature
- itemcollector.remove.item
- itemcollector.set.region
- itemcollector.set.option
- itemcollector.set.world
- itemcollector.set.message
- itemcollector.set.outputfile
Configuration file
Web Viewer
A web viewer allows you too see the complete list of items and creatures in your collection and you can filter to see only those missing. To use this feature, a webserver is required.
good plugin! can you make it compatible with Feudal, so every kingdom competes in this collection for items?
Thanks.
@2008Choco
Thanks
This is really cool! You want to know the cooler part? Your plugin inspired me to make a plugin that may go hand in hand with this one. I mean... kind of. It's not going to hook into your plugin, though you gave me an idea for an add-on for one of my plugins involving the collection of items. Don't worry, I'm not stealing your idea. Your idea is very unique, and I like it very much. I couldn't program it for myself. Though, I'll let you know when my add-on is complete, and maybe you can check it out ^-^
Keep up the great work, because it looks like you've got a lot of work cut out for you