WebShopX | Web 驱动的 Minecraft 商城系统（B2C + C2C + 管理后台）

面向 Paper/Spigot 服务器的网页商城插件。 一个系统里同时解决：官方商城、玩家市场与管理后台。

本插件目前正在公测阶段，欢迎进群(636803372)下载或反馈问题。

视频介绍(前往Bilibili)

Wiki(前往Wiki)

提交issues(前往GitHub)

一个面向 Paper/Spigot 的 Web 商店插件。 把 官方商城、玩家市场、钱包系统、订单流转、管理后台 放进同一套体系里。

---

插件定位

WebShopX 当前已经实现：

• 官方商城（B2C）
• 玩家市场（C2C）
• 双货币钱包
• 订单、退款、待领取发货
• Web 管理后台
• Vault 可选对接

它不是一个单纯的网页模板，而是一套已经能跑起来的交易系统。

---

当前已实现功能

玩家端

• 使用 Minecraft 用户名 + 网页密码登录
• 查看钱包余额与最近流水
• 使用兑换码入账
• 双币种互换
• 浏览服务器官方商城并直接下单
• 浏览玩家市场，支持搜索、排序、筛选
• 浏览玩家店铺
• 查看个人订单
• 在可退款条件下申请退款
• 对自己的市场上架进行改价、改备注、暂停、恢复、下架

玩家市场

• 普通上架
• 供货箱上架
• 自动补货
• 市场列表 / 玩家店铺 / 我的上架 三种视图
• 价格、备注、供货参数网页端管理
• 商品材质中文显示
• 附魔属性中文展示

官方商城

• 支持多种商品类型：
  • 指令商品
  • 出售物品
  • 回收物品
  • 药水效果
  • 团购券
• 支持搜索、排序和高级筛选
• 支持库存商品与长期供应商品

管理后台

• 管理员登录
• 商品管理
• 兑换码管理
• 订单查看
• 市场管理
• 用户支持
• 审计日志
• 管理员权限管理
  • SUPER_ADMIN
  • 子级管理员精确权限分配
  • 权限模板一键勾选

经济与兼容

• ShopCoin / GameCoin 双币体系
• 可选接入 Vault
• 管理后台可直接查看 Vault 挂钩状态
• 支持手续费、税率、兑换比例配置

---

功能亮点

1. 官方商城 + 玩家市场统一

不需要再拆成多个插件分别维护。 官方商品、玩家交易、订单流转、钱包结算走同一套逻辑。

2. 真正可用的后台

不是只给一个配置文件。

当前后台已经可以处理：

• 商品（上架、编辑、下架、修改）
• 兑换码（生成）
• 团购码（生成、核销）
• 用户管理
• 订单管理
• 市场
• 审计
• 下发子级管理员权限

3. 适合中文服

• 中文界面
• 中文材质名
• 中文附魔显示
• 面向玩家的网页操作体验

4. 可渐进扩展

当前版本已经能直接使用。 后续也方便继续扩展：

• 更复杂的交易系统
• 玩家求购
• 拍卖行
• 更多后台权限能力

---

运行环境

• Java 21
• Paper / Spigot
• MariaDB / MySQL
• Vault 可选

推荐：

• Paper 1.20.6+

---

安装方式

1. 将插件放入 plugins/
2. 启动服务器生成配置
3. 配置数据库
4. 重启服务器
5. 打开网页端

默认页面：

• 玩家端：http://你的地址:8819/
• 管理端：http://你的地址:8819/admin.html

---

指令与权限

主指令：

• /webshopx
• /ws

当前主要权限：

• webshop.use
• webshop.admin
• webshop.market.limit.<数字>

---

适合哪些服务器

• 生存服
• 综合服
• 带网页商店需求的商业服
• 想把游戏内交易搬到网页端的服务器

本插件目前正在公测阶段，欢迎进群(636803372)下载或反馈问题。

截图