命令与权限
/malkuth
别名 /mal
多数管理子命令在源码中声明了独立权限节点，默认 OP；玩家向命令会在下表单独标明默认可用或需服主授权。
| 命令 | 权限 | 说明 |
|---|---|---|
/malkuth | - | 显示帮助 |
/malkuth reload | malkuth.command.reload | 重载主配置、货币、autosell_chest.yml、商店、商品、UI、回收规则、玩家商店方块缓存与语言文件，并清理运行时缓存 |
/malkuth place [商店ID] | malkuth.command.place（注解级声明，默认 OP） | 绑定玩家商店方块；不填 商店ID 时自动选择你第一个已有商品的玩家商店 |
/malkuth place create [商店ID] | malkuth.command.place | 无视当前 player-shop-block.mode，按 PLACE_ABOVE 逻辑在目标方块上方生成并绑定商店方块 |
/malkuth place model [模型ID] [商店ID] | malkuth.command.place | 切换已绑定玩家商店方块的摆摊模型；不填模型 ID 时打开模型选择界面 |
/malkuth place hologram / /malkuth place holo | malkuth.command.place | 显示玩家商店方块全息编辑帮助；下方命令都可把 holo 换成 hologram |
/malkuth place holo preview [商店ID] | malkuth.command.place | 预览当前商店方块全息内容；别名 view |
/malkuth place holo toggle [商店ID] | malkuth.command.place | 开启或关闭当前商店方块全息显示；别名 switch |
/malkuth place holo set [商店ID] | malkuth.command.place | 重写全部全息行，聊天输入内容并用竖线分隔多行 |
/malkuth place holo line <行号> [商店ID] | malkuth.command.place | 修改指定行全息；别名 setline |
/malkuth place holo add [商店ID] | malkuth.command.place | 追加一行全息；别名 addline |
/malkuth place holo remove <行号> [商店ID] | malkuth.command.place | 删除指定行全息；别名 removeline / del / delete |
/malkuth place holo height <高度> [商店ID] | malkuth.command.place | 调整全息高度 |
/malkuth place holo spacing <行距> [商店ID] | malkuth.command.place | 调整全息行距；别名 space |
/malkuth place holo reset [商店ID] | malkuth.command.place | 恢复该商店方块的默认全息配置 |
/malkuth place holo refresh [商店ID] | malkuth.command.place | 手动刷新该商店方块全息显示 |
/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 auction upload <商店> <起拍价> [一口价] [时长] | malkuth.command.auction.upload | 手持物品上架到拍卖行；未启用一口价时第三个参数会按时长解析 |
/malkuth market upload <商店> <价格> [数量] | malkuth.command.market.upload | 手持物品上架到全球市场；不填数量时默认上架主手全部数量 |
/malkuth request | malkuth.command.request | 显示全球求购命令帮助 |
/malkuth request create <商店> <单价> <数量> [匹配方式] | malkuth.command.request.create | 手持样品物品发布全球求购；匹配方式可用 source_or_similar / source_id / similar / material |
/malkuth request submit <求购ID> [数量] | malkuth.command.request.submit | 手持匹配物品提交供货申请；不填数量时使用主手数量 |
/malkuth request cancel <求购ID> | malkuth.command.request.cancel | 取消自己的全球求购；管理员取消还需要运行时权限 |
/malkuth request approve <供货ID> | malkuth.command.request.approve | 同意供货申请并结算求购交易 |
/malkuth request reject <供货ID> | malkuth.command.request.reject | 拒绝供货申请并退回供货物品 |
/malkuth random refresh <商店ID> [玩家] | malkuth.command.random | 刷新随机商品结果；不指定玩家则清除所有玩家该商店的结果 |
/malkuth random info <商店ID> <玩家> | malkuth.command.random | 查看指定玩家的随机商品结果 |
/malkuth autosell give <玩家> <类型> [数量] | malkuth.command.autosell | 给玩家发放自动售卖箱物品，类型来自 autosell_chest.yml -> types |
/malkuth autosell list | malkuth.command.autosell | 查看当前已绑定的自动售卖箱，最多输出前 20 条 |
/malkuth recovery types | malkuth.command.recovery | 查看可处理的恢复记录类型 |
/malkuth recovery list <类型> [数量] | malkuth.command.recovery | 列出指定类型待人工确认或可重试的恢复记录，数量限制在 1~100 |
/malkuth recovery show <类型> <ID> | malkuth.command.recovery | 查看指定恢复记录详情 |
/malkuth recovery resolve <类型> <ID> [备注] | malkuth.command.recovery | 将允许人工确认的恢复记录标记为已处理 |
/malkuth recovery retry <类型> <ID> [备注] | malkuth.command.recovery | 对允许安全重试的恢复记录发起重试 |
/malkuth tax report [商店/all] [天数] [模式/all] | malkuth.admin.tax | 查看税收汇总，默认最近 30 天 |
/malkuth tax player <玩家> [天数] [模式/all] | malkuth.admin.tax | 按卖家视角查看玩家税收报表 |
/malkuth tax buyer <玩家> [天数] [模式/all] | malkuth.admin.tax | 按买家视角查看玩家参与的税收报表 |
/malkuth tax top [商店/all] [天数] [模式/all] | malkuth.admin.tax | 查看卖家税收排行，最多前 10 名 |
/malkuth tax shoptop [天数] [模式/all] | malkuth.admin.tax | 查看商店税收排行，最多前 10 个商店 |
/malkuth extract | malkuth.command.extract | 释放缺失的默认资源文件（包含 autosell_chest.yml 与新增 UI 模板） |
恢复命令当前支持的类型：refund_ledger、seller_payout、global_market_expired_return、mail_claim、autosell_settlement、pending_delivery、global_request_recovery、global_request_deferred_delivery、auction_payment_intent。其中 resolve 只适合管理员已经确认结果的记录，retry 只会对源码允许安全重试的类型生效。
/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 seller <商店ID> <卖家> | malkuth.command.shop.open.self | 按卖家名称或 UUID 打开拍卖行 / 全球市场筛选结果 |
/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_balance_<货币Key>% | 查询指定货币的余额（如 vault、playerpoints 或自定义货币名） |
%malkuth_cart_count% | 购物车内商品数量 |
%malkuth_favorite_count% | 收藏夹内挂单数量 |
%malkuth_mailbox_count% | 邮箱中未领取邮件数量 |
%malkuth_auction_active_count% | 当前玩家正在进行中的拍卖数量 |
%malkuth_auction_bid_count% | 当前玩家仍在参与出价的拍卖数量 |
%malkuth_global_market_count_<商店ID>% | 当前玩家在指定全球市场商店中的上架数量 |
%malkuth_global_request_count_<商店ID>% | 指定全球求购商店当前 active 求购单数量 |
%malkuth_global_request_pending_<商店ID>% | 指定全球求购商店当前 pending 供货申请数量 |
%malkuth_global_request_my_active_<商店ID>% | 当前玩家在指定全球求购商店中的 active 求购单数量 |
%malkuth_global_request_my_pending_offers_<商店ID>% | 当前玩家作为求购者收到的 pending 供货申请数量 |
%malkuth_recycle_daily_count_<商店ID>% | 当前玩家在指定回收商店今日回收次数 |
%malkuth_recycle_daily_currency_<商店ID>% | 当前玩家在指定回收商店今日回收货币收入，保留两位小数 |
%malkuth_recycle_total_count_<商店ID>% | 当前玩家在指定回收商店累计回收次数 |
%malkuth_recycle_total_currency_<商店ID>% | 当前玩家在指定回收商店累计回收货币收入，保留两位小数 |
按当前源码：%malkuth_limit_*%、%malkuth_limit_remaining_*% 与 %malkuth_remaining_*% 都返回同一套剩余限购结果；若该商品未配置任何限购，则返回 999。这三类购买限购变量的参数通过 _ 分段解析，<商店ID> 与 <商品Key> 建议避免使用下划线。拍卖、全球市场和回收统计变量带 5 秒内存缓存，用于计分板这类高频刷新场景。
权限汇总
命令权限
| 权限 | 说明 | 默认 |
|---|---|---|
malkuth.command.give | 使用 /malkuth give 投递邮箱 | OP |
malkuth.command.debug | 切换调试模式 | OP |
malkuth.command.reload | 重载配置 | OP |
malkuth.command.place | 绑定玩家商店方块 | OP |
malkuth.command.random | 随机商品管理 | OP |
malkuth.command.autosell | 自动售卖箱管理命令 | OP |
malkuth.command.recovery | 交易与交付恢复管理命令 | OP |
malkuth.command.auction.upload | 拍卖行指令上架 | 需服主授权 |
malkuth.command.market.upload | 全球市场指令上架 | 需服主授权 |
malkuth.command.request | 全球求购命令入口 | 所有玩家 |
malkuth.command.request.create | 创建全球求购 | 需服主授权 |
malkuth.command.request.submit | 提交全球求购供货 | 需服主授权 |
malkuth.command.request.cancel | 取消全球求购 | 需服主授权 |
malkuth.command.request.approve | 同意全球求购供货 | 需服主授权 |
malkuth.command.request.reject | 拒绝全球求购供货 | 需服主授权 |
malkuth.admin.tax | 税收报表管理命令 | 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.market.renew | 允许玩家续期自己的全球市场挂单 | 需服主授权 |
malkuth.globalrequest.open | 允许打开全球求购商店 | 所有玩家（需服主主动授权时再细分） |
malkuth.globalrequest.my | 允许切换查看自己的求购 | 所有玩家（需服主主动授权时再细分） |
malkuth.globalrequest.create | 允许创建全球求购单 | 所有玩家（需服主主动授权时再细分） |
malkuth.globalrequest.submit | 允许提交供货申请 | 所有玩家（需服主主动授权时再细分） |
malkuth.globalrequest.approve | 允许同意供货申请 | 所有玩家（需服主主动授权时再细分） |
malkuth.globalrequest.reject | 允许拒绝供货申请 | 所有玩家（需服主主动授权时再细分） |
malkuth.globalrequest.cancel | 允许取消自己的求购单 | 所有玩家（需服主主动授权时再细分） |
malkuth.globalrequest.admin | 允许以管理员身份审核/管理他人求购 | OP |
malkuth.globalrequest.admin.cancel | 允许管理员取消他人求购 | OP |
malkuth.autosell.place.<类型> | 允许玩家放置指定类型的自动售卖箱，例如 malkuth.autosell.place.basic | 需服主授权 |
malkuth.autosell.limit.<数量> | 覆盖玩家可放置的自动售卖箱数量上限，例如 malkuth.autosell.limit.5 | 需服主授权 |
malkuth.autosell.admin.open | 允许打开他人的自动售卖箱升级界面 | OP |
malkuth.autosell.admin.break | 允许破坏他人的自动售卖箱 | OP |
使用示例
# 重载配置
/malkuth reload
# 绑定自己第一个已有商品的玩家商店到当前指向的方块
/malkuth place
# 在目标方块上方生成并绑定玩家商店方块
/malkuth place create player_shop
# 预览并编辑当前商店方块全息
/malkuth place holo preview
/malkuth place holo set player_shop
# 切换摆摊实体模型
/malkuth place model merchant player_shop
# 开启调试模式
/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
# 指令上架主手物品到拍卖行，起拍价 1000，一口价 5000，持续 24 小时
/malkuth auction upload auction 1000 5000 24
# 指令上架主手 16 个物品到全球市场，整批价格 8000
/malkuth market upload global_market 8000 16
# 手持样品物品发布求购：单价 50，收 64 个，优先按物品源或相似度匹配
/malkuth request create global_request 50 64 source_or_similar
# 手持匹配物品提交 16 个供货到指定求购单
/malkuth request submit 5d3f1c2e-0000-0000-0000-000000000000 16
# 同意或拒绝指定供货申请
/malkuth request approve 7b6a1c2d-0000-0000-0000-000000000000
/malkuth request reject 7b6a1c2d-0000-0000-0000-000000000000
# 给 Steve 发放 1 个 basic 自动售卖箱
/malkuth autosell give Steve basic 1
# 查看当前已登记的自动售卖箱
/malkuth autosell list
# 查看需要人工处理的恢复记录类型与指定类型记录
/malkuth recovery types
/malkuth recovery list global_request_recovery 20
# 查看并处理一条恢复记录
/malkuth recovery show pending_delivery 5d3f1c2e-0000-0000-0000-000000000000
/malkuth recovery retry pending_delivery 5d3f1c2e-0000-0000-0000-000000000000 admin_retry
# 查看最近 7 天所有全球市场税收汇总
/malkuth tax report all 7 GLOBAL_MARKET
# 查看最近 30 天卖家 Steve 的税收报表
/malkuth tax player Steve 30 all
# 打开名为 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 钻石
# 只查看 Steve 在拍卖行里的拍品，全球市场同样可用
/malshop seller auction Steve
# 将手持物品保存到物品仓库
/malapi item save 我的钻石剑
# 同步物品仓库到数据库
/malapi item sync