常见问题
指令与安装
输入 /cg 打开的不是公会？/ 和别的插件指令冲突？
云公会的主指令是 /cloudguild，/cg 是别名。config.yml 的 command-aliases（默认 [cg]）会让玩家输入的 /cg 一律交给云公会，即使别的插件也注册了 /cg。
- 想把
/cg让给别的插件：改成command-aliases: []，玩家改用/cloudguild，或加一个新的别名例如[guild]。 - 控制台不受这个设定影响，冲突时请在控制台写
cloudguild。
玩家建不了公会，提示「伺服器沒有經濟插件，無法收取建立費用」？
默认建立公会要花 10000 金币（create.money），服务器没有 Vault + 经济插件时就无法收费。装上经济插件，或把 create.money 改成 0 再 /cg admin reload。
公会银行的存钱、提领也需要 Vault。
玩家没有权限？
所有玩家指令都需要 cloudguild.use，建立公会需要 cloudguild.create，两个默认所有人都有。被权限插件拿掉了的话加回来：lp group default permission set cloudguild.use true。
如果提示的是「你的職位（xxx）沒有這個權限」，那是公会内的职位权限，在 config.yml 的 ranks 调整，见 职位与等级。
指令、菜单都没反应，公会聊天也停了？
插件处于未授权模式：公会资料都还在，但指令、菜单、公会聊天、变量、增益、任务与公会战都暂停。用 /cg version 查看授权状态，再到 会员中心「我的授权」复制授权码，填进 plugins/CloudGuild/token.yml 的 key: 后重启。见 安装与授权。
控制台显示「无法连接授权服务器」？
第一次启动必须连上 license.plugins.wiki 验证一次，之后断网也能离线运行 72 小时；连不上时每 60 秒自动重试，连上就立即生效，不需要重启。控制台会写出原因：
| 原因 | 处理 |
|---|---|
| DNS 解析不到 | 换 DNS（例如 223.5.5.5 / 119.29.29.29）后重启 |
| 连线被拒绝或无法建立 | 主机商 / 面板的防火墙放行对外 HTTPS；本机电脑检查杀毒软件是否拦截 java.exe |
| 连线超时 | 网络太慢或被拦截；稍后会自动重试 |
| HTTPS 握手失败 | 关闭会拦截 HTTPS 的代理或网络设备 |
本机电脑如果是靠加速器 / 代理（例如 Clash）才打得开网站：浏览器会走代理，但 Java 不会。请开启加速器的「TUN / 虚拟网卡」模式，或在启动参数加 -Djava.net.useSystemProxies=true。
换服务器（换机器）后授权失效？
首次验证会绑定当时的机器。搬到新机器前，先在 会员中心 自助解绑，再在新机器填同一个授权码。不要修改 .license-cache。
支持哪些版本？支持 Folia 吗？
Paper / Purpur / Folia 1.20 – 26.x，同一个 jar。插件本身 Java 17 就能运行（1.20.5 起的服务端本身需要 Java 21）。不支持 Spigot。 云界面 CloudUI 的公会画面需要 1.21.11 与 26.x（目前实测 26.3）（云界面本身的要求），其他功能在 1.20 上都能使用。
跨服
在 A 服的公会聊天，B 服的成员看不到？
依序检查：
- 两边的控制台有没有「跨服同步已開啟」这一行？没有的话：确认
database.type: mysql，sync.enabled是auto或true。 - 两边的
database（地址、数据库名称）与table-prefix是不是完全一样？ - 两边的
sync.server-name是不是不同？同名的子服会把对方的变动当成自己的而忽略。留空时用的是plugins/CloudGuild/server-id.txt里的自动代号——如果新子服是复制旧子服的 插件资料夹开的，两边的server-id.txt会一样，删掉新子服的那个文件再重启。 - 改了数据库或跨服设定之后有没有重启？
/cg admin reload不会重新连接数据库。
跨服的聊天与通知有 sync.interval-ticks（默认 1 秒）的延迟，属于正常。详见 跨服设置。
跨服回据点没反应 / 被送到错误的子服？
- 每个子服的
sync.server-name都要填，而且要和 BungeeCord / Velocity 设定里的子服名称完全一致。 - 据点会记下设定当时那个子服的
server-name。设定据点时那个子服还没填server-name，记录的就是自动代号，别的子服会提示「那個子服沒有設定 sync.server-name，無法跨服傳送」：填好server-name、重启后在那个子服重新/cg sethome一次。 - Velocity 需要开启
bungee-plugin-message-channel（默认开启）。
见 跨服回据点。
别的子服刚升级 / 存钱，这边的数字还是旧的？
公会资料变动会在下一次同步（默认 1 秒内）更新；在线结算累积的活跃这类不发通知的变动，每 60 秒整批刷新一次。
玩法
打开仓库提示「這頁倉庫有其他成員正在使用」，可是没人在用？
同一页仓库全服只能有一个人打开。如果是子服当机留下的锁，60 秒后会自动失效；那个子服重开时也会立刻放掉自己的锁。
如果一直这样，检查是不是有两个子服的 sync.server-name 一样。见 公会仓库。
打开仓库时服务器卡了一下，放进去的东西会不见吗？
不会。服务器或数据库卡住超过 60 秒、仓库的锁被别人拿走时，这次的变更不会写入，你这次放进去的物品会退还给你（背包满了掉在 脚下）。见 公会仓库。
玩家能在公告、申请留言里写点击指令骗人吗？
不能。玩家输入的文字里 < > \ 都会换成全角字符，写不出 MiniMessage 标签，见 玩家文字的安全处理。
增益没有生效？
- 公会等级是否达到增益的
min-level？升级需要buff职位权限。 - 玩家是不是在
pvp.ignore-worlds里的世界？那些世界会暂时移除增益。 buffs.yml的effect/attribute名称是否正确（原版 ID，例如speed、max_health）？- 增益每 5 秒检查一次，牛奶清掉的药水效果会在 5 秒内补回。
升级公会时提示资金 / 活跃 / 成员不足？
升级要同时满足三个条件 ：公会资金 ≥ 下一级的 cost（会扣除）、公会活跃 ≥ activity（不扣除）、成员数 ≥ min-members。主页的升级按钮说明里会列出需要与目前的数值。
活跃来自存钱、签到、在线与任务，见 银行、签到与活跃。
公会资金每天都在变少？
那是每日维护费（levels.<等级>.upkeep），在 activity.daily-time（默认 04:00）结算，同时扣 decay 活跃。不想要就把各等级的 upkeep、decay 改成 0。见 每日结算。
任务进度怎么不动？
- 进度每 5 秒写入一次，菜单要重新打开才会看到最新进度。
- 公会等级是否达到任务的
min-level？等级不够的任务不会累积。 break类型不算玩家自己放的方块；kill的targets要写生物种类（例如ZOMBIE），不是物品材质。
会长不在了，怎么换会长？
管理员执行 /cg admin setleader <公会> <玩家>（玩家要是这个公会的成员）。原本的会长会降为第二高的职位。
想退出公会，提示「會長不能直接退出」？
会长要先 /cg transfer <成员> 把会长交给别人；公会只剩自己时用 /cg disband 解散。
迁移
从 PlayerGuild 换过来，资料会不见吗？
不会。/cg admin import playerguild 只读取 PlayerGuild 的数据库，不会修改它；云公会里已经有同名公会时会跳过，所以重复执行也不会导入两次。见 从 PlayerGuild 导入。
导入的公会有好几位会长？
导入时云公会会自动整理，每个公会只保留一位会长：会长选建立者，其次选累积贡献最高的成员，其他人改为第二高的职位，完成时会显示修复了几个公会。导入后想再调整，用 /cg admin setleader。
单服用了一段时间，现在要开第二个子服？
先把 database.type 改成 mysql 并重启，再执行 /cg admin migrate sqlite 把 data.db 的资料搬进 MySQL，然后把其他子服接上来。见 从 SQLite 搬到 MySQL。
怎么备份？搬服要带走什么？
- SQLite：整个
plugins/CloudGuild/资料夹。请在关服后复制；开服中复制时要连同data.db-wal、data.db-shm一起复制。 - MySQL：备份数据库（例如
mysqldump cloudguild），以及每个子服的plugins/CloudGuild/（设定、菜单）。