Soul Binding

The Soul Binder is a machine that binds the essence of living beings into items. It is used to create soul-infused materials, tools, and upgrades by combining items with captured mob souls. Each recipe may target a specific entity type, mob category, or use a predefined soul type.

Overview

• access in recipes event via: event.recipes.enderio.soul_binding
• properties:
  • output
    • description: specifies the output item
    • type: ItemStack
    • role: output
    • required: yes
    • usage: needs to be passed as the first argument
  • input
    • description: specifies the input item
    • type: Ingredient
    • role: input
    • required: yes
    • usage: needs to be passed as the second argument
  • energy
    • description: specifies the energy usage of the recipe
    • type: int
    • role: other
    • required: no
    • default: 2000
    • usage: can be passed as the third argument or by chaining the function .energy(int)
  • experience
    • description: specifies the experience cost of the recipe
    • type: float
    • role: other
    • required: no
    • default: 5.0
    • usage: can be passed as the fourth argument or by chaining the function .experience(float)
  • entity_type
    • description: specifies the entity type soul required for the recipe
    • type: TagKey<EntityType>
    • role: other
    • required: no
    • default: none
    • usage: can be set by chaining the function .entityType(string)
  • mob_category
    • description: specifies the mob category soul required for the recipe, more information here
    • type: MobCategory
    • role: other
    • required: no
    • default: none
    • usage: can be set by chaining the function .mobCategory(string)
  • soul_data
    • description: specifies the soul data required for the recipe
    • type: string
    • role: other
    • required: no
    • default: none
    • usage: can be set by chaining the function .soulData(string)
• validators:
  • entity_type, mob_category, and soul_data must be mutually exclusive

Examples

ServerEvents.recipes(event => {
    // removes all soul binding recipes
    event.remove({ type: "enderio:soul_binding" })

    // adds a recipe that converts an apple to a stick
    // uses default values for energy and experience
    // no entity type, mob category, or soul data
    event.recipes.enderio.soul_binding("stick", "apple")

    // adds a recipe that converts any ingot to 3 carrots
    // energy usage of 5000
    // experience of 3
    // no entity type, mob category, or soul data
    event.recipes.enderio.soul_binding("3x carrot", "#c:ingots", 5000, 3)

    // adds a recipe that converts a stick to 4 stone
    // energy usage of 5000
    // no experience
    // mob category of axolotls
    // uses the chaining function for the mob category
    event.recipes.enderio
        .soul_binding(Item.of("stone", 4), "stick", 5000)
        .mobCategory(MobCategory.AXOLOTLS)

    // adds a recipe that converts white wool to bread
    // default values for energy and exp
    // entity type of minecraft:zombie
    // uses the chaining function for the entity type
    event.recipes.enderio
        .soul_binding("bread", "white_wool")
        .energy(3000)
        .experience(2)
        .entityType("minecraft:zombie")
})