经济货币 ShiroGomaVault
白芝麻服货币系统使用说明 —— 领地币、铜币、芝麻券，货币兑换、账单查询与管理员命令
简介
ShiroGomaVault 是白芝麻服的货币插件。服务器里一共三种货币，各自独立、互不干扰：
| 货币 | 怎么来的 | 主要用途 |
|---|---|---|
| 领地币 | 用铜币兑换，或管理员发放 | 服务器商店 / 领地等消费（主货币） |
| 铜币 | 银行系统里攒的 | 攒够后到兑换界面换成领地币 |
| 芝麻券 | 管理员发放（如活动奖励） | 点券类福利，变动都有账单记录 |
一句话：铜币 → 领地币 是兑换关系；芝麻券是独立发放的点券，不能互相兑换。
玩家使用
| 想做什么 | 怎么做 |
|---|---|
| 看自己的三种余额 | /money（也可 /balance、/bal） |
| 铜币换领地币 | /exchange 打开兑换界面 |
| 看铜币排行榜 | /money coins top |
| 看自己芝麻券的账单 | /money sesame log |
| 看命令帮助 | /money help |
查余额
直接输入 /money，聊天框会一次列出你当前的三种货币余额。
铜币换领地币（/exchange）
打开后是一个 3×3 的兑换界面：
- 正中间是一枚向日葵「点击兑换」按钮，按钮上写着你当前铜币和领地币余额。
- 默认比例：1 铜币 = 100 领地币。
点按钮的不同方式，兑换次数不同：
| 操作 | 兑换次数 |
|---|---|
| 左键 | 1 次 |
| 右键 | 10 次 |
| Shift + 左键 | 100 次 |
| Shift + 右键 | 1000 次 |
兑换成功后界面会刷新出最新余额。铜币不够会提示「铜币不足」，点太快会短暂提示「冷却中」，等一下再点就好。
铜币不够兑换时，先去银行系统里攒铜币。兑换会自动从你的银行账户扣铜币、加上领地币，不用手动操作。
铜币排行榜
/money coins top 打开排行榜：前三名用玩家头颅摆在最上面，下面是其余排名，可翻页，底部有「排行榜信息」能看到自己的名次。排行榜只统计普通玩家的银行账户（余额大于 0，OP 不参与）。
芝麻券账单
/money sesame log 打开你自己的芝麻券账单：每条记录显示变动多少、变动后余额、操作人和时间，底部可翻页。芝麻券每次发放 / 扣除 / 调整都会自动记进账单。
管理员命令
管理命令权限：shirogomavault.money.admin（默认仅 OP）。/money help、/money coins top、/money sesame log（看自己）无需权限。
领地币
| 命令 | 说明 |
|---|---|
/money give <玩家> <数量> | 给玩家加领地币 |
/money take <玩家> <数量> | 从玩家扣领地币 |
/money set <玩家> <数量> | 把玩家领地币直接设成某个数 |
/money balance <玩家> | 查某玩家的领地币 |
铜币
| 命令 | 说明 |
|---|---|
/money coins give <玩家> <数量> | 给玩家加铜币 |
/money coins take <玩家> <数量> | 从玩家扣铜币 |
/money coins set <玩家> <数量> | 把玩家铜币直接设成某个数 |
/money coins balance <玩家> | 查某玩家的铜币 |
芝麻券
| 命令 | 说明 |
|---|---|
/money sesame give <玩家> <数量> | 发放芝麻券（会记入该玩家账单） |
/money sesame take <玩家> <数量> | 扣除芝麻券（会记入账单） |
/money sesame set <玩家> <数量> | 直接设定芝麻券余额（会记入账单） |
/money sesame balance <玩家> | 查某玩家的芝麻券 |
/money sesame log <玩家> | 打开某玩家的芝麻券账单（查他人需管理员权限） |
take / set 目标玩家不必在线；give 若玩家在线会给对方收到一条提醒。给芝麻券时操作人会被写进账单，发放前想清楚数量。
兑换比例调整（可选）
管理员若想改兑换比例，改 plugins/ShiroGomaVault/config.yml：
exchange:
coin-cost: 1 # 每次兑换消耗多少铜币
rate: 100 # 换到多少领地币（这里 1 铜币 = 100 领地币）
cooldown-ticks: 10 # 兑换冷却，20 tick = 1 秒（10 = 0.5 秒，防连点）改完重启服务器生效。Vault: true 是主货币开关，保持开启即可。
PlaceholderAPI 变量
供其他插件（如计分板、TAB 列表）显示余额用，需装 PlaceholderAPI。扩展标识符为 shirogomavault：
| 变量 | 显示内容 |
|---|---|
%shirogomavault_balance% | 领地币余额 |
%shirogomavault_coins% | 铜币余额 |
%shirogomavault_sesame% | 芝麻券余额 |
%shirogomavault_cointop_1% | 铜币榜第 1 名玩家名 |
%shirogomavault_cointop_1_balance% | 铜币榜第 1 名的铜币数 |
排行榜变量把 1 换成 2 / 3 即可取第 2、3 名。
常见问题
Q：兑换提示「铜币不足」？
铜币不够本次兑换的量（coin-cost × 次数）。可以先少点几次，或先去攒铜币。
Q：兑换提示「冷却中」？ 连点太快触发短冷却，等 0.5 秒再点即可，属正常防作弊机制。
Q：芝麻券能换成领地币吗？
不能。芝麻券和领地币是独立的，只由管理员发放。可通过 /money sesame log 查每一笔的来源。
Q：/money coins top 里怎么没有我？
排行榜只统计余额大于 0 的普通玩家账户，OP 不上榜。