模组插件数据包光影资源包整合包软件汉化地图
设置
WebShopX

WebShopX

一体化 Minecraft 网页商城与玩家交易系统

存储管理经济
004 hours ago

基本信息

我的世界Java版本

26.1.x
1.21.x
1.20.x
1.19.x
1.18.2

平台

Bukkit
Folia
\n \n \n \n \n Paper
\n \n \n \n \n \n \n \n \n \n \n Purpur
Spigot

运行环境

服务端

分类

存储
管理
经济

其他链接

反馈问题 访问 wiki
Modrinth

创作团队

Prism-Committee
Prism-Committee团队

详情信息

许可证 保留所有权益/无许可证
发布于 2026-05-31
更新于 2026-05-31

We also support English—please scroll down.

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

Join our Discord Server: Discord

Minecraft Java Paper/Spigot B2C+C2C Auction

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

快捷导航 (可点击)

Discord

环境要求

  • 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 <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 查看文字教程，或点击查看 视频教程 。

反馈与支持

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

WebShopX: Web-Driven Minecraft Store & Trading System

Join our Discord Server: Discord

Minecraft Java Paper/Spigot B2C+C2C Auction

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)

Discord

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 <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

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