变量
安装 PlaceholderAPI 后，云公会会自动注册下面的变量（不需要 /papi ecloud download）。开服时控制台会显示「PlaceholderAPI 變數已註冊」。
不会查数据库
所有变量都只读内存缓存，计分板、TAB、聊天格式每秒刷新也不会查数据库。排行榜的排序结果另外缓存 5 秒。
未授权时
授权还没验证通过时（见 安装与授权），变量功能暂停。
显示用
| 变量 | 内容 | 例子 |
|---|---|---|
%cloudguild_has_guild% | 有没有公会 | true |
%cloudguild_display% | 按 display.format 显示（默认 &f[{color}{name}&f]）；没有公会时显示 display.no-guild（默认 &7無公會） | [雲海] |
%cloudguild_tag_formatted% | 按 tag.format 显示标签（默认 &7[&b{tag}&7] ）；没有公会或没有标签时是空的 | [YUN] |
%cloudguild_name% | 公会名称（含颜色） | 雲海 |
%cloudguild_name_plain% | 公会名称（不含颜色） | 雲海 |
%cloudguild_tag% | 标签（没有时空的） | YUN |
%cloudguild_id% | 公会编号 | 3 |
display.format 可用 {color} 等级颜色、{name} 名称、{tag} 标签、{level} 等级。聊天前缀推荐用 %cloudguild_tag_formatted%（没公会时自动变成空的）。
公会
| 变量 | 内容 | 例子 |
|---|---|---|
%cloudguild_level% | 公会等级 | 4 |
%cloudguild_level_color% | 这个等级的颜色（levels.<等级>.color） | &b 的颜色 |
%cloudguild_max_level% | 最高等级 | 10 |
%cloudguild_members% | 成员数 | 18 |
%cloudguild_max_members% | 这个等级的人数上限 | 25 |
%cloudguild_online% | 这个子服上在线的成员数 | 6 |
%cloudguild_funds% | 公会资金 | 152300 |
%cloudguild_funds_formatted% | 公会资金（千分位） | 152,300 |
%cloudguild_activity% | 公会活跃 | 8420 |
%cloudguild_month_activity% | 本月活跃 | 2310 |
%cloudguild_leader% | 会长名称 | Steve |
%cloudguild_position% | 等级排行的名次 | 2 |
%cloudguild_next_level_cost% | 升到下一级要花的资金；已经最高级时 - | 200000 |
%cloudguild_next_level_activity% | 升到下一级需要的活跃；已经最高级时 - | 15000 |
%cloudguild_join_mode% | 加入方式名称，原样输出 messages.yml 的 join-mode 文字（含 & 颜色代码） | &e申請審核 |
%cloudguild_friendly_fire% | 友伤是否开启 | false |
%cloudguild_allies% | 同盟数 | 2 |
%cloudguild_guild_kills% / %cloudguild_guild_deaths% | 全公会的击杀 / 死亡 | 340 / 512 |
%cloudguild_war_wins% / %cloudguild_war_losses% | 公会战胜场 / 败场 | 5 / 2 |
%cloudguild_at_war% | 现在是否正在开战 | true |
%cloudguild_war_enemy% | 开战中的对手名称（不含颜色；没有时空的） | 星辰 |
自己
| 变量 | 内容 | 例子 |
|---|---|---|
%cloudguild_rank% | 职位名称（含颜色） | 副會長 |
%cloudguild_rank_id% | 职位 id | vice |
%cloudguild_contribution% | 目前的贡献（可以在商店花） | 1250 |
%cloudguild_total_contribution% | 累积贡献 | 8600 |
%cloudguild_week_contribution% | 本周贡献 | 430 |
%cloudguild_donated% | 累积捐献的金币 | 120000 |
%cloudguild_kills% / %cloudguild_deaths% | 自己的击杀 / 死亡 | 42 / 17 |
%cloudguild_unread_notices% | 未读公告数 | 1 |
%cloudguild_has_unread% | 有没有未读公告 | true |
%cloudguild_chat_mode% | 目前的聊天频道名称（messages.yml 的 chat-mode-name） | 公會頻道 |
%cloudguild_signed_today% | 今天签到过没有 | false |
全服
| 变量 | 内容 | 例子 |
|---|---|---|
%cloudguild_guild_count% | 公会总数（不需要玩家） | 27 |
排行榜
%cloudguild_top_<类型>_<名次>_<字段>%
| 部分 | 可以写 |
|---|---|
<类型> | level 等级、activity 活跃、month 本月活跃、funds 资金、members 人数、kills 击杀、wars 胜场 |
<名次> | 1、2、3…… |
<字段> | name 公会名称（含颜色，不写字段时就是它）、value 这个类型的数值、level 等级、tag 标签、leader 会长、members 成员数 |
例子：
| 变量 | 内容 |
|---|---|
%cloudguild_top_level_1% | 等级第 1 名的公会名称 |
%cloudguild_top_level_1_value% | 等级第 1 名的等级 |
%cloudguild_top_month_3_name% | 本月活跃第 3 名的公会名称 |
%cloudguild_top_month_3_value% | 本月活跃第 3 名的本月活跃 |
%cloudguild_top_funds_2_leader% | 资金第 2 名的会长 |
%cloudguild_top_wars_1_tag% | 胜场第 1 名的标签 |
- 排序相同时，等级榜再比活跃，人数榜再比等级，最后比较早建立的公会在前。
- 名次超过公会数量时，
value与level显示0，其他字段显示messages.yml的top-none（默认-）。
全息看板排行榜的例子：
&6公會排行 · 本月活躍
&e#1 %cloudguild_top_month_1_name% &7- &f%cloudguild_top_month_1_value%
&e#2 %cloudguild_top_month_2_name% &7- &f%cloudguild_top_month_2_value%
&e#3 %cloudguild_top_month_3_name% &7- &f%cloudguild_top_month_3_value%
没有公会时
变量只对在线玩家有效（离线玩家当作没有公会）。没有公会时：
| 变量 | 显示 |
|---|---|
has_guild | false |
display | display.no-guild（默认 &7無公會） |
tag_formatted、name、name_plain、tag、leader、rank、rank_id、war_enemy、join_mode | 空的 |
chat_mode | 一般聊天的名称（默认 一般聊天） |
at_war、friendly_fire | false |
| 其他数字变量 | 0 |
signed_today、guild_count 与排行榜变量不受影响。