WebShopX

Web-based Minecraft Marketplace (B2C + C2C + Admin Dashboard)

123

Quick challenge

How far can you run before the mobs catch you?

WebShopX

We also support English—please scroll down.

WebShopX：Web 驱动的 Minecraft 商城与交易系统

> 这不是网页模板，而是一套可运行的交易系统。 > 官方商城（B2C）+ 玩家市场（C2C）+ 拍卖行 + 订单履约 + 管理后台，一体化落地。

快捷导航 (可点击)

Open

环境要求

- Java 17+ - Paper 1.18.2+ 或 Folia 1.19.4+ - SQLite（无需额外配置）或 MariaDB / MySQL - Vault（可选） - 支持群组服 - Language：zh-CN / en-US

核心闭环

- 玩家网页登录与会话 - 钱包、流水、双币兑换 - 官方商品下单、发货、退款 - 玩家市场上架、购买、竞拍、结算 - 发货失败兜底（待领取命令 + 邮箱补偿） - 后台运营与审计治理

---

你能得到什么

| 模块 | 已实现能力 | |---|---| | 官方商城 | 出售物品、回收商品、命令、药水效果、兑换码五大类型商品 | | 动态定价 | 官方商品支持动态定价与需求热度衰减（多算法） | | 玩家市场 | 普通上架、供货箱上架、自动补货、改价、备注、暂停/恢复/下架 | | 拍卖模式 | 英式、荷兰式、维克里、烛台拍卖；支持竞价、反狙击延时、到期结算 | | 履约兜底 | 自动发货失败后可 /ws claim，且支持 mailbox 补偿领取 | | 通知体系 | 站内通知列表、未读计数、已读标记、后台全服公告 | | 管理后台 | 商品/订单/兑换码/市场/经济参数/用户支持/管理员管理/审计日志 |

---

玩家端能力

- Minecraft 用户名 + 网页密码登录 - 查看钱包余额与账变流水 - 兑换码入账 - ShopCoin / GameCoin 双向兑换 - 浏览官方商城并下单 - 浏览市场与店铺，支持搜索、筛选、排序 - 市场购买与拍卖出价（按商品交易模式） - 查看订单并在规则内申请退款 - 领取待发货内容

---

玩家市场与拍卖

交易模式

| 拍卖模式 (AUCTION) | 拍卖模式 (AUCTION) | 拍卖模式 (AUCTION) | | ---------------------- | ------------------------------------------------------------ | -------------------------------- | | 拍卖模式 (AUCTION) | 卖家设定固定价格，买家支付后立即成交。支持库存自动补货。 | 常规材料、消耗品、量产装备。 | | 拍卖模式 (AUCTION) | 卖家设定起拍价，在规定时间内由买家竞价，最终根据算法决定归属。 | 极品武器、稀有收藏品、地皮转让。 |

拍卖算法

| 蜡烛拍卖 | 蜡烛拍卖 | 蜡烛拍卖 | 蜡烛拍卖 | | ------------ | -------------- | ------------------------------------------------------------ | -------------------------------- | | `ENGLISH` | 蜡烛拍卖 | 价格由低往高喊，出价最高者获胜。支持反狙击延时（有人最后出价则自动延长）。 | 最符合直觉，互动性最强。 | | `DUTCH` | 蜡烛拍卖 | 价格由高往低随时间自动下降，第一个确认购买的买家即成交。 | 速度快，适合想快速出手的卖家。 | | `VICKREY` | 蜡烛拍卖 | 密封投标（互相看不到出价），最高出价者获胜，但支付的是蜡烛拍卖的价格。 | 鼓励买家出示心中真实的最高价。 | | `CANDLE` | 蜡烛拍卖 | 英式拍卖的变种，拍卖结束时间在最后阶段随机。 | 防止玩家在最后一秒恶意压秒出价。 |

市场特性

- 供货箱库存自动补货 - 市场广播 - 周期性市场结算任务 - 卖家成交日志查询

---

官方商城能力

- 商品类型：

| 团购/兑换码 | 团购/兑换码 | 团购/兑换码 | | ----------------------- | --------------- | ------------------------------------------ | | 团购/兑换码 | 团购/兑换码 | 购买后由控制台或以玩家身份执行预设指令。 | | 团购/兑换码 | 团购/兑换码 | 系统直接生成物理道具并放入玩家背包。 | | 团购/兑换码 | 团购/兑换码 | 购买后为玩家施加特定的药水效果。 | | 团购/兑换码 | 团购/兑换码 | 系统以特定价格回收玩家特定物品。 | | 团购/兑换码 | 团购/兑换码 | 交付特定的序列号或兑换凭证，支持群体核销。 | - 商品支持发布/下架时间窗 - 可配置库存、个人限购 - 回收与实物商品可启用动态定价

---

履约、退款与兜底

- 订单状态覆盖退款、退款、退款到退款等流程 - 支持订单退款与退款策略配置 - 可选开启未发放前可退款 - 团购券支持核销状态管理与退款联动 - 自动发货失败时可通过命令领取或邮箱补偿

---

管理后台

- 管理员鉴权与会话 - 商品管理、上下架、限购重置 - 兑换码创建与列表 - 团购券核销 - 订单查询 - 经济参数管理（汇率、市场税费/手续费） - 市场管理与强制下架 - 用户支持：查用户、重置密码、解绑、强制下线、钱包调整 - 全服系统公告 - 管理员账号与权限模板管理 - 审计日志查询

内置角色模板

| 审计员 | 审计员 | 审计员 | | ------------------ | -------------- | ------------------------------------------------------------ | | `SUPER_ADMIN` | 审计员 | 拥有系统最高权限，可管理所有后台模块、配置参数及管理员账号。 | | `SHOP_ADMIN` | 审计员 | 负责官方商城（B2C）的运营，包括商品上下架、限购设置、兑换码生成等。 | | `MARKET_MODERATOR` | 审计员 | 负责玩家市场（C2C）的治理，有权强制下架违规商品或监控拍卖行为。 | | `SUPPORT_ADMIN` | 审计员 | 负责用户支持工作，如查询玩家信息、重置密码、手动调整钱包余额等。 | | `AUDITOR` | 审计员 | 仅拥有查看和导出权限，负责审计全局日志、交易流水及管理员操作记录。 |

---

命令（游戏内）

| 命令 | 说明 | |---|---| | /webshopx help | 帮助 | | /webshopx password <新密码> | 设置/重置网页登录密码 | | /webshopx market [gui] | 打开市场 GUI | | /webshopx market sell <price> [amount] [currency] | 兼容式快速上架 | | /webshopx market logs [count] | 查看卖家近期成交日志 | | /webshopx claim [all|ODR-...|MKT-...|CLM-...|MCL-...] | 领取待发货内容 | | /webshopx mailbox claim | 领取邮箱待补偿物品 | | /webshopx redeem create <shop> <game> [max] [perUserMax] [minutes] [code] | 创建兑换码（管理员） | | /webshopx reload | 重载配置与网页资源（管理员） |

别名：/ws

---

快速开始

请前往 Wiki 查看文字教程，或点击查看视频教程。

---

反馈与支持

- 视频介绍：https://www.bilibili.com/video/BV16zdZBTEbV/ - 配置教程：https://www.bilibili.com/video/BV18eoSBaEPY/ - Wiki：https://github.com/Cc-Cece/WebShopX-Issues/wiki - Issues：https://github.com/Cc-Cece/WebShopX-Issues/issues - 公测交流群（QQ）：636803372

WebShopX 正在持续迭代，欢迎提出功能建议与真实运营场景反馈。

---

WebShopX: Web-Driven Minecraft Store & Trading System

> This is not a web template, but a fully functional trading system. > Official Store (B2C) + Player Market (C2C) + Auction House + Order Fulfillment + Admin Dashboard, all in one.

Quick Navigation (Clickable)

Open

Requirements

- Java 21 - Paper 1.20.6+ (Spigot compatible) - MariaDB / MySQL - Vault (Optional) - BungeeCord/Velocity proxy support - Built-in languages: zh-CN / en-US

Core Loop

- Player web login & session management - Wallet, transaction history, dual-currency exchange - Official store ordering, delivery, and refunds - Player market listing, purchasing, bidding, and settlement - Delivery failure fallback (claim command + mailbox compensation) - Backend operations and audit governance

---

What You Get

| Module | Implemented Capabilities | |---|---| | Official Store | 5 commodity types: Sell items, Recycle items, Commands, Potion effects, Redeem codes | | Dynamic Pricing | Official products support dynamic pricing and demand decay (multiple algorithms) | | Player Market | Standard listing, Shulker box listing, Auto-restock, Price editing, Notes, Pause/Resume/Unlist | | Auction Mode | English, Dutch, Vickrey, Candle auctions; supports bidding, anti-sniper delay, expiry settlement | | Fulfillment Fallback | Auto-delivery failure allows `/ws claim`, and supports mailbox compensation claim | | Notification System | In-site notification list, Unread count, Mark as read, Global backend announcements | | Admin Dashboard | Products / Orders / Redeem codes / Market / Economy params / User support / Admin management / Audit logs |

---

Player Features

- Minecraft Username + Web Password login - View wallet balance and transaction history - Redeem codes - ShopCoin / GameCoin bidirectional exchange - Browse official store and place orders - Browse market and shops, supports searching, filtering, and sorting - Market purchasing and auction bidding (based on trading mode) - View orders and apply for refunds within rules - Claim pending deliveries

---

Player Market & Auctions

Trading Modes

| Auction Mode (AUCTION) | Auction Mode (AUCTION) | Auction Mode (AUCTION) | | ---------------------- | ------------------------------------------------------------ | -------------------------------- | | Auction Mode (AUCTION) | Seller sets a fixed price, buyer pays and receives it instantly. Supports auto-restock. | Common materials, consumables, mass-produced gear. | | Auction Mode (AUCTION) | Seller sets a starting price, buyers bid within a time limit, algorithm decides winner. | Top-tier weapons, rare collectibles, plot transfers. |

Auction Algorithms

| Candle Auction | Candle Auction | Candle Auction | Candle Auction | | ------------ | -------------- | ------------------------------------------------------------ | -------------------------------- | | `ENGLISH` | Candle Auction | Price goes up, highest bidder wins. Supports anti-sniper delay. | Most intuitive, highly interactive. | | `DUTCH` | Candle Auction | Price drops automatically over time, first buyer to confirm wins. | Fast-paced, suitable for quick sales. | | `VICKREY` | Candle Auction | Sealed-bid (blind), highest bidder wins but pays the Candle Auction price. | Encourages buyers to bid their true maximum value. | | `CANDLE` | Candle Auction | Variation of English auction, end time is randomized in the final stage. | Prevents malicious last-second sniping. |

Market Features

- Shulker box inventory auto-restock - Market broadcasts - Periodic market settlement tasks - Seller transaction log queries

---

Official Store Features

- Product Types:

| Group Buy/Voucher | Group Buy/Voucher | Group Buy/Voucher | | ----------------------- | --------------- | ------------------------------------------ | | Group Buy/Voucher | Group Buy/Voucher | Executes a preset command via console or player after purchase. | | Group Buy/Voucher | Group Buy/Voucher | System generates physical items and puts them in player's inventory. | | Group Buy/Voucher | Group Buy/Voucher | Applies specific potion effects to the player after purchase. | | Group Buy/Voucher | Group Buy/Voucher | System recycles specific player items at a set price. | | Group Buy/Voucher | Group Buy/Voucher| Delivers specific serials or vouchers, supports group verification. | - Products support publish/unlist time windows - Configurable stock and personal purchase limits - Recycle and physical items can enable dynamic pricing

---

Fulfillment, Refunds & Fallbacks

- Order status covers Refund, Refund, Refund, and Refund - Supports order Refund and Refund policy configuration - Optional toggle for refunds before delivery - Group buy vouchers support verification status management linked with refunds - Auto-delivery failure can be claimed via command or mailbox compensation

---

Admin Dashboard

- Admin authentication & session management - Product management, listing/unlisting, limit resets - Redeem code creation and list - Group buy voucher verification - Order queries - Economy parameter management (Exchange rates, Market taxes/fees) - Market management and forced unlisting - User support: Query users, reset passwords, unbind, kick offline, adjust wallets - Global system announcements - Admin accounts & permission template management - Audit log queries

Built-in Role Templates

| Auditor | Auditor | Auditor | | ------------------ | -------------- | ------------------------------------------------------------ | | `SUPER_ADMIN` | Auditor | Highest system authority, manages all modules, configs, and admin accounts. | | `SHOP_ADMIN` | Auditor | Manages official store (B2C) operations, including products, limits, and codes. | | `MARKET_MODERATOR` | Auditor | Manages player market (C2C), can force-unlist items or monitor auctions. | | `SUPPORT_ADMIN` | Auditor | Handles user support, user queries, password resets, and manual wallet adjustments. | | `AUDITOR` | Auditor | View and export permissions only, audits global logs, transactions, and admin actions. |

---

Commands (In-Game)

| Command | Description | |---|---| | /webshopx help | Help menu | | /webshopx password <new_password> | Set/Reset web login password | | /webshopx market [gui] | Open market GUI | | /webshopx market sell <price> [amount] [currency] | Compatible quick listing | | /webshopx market logs [count] | View seller's recent transaction logs | | /webshopx claim [all|ODR-...|MKT-...|CLM-...|MCL-...] | Claim pending deliveries | | /webshopx mailbox claim | Claim mailbox compensation items | | /webshopx redeem create <shop> <game> [max] [perUserMax] [minutes] [code] | Create redeem code (Admin) | | /webshopx reload | Reload config and web resources (Admin) |

Alias: /ws

---

Quick Start

Please check the Wiki for written tutorials, or click to watch the Video Tutorial.

---

Feedback & Support

- Video Intro: https://www.bilibili.com/video/BV16zdZBTEbV/ - Setup Tutorial: https://www.bilibili.com/video/BV18eoSBaEPY/ - Wiki: https://docs.akihito.dpdns.org/ - Issues: https://github.com/Cc-Cece/WebShopX-Issues/issues - Open Beta Group (QQ): 636803372

WebShopX is continuously iterating. Feature suggestions and real-world operational feedback are welcome.