职位与等级
职位
职位写在 config.yml 的 ranks，默认有四个：
ranks:
leader:
name: '&6會長'
weight: 100
limit: 1
permissions: ['*']
vice:
name: '&e副會長'
weight: 80
limit: 2
permissions: [invite, accept, kick, promote, demote, notice, home, upgrade, settings, relation, war, buff, withdraw, vault, shop, task]
elite:
name: '&b精英'
weight: 50
limit: 0
permissions: [invite, accept, vault, shop, task]
member:
name: '&7成員'
weight: 10
limit: 0
permissions: [vault, shop, task]
# 新成員的職位
default-rank: member
| 键 | 说明 |
|---|---|
职位 id（例如 vice） | 职位的代号，用在 /cg setrank、%cloudguild_rank_id%、API。改了 id，原本是这个职位的成员会被当成 default-rank |
name | 显示名称，支持 & 颜色、&#RRGGBB 与 MiniMessage；用在聊天格式的 {rank}、菜单与 %cloudguild_rank% |
weight | 权重，越大职位越高。只能管理权重比自己低的成员 |
limit | 一个公会里这个职位最多几人；0 = 不限 |
permissions | 职位权限，见下表；'*' = 全部 |
- 权重最高的职位就是会长。会长默认是
['*']，请保留，否则会长也会缺少权限。 - 至少要有两个职位，少于两个时控制台警告并使用内置的「会长 + 成员」。
default-rank是新成员的职位；写错或写成会长时，改用权重最低的职位。- 只有会长能做的事：
/cg setrank、/cg transfer、/cg disband（不受权限清单影响）。
职位权限
| 权限 | 能做什么 |
|---|---|
invite | 邀请玩家（/cg invite、成员菜单的「邀请玩家」） |
accept | 审核入会申请（/cg accept、/cg deny、「入会申请」菜单）；也会收到新申请的通知 |
kick | 踢出成员 |
promote | 升职 |
demote | 降职 |
notice | 发布与删除公告 |
home | 设定、删除据点（回据点不需要权限） |
upgrade | 升级公会 |
settings | 改名、标签、介绍、图示、加入方式、友伤 |
relation | 同盟、敌对（提出、同意、解除） |
war | 宣战 |
buff | 用公会资金升级增益 |
withdraw | 从公会银行提领；也会收到其他人提领的通知 |
vault | 打开公会仓库 |
shop | 在公会商店购买 |
task | 打开公会任务菜单（见下方说明） |
task 权限
task 只控制能不能打开 /cg tasks 任务菜单。任务进度对所有成员都会累积，出力的成员都会拿到贡献奖励，跟有没有这个权限无关。
存钱、签到、回据点、公会频道、查看成员与公告不需要职位权限，所有成员都可以用。
升职、降职与转让
| 操作 | 指令 | 规则 |
|---|---|---|
| 升职 | /cg promote <成员> | 需要 promote。升到高一阶的职位（不会升成会长）；对方的职位和升上去的职位都要比你低 |
| 降职 | /cg demote <成员> | 需要 demote。降到低一阶的职位；对方的职位要比你低 |
| 指定职位 | /cg setrank <成员> <职位> | 只有会长。<职位> 写职位 id 或名称（不含颜色），不能指定为会长 |
| 转让会长 | /cg transfer <成员> | 只有会长；30 秒内再输入一次（或加 confirm）确认。对方成为会长，你变成第二高的职位 |
- 新职位的人数达到
limit时提示「已經有 N 人了」。 - 两位管理同时改同一个人的职位时，只有一位会成功，另一位提示「資料剛被其他人修改了，請再試一次」。
- 也可以在主页 → 成员 → 点一位成员（只有你能管理的成员可以点）→ 升职 / 降职 / 踢出 / 转让会长。
管理员可以用 /cg admin setleader <公会> <玩家> 直接指定会长：原本所有的「会长」都会降为第二高的职位，所以也能用来修复「一个公会好几个会长」的资料。
公会等级
等级写在 config.yml 的 levels，默认 10 级：
levels:
1: {members: 10, cost: 0, activity: 0, min-members: 0, upkeep: 0, decay: 0, homes: 1, vault-pages: 1, color: '&f'}
2: {members: 15, cost: 20000, activity: 1000, min-members: 3, upkeep: 50, decay: 20, homes: 1, vault-pages: 1, color: '&a'}
# …
10: {members: 100, cost: 6000000, activity: 400000, min-members: 40, upkeep: 3000, decay: 1200, homes: 5, vault-pages: 6, color: '<gradient:#ffd36e:#ff8f6e>', buffs: {luck: 4}}
| 键 | 说明 |
|---|---|
members | 成员人数上限 |
cost | 从上一级升到这一级要花的公会资金（会扣除） |
activity | 升到这一级需要的公会活跃（只检查，不扣除） |
min-members | 升到这一级需要的成员人数 |
upkeep | 这个等级每天扣的公会资金（维护费，不会扣成负数） |
decay | 这个等级每天扣的活跃（不会小于 0） |
homes | 可以设定几个据点（最少 1） |
vault-pages | 公会仓库有几页；0 = 不能使用仓库 |
color | 名称颜色，用在 {color}、%cloudguild_level_color%、%cloudguild_display% |
buffs | 这个等级免费得到的增益，写法 {增益id: 等级}，见 公会增益 |
默认等级
| 等级 | 人数 | 升级资金 | 需要活跃 | 需要成员 | 每日维护费 | 每日活跃衰减 | 据点 | 仓库页 | 免费增益 |
|---|---|---|---|---|---|---|---|---|---|
| 1 | 10 | 0 | 0 | 0 | 0 | 0 | 1 | 1 | — |
| 2 | 15 | 20,000 | 1,000 | 3 | 50 | 20 | 1 | 1 | — |
| 3 | 20 | 50,000 | 3,000 | 5 | 100 | 40 | 2 | 2 | — |
| 4 | 25 | 100,000 | 8,000 | 8 | 200 | 80 | 2 | 2 | 幸运 1 |
| 5 | 30 | 200,000 | 15,000 | 10 | 300 | 120 | 3 | 3 | 幸运 1 |
| 6 | 40 | 400,000 | 30,000 | 15 | 500 | 200 | 3 | 3 | 幸运 2 |
| 7 | 50 | 800,000 | 60,000 | 20 | 800 | 300 | 4 | 4 | 幸运 2 |
| 8 | 60 | 1,500,000 | 100,000 | 25 | 1,200 | 500 | 4 | 5 | 幸运 3 |
| 9 | 80 | 3,000,000 | 200,000 | 30 | 2,000 | 800 | 5 | 5 | 幸运 3 |
| 10 | 100 | 6,000,000 | 400,000 | 40 | 3,000 | 1,200 | 5 | 6 | 幸运 4 |
- 可以一直往下加等级（11、12……）。
- 等级必须从 1 开始、连续：缺了某一级时，那一级以后的等级都不使用（控制台会警告），避免升级时跳级。
升级
/cg upgrade
需要 upgrade 权限，或在主页 / 设定菜单点「升级公会」。三个条件（资金、活跃、成员数）在同一个数据库操作里检查并扣除资金，两个人同时按也只会升一级。
- 成功后公会成员收到「公會升到 Lv.N 了！」，全服收到「公會 xxx 升到了 Lv.N！」（不想全服公告，把
messages.yml的upgraded-broadcast设成''）。 - 条件都满足时，主页的升级按钮会换成
ready状态（默认发光的下界之星）。 - 管理员可以用
/cg admin setlevel <公会> <等级>直接设定（不扣资金，会限制在 1 ～ 最高等级）。
维护费与活跃衰减怎么结算，见 银行、签到与活跃。