⚔️ NPC Slayer Enchantments - SimpleEnchantments Addon

NPC Slayer Enchantments is a fully config-driven plugin for Hytale servers that adds custom weapon enchantments granting bonus damage against specific NPC types. No coding required — every enchantment, target, damage value, and crafting recipe is defined in a single JSON file that you can edit and reload without recompiling.

🎯 Goal

The goal of this plugin is to give server owners a flexible system to create hunter-style enchantments — rewarding players who specialize in fighting specific enemy types. Want a sword that deals extra damage to stone golems? A blade that shreds through goblins? Configure it in the JSON, restart the server, and it's live.

Every enchantment integrates natively with Simple Enchantments — scrolls appear in the crafting system, tooltips show the bonus, and activation effects fire just like any built-in enchantment.

✨ Features

• 🔧 Fully config-driven — add unlimited enchantments via JSON, no Java required
• 🎯 Per-enchantment NPC targeting — each enchantment has its own list of target NPC IDs
• 📈 Custom per-level damage values — define exact % bonus for each level independently
• 📜 Full scroll integration — custom crafting recipes per level with quality tiers
• 🔁 Hot-swappable config — edit the JSON and restart to apply changes
• ⚙️ Simple Enchantments compatible — scrolls, tooltips, and activation events all work natively

📦 Requirements

• Simple Enchantments v0.9.0+

🛠️ Configuration

On first server start, the plugin automatically creates the config file at:

saves/<world>/mods/SlayerEnchantment/config/slayer_enchantments.json

Edit this file to add, remove, or modify enchantments. Restart the server to apply changes.

📝 Example Configuration

The following example defines two enchantments — Slayer (bonus damage vs stone golems) and Berserker (bonus damage vs humanoid enemies):

{
  "enchantments": [
    {
      "id": "Utopia:goblin_slayer",
      "displayName": "Goblin Slayer",
      "description": "Increases damage against Goblins enemies: {amount}%",
      "targetNpcIds": [
        "Goblin_Miner",
        "Goblin_Hermit",
        "Goblin_Lobber"
      ],
      "levels": 3,
      "levelAttributes": [
        {
          "level": 1,
          "value": 15
        },
        {
          "level": 2,
          "value": 30
        },
        {
          "level": 3,
          "value": 50
        }
      ],
      "scrolls": [
        {
          "level": 1,
          "quality": "Uncommon",
          "craftingTier": 1,
          "ingredients": [
            {
              "itemId": "Ingredient_Crystal_Red",
              "quantity": 5
            },
            {
              "itemId": "Ingredient_Bone",
              "quantity": 20
            }
          ]
        },
        {
          "level": 2,
          "quality": "Rare",
          "craftingTier": 2,
          "ingredients": [
            {
              "itemId": "Ingredient_Crystal_Red",
              "quantity": 10
            },
            {
              "itemId": "Ingredient_Fang",
              "quantity": 10
            }
          ]
        },
        {
          "level": 3,
          "quality": "Epic",
          "craftingTier": 3,
          "ingredients": [
            {
              "itemId": "Ingredient_Crystal_Red",
              "quantity": 20
            },
            {
              "itemId": "Ingredient_Fang",
              "quantity": 20
            },
            {
              "itemId": "Ingredient_Horn",
              "quantity": 5
            }
          ]
        }
      ]
    },
    {
      "id": "Utopia:Trork_slayer",
      "displayName": "Trork Slayer",
      "description": "Increases damage against Trorks enemies: {amount}%",
      "targetNpcIds": [
        "Trork_Brawler",
        "Trork_Chieftain",
        "Trork_Shaman",
        "Trork_Guard"
      ],
      "levels": 3,
      "levelAttributes": [
        {
          "level": 1,
          "value": 15
        },
        {
          "level": 2,
          "value": 30
        },
        {
          "level": 3,
          "value": 50
        }
      ],
      "scrolls": [
        {
          "level": 1,
          "quality": "Uncommon",
          "craftingTier": 1,
          "ingredients": [
            {
              "itemId": "Ingredient_Crystal_Red",
              "quantity": 5
            },
            {
              "itemId": "Ingredient_Bone",
              "quantity": 20
            }
          ]
        },
        {
          "level": 2,
          "quality": "Rare",
          "craftingTier": 2,
          "ingredients": [
            {
              "itemId": "Ingredient_Crystal_Red",
              "quantity": 10
            },
            {
              "itemId": "Ingredient_Fang",
              "quantity": 10
            }
          ]
        },
        {
          "level": 3,
          "quality": "Epic",
          "craftingTier": 3,
          "ingredients": [
            {
              "itemId": "Ingredient_Crystal_Red",
              "quantity": 20
            },
            {
              "itemId": "Ingredient_Fang",
              "quantity": 20
            },
            {
              "itemId": "Ingredient_Horn",
              "quantity": 5
            }
          ]
        }
      ]
    }
  ]
}

Config Fields Reference

🔍 Finding NPC IDs

NPC type IDs appear in your server logs whenever an NPC dies:

NPC death detected: npcTypeId=goblin_miner, role=Goblin_Miner

Use the value from npcTypeId in your targetNpcIds list. Matching is case-insensitive.

📋 Installation

1. Download the .jar file

2. Place it in your world's mods/ folder:

   mods/SlayerEnchantment/SlayerEnchantmentAddon-0.0.12.jar

3. Start the server — the config file is created automatically on first run

4. Edit config/slayer_enchantments.json in your /saves/{worldname}/mods/ to define your enchantments

5. Restart the server

Requires Simple Enchantments. Built for Hytale server modding.

** Credit: **

• Simple Enchantments Api Author: Herolias

• Slayer Enchantments Addon Author: Utopia.