跳到主要内容

安装

运行环境​

项目要求
服务端Paper / Purpur 1.21.4 – 1.21.11（Java 21）
数据库MySQL 8 或 MariaDB（所有分流连同一个库）。SQLite 无法跨主机加锁，不支持
代理端不限：BungeeCord、Waterfall、Velocity 都可以
可选Redis（转服加速）、Vault（managed 经济同步）、BungeeCord 系代理（Bungee 加强模块）

下载​

购买后在 资源中心 打开 CloudSync 云同步 即可直接下载最新版，授权码在会员中心。共两个 JAR：

文件装在哪里
CloudSync-Paper-<版本>-簡體授權版.jar每一个分流（必装）
CloudSync-Bungee-<版本>-簡體授權版.jarBungeeCord / Waterfall 代理端（选用）

安装步骤​

  1. 建立一个数据库，例如 CREATE DATABASE cloudsync;，给插件一个有建表权限的账号。
  2. 每个分流放入 CloudSync-Paper 的 JAR，启动一次生成 plugins/CloudSync/config.yml，然后关服。
  3. 修改每个分流的配置：
plugins/CloudSync/config.yml
server:
  id: "survival-1"        # 每个分流必须不同，建议与代理端的服务器名称相同
storage:
  mysql:
    host: "127.0.0.1"
    port: 3306
    database: "cloudsync"
    username: "cloudsync"
    password: "你的密码"
  1. 完整重启所有分流（不要用 /reload）。控制台出现 Storage ready; server-id=… 即成功，数据表会自动建立。
  2. 进服测试：在 A 分流拿一些物品，切到 B 分流，物品应该一模一样。
第一次上线前
  • 所有分流的 server.id 不能重复，重复会导致两个分流互相回收对方的锁。
  • 先备份各分流的 world/playerdata。启用后，玩家第一次进入时会以「当时所在分流的本地资料」作为初始存档。

填写授权码​

  1. 在 会员中心 注册，把 UID 发给作者开通授权。
  2. 首次启动会生成 plugins/CloudSync/token.yml，把授权码填入 key: 后重启。首次启动会自动绑定本机。
  3. 未授权时插件不会读写任何玩家资料，并挡下所有登录（避免玩家在没有同步的情况下游玩）。
  4. 授权在运行中失效：在线玩家照常存档离开，只挡新的登录。可离线运行 72 小时。

授权码绑定的是主机（机器码）：同一台主机上的多个分流共用同一个授权码；分流分布在多台主机时请联系作者。换主机时在会员中心自助解绑即可。

Bungee 加强模块（选用）​

只装 Paper 端就能完整同步。Bungee 加强模块额外提供：

  • /csp send <群组>：先让来源分流存档，确认成功后才把玩家送到群组里最健康的分流（按 TPS、人数、内存评分）。
  • /csp status、/csp route <群组>：查看各分流心跳、预览会被选中的分流。

安装：把 CloudSync-Bungee 的 JAR 放进代理端 plugins/，启动后修改 plugins/CloudSync-Bungee/config.yml：数据库与各分流相同，load-balancing.groups 里的分流 ID 要与各分流的 server.id、代理端的服务器名称一致。

Velocity

Paper 端不依赖代理端插件，Velocity 网络可以直接使用。维护模式把玩家送往大厅时使用 BungeeCord 插件消息通道，Velocity 默认已兼容（bungee-plugin-message-channel = true）。

最后于 更新