命令与权限
/malkuth
别名 /mal
所有子命令均在源码中声明了独立权限节点，默认 OP。
| 命令 | 权限 | 说明 |
|---|---|---|
/malkuth | - | 显示帮助 |
/malkuth reload | malkuth.command.reload | 重载主配置、货币、autosell_chest.yml、商店、商品、UI、回收规则、玩家商店方块缓存与语言文件，并清理运行时缓存 |
/malkuth place [商店ID] | malkuth.command.place（注解级声明，默认 OP） | 绑定玩家商店方块；不填 商店ID 时自动选择你第一个已有商品的玩家商店 |
/malkuth debug [on/off/status] | malkuth.command.debug | 切换或查看调试状态；status 会同时输出 matcher 明细/摘要和单次日志上限 |
/malkuth source <物品源名 或 all> | malkuth.command.source | 读取主手物品在指定物品源下的物品 ID；all 会列出当前所有已识别来源并在识别失败时回退显示 Malkuth trace |
/malkuth itemdebug | malkuth.command.itemdebug | 输出主手物品材质、显示名、CustomModelData、source tag / source id tag 和当前可识别来源列表 |
/malkuth give <玩家> <物品ID> [数量] [原因] | malkuth.command.give | 将物品/商品/物品源物品投递到玩家邮箱 |
/malkuth random refresh <商店ID> [玩家] | malkuth.command.random | 刷新随机商品结果；不指定玩家则清除所有玩家该商店的结果 |
/malkuth random info <商店ID> <玩家> | malkuth.command.random | 查看指定玩家的随机商品结果 |
/malkuth extract | malkuth.command.extract | 释放缺失的默认资源文件（包含 autosell_chest.yml 与新增 UI 模板） |
/malshop
玩家命令，默认所有玩家可用。
| 命令 | 权限 | 说明 |
|---|---|---|
/malshop open <商店> | malkuth.command.shop.open.self | 打开商店 |
/malshop open <商店> <玩家> | malkuth.command.shop.open.other | 为其他玩家打开商店 |
/malshop mailbox | malkuth.command.mailbox | 打开邮箱 |
/malshop mailbox give item <玩家> <itemId> [数量] [原因] | malkuth.command.mailbox.give.item | 管理员投递物品到邮箱 |
/malshop mailbox give goods <玩家> <shopId> <goodsKey> [数量] [原因] | malkuth.command.mailbox.give.goods | 管理员投递商店商品到邮箱 |
/malshop favorite | malkuth.command.favorite | 打开收藏夹 |
/malshop cart | malkuth.command.cart | 打开购物车 |
/malshop compare [关键词] | malkuth.command.compare | 比价搜索 |
/malshop playershop <商店ID> <玩家> | malkuth.command.playershop | 打开指定玩家的玩家商店 |
/malshop browse <商店ID> | malkuth.command.browse | 浏览玩家商店列表 |
/malgive
/malkuth give 的独立别名命令。
| 命令 | 权限 | 说明 |
|---|---|---|
/malgive <玩家> <物品ID> [数量] [原因] | malkuth.command.give | 将物品投递到玩家邮箱 |
支持选择器：*:on（所有在线玩家，需 malkuth.command.give.selector.online）、*:off（所有玩家含离线，需 malkuth.command.give.selector.all）。
/malapi
管理命令入口，权限 malkuth.command.api（OP）。每个子命令有独立权限。
| 命令 | 权限 | 说明 |
|---|---|---|
/malapi item save <商品名> | malkuth.command.api.item.save | 将手持物品保存到插件物品仓库 |
/malapi item remove <商品名> | malkuth.command.api.item.remove | 从物品仓库删除 |
/malapi item give <商品名> | malkuth.command.api.item.give | 从物品仓库取出物品 |
/malapi item sync | malkuth.command.api.item.sync | 同步物品仓库数据库 |
PlaceholderAPI 变量
需要安装 PlaceholderAPI 前置。
| 变量 | 说明 |
|---|---|
%malkuth_shop_<商店ID>_enable% | 商店是否对该玩家开放 |
%malkuth_limit_<商店ID>_<商品Key>% | 该玩家剩余限购次数（兼容变量） |
%malkuth_limit_remaining_<商店ID>_<商品Key>% | 该玩家剩余限购次数（新变量） |
%malkuth_remaining_<商店ID>_<商品Key>% | limit_remaining 的别名 |
%malkuth_bought_<商店ID>_<商品Key>% | 该玩家累计已购买次数 |
按当前源码：%malkuth_limit_*%、%malkuth_limit_remaining_*% 与 %malkuth_remaining_*% 都返回同一套剩余限购结果；若该商品未配置任何限购，则返回 999。另外，这三类变量的参数通过 _ 分段解析，<商店ID> 与 <商品Key> 建议避免使用下划线。
权限汇总
命令权限
| 权限 | 说明 | 默认 |
|---|---|---|
malkuth.command.give | 使用 /malkuth give 投递邮箱 | OP |
malkuth.command.debug | 切换调试模式 | OP |
malkuth.command.reload | 重载配置 | OP |
malkuth.command.place | 绑定玩家商店方块 | OP |
malkuth.command.random | 随机商品管理 | OP |
malkuth.command.extract | 释放默认资源 | OP |
malkuth.command.source | 读取主手物品的物品源 ID / 全来源列表 | OP |
malkuth.command.itemdebug | 输出主手物品调试信息 | OP |
malkuth.command.api | API 命令入口 | OP |
malkuth.command.api.item.save | 保存物品到仓库 | OP |
malkuth.command.api.item.remove | 从仓库删除物品 | OP |
malkuth.command.api.item.give | 从仓库取出物品 | OP |
malkuth.command.api.item.sync | 同步物品仓库 | OP |
malkuth.command.shop.open.self | 打开商店 | 所有玩家 |
malkuth.command.shop.open.other | 为其他玩家打开商店 | OP |
malkuth.command.mailbox | 打开邮箱 | 所有玩家 |
malkuth.command.mailbox.give.item | 投递物品到邮箱 | OP |
malkuth.command.mailbox.give.goods | 投递商店商品到邮箱 | OP |
malkuth.command.favorite | 打开收藏夹 | 所有玩家 |
malkuth.command.cart | 打开购物车 | 所有玩家 |
malkuth.command.compare | 比价搜索 | 所有玩家 |
malkuth.command.playershop | 打开指定玩家商店 | 所有玩家 |
malkuth.command.browse | 浏览玩家商店列表 | 所有玩家 |
malkuth.command.give.selector.online | 使用 *:on 选择器 | OP |
malkuth.command.give.selector.all | 使用 *:off 选择器 | OP |
malkuth.command.mailbox.give.selector.online | 邮箱投递 *:on 选择器 | OP |
malkuth.command.mailbox.give.selector.all | 邮箱投递 *:off 选择器 | OP |
运行时权限
以下权限在玩家操作时动态检查，不绑定到具体命令：
| 权限 | 说明 | 默认 |
|---|---|---|
malkuth.shop.<商店ID> | 允许打开指定商店 | 所有玩家 |
malkuth.shop.* | 允许打开所有商店 | 所有玩家 |
malkuth.buy.<商品ID> | 允许购买指定商品 | 所有玩家 |
malkuth.buy.* | 允许购买所有商品 | 所有玩家 |
malkuth.admin | 管理其他玩家的玩家商店（非店主也可编辑） | OP |
malkuth.globalmarket.detail | 查看全球市场详情页 | 所有玩家（需服主主动授权时再细分） |
malkuth.globalmarket.favorite | 收藏或取消收藏全球市场挂单 | 所有玩家（需服主主动授权时再细分） |
malkuth.globalmarket.compare | 打开全球市场同类比价界面 | 所有玩家（需服主主动授权时再细分） |
malkuth.globalmarket.search-similar | 在详情页按名称 / 来源搜索同类挂单 | 所有玩家（需服主主动授权时再细分） |
malkuth.globalmarket.edit-price | 修改自己的全球市场挂单价格 | 所有玩家（建议只给允许卖家调价的玩家） |
malkuth.globalmarket.admin.edit-price | 允许管理员修改任意全球市场挂单价格 | OP |
malkuth.globalmarket.admin.delist | 允许管理员下架任意全球市场挂单 | OP |
使用示例
# 重载配置
/malkuth reload
# 绑定自己第一个已有商品的玩家商店到当前指向的方块
/malkuth place
# 开启调试模式
/malkuth debug on
# 查看当前 debug / matcher 摘要状态
/malkuth debug status
# 给 Steve 投递一个物品源物品到邮箱
/malkuth give Steve mm:legendary_sword 1 管理员发放
# 查看主手物品在 MythicMobs 物品源下的 ID
/malkuth source mm
# 列出主手物品当前所有可识别来源
/malkuth source all
# 输出主手物品的基础调试信息
/malkuth itemdebug
# 打开名为 def 的商店
/malshop open def
# 为玩家 Steve 打开商店
/malshop open def Steve
# 查看邮箱
/malshop mailbox
# 管理员按商品ID投递到邮箱
/malshop mailbox give item Steve my_repo_item 3 活动奖励
# 管理员按商店商品投递到邮箱
/malshop mailbox give goods Steve def 1 2 补偿发放
# 搜索包含"钻石"的商品并比价
/malshop compare 钻石
# 将手持物品保存到物品仓库
/malapi item save 我的钻石剑
# 同步物品仓库到数据库
/malapi item sync