建立与加入
建立公会
/cg create <名称> [标签]
或在公会列表（没有公会时输入 /cg）点「建立公会」，在聊天栏输入「名称 标签」。需要 cloudguild.create 权限（默认所有人都有）。
费用与条件
在 config.yml 的 create 设定，几项同时设定时全部都要满足：
| 键 | 默认 | 说明 |
|---|---|---|
money | 10000 | 金币（Vault），建立时扣除 |
points | 0 | 点券（PlayerPoints），建立时扣除 |
exp-level | 0 | 需要的原版经验等级（只检查、不扣除） |
items | [] | 需要的物品，写法 材质: 数量，例如 ['DIAMOND:5', 'GOLD_INGOT:32']，建立时从背包扣除 |
- 金币与点券要么一起扣、要么都不扣。数据库写入失败时（例如同时有人抢先用了这个名称）费用会退回。
items只检查背包，建立成功后才扣除物品，失败时不会被吃掉。- 其他插件可以用
GuildCreateEvent在扣费之前取消建立。 - 建立成功后：
create.broadcast: true时全服公告，并以控制台执行create.commands（{player}玩家名、{guild}公会名称）。
名称规则
| 键 | 默认 | 说明 |
|---|---|---|
name.min-length / max-length | 2 / 8 | 去掉颜色代码后的字数（中文、英文都算 1 个字） |
name.pattern | '^[\p{IsHan}A-Za-z0-9_]+$' | 允许的字符（正则表达式，比对去掉颜色代码后的名称）。默认：中文、英文、数字、下划线 |
name.color-permission | 'cloudguild.create.color' | 有这个权限才能在名称里使用 & 颜色代码；留空 = 大家都可以 |
name.blacklist | [管理員, 服主, admin, owner] | 名称（以及标签）不能包含这些字，不分大小写 |
- 重复判断不分大小写、忽略颜色：
雲海、&b雲海、&l雲海视为同一个名称。 - 名称里不能有
<、>、§（不能写 MiniMessage 标签）。
标签
标签是公会的短代号，例如 YUN，显示在 %cloudguild_tag_formatted%（默认 &7[&b{tag}&7] ），也可以拿来代替公会名称输入指令（/cg info YUN）。
| 键 | 默认 | 说明 |
|---|---|---|
tag.enabled | true | false 时建立公会会忽略标签，/cg tag 与设定菜单的标签按钮也不能用 |
tag.min-length / max-length | 2 / 4 | 字数 |
tag.pattern | '^[\p{IsHan}A-Za-z0-9]+$' | 允许的字符（默认不含下划线） |
标签同样不分大小写判断重复。
加入方式
每个公会有自己的加入方式，新公会使用 join.default-mode（默认 apply）：
| 方式 | /cg join <公会> 的结果 | 菜单显示 |
|---|---|---|
open | 直接加入 | 直接加入 |
apply | 送出申请，等有审核权限的成员同意 | 申请审核 |
closed | 拒绝（「只接受邀請加入」） | 只能邀请 |
有 settings 权限的成员可以用 /cg joinmode <open|apply|closed> 修改；不写参数时按 直接加入 → 申请审核 → 只能邀请 的顺序切换。设定菜单的「加入方式」按钮也一样。
不管哪种方式，有效的邀请都可以直接加入。
<公会> 可以写名称（不分大小写、不用写颜色）、标签，或 #编号。
申请
/cg join 雲海 我是老玩家，想一起打副本
- 后面的文字是申请留言（最多 100 个字；只写
-= 不留言）。从菜单申请时，会请你在聊天栏输入留言，同样输入-表示不留言。 - 留言里的
<、>、\会换成全角字符，不能夹带 MiniMessage 标签或点击指令，见 聊天与公告。 - 一个玩家同时最多申请
join.max-applications（默认 3）个公会；申请join.application-expire（默认 3 天）后过期。 - 申请送出时，公会里有
accept权限的在线成员（任何子服）会收到「申请加入公会：留言 [同意] [拒絕]」，点一下就能审核。 - 有审核权限 的成员上线时，会提示「有 N 個入會申請等待審核」。
审核：/cg accept <玩家>、/cg deny <玩家>，或主页 → 成员 →「入会申请」（左键同意、右键拒绝）。两位管理同时审核同一份申请，只有一位会处理到。
同意后如果公会人数已满，提示「人數已滿」，申请已被取出，对方需要重新申请。
邀请
/cg invite <玩家>
- 需要
invite权限。对方在别的子服也收得到（只要他在连同一数据库的任何子服上线过）；对方离线时，下次上线会看到邀请。 - 邀请
join.invite-expire（默认 5 分钟）内有效，对方点「[接受]」或输入/cg join <公会>就加入。 - 不写玩家名时打开「邀请玩家」菜单，列出这个子服上没有公会的在线玩家。
加入时
- 人数检查与加人是同一个数据库操作，不会超过等级的人数上限。
- 加入成功后，这位玩家的其他申请与邀 请全部清除；新成员的职位是
default-rank。 - 公会所有在线成员（任何子服）会收到「歡迎 xxx 加入」。
没有公会的玩家上线时，join.remind-no-guild: true 会提示「你還沒有公會！點這裡看看有哪些公會」。
退出、踢出与解散
| 操作 | 指令 | 说明 |
|---|---|---|
| 退出 | /cg leave | 会长不能直接退出：先 /cg transfer <成员> 转让，或公会只剩自己时 /cg disband 解散 |
| 踢出 | /cg kick <成员> | 需要 kick 权限，只能踢职位权重比自己低的成员 |
| 解散 | /cg disband | 只有会长；30 秒内再输入一次 /cg disband（或直接 /cg disband confirm）才会执行。中间做了别的确认（例如转让）不会被算成解散的确认 |
- 重新加入冷却：主动退出后
join.rejoin-cooldown（默认 3 小时）内不能加入其他公会。被踢出、公会解散不算；有cloudguild.bypass.cooldown的玩家不受限制，管理员可以用/cg admin cooldown <玩家>清除。 - 解散会删除公会的所有资料：资金、成员、申请、邀请、据点、公告、银行记录、任务进度、增益、仓库里的物品、同盟与敌对关系；进行中的公会战会被取消。无法复原。
公会设定
以下都需要 settings 权限，也可以在主页 →「公会设定」里操作：
| 设定 | 指令 | 说明 |
|---|---|---|
| 改名 | /cg rename <新名称> | 规则同建立；花费公会资金 name.rename-cost（默认 50000），资金不够就失败 |
| 标签 | /cg tag <标签> | /cg tag clear 或 /cg tag - 清除 |
| 介绍 | /cg desc <文字> | 最多 name.description-max-length（默认 64）个字（不算颜色代码），可以用 & 颜色；< > \ 会换成全角字符；菜单里 | 会换行。不写文字 = 清空 |
| 图示 | /cg icon | 把主手的物品设为公会图示（只存一个，名称、附魔、模型都保留），显示在公会列表、主页与云界面徽章 |
| 加入方式 | /cg joinmode [open|apply|closed] | 见上方 |
| 友伤 | /cg ff | 切换成员之间能不能互相伤害，见下方 |
友伤
| 键 | 默认 | 说明 |
|---|---|---|
pvp.friendly-fire | false | 新公会默认是否允许成员互相伤害（之后各公会用 /cg ff 自己切换） |
pvp.ally-damage | false | 同盟公会的成员之间能不能互相伤害 |
pvp.ignore-worlds | [] | 这些世界不管友伤设定（例如竞技场），而且公会增益在这些世界会暂时移除 |
保护范围包括直接攻击、弓箭等投射物、玩家放出的药水云与 TNT，以及有害的喷溅药水。
升职、降职与转让
见 职位与等级。