安装与获取
运行环境
| 项目 | 要求 |
|---|---|
| 服务端 | Paper / Purpur 1.21 – 26.x（Java 21 以上） |
| 推荐 | CloudItems 1.3.0 以上：ci type= / ci id= 规则，以及饰品的属性、被动、技能都需要它 |
| 选装 | PlaceholderAPI（变量）、MySQL（多台子服共用饰品） |
没有 CloudItems 也能用
不装 CloudItems 时，仍可用 material=、model=、name= 等规则做收藏栏、时装栏，物品身上写的原版属性（攻击伤害、护甲、速度…）也会生效。
下载
购买后在 资源中心 打开 CloudAcces 云饰品 下载最新版（CloudAcces-<版本>-简体授权版.jar），授权码在 会员中心 的「我的授权」。
安装步骤
- 确认 CloudItems 已经是 1.3.0 以上（控制台出现「使用 ci 规则，但没有安装 CloudItems 1.3.0 以上」就是版本太旧）。
- 把 JAR 放进
plugins/，启动一次，生成plugins/CloudAcces/后关服。 - 打开
plugins/CloudAcces/token.yml，把授权码填到key:，再启动。首次启动会自动绑定本机。 - 控制台出现
CloudAcces 1.0.0（简体授权版）已启用：1 个菜单、13 个栏位…物品插件 CloudItems即成功。 - 进服输入
/acces（或潜行 + F）打开范例「饰品栏」：左边是原版盔甲，右边是项链、戒指 ×2、手套 ×2、手镯 ×2，以及需要权限的珍藏栏。
生成的文件
| 位置 | 说明 |
|---|---|
config.yml | 全局设置：默认菜单、盔甲托管、存储、音效，见 主设置 |
menus/ | 一个文件一个菜单，见 菜单文件 |
messages.yml | 所有文字（MiniMessage 与 & 色码都能用） |
reports/ | /acces check 的检查报告 |
server-id.txt | 没填 服务器名称 时自动产生的本服名称（跨服交接用） |
corrupt/、failed-saves/ | 出事时才会出现：损坏数据的备份、写不进数据库的备份 |
升级
关服，替换 JAR，开服。配置文件缺的项目使用默认值；玩家数据格式向下兼容。
授权说明
- 授权码绑定机器，换服务器前请先在会员中心自助解绑。
- 授权服务器暂时连不上时，最多可以离线运行 72 小时。
- 没有有效授权时插件不会启用，玩家的饰品数据原封不动保留。