Bukkit

Alchemical Cauldron is an alchemy plugin allowing transmutation of blocks and items into other blocks and items. Recipes can be created by the server op and all code is server-side. See a video of it in action here.

Installation

Download AlchemicalCauldron.jar to minecraft/plugins.

Configuration

A default config.yml will be provided on first run. Included are sample recipes. The config looks like this:

log_level: WARNING
contraption_material: OBSIDIAN
fail_chance: 3
recipes:
    - product: DIAMOND
      type: item
      reagent1: COAL_ORE
      reagent2: OBSIDIAN
      reagent3: WATCH
      reagent3_consumed: false
    - product: COAL_ORE
      type: block
      reagent1: WOOD
      reagent2: COBBLESTONE
      reagent3: INK_SACK
      reagent3_data: BLACK
      reagent3_consumed: true
    - product: Sheep
      type: mob
      reagent3: BONE
      reagent1: WOOL
      reagent1_data: WHITE
      reagent2: WOOL
      reagent2_data: WHITE
    - product: INK_SACK
      product_data: BLUE
      type: item
      reagent1: SNOW_BLOCK
      reagent2: COBBLESTONE
      reagent3: INK_SACK
      reagent3_data: GREEN
      reagent3_consumed: true
      secret: true

• log_level sets how loud you want the plugin to be. Default in WARNING. INFO is also useful and will show you everything the plugin does.
• contraption_material is what material the cauldron must be made out of. Currently only OBSIDIAN is supported.
• fail_chance is the % chance that a recipe fails. Currently unsupported.
• recipes is a list of recipes, of the following format:
  • product: The material or mob the recipe produces. Material names are the same as those provided by the /give command.
  • product_data: optional extra data to apply to the product. For example, if you want a blue sheep or some light pink wool.
  • type: one of mob, block or item. Mobs are spawned on top of the cauldron. Blocks are created inside the cauldron. Items are 'dropped' from the cauldron.
  • reagent1: The block that must be in the bottom of the cauldron (i.e. in the empty space.)
  • reagent2: The block that must be on top of reagent1.
  • reagent3: The ITEM the player must be holding; the recipe triggers when the player right-clicks on reagent2 while holding reagent3.
  • reagent1_data, reagent2_data, reagent3_data: Like product_data, you can use this to require that the reagent be a specific color.
  • reagent3_consumed: If true, the item the player is holding is consumed by the recipe. Reagents 1 and 2 are always consumed.
  • secret: If true, the recipe isn't shown in /recipes.

The recipes in the default config translate to:

• A block of coal ore on the bottom, a block of obsidian on top. Hit it with a watch, it creates a diamond. The watch is not consumed.
• A block of wood on the bottom, a block of cobblestone on top. Hit it with an ink sack (must be black, from a squid), it creates a block of coal ore inside the cauldron. The ink sack is consumed.
• A stack of two white wool. Hit it with a bone, and a sheep is created. The bone is consumed.
• A snow block on the bottom, a cobblestone block on top. Hit it with a green ink sack (from cooking a cactus), and a blue ink sack (lapis lazuli) is created. All reagents are consumed. This recipe is a secret, and not listed in /recipes (see below).

Commands

/recipes lists all recipes that are not set as secret in the config.

Usage (For players)

Build a cauldron out of OBSIDIAN (other materials may be supported in the future). Cauldrons are a 3x3 (9 block square) layer on the bottom and a 3x3 ring (8 block hollow square) on top.

/recipes displays a list of recipes. Place the first reagent in the middle of the ring and the second reagent on top. Right-click with the third reagent to invoke the recipe.

Permissions

alchemicalcauldron.use controls both the /recipes command and whether cauldrons work for the player. If you aren't using a permissions system, this defaults to true.