> For the complete documentation index, see [llms.txt](https://headhunter-1.gitbook.io/headhunter/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://headhunter-1.gitbook.io/headhunter/configurations/custom-enchantments-config-custom-enchantments.yml.md). # Custom Enchantments Config (custom-enchantments.yml) ### File Location ``` plugins/HeadHunter/custom-enchantments.yml ``` *** ### Echantment Structure Each custom enchantment follows this structure: ```yaml ENCHANTMENT_NAME: Cooldown: 20 ## Note: Cooldown is only present for enchantments that support it. Levels: 1: "effect_type:value" 2: "effect_type:value" ``` ### Enchantment Fields | Field | Type | Description | | --------------------------------------------- | ------- | ------------------------------------------------------------------------------ | | Cooldown | Integer | Cooldown in seconds before the enchantment can trigger again (0 = no cooldown) | | Levels | Section | Define effects for each enchantment level | *** {% hint style="info" %} For a full list and more details about Custom Enchantments visit: [Custom Enchantments](/headhunter/core-features/custom-enchantments.md) {% endhint %} ### Effect String Format ```yaml Levels: '1': '@Chance:6@Deal:1.0@Heal:1.0' '2': '@Chance:6@Deal:1.5@Heal:2.0' ```
Single Effects ```yaml '1': '@Chance:50' ```
Multiple Effects ```yaml '1': '@Chance:6@Deal:1.0@Heal:1.0' ```
{% hint style="danger" %} Do NOT remove enchantments from this file! {% endhint %} ### Configuration Tips
🎯 Balancing
  • Test enchantment effects in-game
  • Adjust parameter values
  • Consider PvP vs PvE balance
âš¡ Performance
  • Use cooldowns on frequent triggers
  • Lower chance values reduce checks
  • Disable unused enchantments
🎨 Customization
  • Modify level scaling for progression
  • Change cooldown timers for your liking
🔧 Testing
  • Give yourself test items
  • Use /hh masks get for testing
  • Check console for errors
### Default Configuration {% code expandable="true" %} ```yaml # ################################# # # HeadHunter Plugin by DisabledGoat # # ################################# # # Custom Enchantments Configuration: # ---------------------------------- # This section allows you to configure all custom enchantments available in the plugin. # You can change cooldowns if enchantment supports it, and define their levels and effects. # # Configuration Options: # - Cooldown: The cooldown time (in seconds) before the enchantment can be used again. # Note: Cooldown is only present for enchantments that support it. # # Levels Configuration: # - Levels: Define the effects for each level of the enchantment. # Each level specifies the strength or behavior of the enchantment. # # Example: # ENCHANTMENT_NAME: # Enabled: true # DisplayName: Custom Enchantment # Cooldown: 30 # Levels: # 1: "Effect for level 1" # 2: "Effect for level 2" # # Note: Do not remove enchantments, if you want to not use them, disable them. # ---------------------------------- AEGIS_OF_THE_PEARL: Levels: '1': '' ARROW_GUARD: Levels: '1': '@Chance:10' '2': '@Chance:15' '3': '@Chance:20' '4': '@Chance:25' '5': '@Chance:30' AUTO_PICKUP: Levels: '1': '' BACKFIRE: Levels: '1': '@Chance:10@Duration:4' '2': '@Chance:12@Duration:5' '3': '@Chance:15@Duration:6' BLAST_SHOT: Levels: '1': '@Chance:6' '2': '@Chance:8' '3': '@Chance:12' BLINDNESS_IMMUNITY: Levels: '1': '@Chance:15' '2': '@Chance:20' '3': '@Chance:25' '4': '@Chance:30' '5': '@Chance:100' BLINDNESS_SHIELD: Levels: '1': '@Chance:5@Amplifier:0@Duration:4' '2': '@Chance:7@Amplifier:0@Duration:4' '3': '@Chance:9@Amplifier:0@Duration:5' '4': '@Chance:11@Amplifier:0@Duration:5' '5': '@Chance:13@Amplifier:0@Duration:6' BLOODHOUND: Levels: '1': '@Radius:15' '2': '@Radius:20' '3': '@Radius:25' '4': '@Radius:30' '5': '@Radius:35' CALL_OF_THE_DEAD: Levels: '1': '@Chance:5@Amount:1' '2': '@Chance:7@Amount:2' '3': '@Chance:9@Amount:3' '4': '@Chance:11@Amount:4' '5': '@Chance:13@Amount:5' CURSED_SHOT: Levels: '1': '@Chance:4' '2': '@Chance:6' '3': '@Chance:8' CURSED_STRIKE: Levels: '1': '@Chance:4' '2': '@Chance:6' '3': '@Chance:8' DEEP_LUNGS: Cooldown: 0 Levels: '1': '@Amplifier:0' EXTRA_HEARTS: Cooldown: 10 Levels: '1': '@Amplifier:0' '2': '@Amplifier:1' '3': '@Amplifier:2' '4': '@Amplifier:3' '5': '@Amplifier:4' FIRE_STRETCH: Levels: '1': '@Chance:10@Percent:50' '2': '@Chance:20@Percent:50' '3': '@Chance:30@Percent:50' '4': '@Chance:40@Percent:50' '5': '@Chance:50@Percent:50' FIREPROOF: Cooldown: 0 Levels: '1': '@Amplifier:0' FROSTBIND: Levels: '1': '@Chance:3@Duration:1' '2': '@Chance:4@Duration:2' '3': '@Chance:6@Duration:2' '4': '@Chance:5@Duration:3' '5': '@Chance:30@Duration:4' GHOSTSEER: Levels: '1': '@Radius:10' '2': '@Radius:15' '3': '@Radius:20' '4': '@Radius:25' '5': '@Radius:30' GOLDEN_GRACE: Levels: '1': '@Chance:20' '2': '@Chance:25' '3': '@Chance:30' GRASS_WALKER: Levels: '1': '' HARDENED: Levels: '1': '@Chance:5@Amount:5' '2': '@Chance:7@Amount:7' '3': '@Chance:9@Amount:10' '4': '@Chance:11@Amount:12' '5': '@Chance:13@Amount:15' HEARTFORGE: Cooldown: 20 Levels: '1': '' HIGH_JUMP: Cooldown: 0 Levels: '1': '@Amplifier:0' '2': '@Amplifier:1' '3': '@Amplifier:2' HUNTERS_BLESSING: Levels: '1': '@Chance:7' '2': '@Chance:10' '3': '@Chance:14' '4': '@Chance:20' '5': '@Chance:28' LIFE_STEAL: Levels: '1': '@Chance:20@Damage:0.5@Heal:0.5' '2': '@Chance:30@Damage:0.5@Heal:0.5' '3': '@Chance:20@Damage:1.0@Heal:1.0' '4': '@Chance:30@Damage:1.0@Heal:1.0' '5': '@Chance:20@Damage:1.5@Heal:1.5' LINGERING_FLAME: Levels: '1': '@Duration:1' '2': '@Duration:2' '3': '@Duration:3' '4': '@Duration:4' '5': '@Duration:5' LUCKY_CATCH: Levels: '1': '@Chance:5@Materials:iron_ingot' '2': '@Chance:8@Materials:iron_ingot,gold_ingot' '3': '@Chance:12@Materials:iron_ingot,gold_ingot,emerald' '4': '@Chance:16@Materials:iron_ingot,gold_ingot,emerald,diamond' '5': '@Chance:20@Materials:iron_ingot,gold_ingot,emerald,diamond,spawner' MASS_MINER: Levels: '1': '' '2': '' '3': '' MINERS_ELIXIR: Cooldown: 0 Levels: '1': '@Effects:night_vision(1)' '2': '@Effects:night_vision(1),haste(1)' '3': '@Effects:night_vision(1),haste(1),saturation(1)' '4': '@Effects:night_vision(1),haste(2),saturation(1)' '5': '@Effects:night_vision(1),haste(2),saturation(1),jump_boost(1)' MINING_FATIGUE_SHIELD: Levels: '1': '@Chance:5@Amplifier:0@Duration:4' '2': '@Chance:7@Amplifier:0@Duration:4' '3': '@Chance:9@Amplifier:0@Duration:5' '4': '@Chance:11@Amplifier:0@Duration:5' '5': '@Chance:13@Amplifier:0@Duration:6' NEEDLEPROOF: Levels: '1': '' NIGHT_VISION: Cooldown: 0 Levels: '1': '@Amplifier:0' NIGHTWARD: Levels: '1': '' PAINFUEL: Levels: '1': '@Percent:10' '2': '@Percent:12' '3': '@Percent:14' '4': '@Percent:17' '5': '@Percent:20' PEARL_SALVATION: Cooldown: 20 Levels: '1': '' PIGLIN_HORDE: Levels: '1': '@Chance:5@Amount:1' '2': '@Chance:7@Amount:2' '3': '@Chance:9@Amount:3' '4': '@Chance:11@Amount:4' '5': '@Chance:13@Amount:5' POISON_IMMUNITY: Levels: '1': '@Chance:15' '2': '@Chance:20' '3': '@Chance:25' '4': '@Chance:30' '5': '@Chance:100' POISON_SHIELD: Levels: '1': '@Chance:5@Amplifier:0@Duration:4' '2': '@Chance:7@Amplifier:1@Duration:4' '3': '@Chance:9@Amplifier:0@Duration:5' '4': '@Chance:11@Amplifier:1@Duration:5' '5': '@Chance:13@Amplifier:1@Duration:6' SHADOW_PEARL: Levels: '1': '@Chance:15@Duration:3' '2': '@Chance:20@Duration:4' '3': '@Chance:25@Duration:5' '4': '@Chance:30@Duration:6' '5': '@Chance:35@Duration:7' SHOCKWAVE: Levels: '1': '@Radius:3@Damage:2@Height:5@Distance:2' '2': '@Radius:4@Damage:3@Height:5@Distance:3' '3': '@Radius:5@Damage:4@Height:4@Distance:4' '4': '@Radius:6@Damage:5@Height:3@Distance:5' '5': '@Radius:7@Damage:6@Height:3@Distance:6' SKULL_HOARDER: Levels: '1': '@Chance:10' '2': '@Chance:15' '3': '@Chance:20' '4': '@Chance:25' '5': '@Chance:30' SLOWNESS_IMMUNITY: Levels: '1': '@Chance:15' '2': '@Chance:20' '3': '@Chance:25' '4': '@Chance:30' '5': '@Chance:100' SLOWNESS_SHIELD: Levels: '1': '@Chance:5@Amplifier:0@Duration:4' '2': '@Chance:7@Amplifier:1@Duration:4' '3': '@Chance:9@Amplifier:0@Duration:5' '4': '@Chance:11@Amplifier:1@Duration:5' '5': '@Chance:13@Amplifier:1@Duration:6' SOFTLANDING: Levels: '1': '@Chance:15' '2': '@Chance:20' '3': '@Chance:25' '4': '@Chance:30' '5': '@Chance:100' SPEED: Cooldown: 0 Levels: '1': '@Amplifier:0' '2': '@Amplifier:1' '3': '@Amplifier:2' SPELL_STRETCH: Levels: '1': '@Chance:15@Percent:20' '2': '@Chance:15@Percent:30' '3': '@Chance:15@Percent:40' '4': '@Chance:15@Percent:45' '5': '@Chance:15@Percent:50' '6': '@Chance:100@Percent:50' VACCINE: Levels: '1': '@Chance:15@Effects:hunger,poison,nausea' '2': '@Chance:20@Effects:hunger,poison,nausea,mining_fatigue,blindness' '3': '@Chance:25@Effects:hunger,poison,nausea,mining_fatigue,blindness,darkness' '4': '@Chance:30@Effects:hunger,poison,nausea,mining_fatigue,blindness,darkness,slowness' '5': '@Chance:40@Effects:hunger,poison,nausea,mining_fatigue,blindness,darkness,slowness,weakness,wither' '6': '@Chance:100@Effects:hunger,poison,nausea,mining_fatigue,blindness,darkness,slowness,weakness,wither' WELL_FED: Cooldown: 0 Levels: '1': '@Amplifier:0' WITHER_IMMUNITY: Levels: '1': '@Chance:15' '2': '@Chance:20' '3': '@Chance:25' '4': '@Chance:30' '5': '@Chance:100' WOLF_PACK: Levels: '1': '@Chance:5@Amount:1' '2': '@Chance:7@Amount:2' '3': '@Chance:9@Amount:3' '4': '@Chance:11@Amount:4' '5': '@Chance:13@Amount:5' ``` {% endcode %} {% hint style="info" %} Changes to enchantments require a server restart to take effect. Existing enchanted items will update automatically. {% endhint %}