安装与文件
下载
购买后在 资源中心 打开 CloudItems 云物品 即可直接下载最新版 CloudItems-<版本>-簡體授權版.jar,授权码在会员中心(绑定服务器)。配置文件简体、繁体、英文键都能读。
运行环境
| 项目 | 要求 |
|---|---|
| 服务端 | Paper / Purpur 1.20 – 26.3(实测 Purpur 1.21.4、Paper 26.3) |
| Java | 17 以上 |
| 必要前置 | MythicLib 1.7(属性与技能底层) |
可选联动
| 插件 | 有安装时可以做什么 |
|---|---|
| MythicMobs | 怪物掉落 ci{type=;id=};经 MythicLib 接入的 MythicMobs 技能可以绑定到物品 |
| MMOCore | 等级限制、最高等级限制、职业限制;技能的 mana 消耗;工坊的等级条件 |
| Vault | 工坊收费、/ci sell 回收付款 |
| PlaceholderAPI | %ci_stat_<属性>% 变量 |
| ItemsAdder | IA模型 使用 ItemsAdder 物品外观 |
| CraftEngine | CE模型 使用 CraftEngine 物品外观 |
| EcoEnchants | 附魔 里可以写 EcoEnchants 的附魔 |
| MythicMobs + ModelEngine | /ci effects:玩家自行开关其他人的技能特效(两者都安装才启用) |
文件结构
首次启动后,plugins/CloudItems/ 下会有:
| 文件 / 文件夹 | 作用 |
|---|---|
config.yml | 背包刷新节奏(每 tick 处理几名玩家) |
items/<类型>.yml | 物品文件。文件名就是类型 ID 的小写,例如 items/long_sword.yml |
item-type.yml | 物品类型:名称、行为(近战 / 远程 / 防具 / 消耗品…)、默认材质,可新增自定义类型 |
tier.yml | 物品阶级(精良 / 稀有 / 史诗 / 传说),物品写 tier: 1 |
stats.yml | 属性字典:每个属性的中文名、别名、单位、显示格式 |
lore-format.yml | Lore 排列顺序与分隔线 |
progression.yml | 强化方案与词缀池 |
item-options.yml | 编辑器里每个参数的说明与图标(不影响物品本身) |
item-score.yml | 评分公式、属性权重、回收公式 |
attacks.yml | 10 种法杖攻击模式的行为与粒子 |
crafting-stations.yml | 综合锻造台(方块开启)与配方 |
crafting-stations/*.yml | 工坊站点:强化站、词缀站、宝石站、锻造站,各自独立 |
gui/强化站.yml · gui/词缀站.yml · gui/宝石站.yml | 三个站点的版面、按钮与音效 |
messages.yml | 提示文字 |
effect-models.yml | /ci effects 识别的技能特效模型 |
examples/ | 参考文件(不会自动载入):完整字段、MythicMobs 掉落、宝石、站点示例 |
backups/ | 编辑器每次保存前的备份;被搬走的 MMOItems 格式条目 |
PlaceholderAPI变量.md | 自动生成的变量清单(每次重载更新) |
token.yml | 授权码 |
item-sets.yml | 套装 |
migration/ | MMOItems 迁移 的逐件报告 |
简体、繁体都能读
默认配置为简体。用繁体写的配置(例如 名稱、材質、屬性)同样会被正确读取,不用改文件;也可以全部改用 英文键。
授权
需要授权码:
- 首次启动会生成
plugins/CloudItems/token.yml,此时插件处于「未授权模式」:已加载,但所有功能与指令停用。 - 登录 会员中心 复制授权码,填进
token.yml的key:,重启服务器。 - 首次验证会自动绑定本机(后台会显示本机机器码);换服务器时请先在会员中心自助解绑。
plugins/CloudItems/token.yml
key: 'CI-XXXX-XXXX-XXXX'
- 验证通过后每 6 小时在后台复核一次;断网时可使用最近一次验证结果离线运行 72 小时。
- 授权被停用、解绑或过期时,插件会自动停用并在后台说明原因。
.license-cache是离线验证用的签名缓存,请勿修改。
从旧版或 MMOItems 迁移
- 服务器有
plugins/MMOItems资料夹时,第一次启动会自动迁移全部物品、类型、阶级、强化模板、套装与配方,详见 从 MMOItems 迁移;之后可用/ci migrate再跑一次。 - 直接把 MMOItems 格式的条目(有
base:或MMOItems相容:)贴进items/不会被读取,会被自动移到backups/mmoitems-items-<时间>/保存;请改用上面的迁移。
升级插件
- 停服,替换 jar;
- 启动后执行一次
/ci verify做自检; - 若有「载入警告」,在
/ci物品库首页点开查看。