- 版权类型
- 原创
- 插件中文名称
- 网页商店
- 插件英文名称
- WebOmniMarket
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- Folia
- Purpur
- Leaves
- 其他核心
- 语言支持
- 中文（简体）
- 前置组件
- Vaul 必须
PlayerPoints 可选
Geyser + Floodgate 可选
- 适配版本（Java）
- 最新版本
- 26.x
- 1.21
插件将响应式网页、Java 版箱子 GUI 与基岩版 Cumulus 原生表单整合到同一套市场系统中，覆盖官方出售与回收、玩家市场、求购订单、代理竞拍、资金托管、跨服同步、账号安全、交易风控和运营管理等场景。
看到别的网页商城卖太贵了，于是把自用的商城进行多核心兼容进行出售
无论是单服生存服务器，还是由多个子服组成的群组服，都可以通过 WebOmniMarket 建立统一、安全且便于管理的交易中心。
网页采用响应式设计，可自动适配电脑与手机浏览器。玩家能够在网页中浏览商品、购买物品、管理订单、查看背包、参与拍卖以及提交售后申诉。
数据库读写、文件处理、网络通知、过期商品处理和拍卖结算均在后台执行。网页服务使用固定工作线程池，背包快照会自动合并高频保存事件，降低市场系统对游戏线程的影响。
群组服可以让所有子服连接同一个 MySQL/MariaDB，并为每个子服设置独立的 server-id，从而共享商城、订单、账户和交易数据。
商品同时支持两种交易范围：
参与拍卖时采用代理竞价机制，玩家只需设置自己的最高承受价格，系统将根据“第二高代理价加最小加价”自动计算当前价格。
拍卖还支持：
跨服离线上架使用：
金币收入可根据以下条件计算风险分：
每件官方出售商品都可以独立设置：
绑定后的玩家可以查看：
后台支持：
默认仅服务器 OP 拥有。
看到别的网页商城卖太贵了，于是把自用的商城进行多核心兼容进行出售
无论是单服生存服务器，还是由多个子服组成的群组服，都可以通过 WebOmniMarket 建立统一、安全且便于管理的交易中心。
核心技术亮点
1. Java、基岩与网页三端互通
Java 版玩家可以通过箱子 GUI 使用市场；安装 Geyser/Floodgate 后，基岩版玩家将优先使用 Cumulus 原生表单。网页采用响应式设计，可自动适配电脑与手机浏览器。玩家能够在网页中浏览商品、购买物品、管理订单、查看背包、参与拍卖以及提交售后申诉。
2. 面向 Paper与Folia 的异步架构
插件面向 Minecraft 1.21+ 多核心兼容开发。数据库读写、文件处理、网络通知、过期商品处理和拍卖结算均在后台执行。网页服务使用固定工作线程池，背包快照会自动合并高频保存事件，降低市场系统对游戏线程的影响。
3. 单服与群组服双模式
单服可以直接使用默认 SQLite，无需额外安装数据库。群组服可以让所有子服连接同一个 MySQL/MariaDB，并为每个子服设置独立的 server-id，从而共享商城、订单、账户和交易数据。
商品同时支持两种交易范围：
- 当前服：仅允许当前子服玩家查看和交易
- 全服：允许所有连接同一数据库的子服玩家交易
4. 完整 NBT 匹配与批量扣物
市场物品使用 Bukkit 字节序列化保存完整数据，包括：- 名称与 Lore
- 附魔、药水和耐久
- CustomModelData
- 自定义资源标识
- 潜影盒、收纳袋等容器内容
- 其它物品元数据
5. 资金托管与代理竞拍
创建收购单时，系统会立即冻结完整收购预算。参与拍卖时采用代理竞价机制，玩家只需设置自己的最高承受价格，系统将根据“第二高代理价加最小加价”自动计算当前价格。
拍卖还支持：
- 代理出价差额冻结
- 流拍与撤销自动退款
- 成交后自动结算
- 最小加价配置
- 结束前出价自动延时
- 防狙击最大延长次数
6. 跨服背包防复制保护
网页登录后可读取已绑定玩家的背包和末影箱快照，并直接从网页上架物品。跨服离线上架使用：
- 玩家在线状态心跳
- 权威背包快照
- 快照版本验证
- 分布式背包锁
- 数据库事务写回
7. 交易风控与安全结算
玩家出售、官方回收、收购交付和拍卖收入会进入统一结算系统。金币收入可根据以下条件计算风险分：
- 单笔结算金额
- 一小时内交易次数
- 最近24小时累计收入
- 网页账户注册时间
- 风控数据库读取状态
核心功能
- 响应式电脑与手机网页
- Java 版箱子 GUI
- Geyser/Floodgate 基岩版原生表单
- 官方商品出售
- 官方物品回收
- 玩家一口价市场
- 玩家求购订单
- 背包扫描与 NBT 匹配交付
- 代理竞价拍卖
- 拍卖防狙击延时
- Vault 金币支持
- PlayerPoints 点券支持
- 当前服与全服交易范围
- 玩家上架全服公告
- 公告点击快速购买
- 网页购物车
- 商品收藏与目标价格
- 降价、成交和售后提醒
- 商城站内通知
- 商城物品邮箱
- 历史价格曲线
- 订单申诉系统
- 管理员退款与补发
- 交易审计与 CSV 报表
- 经济趋势与通胀报表
- QQ OneBot 通知
- 通用 Webhook 通知
- HMAC-SHA256 Webhook 签名
- 自动数据库备份
- SQLite/MySQL 数据迁移与恢复
官方商城管理
管理员可以分别创建官方出售与官方回收商品。每件官方出售商品都可以独立设置：
- 商品库存，-1 表示无限
- 商品单价
- 金币或点券
- 个人每日限购
- 全服每日限购
- 当前服或全服范围
- 回收单价
- 个人每日回收限额
- 金币或点券
- 当前服或全服范围
网页账户系统
玩家可以直接在游戏内注册网页账户并绑定当前角色，也可以先在网页注册，再通过临时绑定码完成关联。绑定后的玩家可以查看：
- 自己的背包
- 自己的末影箱
- 上架商品
- 收购订单
- 拍卖与出价记录
- 商城邮箱
- 购物车与收藏
- 历史订单
- 站内通知
- 售后申诉
管理员网页后台
只有列入 security.admin-emails 的账户登录后，才会显示管理员后台入口。后台支持：
- 市场数据汇总
- 最近订单查询
- 管理操作审计
- 玩家封禁与解封
- 商品强制下架
- 官方商品编辑
- 风控款项批准与拒绝
- 平台退款
- 原订单物品补发
- 玩家申诉处理
- 历史价格趋势
- 经济与通胀报表
- CSV 数据导出
- 手动创建备份
- 查看数据库备份
权限节点
webomnimarket.admin默认仅服务器 OP 拥有。
JSON：
玩家指令
/mk
打开 Java 版商城 GUI 或基岩版原生商城表单。
/mklist <数量> <单价> [金币|点券] [当前服|全服]
将主手物品上架至玩家市场。
/mkrequest <数量> <单价> [金币|点券] [当前服|全服]
以主手物品为完整 NBT 样品创建收购单。
/mkfulfill
打开收购交付菜单，自动扫描背包内符合条件的物品。
/mkauction <数量> <起拍价> [金币|点券] [当前服|全服]
创建带资金托管和防狙击机制的代理竞价拍卖。
/mkbuy <商品编号>
打开指定商品的购买数量菜单，可选择一半、全部或自定义数量。
/mkcancel <编号>
撤销自己的上架商品或收购订单。
/mkregister <邮箱> <密码> [用户名]
在游戏内注册并自动绑定网页账户。
/mkbind
生成网页账户临时绑定码。
货币参数可以省略后直接填写范围，例如：
/mklist 128 5 全服
管理员指令
/mkadmin
打开游戏内官方商城管理菜单。
/mkadmin add <材质> <库存|-1> <单价> <个人日限> <全服日限> [金币|点券] [当前服|全服]
创建官方出售商品。
/mkadmin recycle <材质> <单价> <个人日限额> [金币|点券] [当前服|全服]
创建官方回收商品。
/mk reload
热重载普通配置。数据库连接、网页端口等关键设置建议重启服务器生效。
/mk backup
立即创建数据库备份。
/mk backups
查看最近生成的备份文件。
/mk restore <备份文件> CONFIRM
通过指定备份恢复商城数据，仅允许控制台执行。
