SlayerEnchantmentsAddon - SimpleEnchantment 附加组件

⚔️ NPC杀戮附魔 - SimpleEnchantments 扩展

NPC杀戮附魔 是一个完全由配置驱动的 Hytale 服务器插件，它能添加对特定 NPC 类型造成额外伤害的自定义武器附魔。无需编写代码——每个附魔、目标、伤害值和合成配方都在单个 JSON 文件中定义，你可以编辑并通过重启服务器来重新加载，无需重新编译。

---

🎯 目标

本插件的目标是让服务器管理员拥有一个灵活的系统来创建猎人风格的附魔——奖励那些专门对抗特定敌对类型的玩家。想要一把对石像鬼造成额外伤害的剑？或者一把能撕裂哥布林的刀刃？在 JSON 中配置，重启服务器，即可生效。

每个附魔都与 Simple Enchantments 原生集成——卷轴会出现在合成系统中，工具提示会显示加成，激活效果如同内置附魔一样触发。

---

✨ 功能

• 🔧 完全配置驱动 — 通过 JSON 添加无限附魔，无需 Java 知识
• 🎯 逐个附魔的 NPC 目标设定 — 每个附魔拥有独立的目标 NPC ID 列表
• 📈 自定义每级伤害数值 — 为每个等级独立定义精确的百分比加成
• 📜 完整的卷轴集成 — 每个等级都有自定义合成配方，包含品质等级
• 🔁 可热替换的配置 — 编辑 JSON 文件后重启服务器即可应用更改
• ⚙️ 与 Simple Enchantments 兼容 — 卷轴、工具提示和激活事件均原生工作

---

📦 前置要求

• Simple Enchantments v0.9.0+

---

🛠️ 配置

在服务器首次启动时，插件会自动在以下路径创建配置文件：

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

编辑此文件以添加、移除或修改附魔。重启服务器以应用更改。

---

📝 配置示例

以下示例定义了两个附魔——杀戮者（对石像鬼造成额外伤害）和狂战士（对人形敌人造成额外伤害）：

{
  "enchantments": [
    {
      "id": "Utopia:goblin_slayer",
      "displayName": "哥布林杀戮者",
      "description": "增加对哥布林敌人的伤害：{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": "兽人杀戮者",
      "description": "增加对兽人敌人的伤害：{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
            }
          ]
        }
      ]
    }
  ]
}

配置字段参考

字段	描述
id	唯一附魔 ID，格式为 命名空间:名称
displayName	游戏中显示的名称
description	附魔物品上的提示文本。使用 {amount} 代表动态百分比数值
targetNpcIds	接收额外伤害的 NPC 类型 ID 列表
levels	附魔等级数量
levelAttributes	每级伤害加成百分比（例如 20 = +20%）
scrolls	每级合成配方：品质、等级和材料

---

🔍 查找 NPC ID

每当 NPC 死亡时，NPC 类型 ID 会出现在服务器日志中：

NPC death detected: npcTypeId=goblin_miner, role=Goblin_Miner

在你的 targetNpcIds 列表中使用 npcTypeId 的值。匹配不区分大小写。

---

📋 安装

1. 下载 .jar 文件

2. 将其放入你世界的 mods/ 文件夹中：

   mods/SlayerEnchantment/SlayerEnchantmentAddon-0.0.12.jar

3. 启动服务器——配置文件会在首次运行时自动创建

4. 编辑 /saves/{世界名称}/mods/ 目录下的 config/slayer_enchantments.json 文件来定义你的附魔

5. 重启服务器

---

需要 Simple Enchantments。专为 Hytale 服务器模组制作。

** 鸣谢： **

• Simple Enchantments API 作者：Herolias

• 杀戮附魔扩展作者：Utopia.