跳到主要内容

安装与授权

运行环境​

项目要求
服务端Paper / Purpur / Folia（及其分支），1.20 – 26.x
Java17 以上（1.20.5+ 服务端本身需要 21）
推荐前置PlaceholderAPI（头顶 / TAB / 记分板显示称号都靠它的变量）
可选联动Vault 经济、PlayerPoints、MythicLib / MMOItems、ItemsAdder、CraftEngine、Nexo
数据库默认 SQLite，不用配置；多服共享用 MySQL 8 / MariaDB

安装​

  1. 把 CloudTitle-<版本>-簡體授權版.jar 放进 plugins/，启动服务器。
  2. 首次启动会生成 plugins/CloudTitle/ 与 token.yml，按下面的「授权」填好授权码后重启。
  3. 想立刻看到效果：输入 /clt 打开主菜单，或照着快速开始做第一个称号。

授权​

需要授权码：

  1. 首次启动会生成 plugins/CloudTitle/token.yml，此时插件处于「未授权模式」：服务器照常开启，称号数据照常读取，但称号的指令、菜单、变量、称号卡、属性、药水与粒子都暂停。
  2. 登录 会员中心，在「我的授权」复制 CloudTitle 的授权码，填进 token.yml 的 key:，重启服务器。
  3. 首次验证会自动绑定本机（后台会显示本机机器码）；换服务器时请先在会员中心自助解绑。
plugins/CloudTitle/token.yml
key: 'CT-XXXX-XXXX-XXXX'
  • 授权在后台验证，不会拖慢开服；连不上授权服务器时每 60 秒自动重试，连上后立即生效，不需要重启。
  • 验证通过后每 6 小时在后台复核一次；断网时可使用最近一次验证结果离线运行 72 小时。
  • 授权被停用、解绑或过期时，称号功能会暂停并在后台说明原因；玩家的称号数据不会丢失。
  • .license-cache 是离线验证用的签名缓存，请勿修改。
  • /clt version 可以查看当前版本与授权状态。

连不上授权服务器时，后台会写明原因（DNS 解析失败、连线被拒绝、超时、HTTPS 被拦截…）。最常见的是主机商面板禁止对外连线，或本机电脑开了代理但 Java 没有走代理。

升级​

  • 从 2.0.0 升级到 2.0.1 及以后：替换 jar 后需要按上面的步骤填写授权码，其余配置与数据不用改。
  • 从 1.x 升级：玩家数据完全兼容。2.0 重做了全部菜单，第一次启动时旧的 menus/ 会被移到 menus-1.x-backup-日期/ 并生成新菜单，见菜单。
  • 从 PlayerTitle 搬过来：见从 PlayerTitle 迁移。
最后于 更新