命令与权限
JoyMart 提供玩家命令与管理命令两套体系，全部通过权限节点控制。命令相关的全局开关与子命令配置见 配置文件说明。
玩家命令
默认 /gamebox，简写 /gb。
| 命令 | 权限 | 说明 |
|---|---|---|
/gamebox | gamebox.use | 打开主菜单 |
/gamebox <子命令> | gamebox.play.<id> | 直接进入指定游戏（子命令见 games.yml） |
/gamebox token | gamebox.use | 查看自己代币余额 |
/gamebox info | gamebox.use | 查看插件信息 |
/gamebox help | gamebox.use | 查看帮助 |
/gamebox accept [玩家] | gamebox.use | 接受对战邀请 |
/gamebox decline [玩家] | gamebox.use | 拒绝对战邀请 |
管理命令
默认 /gameboxadmin，简写 /gba。
| 命令 | 权限 | 说明 |
|---|---|---|
/gba reload | gamebox.admin.reload | 重载所有配置 |
/gba tokens <玩家> get | gamebox.admin.tokens | 查看玩家代币 |
/gba tokens <玩家> set <数量> | gamebox.admin.tokens | 设置玩家代币 |
/gba tokens <玩家> give <数量> | gamebox.admin.tokens | 给予玩家代币 |
/gba tokens <玩家> take <数量> | gamebox.admin.tokens | 扣除玩家代币 |
/gba games <游戏> <enable|disable> | gamebox.admin.games | 开关某款游戏 |
/gba games | gamebox.admin.games | 打开游戏管理 GUI（开关游戏、编辑彩票/抽奖机奖项池） |
/gba language | gamebox.admin.language | 检查语言文件完整性 |
/gba migrate <file|mysql> | gamebox.admin.migrate | 在 YAML/MySQL 之间迁移数据 |
/gba reset <游戏> | gamebox.admin.reset | 重置某游戏的高分榜 |
/gba shop | gamebox.admin.shop | 打开商店管理 GUI（上架/下架物品） |
权限
| 权限节点 | 默认 | 说明 |
|---|---|---|
gamebox.use | true | 使用 /gamebox 主命令 |
gamebox.play.* | true | 游玩所有游戏 |
gamebox.play.<id> | true | 游玩指定游戏（如 gamebox.play.2048） |
gamebox.gamegui.<id> | true | 在主菜单看到指定游戏的图标 |
gamebox.admin.* | op | 所有管理权限 |
gamebox.admin.shop | op | 通过 GUI 上架/下架商店物品 |
gamebox.shop.<custom> | false | 商店商品的购买权限（在 tokenShop.yml 中按商品定义） |
权限自动注册
每个游戏在加载时会自动注册对应的 gamebox.play.<id> 和 gamebox.gamegui.<id> 权限（默认 true）。商店商品的 buyPermission 不会自动注册，请用你的权限插件（如 LuckPerms）分配。