Bukkit

Configuration & Permissions

Back to the main page

Permission Nodes

The default node fruitful.drop.* is set to true. If you want to control who has access to which drops, you may set that to false in your permissions.yml file, then with a plugin such as PermissionsBukkit you can then customize as necessary.

The permission hierarchy is below. With 0.7 you now configure what the blocks and drops are called, so the drop names are configuration dependent.

fruitful.*
    fruitful.drop.*
        fruitful.drop.<blocktype>.*
            fruitful.drop.<blocktype>.<dropname>
    fruitful.command.*
        fruitful.command.reload

Configuration

You only need to put in whatever you want to happen, any drops or sections missing will be ignored. With v0.7 the Configuration has changed significantly. It is now as follows:

options:
    Permissions: true
defaults:
    blocktype1:
        keywords: [keyword1, keyword2, ...]
        item1:
            range: [number] OR [min, max]
            chance: percentage% | rat:io  | .decimal
            keywords: ...
        creature1:
            ...
worlds:
    WorldName:
        blocktype1:
            ...
valid:
    blocktypes:
        blocktype1:
            type: <Material> or <ID>
            data: [value1, value2, ...]
            biomes: [biome1, biome2]
            keywords: ...
    items:
        item1:
            type: <Material> or <ID>
            data: [value1, value2, ...]
            keywords: ...
    creatures:
        creature1:
            creature: <CreatureType>
            keywords: ...
    groups:
        group1:
            item1:
                range: ...
                chance: ...
                keywords: ...
            creature1:
                range: ...
                chance: ...
                keywords: ...

The WorldName is a case sensitive world name.
The blocktype is defined in the configuration under blocktypes:
The range may be a single integer in brackets [number], or a range in brackets [min, max]
The chance may be a ratio in single quotes, a percentage, or a decimal between zero and one.
The chance under a group's item, is actually a weight; the values are relative to each other.

item, creature, and group names must all be unique from each other. blocktype names must also be unique from other blocktype names.

The keywords may be nonexistent, or any number of the following:

• shearable - Allows shears to drop this item
• burnable - Allows fire destroying a block to drop this
• secure - Prevent this from droping if it isn't player oriented
• no_boom - Prevent this from dropping due to an explosion
• no_water - Prevent this from dropping due to water or lava flow
• no_decay - Prevent this from dropping due to leaf decay
• no_break - Prevent this from dropping by a player breaking a block
• disabled - No matter what, don't do this
• no_override - Do not override a block's normal drops

There are also creature specific keywords; they only matter in the creatures: section:

• burning - This creature is on fire!
• electric - This creeper is super powered!
• rainbow - Random sheep colors (Defaults to natural otherwise)
• sheared - Very cold sheep
• angry - Wolves, spiders, and Zombie Pigmen don't dawdle
• saddled - This pig, is a mighty steed

All keywords should be enclosed in brackets, and separated with a comma. Case doesn't matter. (i.e. "[no_boom, NO_Break]")