⚔️ 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

Field	Description
`id`	Unique enchantment ID, format `namespace:name`
`displayName`	Name shown in-game
`description`	Tooltip text shown on enchanted items. Use `{amount}` for dynamic % value
`targetNpcIds`	List of NPC type IDs that receive the bonus damage
`levels`	Number of enchantment levels
`levelAttributes`	Per-level damage bonus in % (e.g. `20` = +20%)
`scrolls`	Crafting recipe per level: quality, tier, and ingredients

🔍 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

Download the .jar file

Place it in your world's mods/ folder:

mods/SlayerEnchantment/SlayerEnchantmentAddon-0.0.12.jar

Start the server — the config file is created automatically on first run
Edit config/slayer_enchantments.json in your /saves/{worldname}/mods/ to define your enchantments
Restart the server

Requires Simple Enchantments. Built for Hytale server modding.

** Credit: **

Simple Enchantments Api Author: Herolias
Slayer Enchantments Addon Author: Utopia.

SlayerEnchantmentsAddon - SimpleEnchantment Addon

Simple Enchantments