跳到主要内容

安装与授权

购买与下载​

  1. 打开 资源中心，注册并登录，购买 CloudArena 云竞技（48R，一次购买、永久包更）。
  2. 在资源中心打开 CloudArena 云竞技，下载最新的 CloudArena-<版本>-簡體授權版.jar。
  3. 授权码在 会员中心 的「我的授权」。

运行环境​

项目要求
服务端Paper / Purpur / Folia 1.20 – 26.x，同一个 jar
Java17 或更新（1.20.5 起的服务端本身需要 Java 21）
前置插件无（数据库连接池已内置；SQLite / MySQL 驱动由 Paper 提供）
数据库默认 SQLite，不用设置；也可以改用 MySQL / MariaDB，见 数据库
可选：Vault + 经济插件金币奖励，见 奖励。没有时金币奖励不发，指令奖励照常
可选：PlaceholderAPI变量，自动注册
不支持Spigot（需要 Paper 系服务端）

安装​

  1. 把 CloudArena-<版本>-簡體授權版.jar 放进 plugins/，启动服务器。
  2. 首次启动会生成 plugins/CloudArena/ 与 token.yml，照下面的 授权 填好授权码后重启。控制台会显示：
[CloudArena] 数据库已连接：SQLite data.db
[CloudArena] 已加载 0 张地图、0 套套装（简体授权版）
[CloudArena] CloudArena 授权已生效，竞技功能已开启
  1. 照 快速上手 建第一张地图与套装，然后输入 /ca 打开菜单。

授权​

  1. 首次启动会生成 plugins/CloudArena/token.yml，此时插件处于「未授权模式」：服务器照常开启、资料全部保留，菜单可以打开，但排队、观战、切磋都暂停（提示「云竞技尚未授权」）。
  2. 登录 会员中心，在「我的授权」复制 CloudArena 的授权码，填进 token.yml 的 key:，重启服务器。
  3. 首次验证会自动绑定本机（后台会显示本机机器码）；换服务器时请先在会员中心自助解绑。
plugins/CloudArena/token.yml
key: 'XXXX-XXXX-XXXX-XXXX'
  • 授权在后台验证，不会拖慢开服；连不上授权服务器时每 60 秒自动重试，连上后立即生效，不需要重启。
  • 断网时可使用最近一次验证结果离线运行 72 小时。
  • /ca admin info 可以查看版本、授权状态、地图与套装数量、等待还原的备份数。
  • 多个子服都装的话，每个子服的 token.yml 都要填好授权码。

从 LittleArena 迁移​

已经在用 LittleArena（含 FairPeak 融合版）的服务器，不用手动操作：云竞技第一次启动时发现 plugins/LittleArena/ 资料夹，会自动把下面的东西全部迁移过来。

换插件步骤​

  1. 关服。
  2. 移除 LittleArena 的 jar，保留 plugins/LittleArena/ 资料夹。
  3. 放入 CloudArena-<版本>-簡體授權版.jar，开服，填好 授权码 后再重启一次。
  4. 控制台会列出迁移结果，例如：
[CloudArena] 发现 plugins/LittleArena，开始自动迁移（地图、套装、黑名单、玩家资料、背包备份、设定）……
[CloudArena] 设定：段位线 25 级、初始分、K 值、定级场数、排位分数范围、晋升播报、倒数、比赛时长、友伤……
[CloudArena] 黑名单：迁移 5 条到巅峰模式黑名单
[CloudArena] 地图：导入 30 张（公平 15、巅峰 15、通用 0）
[CloudArena] 套装：导入 3 套
[CloudArena] 玩家资料（SQLITE）：读取 820 人，导入 812 人、1904 个模式战绩、9530 笔对战记录、240 笔赛季存档
[CloudArena] 背包备份：迁移 2 人（玩家上线时还原）；原文件改名为 restores.yml.migrated-to-cloudarena
[CloudArena] LittleArena 迁移完成。之后要再导入请用 /ca admin import littlearena

迁移完成后会在 plugins/CloudArena/ 留下 .littlearena-migrated（里面记着迁移结果），之后开服不会再自动迁移；删掉这个文件，下次开服会再迁移一次（已存在的资料不会被覆盖）。

迁移哪些东西​

LittleArena云竞技
arenas.yml 地图（红 / 蓝出生点、观战点、区域、开场指令、启用状态）同名地图；在「公平地图池」的设为 fair，在「巅峰地图池」的设为 peak，其他为 all；match.block-edit 开着的话地图允许改方块
kits.yml 套装同名套装，物品完整保留（附魔、名称、Lore、插件物品数据）
blacklist.yml 黑名单巅峰模式黑名单：material: → 材质、name: → 名称包含、model: → CustomModelData、ce: → CraftEngine 物品 ID
玩家资料（SQLite data.db / MySQL / playerdata/*.yml，自动读取 LittleArena 的 storage.type）每个模式的分数、场次、胜负、击杀、阵亡、连胜、最高连胜、游戏时长；最近的对战记录；赛季存档
restores.yml（LittleArena 关服时还没还原的背包）云竞技的背包备份，玩家上线时自动还原（盔甲、副手的格子顺序已转换）
config.yml 设定（只在云竞技第一次启动、config.yml 是新建的时候）段位线、初始分、K 值、定级场数、排位分数范围、晋升播报、倒数、比赛时长、友伤、场地半径、同 IP、排队逾时、全服播报；奖励写进 rewards.yml
busy.yml 副本世界queue.blocked-worlds（不能排队、不能切磋）
season.number赛季编号

模式对应：

LittleArena云竞技
公平单挑（自选套装）公平匹配 1V1
公平排位（套装排位）公平排位 1V1
巅峰单挑（普通匹配 / 背包切磋）巅峰匹配 1V1
巅峰排位（背包排位）巅峰排位 1V1
2V2（公平与巅峰共用一个记录）巅峰匹配 2V2
  • LittleArena 的两个排位其实共用一个分数（读取时取较大的那个）；迁移后两个排位都从这个分数开始，之后各自独立计算。
  • 已打完定级赛的玩家直接显示段位；还没打完的保留进度。
  • 奖励迁移到 rewards.yml：金币、点券（points，用 points-command 发放）照原数值；连胜奖励变成 streaks.<连胜数>.money。
  • 背包备份只有在 LittleArena 已经移除时才迁移，避免两个插件重复还原；LittleArena 还在的话，等你移除它、重启后会自动补迁移。

手动导入​

/ca admin import littlearena <all|arenas|kits|blacklist|data|restores|config> [overwrite]

all = 除了 config 以外全部；加上 overwrite 会覆盖同名的地图、套装与已存在的玩家资料（不加时已存在的会略过，可以放心重复执行）。 导入完成后可以用 /ca admin arena list 检查地图，/ca admin lookup <玩家> 抽查玩家资料。

升级​

关服，替换 jar，开服。地图、套装、设定文件与玩家资料都会保留；新版本新增的设定项会使用默认值。

最后于 更新