Bukkit

Tool Stats

Overview

Features

Config Breakdown

After putting the .jar file in your plugins folder a config file will be created. Inside the config you'll see 2 sections, General And Tools. Remember to delete your old config file when updating!

Tools

Each tool has 3 options: Color, Track Stats, and Block Ids. Color determines what color and effect the statistics will have. Track Stats determines whether or not ToolStats tracks that type of tool. Block Ids is a list of the block ids that are tracked for each type of tool.

Colors

There are 7 different color settings, one for each tool, and a universal option.

When you first open the config the universal setting will be filled out with 5;o. The 5 means the color is purple, the o means letters are Italicized. To pick a color you simply select the number that represents your color of choice and the replace 5;o with that number. If you want to add effects such as bold, you add a colon (;) after your first number, then you add the letter that represents your effect of choice.

The numbers and letters representing colors and effects can be found in the following image:

Block Ids and Mob Ids

Each tool type contains a list of ids that determines what statistics are kept track of. For weapons the list contains mob ids, for the other tool types block ids.

By default each list is filled out with a basic set of blocks and mobs. To keep track of how many oak logs you've chopped you would put 17 on the list under Axe. For blocks with special data types (e.g. black wool (35;15) or brick slabs (44;4)) such as a spruce log, 17;1, you enter the id, 17, first, followed by a semi-colon (;) and then the data type, 1. The Bow and Sword lists contain mob ids that can be found below.

There are also 4 special options for the lists: miscellaneous, hostile, passive, and player. Miscellaneous is for the Block Ids lists. When set it tracks all blocks not already listed. Hostile, passive, and player are for the Mob Ids lists. When hostile is set it tracks all hostile mob kills, passive tracks all passive mob kills, and player tracks all player kills.

Minecraft block ids can be found here: http://minecraft.gamepedia.com/Data_values/Block_IDs

Mob Ids can be found in the following image:

General

There are two options in the General section of the config. One is "Delete Stats On Untracked Tools" and the other is "Use Universal Color".

If you set "Delete Stats On Untracked Tools" to true, all of the saved statistics for tools that have the "Track Stats" option set to false will be deleted when the tool is next used.

The "Use Universal Color" option is used to determine whether or not to use the universal color. When set to true, all stats for all tools will be the universal color. When set to false, each tool will use its own individual set color.

Permissions

Note: All ToolStats permissions (excluding toolstats.*) are set to true by default. If you don't what someone to have a specific tool type tracked you will have to disable that specific permission. To disable all tools you only have to disable toolstats.*

Media