Blood Altar (Blood Magic: Alchemical Wizardry)

Description

Converts an input item into an output itemstack, draining life essence from the altar at a base rate and requiring at least a specific tier.

Note

The Blood Altar consumes Life Essence from its internal tank to convert the input item into the output item. Each tier requires a larger multiblock, which may contain Runes that modify the Blood Altar's functionality.

Danger

Tier 6 must be enabled in the config to use a Blood Altar of that tier.

Identifier

Refer to this via any of the following:

mods.bm.blood_altar
mods.bm.bloodaltar
mods.bm.bloodAltar
mods.bm.BloodAltar
mods.bloodmagic.blood_altar/* Used as page default */
mods.bloodmagic.bloodaltar
mods.bloodmagic.bloodAltar
mods.bloodmagic.BloodAltar

Adding Recipes

• Add the given recipe to the recipe list:

  mods.bloodmagic.blood_altar.add(RecipeBloodAltar)

• Adds recipes in the format input, output, minimumTier, syphon, consumeRate, drainRate:

  mods.bloodmagic.blood_altar.add(IIngredient, ItemStack, int, int, int, int)

Recipe Builder

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

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

mods.bloodmagic.blood_altar.recipeBuilder()

• IngredientList<IIngredient>. Sets the item inputs of the recipe. Requires exactly 1.

  input(IIngredient)
  input(IIngredient...)
  input(Collection<IIngredient>)

• ItemStackList. Sets the item outputs of the recipe. Requires exactly 1.

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

• int. Sets how much Life Essence in total is required. Requires greater than or equal to 0. (Default 0).

  syphon(int)

• int. Sets how much Life Essence the recipe looses per tick when the recipe cannot consume Life Essence. Requires greater than or equal to 0. (Default 0).

  drainRate(int)

• int. Sets how much Life Essence the Blood Altar can consume per tick for this recipe. Requires greater than or equal to 0. (Default 0).

  consumeRate(int)

• int. Sets the minimum tier required from the altar. Requires greater than or equal to 0 and less than AltarTier.MAXTIERS, which is determined by the config option enableTierSixEvenThoughThereIsNoContent. (Default 0).

  tier(int)
  minimumTier(int)

• 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 WayofTime.bloodmagic.api.impl.recipe.RecipeBloodAltar).

  register()

Example

mods.bloodmagic.blood_altar.recipeBuilder()
    .input(item('minecraft:clay'))
    .output(item('minecraft:gold_ingot'))
    .minimumTier(0)
    .drainRate(5)
    .syphon(10)
    .consumeRate(5)
    .register()

mods.bloodmagic.blood_altar.recipeBuilder()
    .input(item('minecraft:gold_ingot'))
    .output(item('minecraft:diamond'))
    .tier(3)
    .drainRate(100)
    .syphon(50000)
    .consumeRate(500)
    .register()

Removing Recipes

• Removes the given recipe from the recipe list:

  mods.bloodmagic.blood_altar.remove(RecipeBloodAltar)

• Removes all recipes that match the given input:

  mods.bloodmagic.blood_altar.removeByInput(IIngredient)

• Removes all recipes that match the given output:

  mods.bloodmagic.blood_altar.removeByOutput(ItemStack)

• Removes all registered recipes:

  mods.bloodmagic.blood_altar.removeAll()

Example

mods.bloodmagic.blood_altar.removeByInput(item('minecraft:ender_pearl'))
mods.bloodmagic.blood_altar.removeByOutput(item('bloodmagic:slate:4'))
mods.bloodmagic.blood_altar.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.bloodmagic.blood_altar.streamRecipes()

Contributors

Waiting Idly Nullpinter

Changelog

Last edited 2 months ago

View full history

e6f31de-update docs for GroovyScript 1.2.0 (#24)

172cf3f-update docs for GroovyScript 1.1.2 (#18)

481224d-GroovyScript Improvements (#12)

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