快速开始

1. 安装

1. 确认服务器是 Paper / Purpur 1.20 – 1.21，Java 17 以上。
2. 先安装前置 MythicLib 1.7。
3. 把 CloudItems-<版本>.jar 放进 plugins/，重启服务器。
4. 后台看到 CloudItems 启用后，plugins/CloudItems/ 会生成全部配置与几件示范物品。

可选插件（有就自动联动，没有也能正常运行）：MythicMobs、MMOCore、Vault、PlaceholderAPI、ItemsAdder、EcoEnchants、ModelEngine。详见 安装与文件。

2. 写第一件物品

物品放在 plugins/CloudItems/items/<类型>.yml。长剑类型是 LONG_SWORD，所以写进 items/long_sword.yml：

中文键

plugins/CloudItems/items/long_sword.yml

MOON_BLADE:
  名称: '<gradient:#8ec5ff:#e0aaff>月影长剑</gradient>'
  材质: IRON_SWORD
  属性:
    攻击伤害: {最小值: 80, 最大值: 120, 小数位数: 0}
    暴击机率: 5
  Lore:
    - '&7每一把长剑，都有自己的命运。'

English keys

plugins/CloudItems/items/long_sword.yml

MOON_BLADE:
  name: '<gradient:#8ec5ff:#e0aaff>月影长剑</gradient>'
  material: IRON_SWORD
  stats:
    ATTACK_DAMAGE: {min: 80, max: 120, decimals: 0}
    CRITICAL_STRIKE_CHANCE: 5
  lore:
    - '&7每一把长剑，都有自己的命运。'

不想手写？

打开 线上道具模板，选「长剑」、点几个属性，复制右边生成的 YAML 贴进文件即可。

3. 重载并拿到物品

/ci reload
/ci give LONG_SWORD MOON_BLADE

每次 give 都会重新抽一次 80 – 120 的攻击伤害；同一件物品生成后数值就固定了，之后改模板也不会重抽，只会更新名称、说明等外观。

4. 在游戏里继续改

输入 /ci 打开物品库 → 长剑 → 月影长剑，就能直接在界面里改名称、属性、技能、限制。 每次修改都会：

• 自动备份原文件到 plugins/CloudItems/backups/；
• 立即发布，在线玩家背包里的同一件物品自动更新（保留已抽到的数值、强化与宝石）；
• 保留你原本的配置语言（英文键的物品存回去仍然是英文键）。

5. 接下来

• 想让物品掉落？ → MythicMobs 掉落
• 想加技能？ → 技能与攻击模式
• 想做宝石、强化？ → 宝石 · 词缀 · 强化
• 每个字段的完整说明 → 物品字段总表