Bukkit

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

Full commands article

• /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

Full configuration article

Web Viewer

Full web viewer article

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.