WebShopX

也提供中文版本，请往下滑。 # WebShopX v3: A Web-Driven Minecraft Store and Trading System > Official Store (B2C) + Player Market (C2C) + Auctions + Dynamic Pricing + Order Fulfillment + Admin Dashboard (https://img.shields.io/badge/Minecraft-1.18.2%2B-2e7d32?style=flat&logo=minecraft&logoColor=white)](#1-runtime-requirements) (https://img.shields.io/badge/Paper%20%2F%20Purpur-Supported-ef6c00?style=flat)](#1-runtime-requirements) (https://img.shields.io/badge/Folia-Supported-8e24aa?style=flat)](#1-runtime-requirements) (https://img.shields.io/badge/Language-Chinese%20%7C%20English-1565c0?style=flat)](#internationalization) (https://img.shields.io/badge/Video_Introduction-Bilibili-fb7299?style=flat&logo=bilibili&logoColor=white)](https://www.bilibili.com/video/BV16zdZBTEbV/) (https://img.shields.io/badge/Setup_Tutorial-Bilibili-fb7299?style=flat&logo=bilibili&logoColor=white)](https://www.bilibili.com/video/BV18eoSBaEPY/) (https://img.shields.io/badge/Wiki-Docusaurus-34d058?style=flat&logo=docusaurus&logoColor=white)](https://docs.akihito.dpdns.org/category/webshopx) (https://img.shields.io/badge/Issue_Tracker-GitHub-181717?style=flat&logo=github&logoColor=white)](https://github.com/Cc-Cece/WebShopX-Issues/issues) (https://img.shields.io/badge/Discord-Join-5865F2?style=flat&logo=discord&logoColor=white)](https://discord.gg/4mSg4VyxBN) WebShopX is a complete trading system: the Minecraft plugin provides business logic and APIs, while a modern web frontend serves both players and server operators. Version 3 completely rebuilds the frontend and supports three deployment modes: embedded, external, and Relay. ## v3 Highlights - SQLite works out of the box, with MySQL and MariaDB also supported - WebShopX Relay deployment without exposing a server port - Fixed-price listings, buy orders, four auction formats, and dynamic pricing for official products - Dual-currency wallets, recharging, refunds, an in-game mailbox, and fallback handling for failed deliveries - Redis-powered cross-server events and player-presence synchronization - Plugin update checks, Relay status monitoring, and immediate reconnection - A standalone server homepage with a visual editor and database-backed revision management ## 1 Runtime Requirements Download the build that matches both your Minecraft version and server type. | Minecraft target | Java | Supported servers | |---|---:|---| | `1.18.2+` | 17 | Paper / Purpur / Spigot | | `1.20.6+` | 21 | Paper / Purpur / Spigot / Folia | | `26.1+` | 25 | Paper / Purpur / Spigot / Folia | | `26.2+` | 25 | Paper / Purpur / Spigot / Folia | - Databases: SQLite, MySQL, or MariaDB - Optional dependencies: Vault, WebShopX-Payments, and others - Multi-server deployments: MySQL/MariaDB + Redis - Bundled languages: `zh-CN` and `en-US` ## 2 Three Web Deployment Modes ### Embedded Mode The plugin serves both the API and static web files. After installing the JAR, the site is available on port `8819` by default. This mode is ideal for single-server setups and quick deployment. ### External Mode The plugin provides the API, while Vue static files are hosted by Nginx, a hosting panel, or a CDN. This mode is designed for servers that already have a domain, reverse proxy, and TLS infrastructure. ### Relay Mode > Relay mode is implemented but is still undergoing further testing. Before using it, consult the GitHub/Wiki guides or join the QQ group or Discord for assistance. The Minecraft server establishes an outbound connection to WebShopX Relay, so neither the WebShopX port nor the Minecraft port needs to be exposed publicly. Relay instances, server bindings, and public endpoints can all be managed from the Relay website. ```yaml webshop: server-mode: relay relay: url: "" # Leave empty to use the built-in Relay server access-key: "wsx_user_xxxxxxxxx" ``` ## 3 Complete Trading Lifecycle | Module | Implemented capabilities | |---|---| | Official Store | Commands, item delivery, item recycling, potion effects, and group-buy vouchers | | Dynamic Pricing | Multiple algorithms, demand pressure, price trends, and popularity decay | | Player Market | Sell orders, buy orders, supply containers, automatic restocking, tags, and restriction rules | | Auction System | English, Dutch, Vickrey, and Candle auctions with expiration settlement | | Wallets and Payments | ShopCoin / GameCoin, Vault, currency exchange, and recharge orders | | Fulfillment and Support | Automatic delivery, manual claims, mailbox fallback, refunds, and group-buy voucher redemption | | Admin Dashboard | Product, order, market, user, economy, announcement, language, and theme management | | Server Homepage | Standalone presentation site, visual section editing, draft publishing, revision history, and asset library | | Security and Auditing | Role-based permissions, admin audit logs, and business ledger | ## 4 Player Experie