饰品

FineCraft 饰品

为游戏添加一个轻量级饰品系统，配有专用界面来管理你所装备的饰品。

可直接从手中装备饰品，通过 /accessory 指令进行管理，并从四款与生命精华相关的入门级饰品开始，体验首次基础成长。

插件新增内容

• 一个 /accessory 指令
• 一个 /acc 别名
• 一个用于管理已装备饰品的界面
• 饰品属性加成
• 支持 StatModifiers
• 支持 Effects
• 支持 DamageResistance
• 支持 DamageCauseEnhancement

可用槽位

当前插件支持 6 个槽位：

• 2 个戒指槽
• 1 个项链槽
• 1 个腰带槽
• 2 个耳环槽

如何装备饰品

饰品直接通过你手中的物品进行装备。

单槽位饰品

• 项链
• 腰带

对于这些饰品，Primary 和 Secondary 都装备到同一个槽位。

双槽位饰品

• 戒指
• 耳环

对于这些饰品：

• Primary 装备到槽位 1
• Secondary 装备到槽位 2

示例：

• 使用 Primary 的戒指放入 戒指 1
• 使用 Secondary 的戒指放入 戒指 2
• 使用 Primary 的耳环放入 耳环 1
• 使用 Secondary 的耳环放入 耳环 2

游戏中

1. 手持一个饰品。
2. 使用你想要装备的交互方式。
3. 打开 /accessory 查看你的已装备槽位。
4. 如需卸下饰品，直接在界面中操作。

当前内容状态

插件目前提供一套可玩的入门级饰品，包含四款：

• 铁戒指：少量生命值加成
• 铁耳环：少量法力值加成
• 铁项链：部分生命值加成外加微弱的回复效果
• 带铁扣的皮革腰带：部分耐力值加成外加轻量防护

这些饰品在专用的饰品工作台上制作。

模型并非装饰性附件，不会在角色外观上显示。

快速教程：添加一个新饰品

如果你想扩展插件，添加自己的饰品，这是最快捷的路径。

1. 创建物品 JSON

将你的物品放置在合适的文件夹中，例如：

• Server/Item/Items/Accessories/Ring/
• Server/Item/Items/Accessories/Necklace/
• Server/Item/Items/Accessories/Belt/
• Server/Item/Items/Accessories/Earring/

最小示例：

{
  "TranslationProperties": {
    "Name": "caccessories.items.Accessory_Ring_Mythril.name",
    "Description": "caccessories.items.Accessory_Ring_Mythril.description"
  },
  "Quality": "Rare",
  "ItemLevel": 20,
  "Categories": [
    "Items.Accessories"
  ],
  "Icon": "Icons/MyAccessoryIcon.png",
  "Model": "Items/MyAccessory.blockymodel",
  "Texture": "Items/MyAccessory_Texture.png",
  "AccessoryProperties": {
    "Slot": "Ring",
    "StatModifiers": {
      "Health": [
        {
          "Amount": 15,
          "CalculationType": "Additive"
        }
      ]
    }
  },
  "Interactions": {
    "Primary": "Root_CA_Equip_Accessory_Primary",
    "Secondary": "Root_CA_Equip_Accessory_Secondary"
  },
  "InteractionConfig": {
    "AllEntities": true
  }
}

2. 选择正确的槽位类型

AccessoryProperties.Slot 的可用值：

• Ring
• Necklace
• Belt
• Earring

3. 添加翻译

将键值添加到：

• Server/Languages/fr-FR/caccessories.lang
• Server/Languages/en-US/caccessories.lang

示例：

items.Accessory_Ring_Mythril.name = Mythril Ring
items.Accessory_Ring_Mythril.description = A fine ring that strengthens vitality.

4. 添加属性加成

你可以组合多种类型的增益：

• StatModifiers
• DamageResistance
• Effects

抗性示例：

"DamageResistance": {
  "Physical": [
    {
      "Amount": 0.05,
      "CalculationType": "Multiplicative"
    }
  ]
}

伤害增强示例：

"DamageCauseEnhancement": {
  "Physical": [
    {
      "Amount": 0.05,
      "CalculationType": "Multiplicative"
    }
  ]
}

效果示例：

"Effects": [
  "FineCraft_CA_MythrilRing_Regen"
]

5. 如果饰品提供效果，还需创建效果资源

效果应放置在：

• Server/Entity/Effects/...

重要说明

• 对于戒指和耳环，确保使用 Primary 和 Secondary 来分别对应两个槽位。
• 对于项链或腰带，两种交互可以指向同一个装备根节点。

后续计划

• 新的饰品套装
• 更丰富的效果、变体与成长系统