WebShopX | Web 驱动的 Minecraft 商城系统 (B2C + C2C + 管理后台)

面向 Paper/Spigot 服务器的网页商城插件。 一个系统里同时解决：官方商城、玩家市场与管理后台。

---

📖 插件简介

WebShopX 是一套面向 Paper/Spigot 的 Web 商店系统。它不只是一个网页模板，而是一套将 官方商城、玩家市场、钱包系统、订单流转、管理后台 深度整合的成熟交易体系，旨在将复杂的交易操作从游戏内 GUI 搬到更加直观的网页端。

✨ 核心功能

• 玩家端: 支持 Minecraft ID 登录，集成双币种钱包，可在线下单、申请退款、查看个人流水。
• 玩家市场 (C2C): 支持普通上架与 供货箱上架（自动补货），支持网页端改价、改备注。
• 官方商城 (B2C): 支持出售/回收物品、执行指令、药水效果及团购券。
• 管理后台: 提供完整的可视化界面，管理商品、生成兑换码、查看审计日志及分配子管理员权限。
• 兼容性: 原生支持中文材质名与附魔展示，支持 Vault 经济挂钩。

🛠️ 安装与运行

1. 需要 Java 21 环境及 MariaDB/MySQL 数据库。
2. 将插件放入 plugins/ 文件夹并启动服务器。
3. 在配置文件中填写数据库信息并重启。
4. 默认访问地址：http://服务器IP:8819/（后台为 /admin.html）。

---

WebShopX | Web-Driven Minecraft Marketplace (B2C + C2C + Admin)

A modern, web-based store solution for Paper/Spigot servers. Manage Official Shops, Player Markets, and Admin Dashboards in one unified system.

---

📖 Overview

WebShopX is a comprehensive web-driven marketplace for Paper/Spigot. It integrates Official Stores (B2C), Player Markets (C2C), Wallet Systems, and Order Management into a high-performance system, designed to move complex in-game trading to a clean and intuitive web interface.

✨ Key Features

• Player Portal: Login via Minecraft username, manage dual-currency wallets, place orders, and track transactions online.
• Marketplace (C2C): Supports standard listings and Supply Chest listings (auto-restock) with web-based price and remark management.
• Official Shop (B2C): Sell or buy-back items, execute commands, grant potion effects, and manage group coupons.
• Admin Dashboard: A fully functional UI to manage products, generate redeem codes, monitor audit logs, and assign granular sub-admin permissions.
• Compatibility: Native support for Chinese item/enchantment localized names; optional Vault economy integration.

🛠️ Requirements & Setup

1. Environment: Java 21+ and MariaDB/MySQL are required.
2. Installation: Drop the plugin into the plugins/ folder and start the server.
3. Config: Set up your database credentials in the config file and restart.
4. Access: Default URL is http://<your-ip>:8819/ (Admin: /admin.html).

---

📜 Commands & Permissions

• /webshopx (or /ws) - Main command.
• webshop.use - Permission to use the web store.
• webshop.admin - Admin access for in-game commands.
• webshop.market.limit.<number> - Set maximum market listing limits per player.