Transmutation (Roots 3)

Description

When running the Transmutation, convert nearby blocks that match a set of conditions into either a block or items.

Identifier

Refer to this via any of the following:

mods.roots.transmutation/* Used as page default */
mods.roots.Transmutation

Adding Recipes

Recipe Builder

Just like other recipe types, the Transmutation also uses a recipe builder.

Don't know what a builder is? Check the builder info page out.

mods.roots.transmutation.recipeBuilder()

• ResourceLocation. Sets the Resource Location of the recipe.

  name(String)
  name(ResourceLocation)

• ItemStackList. Sets the item outputs of the recipe. Requires greater than or equal to 0 and less than or equal to 1.

  output(ItemStack)
  output(ItemStack...)
  output(Collection<ItemStack>)

• BlockStatePredicate. Sets the starting blockstate. Requires not null.

  start(IBlockState)
  start(BlockStatePredicate)

• IBlockState. Sets the output iblockstate.

  state(IBlockState)
  output(IBlockState)

• WorldBlockStatePredicate. Sets a condition for the input to be converted, typically indicating a specific block above or below. (Default WorldBlockStatePredicate.TRUE).

  condition(WorldBlockStatePredicate)

• First validates the builder, returning null and outputting errors to the log file if the validation failed, then registers the builder and returns the registered object. (returns null or epicsquid.roots.recipe.TransmutationRecipe).

  register()

Example

mods.roots.transmutation.recipeBuilder()
    .name('clay_duping')
    .start(blockstate('minecraft:clay'))
    .output(item('minecraft:clay_ball') * 30)
    .condition(mods.roots.predicates.stateBuilder().blockstate(blockstate('minecraft:gold_block')).below().register())
    .register()

mods.roots.transmutation.recipeBuilder()
    .start(mods.roots.predicates.stateBuilder().blockstate(blockstate('minecraft:yellow_flower:type=dandelion')).properties('type').register())
    .state(blockstate('minecraft:gold_block'))
    .condition(mods.roots.predicates.above(mods.roots.predicates.LEAVES))
    .register()

mods.roots.transmutation.recipeBuilder()
    .start(blockstate('minecraft:diamond_block'))
    .state(blockstate('minecraft:gold_block'))
    .register()

Removing Recipes

• Removes the Transmutation recipe for the given input IBlockState:

  mods.roots.transmutation.removeByInput(IBlockState)

• Removes the Transmutation recipe with the given name:

  mods.roots.transmutation.removeByName(ResourceLocation)

• Removes the Transmutation recipe for the given output IBlockState:

  mods.roots.transmutation.removeByOutput(IBlockState)

• Removes the Transmutation recipe for the given output itemstack:

  mods.roots.transmutation.removeByOutput(ItemStack)

• Removes all registered recipes:

  mods.roots.transmutation.removeAll()

Example

mods.roots.transmutation.removeByName(resource('roots:redstone_block_to_glowstone'))
mods.roots.transmutation.removeByOutput(blockstate('minecraft:log:variant=jungle'))
mods.roots.transmutation.removeByOutput(item('minecraft:dye:3'))
mods.roots.transmutation.removeAll()

Getting the value of recipes

• Iterates through every entry in the registry, with the ability to call remove on any element to remove it:

  mods.roots.transmutation.streamRecipes()

Contributors

Waiting Idly Nullpinter

Changelog

Last edited 5 months ago

View full history

481224d-GroovyScript Improvements (#12)

70357c1-docs(en): migrate grs docs (#2)