跳到主要内容

安装与文件

下载​

购买后在 资源中心 打开 CloudItems 云物品 即可直接下载最新版 CloudItems-<版本>-簡體授權版.jar,授权码在会员中心(绑定服务器)。配置文件简体、繁体、英文键都能读。

运行环境​

项目要求
服务端Paper / Purpur 1.20 – 26.3(实测 Purpur 1.21.4、Paper 26.3)
Java17 以上
必要前置MythicLib 1.7(属性与技能底层)

可选联动​

插件有安装时可以做什么
MythicMobs怪物掉落 ci{type=;id=};经 MythicLib 接入的 MythicMobs 技能可以绑定到物品
MMOCore等级限制、最高等级限制、职业限制;技能的 mana 消耗;工坊的等级条件
Vault工坊收费、/ci sell 回收付款
PlaceholderAPI%ci_stat_<属性>% 变量
ItemsAdderIA模型 使用 ItemsAdder 物品外观
CraftEngineCE模型 使用 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.ymlLore 排列顺序与分隔线
progression.yml强化方案与词缀池
item-options.yml编辑器里每个参数的说明与图标(不影响物品本身)
item-score.yml评分公式、属性权重、回收公式
attacks.yml10 种法杖攻击模式的行为与粒子
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 迁移 的逐件报告
简体、繁体都能读

默认配置为简体。用繁体写的配置(例如 名稱、材質、屬性)同样会被正确读取,不用改文件;也可以全部改用 英文键。

授权​

需要授权码:

  1. 首次启动会生成 plugins/CloudItems/token.yml,此时插件处于「未授权模式」:已加载,但所有功能与指令停用。
  2. 登录 会员中心 复制授权码,填进 token.yml 的 key:,重启服务器。
  3. 首次验证会自动绑定本机(后台会显示本机机器码);换服务器时请先在会员中心自助解绑。
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-<时间>/ 保存;请改用上面的迁移。

升级插件​

  1. 停服,替换 jar;
  2. 启动后执行一次 /ci verify 做自检;
  3. 若有「载入警告」,在 /ci 物品库首页点开查看。