指令
主指令是 /cloudguild，平常打 /cg 就好。所有子指令都支持 Tab 补全（公会名称、在线的公会成员、职位、增益 id、快速存款金额……）。
config.yml 的 command-aliases（默认 [cg]）里的指令，玩家输入时一律交给云公会，即使别的插件也注册了 /cg。
控制台不受这个设定影响；控制台遇到冲突时请写完整的 cloudguild。见 config.yml。
看懂指令写法
| 写法 | 意思 |
|---|---|
<名称> | 必填 |
[文字] | 选 填，可以不写 |
a|b | 二选一 |
<公会> | 公会名称（不分大小写、不用写颜色代码）、标签，或 #编号 |
<成员> | 自己公会的成员名称（离线也可以） |
权限与职位
- 所有玩家指令都需要
cloudguild.use（默认所有人），而且只能由玩家执行；控制台只能用/cg help、/cg reload与/cg admin …。 - 公会内的操作还要看你的 职位权限（下表「职位权限」一栏），见 职位与等级。没有时提示「你的職位（xxx）沒有這個權限」。
- 管理指令都需要
cloudguild.admin。全部权限节点见 权限。
还没填授权码、或授权还在验证中时，插件处于未授权模式：公会资料全部保留，但指令、菜单、公会聊天、变量、增益、任务与公会战都暂停。用 /cg version 查看授权状态，见 安装与授权 。
玩家指令一览
| 指令 | 作用 | 职位权限 |
|---|---|---|
/cg | 打开公会主页（没有公会时打开公会列表） | — |
/cg help | 显示帮助（/cg ? 也可以） | — |
/cg create <名称> [标签] | 建立公会（需要 cloudguild.create） | — |
/cg info [公会] | 在聊天栏显示公会资讯；不写 = 自己的公会 | — |
/cg list [排序] | 打开公会列表（browse 也可以） | — |
/cg top [类型] | 在聊天栏显示前 10 名 | — |
/cg join <公会> [留言] | 加入 / 申请加入（apply 也可以） | — |
/cg leave | 退出公会（quit 也可以） | — |
/cg members | 打开成员列表 | — |
/cg invite [玩家] | 邀请玩家；不写玩家 = 打开邀请菜单 | invite |
/cg accept [玩家] / /cg deny [玩家] | 同意 / 拒绝申请；不写玩家 = 打开申请菜单 | accept |
/cg applications | 打开入会申请菜单（apps 也可以） | accept（审核时） |
/cg kick <成员> | 踢出成员 | kick |
/cg promote <成员> / /cg demote <成员> | 升职 / 降职 | promote / demote |
/cg setrank <成员> <职位> | 直接指定职位 | 会长 |
/cg transfer <成员> [confirm] | 转让会长 | 会长 |
/cg disband [confirm] | 解散公会 | 会长 |
/cg rename <新名称> | 改名（花费公会资金） | settings |
/cg tag <标签|clear> | 设定 / 清除标签 | settings |
/cg desc [文字] | 设定公会介绍（description 也可以） | settings |
/cg icon | 把主手物品设为公会图示 | settings |
/cg joinmode [open|apply|closed] | 加入方式（mode 也可以） | settings |
/cg ff | 切换友伤（friendlyfire、pvp 也可以） | settings |
/cg upgrade | 升级公会（levelup 也可以） | upgrade |
/cg bank | 打开公会银行 | — |
/cg deposit [金额] | 存钱（donate 也可以）；不写金额 = 打开银行 | — |
/cg withdraw <金额> | 提领 | withdraw |
/cg signin | 每日签到（sign、checkin 也可以） | — |
/cg home [名称] | 回到据点 | — |
/cg sethome [名称] / /cg delhome [名称] | 设定 / 删除据点 | home |
/cg homes | 打开据 点菜单 | — |
/cg notice | 打开公告栏（notices 也可以） | — |
/cg notice post <标题>|<内容> | 发布公告 | notice |
/cg notice delete <编号> | 删除公告 | notice |
/cg c [消息] | 公会频道（chat、gc 也可以） | — |
/cg ac [消息] | 同盟频道（allychat 也可以） | — |
/cg ally [公会] | 提出 / 同意同盟；不写公会 = 打开外交菜单 | relation |
/cg unally <公会> | 解除同盟 / 撤回或拒绝请求 | relation |
/cg enemy <公会> / /cg unenemy <公会> | 设为 / 取消敌对 | relation |
/cg relations | 打开外交菜单 | — |
/cg war [公会] | 宣战；不写公会 = 列出进行中的战争 | war |
/cg buff [增益] | 不写 = 打开增益菜单；写增益 id = 升级（buffs 也可以） | buff（升级时） |
/cg shop | 打开公会商店 | shop（购买时） |
/cg tasks | 打开公会任务（task、quests 也可以） | — |
/cg vault [页] | 打开公会仓库（storage 也可以） | vault |
/cg spy | 开关公会频道监听（需要 cloudguild.chat.spy） | — |
/cg version | 查看插件版本、版本类型与授权状态 | — |
公会与成员
/cg version
显示插件版本、版本类型（例如简体授权版）与授权状态。还没授权、连不上授权服务器时，用它确认原因是否已经排除。
/cg
打开公会主页。
| 情况 | 打开 |
|---|---|
| 有公会、服务器装了云界面 CloudUI、这位玩家能显示云界面 | 云界面公会主页 |
| 有公会 | 箱子菜单 menus/main.yml |
| 没有公会 | 公会列表 menus/browse.yml（可以从这里建立或申请） |
输入不认识的子指令时提示「不認得的指令，輸入 /cg help 查看說明」。
/cg create
| 项目 | 内容 |
|---|---|
| 用法 | /cg create <名称> [标签] |
| 权限 | cloudguild.create（默认所有人）；名称带颜色需要 cloudguild.create.color |
| 参数 | 必填 | 说明 |
|---|---|---|
<名 称> | 是 | 默认 2 ～ 8 个字，中文、英文、数字、下划线。可以带 & 颜色代码（需要权限） |
[标签] | 否 | 默认 2 ～ 4 个字，中文、英文、数字 |
费用、条件与名称规则见 建立与加入。
/cg create 雲海
/cg create 雲海 YUN
/cg create &b雲海 YUN
/cg info
在聊天栏显示公会资讯：标签、等级、排名、会长、成员、资金、活跃、本月活跃、加入方式、友伤、击杀、公会战战绩、同盟与敌对、建立时间与介绍。格式在 messages.yml 的 info。
/cg info
/cg info 雲海
/cg info YUN
/cg list 与 /cg top
| 指令 | 说明 |
|---|---|
/cg list [排序] | 打开公会列表菜单，按排序显示所有公会，点一个公会查看资讯、申请、提出同盟或宣战 |
/cg top [类型] | 在聊天栏列出前 10 名 |
排序 / 类型：level 等级（默认）、activity 活跃、month 本月活跃、funds 资金、members 人数、kills 击杀、wars 胜场（也可以写 活躍、本月、資金、人數、擊殺、勝場）。
/cg list funds
/cg top month
/cg join
| 项目 | 内容 |
|---|---|
| 用法 | /cg join <公会> [留言] |
- 有这个公会的有效邀请时：直接加入。
- 否则看公会的加入方式：
open直接加入、apply送出申请（后面的文字是留言）、closed拒绝。 - 主动退出后的重新加入冷却中时不能加入。
/cg join 雲海
/cg join YUN 我是老玩家，想一起打副本
/cg leave
退出公会。会长不能退出（先转让或解散）。主动退出后 join.rejoin-cooldown（默认 3 小时）内不能加入其他公会。
/cg invite
| 项目 | 内容 |
|---|---|
| 用法 | /cg invite [玩家] |
| 职位权限 | invite |
邀请一位没有公会的玩家（离线、在别的子服都可以，只要他在连同一数据库的子服上线过）。不写玩家时打开邀请菜单（这个子服上没有公会的在线玩家）。
/cg accept、/cg deny、/cg applications
| 指令 | 说明 |
|---|---|
/cg accept <玩家> | 同意申请，对方立即加入 |
/cg deny <玩家> | 拒绝申请，对方会收到通知 |
/cg accept、/cg deny、/cg applications | 打开入会申请菜单：左键同意、右键拒绝 |
需要 accept 职位权限。
/cg kick、/cg promote、/cg demote
| 指令 | 职位权限 | 说明 |
|---|---|---|
/cg kick <成员> | kick | 踢出；只能踢职位权重比自己低的成员。被踢的人没有重新加入冷却 |
/cg promote <成员> | promote | 升到高一阶的职位（不会升成会长，升上去的职位也要比你低） |
/cg demote <成员> | demote | 降到低一阶的职位 |
/cg setrank
| 项目 | 内容 |
|---|---|
| 用法 | /cg setrank <成员> <职位> |
| 谁能用 | 会长 |
<职位> 写职位 id（例如 elite）或职位名称（不含颜色，例如 精英）；不能指定为会长。新职位的人数达到上限时失败。
/cg setrank Steve elite
/cg transfer
| 项目 | 内容 |
|---|---|
| 用法 | /cg transfer <成员> [confirm] |
| 谁能用 | 会长 |
第一次输入会提示确认，30 秒内对同一位成员再输入一次（或直接加 confirm）才执行。对方成为会长，你变成第二高的职位。转让与解散的确认分开计算，不会互相顶替。
/cg disband
| 项目 | 内容 |
|---|---|
| 用法 | /cg disband [confirm] |
| 谁能用 | 会长 |
30 秒内再输入一次（或加 confirm）才执行。删除公会的所有资料（资金、仓库物品、据点、公告……），无法复原。
公会设定
需要 settings 职位权限。也可以在主页 →「公会设定」操作。
| 指令 | 说明 |
|---|---|
/cg rename <新名称> | 改名，花费公会资金 name.rename-cost（默认 50000） |
/cg tag <标签> | 设定标签；/cg tag clear 或 /cg tag - 清除 |
/cg desc [文字] | 设定介绍（最多 64 字，| 在菜单里换行）；不写文字 = 清空 |
/cg icon | 把主手的物品设为公会图示 |
/cg joinmode [open|apply|closed] | 设定加入方式；不写 = 依序切换 |
/cg ff | 切换友伤，公会成员会收到通知 |
/cg rename 雲海之巔
/cg tag YUN
/cg desc 每晚 8 點副本團|歡迎新手
/cg joinmode open
/cg upgrade
升级公会，需要 upgrade 职位权限。资金（扣除）、活跃（不扣）、成员数都满足才会升级，见 职位与等级。
银行与签到
| 指令 | 说明 |
|---|---|
/cg bank | 打开公会银行（快速存款、自定义金额、提领、最近记录） |
/cg deposit <金额> | 存钱；金额是正整数，可以写 10,000 |
/cg withdraw <金额> | 从公会资金提领到自己身上（withdraw 职位权限） |
/cg signin | 每日签到 |
存钱、提领需要 Vault。规则见 银行、签到与活跃。
/cg deposit 10000
/cg withdraw 5000
据点与仓库
| 指令 | 说明 |
|---|---|
/cg home [名称] | 回到据点；不写 = main |
/cg sethome [名称] | 在这里设定据点；不写 = main（home 职位权限） |
/cg delhome [名称] | 删除据点；不写 = main（home 职位权限） |
/cg homes | 据点菜单 |
/cg vault [页] | 打开公会仓库第几页，默认第 1 页（vault 职位权限） |
公告与聊天
| 指令 | 说明 |
|---|---|
/cg notice | 打开公告栏 |
/cg notice post <标题>|<内容> | 发布公告；第一个 | 前是标题，后面是内容（内容里的 | 换行） |
/cg notice delete <编号> | 删除公告 |
/cg c [消息] | 发到公会频道；不写消息 = 切换频道 |
/cg ac [消息] | 发到同盟频道；不写消息 = 切换频道 |
/cg spy | 开关监听所有公会频道（cloudguild.chat.spy） |
见 聊天与公告。
外交与公会战
| 指令 | 说明 |
|---|---|
/cg ally <公会> | 提出同盟；对方已经提出时直接结盟 |
/cg unally <公会> | 解除同盟、撤回自己的请求或拒绝对方的请求 |
/cg enemy <公会> / /cg unenemy <公会> | 标记 / 取消敌对 |
/cg relations | 外交菜单（同盟、敌对、送出与收到的请求） |
/cg war <公会> | 宣战（war 职位权限，花费公会资金） |
/cg war | 列出自己公会准备中与进行中的战争 |
见 同盟、敌对与公会战。
增益、商店、任务
| 指令 | 说明 |
|---|---|
/cg buff | 增益菜单 |
/cg buff <增益id> | 升级一个增益（buff 职位权限） |
/cg shop | 公会商店 |
/cg tasks | 公会任务 |
管理指令
全部需要 cloudguild.admin（默认 OP），除了 spy 与 shop add 以外都可以在控制台执行（控制台写 cg admin …，不加 /）。
/cg admin 不带参数时显示帮助。
| 指令 | 作用 |
|---|---|
/cg admin reload | 重新载入设定（/cg reload 也可以） |
/cg admin info <公会> | 在聊天栏显示公会资讯 |
/cg admin disband <公会> | 解散公会 |
/cg admin rename <公会> <新名称> | 改名（不扣资金、不检查名称规则，只检查有没有重复） |
/cg admin setlevel <公会> <等级> | 设定公会等级（限制在 1 ～ 最高等级，不扣资金） |
/cg admin funds <公会> give|take|set <数量> | 增加 / 扣除 / 设定公会资金（扣除最多扣到 0），写入银行记录 |
/cg admin activity <公会> give|take|set <数量> | 增加 / 扣除 / 设定公会活跃 |
/cg admin contribution <玩家> give|take|set <数量> | 增加 / 扣除 / 设定成员的贡献（set 只改目前的贡献） |
/cg admin setleader <公会> <玩家> | 指定会长（玩家必须是这个公会的成员）；原本所有的会长降为第二高的职位 |
/cg admin join <玩家> <公会> | 把玩家加入公会（不受人数上限限制） |
/cg admin kick <玩家> | 把玩家踢出他的公会；他是会长而且公会还有其他人时拒绝（请先 setleader）；公会只剩他一人时解散公会 |
/cg admin cooldown <玩家> | 清除玩家的重新加入冷却 |
/cg admin buff <公会> <增益id> <等级> | 设定公会购买的增益等级（0 = 移除） |
/cg admin shop add <id> <价格> [限购次数] [周期] [公会等级] | 把主手物品上架到公会商店（只能玩家） |
/cg admin shop remove <id> | 下架商品 |
/cg admin import playerguild | 从 PlayerGuild 导入 |
/cg admin migrate <sqlite|mysql> | 把另一种数据库的资料搬到目前使用的数据库 |
/cg admin spy | 开关公会频道监听（只能玩家） |
<玩家> 是在连同一数据库的任何子服上线过的玩家（不分大小写）。
/cg admin reload
重新载入 config.yml、messages.yml、buffs.yml、tasks.yml、shop.yml、menus/*.yml，更新 command-aliases，重新连接 Vault / PlayerPoints，重新套用所有在线玩家的增益。
- 所有人打开中的云公会菜单会被关闭。
- 缺少的设定文件与菜单文件会重新生成默认的。
- 数据库（
database）、跨服（sync）、menu.cloudui与activity.online-interval需要重启服务器才会生效。
数值调整的例子
cg admin funds 雲海 give 100000
cg admin funds YUN set 0
cg admin activity 雲海 take 500
cg admin contribution Steve give 300
/cg admin shop
/cg admin shop add <id> <价格> [限购次数] [daily|weekly|monthly|forever] [公会等级]
/cg admin shop remove <id>
| 参数 | 必填 | 说明 |
|---|---|---|
<id> | 是 | 商品 id，只能用英文、数字、-、_（最多 32 字）；已存在时覆盖 |
<价格> | 是 | 贡献 |
[限购次数] | 否 | 每位玩家每个周期 最多买几次，默认 0（不限） |
[周期] | 否 | daily / weekly / monthly / forever，默认 forever |
[公会等级] | 否 | 公会至少几级才能买，默认 1 |
主手的物品（整组）原样保存进 shop.yml 并立即生效。见 公会商店。
/cg admin shop add dragon-sword 5000 1 weekly 5
/cg admin import playerguild
读取 config.yml 的 import.playerguild 指定的 PlayerGuild 数据库，导入公会、成员、主城与公告，并修复「好几个会长」的公会。完成时显示导入、跳过与修复的数量。见 从 PlayerGuild 导入。
/cg admin migrate
/cg admin migrate sqlite
/cg admin migrate mysql
参数写来源：sqlite = 把 database.file 的 SQLite 资料搬进目前使用的 MySQL；mysql = 反过来。目前的数据库必须没有任何公会。见 从 SQLite 搬到 MySQL。