Unofficial site, not affiliated with modrinth.com.What is this?
Плагины/WebShopX
WebShopX

WebShopX

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

92
3

We also support English—please scroll down.

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

Minecraft Java Paper/Spigot B2C+C2C Auction

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

快捷导航 (可点击)

环境要求

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

反馈与支持

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

WebShopX: Web-Driven Minecraft Store & Trading System

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)

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

ModuleImplemented Capabilities
Official Store5 commodity types: Sell items, Recycle items, Commands, Potion effects, Redeem codes
Dynamic PricingOfficial products support dynamic pricing and demand decay (multiple algorithms)
Player MarketStandard listing, Shulker box listing, Auto-restock, Price editing, Notes, Pause/Resume/Unlist
Auction ModeEnglish, Dutch, Vickrey, Candle auctions; supports bidding, anti-sniper delay, expiry settlement
Fulfillment FallbackAuto-delivery failure allows /ws claim, and supports mailbox compensation claim
Notification SystemIn-site notification list, Unread count, Mark as read, Global backend announcements
Admin DashboardProducts / 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

ModeCore DescriptionUse 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 IDAbbreviationLogic OverviewCharacteristics
ENGLISHEnglish AuctionPrice goes up, highest bidder wins. Supports anti-sniper delay.Most intuitive, highly interactive.
DUTCHDutch AuctionPrice drops automatically over time, first buyer to confirm wins.Fast-paced, suitable for quick sales.
VICKREYVickrey AuctionSealed-bid (blind), highest bidder wins but pays the second-highest price.Encourages buyers to bid their true maximum value.
CANDLECandle AuctionVariation 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 IDNameFunctional Description
    COMMANDCommand ExecutionExecutes a preset command via console or player after purchase.
    GIVE_ITEMItem DeliverySystem generates physical items and puts them in player's inventory.
    POTION_EFFECTPotion EffectApplies specific potion effects to the player after purchase.
    RECYCLE_ITEMRecycle/ExchangeSystem recycles specific player items at a set price.
    GROUP_BUY_VOUCHERGroup Buy/VoucherDelivers 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 IDNameCore Functionality
SUPER_ADMINSuper AdminHighest system authority, manages all modules, configs, and admin accounts.
SHOP_ADMINStore AdminManages official store (B2C) operations, including products, limits, and codes.
MARKET_MODERATORMarket ModManages player market (C2C), can force-unlist items or monitor auctions.
SUPPORT_ADMINSupport AdminHandles user support, user queries, password resets, and manual wallet adjustments.
AUDITORAuditorView and export permissions only, audits global logs, transactions, and admin actions.

Commands (In-Game)

CommandDescription
/webshopx helpHelp menu
/webshopx password <new_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 claimClaim mailbox compensation items
/webshopx redeem create [max] [perUserMax] [minutes] [code]Create redeem code (Admin)
/webshopx reloadReload 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.

Совместимость

Minecraft: Java Edition

26.1.x1.21.x1.20.x1.19.x1.18.x

Поддерживаемые окружения

Сервер

Создатели

Cc-Cece

Cc-Cece

Владелец

Детали

Лицензия:LicenseRef-All-Rights-Reserved
Опубликован:1 месяц назад
Обновлён:3 дня назад
Главная