概览
Market 市场系统功能概览
Market 全球市场
模块简介
Market 是 Suite 的核心经济交易模块,提供 拍卖行、玩家商店、系统商店、回收商店 四合一交易系统。模块通过 ArcartX UI(Aria)实现全图形化交互,支持多货币、跨服同步、动态价格策略等高级功能。
如果你只需要系统商店,可以前往 ArcartX 官方购买官方付费插件 SystemShop。
| 属性 | 值 |
|---|---|
| 模块 ID | market |
| 版本 | 1.4.4 |
| 主类 | xuanmo.arcartxsuite.market.MarketModule |
| 配置文件 | config.yml |
| 消息文件 | messages.yml |
| 外部依赖 | PlaceholderAPI(必需,缺失时模块跳过加载) |
| 模块依赖 | 无(本体内置 API 即可运行) |
功能特性
| 特性 | 说明 |
|---|---|
| 拍卖行 | 玩家间纯竞价交易,支持分类筛选、拼音搜索、竞价加价规则、手续费与税率 |
| 玩家商店 | 玩家以固定价格上架物品,其他玩家直接购买(无竞价),支持卖家浏览 |
| 系统商店 | 管理员通过 YAML 文件定义商店,支持多物品来源(原版/MythicMobs/NeigeItems/Overture/MMOItems) |
| 回收商店 | 玩家将物品出售给系统,支持自动回收(拾取触发)和一键批量回收 |
| 多货币支持 | 拍卖行、玩家商店、回收商店均支持多货币,货币 ID 由 CurrencyBridgeAPI 统一管理 |
| 跨服同步 | Redis 缓存 + 跨服事件同步,多服架构下拍卖列表、限购记录、动态商品实时同步 |
| 动态价格 | 系统商店支持三种动态策略:价格浮动、随机刷新(神秘商人)、定时换货 |
| VIP 税率减免 | 按权限节点配置不同税率减免,离线玩家通过 LuckPerms 查询权限 |
| 回收价格倍率 | 按权限组设置回收价格加成(如 VIP 1.2 倍、MVP 1.5 倍) |
| 物品黑名单 | 按材质/物品库 ID/名称/Lore/NBT 键拦截不可交易物品 |
| 分类系统 | 按 NBT/PDC 路径自动分类拍卖行物品,支持自定义分类与优先级 |
| 到期退回 | 到期未售物品通过邮件系统或背包退回,支持安全发放(离线不丢) |
| 交易历史 | 记录所有交易历史(购买/售出/竞价/到期/取消),可通过 UI 查看 |
| 待发放队列 | 竞拍成功和到期退回的物品/货币进入待发放队列,玩家上线自动补发 |
| 指令商品 | 系统商店支持指令商品类型,购买后由控制台执行奖励命令 |
| 限购系统 | 系统商店支持每日/每周/每月/终身限购,跨服同步限购记录 |
| 库存系统 | 系统商店支持无限/全服共享/玩家独立三种库存模式 |
| 折扣系统 | 系统商店按权限节点配置购买折扣,取最低折扣值 |
依赖
| 依赖类型 | 名称 | 必需 | 说明 |
|---|---|---|---|
| 模块依赖 | 无 | - | Market 不依赖其他模块即可运行 |
| 外部依赖 | PlaceholderAPI | 是 | 注册 %axsmarket_xxx% 占位符;external-depends 硬依赖,未安装时模块不加载 |
| 外部软依赖 | MythicMobs | 否 | 提供 MythicMobs 物品来源 |
| 外部软依赖 | NeigeItems | 否 | 提供 NeigeItems 物品来源 |
| 外部软依赖 | Overture | 否 | 提供 Overture 物品来源(含原生序列化) |
| 外部软依赖 | MMOItems | 否 | 提供 MMOItems 物品来源 |
| 外部软依赖 | LuckPerms | 否 | 离线玩家税率减免权限查询 |
| 宿主能力 | MailDispatchable | 否 | 到期物品通过邮件退回(需 Mail 模块) |
| 宿主能力 | EventBusCapability | 否 | 发布交易事件供其他模块监听 |
| 宿主能力 | SignalDispatchable | 否 | 上架成功后派发信号 |
| 宿主配置 | Redis | 否 | 拍卖列表缓存,减轻数据库压力 |
| 宿主配置 | CrossServer | 否 | 跨服数据同步(Redis + Proxy 双后端) |
市场类型详解
Market 模块包含四种不同的交易子系统,各自适用场景不同:
拍卖行 vs 玩家商店
| 对比项 | 拍卖行 | 玩家商店 |
|---|---|---|
| 交易方式 | 竞价(价高者得) | 固定价格直接购买 |
| 价格机制 | 起拍价 + 竞价加价规则 | 固定价格 |
| 上架时长 | 1 小时 ~ 7 天 | 1 小时 ~ 30 天 |
| 默认时长 | 24 小时 | 7 天 |
| 每人上架上限 | 10 件 | 20 件 |
| 手续费 | 上架费(固定金额) | 上架费(固定金额) |
| 税率 | 成交价 5%(可配置 VIP 减免) | 成交价 5%(可配置 VIP 减免) |
| 到期处理 | 有人竞价→成交结算;无人竞价→退回物品 | 到期→退回物品 |
| 数据库表 | axs_market_listings | axs_market_player_shop_listings |
| UI ID | AXS:market_auction | AXS:market_player_shop |
系统商店 vs 回收商店
| 对比项 | 系统商店 | 回收商店 |
|---|---|---|
| 交易方向 | 玩家从系统购买 | 玩家向系统出售 |
| 商品来源 | 管理员 YAML 定义 | 管理员 YAML 定义回收表 |
| 物品来源 | 原版/MythicMobs/NeigeItems/Overture/MMOItems | 同左(用于匹配回收物品) |
| 价格 | 固定价格(支持折扣) | 固定价格(支持倍率加成) |
| 库存 | 无限/全服共享/玩家独立 | 无库存概念 |
| 限购 | 支持(日/周/月/终身) | 无 |
| 特殊功能 | 指令商品、动态价格策略 | 自动回收、批量回收 |
| 配置目录 | shops/*.yml | recycle/*.yml |