Bukkit

Frequent Questions

No time for the A.

How do I set a limit on how much money a player can get from a chest?

TreasureHunt has two per-world options called MoneyMultiplier and MaxValue. MaxValue deals with the max value of the items in the chest as per the 5000-point default scale (which you can change). So let's say you wanted to set a limit of 2500 money in a world where the MaxValue is 5000, the default. You'd just change these options in your WorldOptions section (or with ingame commands while standing in that world):

MaxValue: 5000
MoneyMultiplier: 0.5

That way the limit on money is 5000 * 0.5, or 2500.

You could do any of the following.

Max 25000:

MaxValue: 5000
MoneyMultiplier: 5.0

or

MaxValue: 20000
MoneyMultiplier: 1.25

or

MaxValue: 1000
MoneyMultiplier: 25.0

Max 300:

MaxValue: 3000
MoneyMultiplier: 0.1

or

MaxValue: 6000
MoneyMultiplier: 0.05

How do I create an Enchantment Setup for spawned items?

There are two ways to create an enchantment setup.

• The easy way is to go into MineCraft and hold an enchanted item and do /th addenchant <name>, where <name> is a name you want to give the Enchantment Setup.
• The more complicated way is to add it to the config file yourself. The first thing you need is to choose some Enchantments from the list:

Then, in the config under EnchantedItems.<name>.Effects, add each effect and the level it should have.

EnchantedItems:
  Enchantment_1:
    ID: 257
    Damage: 0
    Effects:
      DURABILITY: 3
      DIG_SPEED: 2

How do I add more items to the item lists?

A default item list looks something like this.

WorldLists:
  Default:
    Common:
      BRICK: 2
      RESTONE: 3
      FLINT: 2

"Default" is the name of this item list (which is truncated). "Common" is the first rarity of chest, and beyond that you list the items it can contain. The name or ID is followed by a colon, and then the item's "value". When a chest is being made, a random value is calculated for the total value of the chest, and then items are drawn until that value is met. The number after the colon (the "value") represents the value of 1 of this item, so if a chest's value (randomly drawn) is 500 and STONE: 2 is the only item in the list, then that chest will end up containing about 250 smooth stone.

You can also use data value items by doing, for example, WOOD:3: 5. In this case the wood would spawn the correct alternate and its value would be 5. Be sure there is no space around the first colon and a space after the second one, as shown here for some colored wool:

WorldLists:
  Default:
    Common:
      BRICK: 2
      RESTONE: 3
      FLINT: 2
      WOOL:14: 10
      WOOL:13: 8

You can use item ids as well, such as in the following example:

WorldLists:
  Default:
    Common:
      BRICK: 2
      RESTONE: 3
      FLINT: 2
      WOOL:14: 10
      WOOL:13: 8
    Uncommon:
      35:1: 15
      35:9: 15
      278:500: 400

The last item ID here would spawn a damaged diamond pickaxe. Neat, huh?

You can also use the new Enchantment Setups in the item lists. They wouldn't be much use if you couldn't, would they? :D

WorldLists:
  Default:
    Uncommon:
      35:1: 15
      35:9: 15
      278:500: 400
      IronPickaxeEff1: 500
      ThisIsSomeBadassDiamondArmor: 1000

The last two here are assumed to be names of enchantment setups under EnchantedItems.

There are two kinds of custom item lists. WorldLists are lists that can be used by the world. Worlds cannot use lists under the CustomLists section because those lists do not have rarity levels set up. CustomLists are used for stationary chests, which can each use a different item list from the CustomLists section. Remember when making custom WorldLists (by adding another section named something besides "Default") that you need to have a section for each rarity of chest under that section name. So like to make a "Custom1" list it would be:

WorldLists:
  Custom1:
    Common:
      COBBLESTONE: 1
    Uncommon:
      STONE: 2
    Rare:
      DIRT: 1
    Legendary:
      DIRT: 1
    Epic:
      DIRT: 1

How do I disable the hunt tool?

Just don't give anyone the taien.th.tool.* (or taien.th.tool.world) permission.

(more coming)