Clone this wiki locally
OtherBlocks is a plugin for the Minecraft Bukkit API that lets you change what blocks and mobs drop when they die or are broken. It is very flexible, but out of the box does nothing. Please read the rest of this page to understand how to configure OtherBlocks to do what you want.
For the latest download, see the Bukkit forum thread: http://forums.bukkit.org/threads/21074/
Config Examples and Ideas (ideas and ways to achieve specific functionality with OtherBlocks)
Material and Creature Values (block, item, creature and tool values)
Color and Data Values (a list of valid color or data values)
Installing and Configuring
Extract the files (jar and OtherBlocks folder) into your plugins folder.
Out of the box, OtherBlocks does nothing. To make it do what you want, edit the file plugins/OtherBlocks/otherblocks-globalconfig.yml. Example files are supplied and can be enabled simply by changing "no" to "yes". Additional custom configuration can be included at the bottom of the global file or you can add your own files. Drop parameters are details further down this page.
include-files: ## OtherBlocks example files ob-fix_undroppables: no # fix glass, bookshelf, boat and stairs drops ob-goldtools-basic: no # allow gold-pickaxe chance to get ice & glowstone, gold-hoe chance to get grass ob-goldtools-smelt: no # gold-pickaxe smelts ores to ingots, sand to glass, etc ob-leaf_overhaul: no # overhaul leaf drops (apples, cocoa beans, leaves, sticks & a very small chance of golden apple) ob-playerdeath_zombie: no # players drop zombies on death (that's it - see undead_chaos for more fun :D) ob-undead_chaos: no # the undead shall rise again! Includes players dropping zombies/skeletons # ob-random_examples: no # For crazy testing only :) Read through examples before activating. ## Other users overhauls overhaul-catballs: no # great example/playable config from Catballs (disable "ob" configs before using this one, otherwise you might have too many drops) overhaul-zarius: no # Zar's messy config (I run this with no other includes, at the moment)
Here is an example we shall go through bit-by-bit:
priority: lowest verbosity: normal otherblocks: SAND: - tool: GOLD_SPADE drop: GLASS - tool: DIAMOND_SPADE drop: GLOWSTONE chance: 50 COAL_ORE: - tool: [GOLD_PICKAXE, DIAMOND_PICKAXE] drop: NETHERRACK quantity: 2-4 LEAVES@BIRCH: - tool: ALL drop: APPLE chance: 5 CREATURE_CREEPER: - tool: DIAMOND_SWORD drop: DIAMOND world: creeperworld SPECIAL_LEAFDECAY: - drop: APPLE chance: 10
You can probably ignore the first two lines, as they are general options that govern the whole plugin:
priority lets you try to fix compatibility issues with other plugins: acceptable values are
verbosity governs how much information is printed to the console. By default,
normalprints every single substitution that OtherBlocks will make. If you have many substitutions, set this to
lowto hide them. It will still print error messages.
- priority lets you try to fix compatibility issues with other plugins: acceptable values are
"otherblocks:" starts the main block of substitutions. Note that from this point on, every line is indented by at least four spaces, not tabs
The first is for when you break a sand block:
- If you break it with a gold spade, you always get glass
- If you break it with a diamond shovel, you get glowstone 50% of the time, otherwise sand.
- The rest of the time, it always drops sand.
The second shows the list syntax and how to have a randomized drop quantity. If you break coal ore with either a diamond or gold pickaxe, you get between two and four netherrack blocks.
The third shows the "all" keyword, and how to select the original block data type. Birch tree leaves drop apples 5% of the time, regardless of tool. Leaves from other trees do not change their behaviour.
The fourth shows a mob drop and the multiworld option. If you kill a creeper, with a diamond sword, in the world called "creeperworld", it drops a diamond.
The final shows the special "leaf decay" event. Leaves decaying drop an apple 10% of the time - less than if you break by hand, in this example.
All config parameters
Here is a summarised list of parameters:
Conditions: tool, toolexcept, quantity, chance, worlds, weather, biomes, time, height, permissions, permissiongroups, exclusive, attackrange, regions.
Actions: drop, color, event, message, damagetool, damageattacker, delay, runcommands.
For full usage details see: Configuration Parameters