Skip to content
◆ TTS-STUDIO docs Discord

Plugins / EnchantsForge

Fusion Recipes

Fusion Recipes

Fusion recipes define which enchant books can be combined at the Fusion Altar and what the result is. All recipes are defined in plugins/EFV2Addon/fusion.yml.

Rename notice: EFV2Addon was previously released as "CustomEnchantsV2"; its plugin data folder is now plugins/EFV2Addon/. The base dependency was renamed from "CustomEnchants" to EnchantsForge.

Default Recipes

Two fusion recipes ship with the plugin:

Vampire Lord

Combines the sustained healing of Lifesteal with the kill bonus of Vampiric.

Field Value
Recipe ID vampire_lord
Input 1 Lifesteal III
Input 2 Vampiric II
Output Vampire Lord I
XP Cost 30 levels
Success Rate 60%
Failure Protection Netherite Scrap (optional)

Excavator Master

Combines area mining with automatic item collection.

Field Value
Recipe ID excavator_master
Input 1 Excavator I
Input 2 Telekinesis I
Output Excavator Master I
XP Cost 30 levels
Success Rate 60% (assumed same as default)
Failure Protection Netherite Scrap (optional)

fusion.yml Format

# fusion.yml — Fusion Altar recipes

vampire_lord:
  # Input enchant books required
  inputs:
    - id: lifesteal
      level: 3
    - id: vampiric
      level: 2

  # Output enchant book produced on success
  output:
    id: vampire_lord
    level: 1

  # XP levels consumed on attempt (success or failure)
  cost-xp-levels: 30

  # Probability of success (0.0 to 1.0)
  # 0.6 = 60% chance of success, 40% chance of failure
  success-rate: 0.6

  # Optional: Material that can be placed in the protection slot
  # If present and fusion fails, this item is consumed and inputs are returned
  # Comment out or remove this line to have no failure protection option
  failure-protection-item: NETHERITE_SCRAP

excavator_master:
  inputs:
    - id: excavator
      level: 1
    - id: telekinesis
      level: 1
  output:
    id: excavator_master
    level: 1
  cost-xp-levels: 30
  success-rate: 0.6
  failure-protection-item: NETHERITE_SCRAP

Adding Custom Recipes

You can add your own fusion recipes for any enchants registered in the system (EnchantsForge + EFV2Addon). Here's a template:

# fusion.yml — Add your custom recipes below

my_custom_fusion:
  inputs:
    - id: berserker        # Enchant ID (lowercase)
      level: 2             # Required level of the input book
    - id: cleave
      level: 2
  output:
    id: berserker          # Can output any registered enchant
    level: 2               # Output level
  cost-xp-levels: 50       # XP levels consumed
  success-rate: 0.5        # 50% success rate
  failure-protection-item: DIAMOND  # Optional protection item

Note: Enchant IDs must match exactly the IDs registered in the system. Use /enchant list to see all available IDs.

Field Reference

Field Type Required Description
inputs List Yes Exactly 2 input enchant books required
inputs[].id String Yes Enchant ID (must be registered)
inputs[].level Integer Yes Required level of the input book
output.id String Yes Enchant ID of the output book
output.level Integer Yes Level of the output book
cost-xp-levels Integer Yes XP levels consumed per attempt
success-rate Double Yes 0.0 (always fail) to 1.0 (always succeed)
failure-protection-item Material No Bukkit material name; consumed on failure to return inputs

Reloading Recipes

After editing fusion.yml, reload without restarting:

/ce reload

Warning: Reloading clears and re-registers all fusion recipes. Any ongoing fusion GUIs will be closed.

Recipe Design Tips

Tip: Set success-rate: 1.0 during testing to guarantee outputs, then tune the rate before going live.

Tip: Use rare or hard-to-obtain materials as failure protection (like Netherite) to make the protection meaningful.

Warning: Creating circular fusion recipes (A+B C, and C+D A) is technically possible but may confuse players. Document your recipes clearly.

Home | Fusion Altar | Enchantments | Commands & Permissions