We also support English—please scroll down. ## WebShopX：Web 驱动的 Minecraft 商城与交易系统 >Join our **Discord Server**: [![Discord](https://img.shields.io/badge/Discord-Join_Server-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/4mSg4VyxBN) ![Minecraft](https://img.shields.io/badge/Minecraft-1.20.6%2B-2e7d32?style=for-the-badge&logo=minecraft&logoColor=white) ![Java](https://img.shields.io/badge/Java-21-1565c0?style=for-the-badge&logo=openjdk&logoColor=white) ![Paper/Spigot](https://img.shields.io/badge/Paper%20%2F%20Spigot-Supported-ef6c00?style=for-the-badge) ![B2C+C2C](https://img.shields.io/badge/Commerce-B2C%20%2B%20C2C-00695c?style=for-the-badge) ![Auction](https://img.shields.io/badge/Auction-Enabled-8e24aa?style=for-the-badge) > 这不是网页模板，而是一套可运行的交易系统。 > 官方商城（B2C）+ 玩家市场（C2C）+ 拍卖行 + 订单履约 + 管理后台，一体化落地。 ### 快捷导航 (可点击) [![](https://img.shields.io/badge/视频介绍-Bilibili-fb7299?style=for-the-badge&logo=bilibili&logoColor=white)](https://www.bilibili.com/video/BV16zdZBTEbV/) [![](https://img.shields.io/badge/配置教程-Bilibili-fb7299?style=for-the-badge&logo=bilibili&logoColor=white)](https://www.bilibili.com/video/BV18eoSBaEPY/) [![](https://img.shields.io/badge/官方Wiki-Docusaurus-34d058?style=for-the-badge&logo=docusaurus&logoColor=white)](https://docs.akihito.dpdns.org/category/webshopx) [![](https://img.shields.io/badge/问题反馈-GitHub-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/Cc-Cece/WebShopX-Issues/issues) [![](https://img.shields.io/badge/交流群-QQ-12B7F5?style=for-the-badge&logo=tencent-qq&logoColor=white)](https://qun.qq.com/universal-share/share?ac=1&authKey=EMHvFOsEqOBnEQi%2FJZtN%2BFwamTisdy0A02IwhRsxJG8t9GWK4uKs2G4CgZpT3yHW&busi_data=eyJncm91cENvZGUiOiI2MzY4MDMzNzIiLCJ0b2tlbiI6ImlpV3lHR3BFT3NvdWxUYysrSnFBN3lSWGRGU1BlTmF4a3FJSnNXeFBNZkI0emZRVDUxdCszbzdEc1NzUlNDTS8iLCJ1aW4iOiI5NTg2MzAxNDYifQ%3D%3D&data=8nepSQv0_dZIm_ZCWW-lPMXP8xlcFXyNWUolkq1DvckJaLbB0JYLVwmuOfmH0Z7mKXGgRx6yhwpi9bjWCvi66Q&svctype=4&tempid=h5_group_info) [![Discord](https://img.shields.io/badge/Discord-Join_Server-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/4mSg4VyxBN) ### 环境要求 - 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 双向兑换 - 浏览官方商城并下单 - 浏览市场与店铺，支持搜索、筛选、排序 - 市场购买与拍卖出价（按商品交易模式） - 查看订单并在规则内申请退款 - 领取待发货内容 --- ## 玩家市场与拍卖 ### 交易模式 | **模式** | **核心说明** | **适用场景** | | ---------------------- | ------------------------------------------------------------ | -------------------------------- | | **直接购买 (DIRECT)** | 卖家设定固定价格，买家支付后立即成交。支持库存自动补货。 | 常规材料、消耗品、量产装备。 | | **拍卖模式 (AUCTION)** | 卖家设定起拍价，在规定时间内由买家竞价，最终根据算法决定归属。 | 极品武器、稀有收藏品、地皮转让。 | ### 拍卖算法 | **算法标识** | **简称** | **逻辑简述** | **特点** | | ------------ | -------------- | ------------------------------------------------------------ | -------------------------------- | | `ENGLISH` | **英式拍卖** | 价格由低往高喊，出价最高者获胜。支持反狙击延时（有人最后出价则自动延长）。 | 最符合直觉，互动性最强。 | | `DUTCH` | **荷兰式拍卖** | 价格由高往低随时间自动下降，第一个确认购买的买家即成交。 | 速度快，适合想快速出手的卖家。 | | `VICKREY` | **维克里拍卖** | 密封投标（互相看不到出价），最高出价者获胜，但支付的是**第二高**的价格。 | 鼓励买家出示心中真实的最高价。 | | `CANDLE` | **蜡烛拍卖** | 英式拍卖的变种，拍卖结束时间在最后阶段随机。 | 防止玩家在最后一秒恶意压秒出价。 | ### 市场特性 - 供货箱库存自动补货 - 市场广播 - 周期性市场结算任务 - 卖家成交日志查询 --- ## 官方商城能力 - 商品类型： | **类型标识** | **中文名称** | **功能描述** | | ----------------------- | --------------- | ------------------------------------------ | | **`COMMAND`** | **指令执行** | 购买后由控制台或以玩家身份执行预设指令。 | | **`GIVE_ITEM`** | **物品发放** | 系统直接生成物理道具并放入玩家背包。 | | **`POTION_EFFECT`** | **药水效果** | 购买后为玩家施加特定的药水效果。 | | **`RECYCLE_ITEM`** | **回收/兑换** | 系统以特定价格回收玩家特定物品。 | | **`GROUP_BUY_VOUCHER`** | **团购/兑换码** | 交付特定的序列号或兑换凭证，支持群体核销。 | - 商品支持发布/下架时间窗 - 可配置库存、个人限购 - 回收与实物商品可启用动态定价 --- ## 履约、退款与兜底 - 订单状态覆盖 **订单挂起**、**待领**、**完成**到**退款** 等流程 - 支持订单**冷静期**与**退款**策略配置 - 可选开启未发放前可退款 - 团购券支持核销状态管理与退款联动 - 自动发货失败时可通过命令领取或邮箱补偿 --- ## 管理后台 - 管理员鉴权与会话 - 商品管理、上下架、限购重置 - 兑换码创建与列表 - 团购券核销 - 订单查询 - 经济参数管理（汇率、市场税费/手续费） - 市场管理与强制下架 - 用户支持：查用户、重置密码、解绑、强制下线、钱包调整 - 全服系统公告 - 管理员账号与权限模板管理 - 审计日志查询 ### 内置角色模板 | **角色标识** | **中文名称** | **核心职能定位** | | ------------------ | -------------- | ------------------------------------------------------------ | | `SUPER_ADMIN` | **超级管理员** | 拥有系统最高权限，可管理所有后台模块、配置参数及管理员账号。 | | `SHOP_ADMIN` | **商城管理员** | 负责官方商城（B2C）的运营，包括商品上下架、限购设置、兑换码生成等。 | | `MARKET_MODERATOR` | **市场监管员** | 负责玩家市场（C2C）的治理，有权强制下架违规商品或监控拍卖行为。 | | `SUPPORT_ADMIN` | **客服管理员** | 负责用户支持工作，如查询玩家信息、重置密码、手动调整钱包余额等。 | | `AUDITOR` | **审计员** | 仅拥有查看和导出权限，负责审计全局日志、交易流水及管理员操作记录。 | --- ## 命令（游戏内） | 命令 | 说明 | |---|---| | /webshopx help | 帮助 | | /webshopx password <新密码> | 设置/重置网页登录密码 | | /webshopx market [gui] | 打开市场 GUI | | /webshopx market sell [amount] [currency] | 兼容式快速上架 | | /webshopx market logs [count] | 查看卖家近期成交日志 | | /webshopx claim [all\|ODR-...\|MKT-...\|CLM-...\|MCL-...] | 领取待发货内容 | | /webshopx mailbox claim | 领取邮箱待补偿物品 | | /webshopx redeem create [max] [perUserMax] [minutes] [code] | 创建兑换码（管理员） | | /webshopx reload | 重载配置与网页资源（管理员） | 别名：/ws --- ## 快速开始请前往 [Wiki](https://docs.akihito.dpdns.org/category/webshopx) 查看文字教程，或点击查看 [视频教程](https://www.bilibili.com/video/BV18eoSBaEPY/) 。 --- ## 反馈与支持 - 视频介绍：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](https://qun.qq.com/universal-share/share?ac=1&authKey=EMHvFOsEqOBnEQi%2FJZtN%2BFwamTisdy0A02IwhRsxJG8t9GWK4uKs2G4CgZpT3yHW&busi_data=eyJncm91cENvZGUiOiI2MzY4MDMzNzIiLCJ0b2tlbiI6ImlpV3lHR3BFT3NvdWxUYysrSnFBN3lSWGRGU1BlTmF4a3FJSnNXeFBNZkI0emZRVDUxdCszbzdEc1NzUlNDTS8iLCJ1aW4iOiI5NTg2MzAxNDYifQ%3D%3D&data=8nepSQv0_dZIm_ZCWW-lPMXP8xlcFXyNWUolkq1DvckJaLbB0JYLVwmuOfmH0Z7mKXGgRx6yhwpi9bjWCvi66Q&svctype=4&tempid=h5_group_info) WebShopX 正在持续迭代，欢迎提出功能建议与真实运营场景反馈。 --- ## WebShopX: Web-Driven Minecraft Store & Trading System >Join our **Discord Server**: [![Discord](https://img.shields.io/badge/Discord-Join_Server-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/4mSg4VyxBN) ![Minecraft](https://img.shields.io/badge/Minecraft-1.20.6%2B-2e7d32?style=for-the-badge&logo=minecraft&logoColor=white) ![Java](https://img.shields.io/badge/Java-21-1565c0?style=for-the-badge&logo=openjdk&logoColor=white) ![Paper/Spigot](https://img.shields.io/badge/Paper%20%2F%20Spigot-Supported-ef6c00?style=for-the-badge) ![B2C+C2C](https://img.shields.io/badge/Commerce-B2C%20%2B%20C2C-00695c?style=for-the-badge) ![Auction](https://img.shields.io/badge/Auction-Enabled-8e24aa?style=for-the-badge) > 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) [![](https://img.shields.io/badge/Video_Intro-Bilibili-fb7299?style=for-the-badge&logo=bilibili&logoColor=white)](https://www.bilibili.com/video/BV16zdZBTEbV/) [![](https://img.shields.io/badge/Setup_Tutorial-Bilibili-fb7299?style=for-the-badge&logo=bilibili&logoColor=white)](https://www.bilibili.com/video/BV18eoSBaEPY/) [![](https://img.shields.io/badge/Official_Wiki-Docusaurus-34d058?style=for-the-badge&logo=docusaurus&logoColor=white)](https://docs.akihito.dpdns.org/category/webshopx) [![](https://img.shields.io/badge/Issue_Tracker-GitHub-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/Cc-Cece/WebShopX-Issues/issues) [![](https://img.shields.io/badge/Community_Group-QQ-12B7F5?style=for-the-badge&logo=tencent-qq&logoColor=white)](https://qun.qq.com/universal-share/share?ac=1&authKey=EMHvFOsEqOBnEQi%2FJZtN%2BFwamTisdy0A02IwhRsxJG8t9GWK4uKs2G4CgZpT3yHW&busi_data=eyJncm91cENvZGUiOiI2MzY4MDMzNzIiLCJ0b2tlbiI6ImlpV3lHR3BFT3NvdWxUYysrSnFBN3lSWGRGU1BlTmF4a3FJSnNXeFBNZkI0emZRVDUxdCszbzdEc1NzUlNDTS8iLCJ1aW4iOiI5NTg2MzAxNDYifQ%3D%3D&data=8nepSQv0_dZIm_ZCWW-lPMXP8xlcFXyNWUolkq1DvckJaLbB0JYLVwmuOfmH0Z7mKXGgRx6yhwpi9bjWCvi66Q&svctype=4&tempid=h5_group_info) [![Discord](https://img.shields.io/badge/Discord-Join_Server-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/4mSg4VyxBN) ### 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 | **Mode** | **Core Description** | **Use Case** | | ---------------------- | ------------------------------------------------------------ | -------------------------------- | | **Direct Purchase (DIRECT)** | 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 | **Algorithm ID** | **Abbreviation** | **Logic Overview** | **Characteristics** | | ------------ | -------------- | ------------------------------------------------------------ | -------------------------------- | | `ENGLISH` | **English Auction** | Price goes up, highest bidder wins. Supports anti-sniper delay. | Most intuitive, highly interactive. | | `DUTCH` | **Dutch Auction** | Price drops automatically over time, first buyer to confirm wins. | Fast-paced, suitable for quick sales. | | `VICKREY` | **Vickrey Auction** | Sealed-bid (blind), highest bidder wins but pays the **second-highest** 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: | **Type ID** | **Name** | **Functional Description** | | ----------------------- | --------------- | ------------------------------------------ | | **`COMMAND`** | **Command Execution** | Executes a preset command via console or player after purchase. | | **`GIVE_ITEM`** | **Item Delivery** | System generates physical items and puts them in player's inventory. | | **`POTION_EFFECT`** | **Potion Effect** | Applies specific potion effects to the player after purchase. | | **`RECYCLE_ITEM`** | **Recycle/Exchange** | 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 **Pending**, **To Claim**, **Completed**, and **Refunded** - Supports order **Cool-down Period** 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 | **Role ID** | **Name** | **Core Functionality** | | ------------------ | -------------- | ------------------------------------------------------------ | | `SUPER_ADMIN` | **Super Admin** | Highest system authority, manages all modules, configs, and admin accounts. | | `SHOP_ADMIN` | **Store Admin** | Manages official store (B2C) operations, including products, limits, and codes. | | `MARKET_MODERATOR` | **Market Mod** | Manages player market (C2C), can force-unlist items or monitor auctions. | | `SUPPORT_ADMIN` | **Support Admin** | 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 | Set/Reset web login password | | /webshopx market [gui] | Open market GUI | | /webshopx market sell [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 [max] [perUserMax] [minutes] [code] | Create redeem code (Admin) | | /webshopx reload | Reload config and web resources (Admin) | Alias: /ws --- ## Quick Start Please check the [Wiki](https://docs.akihito.dpdns.org/category/webshopx) for written tutorials, or click to watch the [Video Tutorial](https://www.bilibili.com/video/BV18eoSBaEPY/). --- ## 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](https://qun.qq.com/universal-share/share?ac=1&authKey=EMHvFOsEqOBnEQi%2FJZtN%2BFwamTisdy0A02IwhRsxJG8t9GWK4uKs2G4CgZpT3yHW&busi_data=eyJncm91cENvZGUiOiI2MzY4MDMzNzIiLCJ0b2tlbiI6ImlpV3lHR3BFT3NvdWxUYysrSnFBN3lSWGRGU1BlTmF4a3FJSnNXeFBNZkI0emZRVDUxdCszbzdEc1NzUlNDTS8iLCJ1aW4iOiI5NTg2MzAxNDYifQ%3D%3D&data=8nepSQv0_dZIm_ZCWW-lPMXP8xlcFXyNWUolkq1DvckJaLbB0JYLVwmuOfmH0Z7mKXGgRx6yhwpi9bjWCvi66Q&svctype=4&tempid=h5_group_info) WebShopX is continuously iterating. Feature suggestions and real-world operational feedback are welcome.