管理员常用命令
白芝麻服所有自定义插件的管理员命令速查表 —— 称号、货币、祈愿抽奖、蛙港点评、聚落
本页汇总白芝麻服全部自定义插件的管理员命令，按插件分组展示。每条命令附权限节点与目标玩家是否需在线。
所有插件的管理员命令权限默认只给 OP（default: op）。非 OP 的管理员需要手动在权限插件里授予对应节点。
称号 ShiroGomaTitles
权限节点：sgtitles.admin
| 命令 | 说明 |
|---|---|
/sgtitles give <玩家> <称号ID> | 给予玩家全局称号（称号 ID 必须在 config.yml 里已定义） |
/sgtitles remove <玩家> <称号ID> | 移除玩家的某个全局称号 |
/sgtitles custom add <玩家> <显示名> | 为玩家添加定制称号（支持 & 颜色代码） |
/sgtitles custom remove <玩家> <定制ID> | 移除定制称号；ID 先 /sgtitles custom list <玩家> 查 |
/sgtitles custom list <玩家> | 列出玩家全部定制称号及其 ID |
/sgtitles list | 列出所有已配置的全局称号 |
/sgtitles reload | 重载 config.yml（称号 / 组 / 存储） |
/sgtitles migrate | 数据迁移 yml → Postgres |
/sgtitles migrate-to-yml | 数据迁移 Postgres → yml |
give / remove / custom 系列命令要求目标玩家在线。
货币 ShiroGomaVault
权限节点：shirogomavault.money.admin（take / set / balance / 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 若玩家在线会收到提醒。芝麻券变动都会写入账单，操作前确认数量。
祈愿抽奖 ShiroGomaLottery
权限节点：shirogomalottery.admin（默认 OP）。
池子与奖励
| 命令 | 说明 |
|---|---|
/qiyuan pool create id slot [material] | 新建池子；slot 是主界面 GUI 格子号 |
/qiyuan pool list | 列出所有池子的 ID / 显示名 / 花费 / UP |
/qiyuan pool settitle <池子> <称号ID> | 设抽中 UP 时自动发放的 ShiroGomaTitles 称号；填 none 表示不发 |
/qiyuan reward add tier weight`` | 把你主手手持的物品加入通用普通奖励表 |
/qiyuan reward up <池子> weight`` | 把你主手物品设为指定池子的本期 UP |
/qiyuan reward list [池子] | 查看奖励表；不带参数查通用普通表 |
tier 可选：common / rare / epic / legendary / mythic。
券发放
| 命令 | 说明 |
|---|---|
/qiyuan tenpull give <玩家> [数量] | 发十连抽奖券（默认 1 张） |
其他
| 命令 | 说明 |
|---|---|
/qiyuan reload | 重载 config.yml / 所有池子 YAML / 十连券配置 |
/qiyuan history <玩家> | 查看该玩家的抽奖历史 GUI（目标需在线） |
reward add / reward up 必须主手手持物品；池子 / 奖励 / history 命令都需在玩家侧执行（控制台无法发 GUI）。
蛙港点评 ShirogomaReview
权限节点：
| 节点 | 作用 |
|---|---|
shirogoma.shop.givelicense | 发放营业执照 / 广告券 |
shirogoma.shop.suspend | 整顿店铺 / 审核开业申请 |
shirogoma.shop.additem | 添加展示物品预设 |
shirogoma.shop.reload | 重载配置 |
执照 / 券
| 命令 | 说明 |
|---|---|
/shop givelicense [玩家] | 向在线玩家发放营业执照（默认发给自己） |
/shop giveticket [玩家] [数量] | 发放广告券，默认 1 张 |
店铺管理
| 命令 | 说明 |
|---|---|
/shop suspend <店铺名> <理由> | 整顿店铺；店主在线时会收到通知 |
/shop review | 打开开业申请审核 GUI |
/shop additem hand · /shop additem <物品> | 把手持物品或指定 Material 加入展示物品预设 |
重载
| 命令 | 说明 |
|---|---|
/shop reload | 重载 config.yml + shops.yml |
聚落 ShiroGomaSettlement
权限节点：shirogoma.admin（默认 OP，覆盖所有权限检查）。
聚落创建 / 删除 / 转移
| 命令 | 说明 |
|---|---|
/settlement create <名称> | 创建聚落，创建者自动成领袖；名称全局唯一 |
/settlement delete <名称|ID> | 删除聚落 |
/settlement setleader <玩家> [聚落] | 转移领袖；目标必须已是该聚落成员 |
任意聚落管理
| 命令 | 说明 |
|---|---|
/settlement setname <新名称> <聚落> | 给任意聚落改名 |
/settlement setprefix <前缀> <聚落> | 给任意聚落设 1 字符前缀（过滤颜色代码后 ≤ 1 字） |
/settlement setviceleader <玩家> <聚落> | 切换任意聚落某成员的副领袖身份 |
/settlement kick <玩家> <聚落> | 从任意聚落踢出成员（不能踢领袖） |
/settlement setwarp <聚落> | 把传送点设在你当前位置（任意聚落） |
/settlement delwarp <聚落> | 清除任意聚落的传送点 |
查看
| 命令 | 说明 |
|---|---|
/settlement info <名称|ID> | 查看任意聚落详情 |
管理员权限覆盖后，所有带 [聚落名称] 参数的命令都能指定任意聚落，不受「自己所在聚落」限制。resolvePlayer 先查在线，查不到遍历离线玩家，所以 <玩家> 参数支持离线玩家。