From bac660a8cbb43c908548f4876eb5cb6f702da241 Mon Sep 17 00:00:00 2001 From: kebi11 Date: Thu, 27 Aug 2026 09:28:06 +0800 Subject: [PATCH 1/4] docs: track WebShopX v3.2.2 product links and version --- docs/intro.mdx | 6 +++++- docs/webshopx/overview.md | 4 ++-- i18n/en/docusaurus-plugin-content-docs/current/intro.mdx | 2 +- .../current/webshopx/overview.md | 4 ++-- 4 files changed, 10 insertions(+), 6 deletions(-) diff --git a/docs/intro.mdx b/docs/intro.mdx index 78eb5c5..8540e10 100644 --- a/docs/intro.mdx +++ b/docs/intro.mdx @@ -19,7 +19,7 @@ import {AiAccess, DocHero, FeatureCards, ProjectPanel} from '@site/src/component title="WebShopX" description="面向 Paper、Purpur、Spigot 与 Folia 服务端的 Web 商城系统，包含官方商城、玩家市场、钱包、订单与发货、充值和管理后台。" links={[ - {label: 'GitHub ↗', to: 'https://github.com/Cc-Cece/WebShopX'}, + {label: 'GitHub ↗', to: 'https://github.com/Prism-Committee/WebShopX-Issues'}, {label: 'Modrinth ↗', to: 'https://modrinth.com/plugin/webshopx'}, {label: 'MineBBS ↗', to: 'https://www.minebbs.com/resources/x-folia-webshopx.15688/'}, ]}> @@ -63,3 +63,7 @@ import {AiAccess, DocHero, FeatureCards, ProjectPanel} from '@site/src/component failedLabel="复制失败" prompt="请读取 https://docs.akihito.dpdns.org/llms.txt 获取本站中文文档索引，并按需读取其中链接的 Markdown 内容。回答时请以这些文档为主要依据，注明相关页面 URL；若文档没有提供答案，请明确说明，不要猜测。" /> + +:::info[问题反馈] +WebShopX 或文档问题请提交到 [Prism-Committee/WebShopX-Issues](https://github.com/Prism-Committee/WebShopX-Issues)。 +::: diff --git a/docs/webshopx/overview.md b/docs/webshopx/overview.md index 65649aa..071490b 100644 --- a/docs/webshopx/overview.md +++ b/docs/webshopx/overview.md @@ -34,7 +34,7 @@ import {DocHero, FeatureCards} from '@site/src/components/DocVisuals'; ## 当前文档基线 :::info -本文档以 WebShopX v3 开发线为主要基线。不同发行版本可能存在功能、字段或界面差异；涉及部署、配置和 API 时，请确认实际安装的 WebShopX 版本。 +本文档以 WebShopX v3 为主要基线，当前稳定版为 **v3.2.2**（2026-08）。不同发行版本可能存在功能、字段或界面差异；涉及部署、配置和 API 时，请确认实际安装的 WebShopX 版本。 ::: ## WebShopX 与 WebShopX-Payments @@ -43,4 +43,4 @@ WebShopX 核心负责商城、资产、订单和业务状态。WebShopX-Payments - 只使用游戏内经济或不需要在线支付：不必安装 WebShopX-Payments； - 需要充值渠道：阅读 [WebShopX-Payments 文档](../webshopx-payments/overview)； -- 开发自己的支付 Provider：阅读 [Payment Provider API](./webshopx-payment-api)。 \ No newline at end of file +- 开发自己的支付 Provider：阅读 [Payment Provider API](./webshopx-payment-api)。 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/intro.mdx b/i18n/en/docusaurus-plugin-content-docs/current/intro.mdx index e70a2e2..5f784d0 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/intro.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/intro.mdx @@ -19,7 +19,7 @@ import {AiAccess, DocHero, FeatureCards, ProjectPanel} from '@site/src/component title="WebShopX" description="A web shop system for Paper, Purpur, Spigot, and Folia servers, including the official shop, player market, wallets, orders and delivery, recharge, and administration." links={[ - {label: 'GitHub source ↗', to: 'https://github.com/Cc-Cece/WebShopX'}, + {label: 'GitHub ↗', to: 'https://github.com/Prism-Committee/WebShopX-Issues'}, {label: 'Modrinth ↗', to: 'https://modrinth.com/plugin/webshopx'}, {label: 'MineBBS ↗', to: 'https://www.minebbs.com/resources/x-folia-webshopx.15688/'}, ]}> diff --git a/i18n/en/docusaurus-plugin-content-docs/current/webshopx/overview.md b/i18n/en/docusaurus-plugin-content-docs/current/webshopx/overview.md index 71706b1..b4e08af 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/webshopx/overview.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/webshopx/overview.md @@ -46,7 +46,7 @@ The visible navigation intentionally does not mirror the repository's `player/`, ## Documentation baseline :::info -These docs primarily track the WebShopX v3 development line. Confirm the exact version installed on your server before relying on configuration or API details. +These docs primarily track WebShopX v3. The current stable release is **v3.2.2** (2026-08). Confirm the exact version installed on your server before relying on configuration or API details. ::: ## WebShopX and WebShopX-Payments @@ -62,4 +62,4 @@ WebShopX owns the shop, assets, orders, and business state. WebShopX-Payments is 1. Code and configuration shipped with the WebShopX version you actually run. 2. Reference documentation. 3. Guides / Administration / Development task documentation. -4. README files, old screenshots, or third-party tutorials. \ No newline at end of file +4. README files, old screenshots, or third-party tutorials. From 2c04d4f60d33484e040d09c2487095d039d753bf Mon Sep 17 00:00:00 2001 From: kebi11 Date: Thu, 27 Aug 2026 09:28:42 +0800 Subject: [PATCH 2/4] docs: document WebShopX v3.2.2 download variants --- docs/webshopx/admin/install-deploy.md | 22 +++++++++++--- .../current/webshopx/admin/install-deploy.md | 29 +++++++++++++++---- 2 files changed, 42 insertions(+), 9 deletions(-) diff --git a/docs/webshopx/admin/install-deploy.md b/docs/webshopx/admin/install-deploy.md index e98da14..fdda147 100644 --- a/docs/webshopx/admin/install-deploy.md +++ b/docs/webshopx/admin/install-deploy.md @@ -21,6 +21,8 @@ import {DocHero, FeatureCards} from '@site/src/components/DocVisuals'; ## 1. 环境要求 +当前稳定版为 **v3.2.2**。请选择与 Minecraft 版本和服务端类型匹配的构建。 + | Minecraft 运行时 | Java | Folia 构建 | | --- | ---: | --- | | `1.18.2+` | 17 | 不提供 | @@ -29,17 +31,29 @@ import {DocHero, FeatureCards} from '@site/src/components/DocVisuals'; | `26.2+` | 25 | 提供 | - 推荐 Paper / Purpur；Spigot 也受支持； -- Folia 必须使用对应 Folia 构建； +- Folia 必须使用对应 Folia 构建，不要混用 Paper 构建； - 默认数据库为 SQLite； - 生产或高并发场景推荐 MySQL / MariaDB； - Vault、WebShopX-Payments 与 YuPay 都是可选软依赖。 ## 2. 获取插件 -请选择与你的 Minecraft 版本和服务端类型匹配的 JAR： +下载渠道： - [Modrinth](https://modrinth.com/plugin/webshopx) -- [MineBBS](https://www.minebbs.com/resources/webshopx-minecraft.15688/updates) +- [GitHub Releases](https://github.com/Prism-Committee/WebShopX-Issues/releases/latest) +- [MineBBS](https://www.minebbs.com/resources/x-folia-webshopx.15688/) + +每个版本提供多种构建变体： + +| 变体 | 说明 | +| --- | --- | +| `full` | 包含 Windows 和 Linux 依赖，体积较大 | +| `slim` | 不含依赖，服务器启动时自动下载，需要能联网 | +| `full-win` | 仅含 Windows 依赖 | +| `full-linux` | 仅含 Linux 依赖 | + +Paper / Purpur / Spigot 使用对应的 Paper 构建；Folia 必须使用 Folia 构建。按自己的 Minecraft 版本区间选择 JAR，不要只看文件名里的 `3.2.2`。 ## 3. 最快部署：SQLite + internal @@ -174,4 +188,4 @@ v3 中应从 WebShopX 站点登录后进入管理后台。`/admin.html` 仅用 {icon: '⌨️', title: '命令与权限体系', description: '查询安装后可用命令和管理员权限。', to: './commands-permissions'}, {icon: '⬆️', title: 'v2 → v3 迁移', description: '旧版本升级时确认迁移步骤和兼容边界。', to: './v2-to-v3-migration'}, {icon: '🛠️', title: '运维排障', description: '上线后遇到运行问题时继续排查。', to: './faq'}, -]} /> \ No newline at end of file +]} /> diff --git a/i18n/en/docusaurus-plugin-content-docs/current/webshopx/admin/install-deploy.md b/i18n/en/docusaurus-plugin-content-docs/current/webshopx/admin/install-deploy.md index 00bd75c..7b620b1 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/webshopx/admin/install-deploy.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/webshopx/admin/install-deploy.md @@ -21,14 +21,33 @@ import {DocHero, FeatureCards} from '@site/src/components/DocVisuals'; ## Requirements -Choose a WebShopX build that matches both your Minecraft runtime and Java version: +Current stable release is **v3.2.2**. Choose a WebShopX build that matches both your Minecraft runtime and Java version: -- Minecraft `1.18.2+`: Java `17` -- Minecraft `1.20.6+` (default line): Java `21` -- Minecraft `26.1+ / 26.2+`: Java `25` +- Minecraft `1.18.2+`: Java `17` (no Folia build) +- Minecraft `1.20.6+` (default line): Java `21` (Folia build available) +- Minecraft `26.1+ / 26.2+`: Java `25` (Folia build available) SQLite is the default database for quick single-server setup. MySQL or MariaDB is recommended for production or multi-server deployments. Vault is optional for `GAME_COIN` integration. +## Get the plugin + +Download channels: + +- [Modrinth](https://modrinth.com/plugin/webshopx) +- [GitHub Releases](https://github.com/Prism-Committee/WebShopX-Issues/releases/latest) +- [MineBBS](https://www.minebbs.com/resources/x-folia-webshopx.15688/) + +Each release ships several JAR variants: + +| Variant | What it includes | +| --- | --- | +| `full` | Windows and Linux native dependencies (largest) | +| `slim` | No bundled dependencies; downloads them on first start (needs network) | +| `full-win` | Windows dependencies only | +| `full-linux` | Linux dependencies only | + +Use a Paper build for Paper / Purpur / Spigot. Folia servers must use a Folia build. Pick the jar for your Minecraft version range, not only the `3.2.2` version string. + ## First Startup 1. Put the WebShopX JAR in `plugins/`. @@ -123,4 +142,4 @@ Do not use SQLite with `master` or `node` cluster roles. {icon: '⌨️', title: 'Commands and Permissions', description: 'Look up commands and administrator permissions.', to: './commands-permissions'}, {icon: '⬆️', title: 'v2 to v3 Migration', description: 'Review upgrade steps and compatibility boundaries.', to: './v2-to-v3-migration'}, {icon: '🛠️', title: 'Troubleshooting', description: 'Continue here for post-deployment operational issues.', to: './faq'}, -]} /> \ No newline at end of file +]} /> From 24d3928cf55978b452598fb9eb83cbbb5e36dd18 Mon Sep 17 00:00:00 2001 From: kebi11 Date: Thu, 27 Aug 2026 09:30:48 +0800 Subject: [PATCH 3/4] docs: note WebShopX is not open source --- docs/intro.mdx | 2 +- i18n/en/docusaurus-plugin-content-docs/current/intro.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/intro.mdx b/docs/intro.mdx index 8540e10..01a34b2 100644 --- a/docs/intro.mdx +++ b/docs/intro.mdx @@ -65,5 +65,5 @@ import {AiAccess, DocHero, FeatureCards, ProjectPanel} from '@site/src/component /> :::info[问题反馈] -WebShopX 或文档问题请提交到 [Prism-Committee/WebShopX-Issues](https://github.com/Prism-Committee/WebShopX-Issues)。 +WebShopX 目前不是开源软件。GitHub 仓库用于 Issue 与构建发布，插件请从 [Modrinth](https://modrinth.com/plugin/webshopx) 下载。问题和文档反馈请提交到 [Prism-Committee/WebShopX-Issues](https://github.com/Prism-Committee/WebShopX-Issues)。 ::: diff --git a/i18n/en/docusaurus-plugin-content-docs/current/intro.mdx b/i18n/en/docusaurus-plugin-content-docs/current/intro.mdx index 5f784d0..0a5d977 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/intro.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/intro.mdx @@ -65,5 +65,5 @@ import {AiAccess, DocHero, FeatureCards, ProjectPanel} from '@site/src/component /> :::info[Feedback and issues] -Report WebShopX or documentation issues at [Prism-Committee/WebShopX-Issues](https://github.com/Prism-Committee/WebShopX-Issues). +WebShopX is not open source. The GitHub repository is for issues and builds; download the plugin from [Modrinth](https://modrinth.com/plugin/webshopx). Report WebShopX or documentation issues at [Prism-Committee/WebShopX-Issues](https://github.com/Prism-Committee/WebShopX-Issues). ::: From 2225435fde49df751e322e548efd69c50e1fc926 Mon Sep 17 00:00:00 2001 From: kebi11 Date: Thu, 27 Aug 2026 09:31:28 +0800 Subject: [PATCH 4/4] docs: map Embedded to internal and warn Relay is still testing --- docs/webshopx/admin/install-deploy.md | 6 ++++++ .../current/webshopx/admin/install-deploy.md | 19 ++++++++++++++----- 2 files changed, 20 insertions(+), 5 deletions(-) diff --git a/docs/webshopx/admin/install-deploy.md b/docs/webshopx/admin/install-deploy.md index fdda147..2644833 100644 --- a/docs/webshopx/admin/install-deploy.md +++ b/docs/webshopx/admin/install-deploy.md @@ -97,6 +97,8 @@ database: ## 5. 选择部署模式 +产品说明里的 Embedded 对应配置值 `internal`（`webshop.server-mode`）。YAML 里请写 `internal` / `external` / `relay`，不要改成 `embedded`。 + @@ -129,6 +131,10 @@ webshop: +:::caution[仍在测试] +Relay 功能已实现，但仍在进一步测试中。使用前请阅读 [Relay 公网访问](./relay-access.md)，或加入 QQ 群 / Discord 获取帮助。 +::: + Relay 模式下，Minecraft 服务器不需要直接向公网开放 Web 端口。插件主动连接 WebShopX Relay，由 Relay 为对应项目提供公网商城入口。 当前官方服务面板：**[打开 WebShopX Relay 服务面板](https://47.122.127.164/)**。 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/webshopx/admin/install-deploy.md b/i18n/en/docusaurus-plugin-content-docs/current/webshopx/admin/install-deploy.md index 7b620b1..8d39dcf 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/webshopx/admin/install-deploy.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/webshopx/admin/install-deploy.md @@ -21,13 +21,16 @@ import {DocHero, FeatureCards} from '@site/src/components/DocVisuals'; ## Requirements -Current stable release is **v3.2.2**. Choose a WebShopX build that matches both your Minecraft runtime and Java version: +Current stable release is **v3.2.2**. Choose a build that matches both Minecraft version and server type. -- Minecraft `1.18.2+`: Java `17` (no Folia build) -- Minecraft `1.20.6+` (default line): Java `21` (Folia build available) -- Minecraft `26.1+ / 26.2+`: Java `25` (Folia build available) +| Minecraft runtime | Java | Folia build | +| --- | ---: | --- | +| `1.18.2+` | 17 | Not available | +| `1.20.6+` | 21 | Available | +| `26.1+` | 25 | Available | +| `26.2+` | 25 | Available | -SQLite is the default database for quick single-server setup. MySQL or MariaDB is recommended for production or multi-server deployments. Vault is optional for `GAME_COIN` integration. +Paper / Purpur are recommended; Spigot is also supported. Folia servers must use the Folia JAR. SQLite is the default for a first single-server setup; MySQL or MariaDB is recommended for production or multi-server deployments. Vault is optional for `GAME_COIN` integration. ## Get the plugin @@ -71,6 +74,8 @@ Replace or disable the default administrator immediately after initialization. ## Deployment Modes +Product copy uses **Embedded** for config `webshop.server-mode: internal`. Keep `internal`, `external`, and `relay` in YAML. + @@ -84,6 +89,10 @@ WebShopX serves the API while static files are hosted by Nginx/CDN or another we +:::caution[Still in testing] +Relay is implemented but still undergoing further testing. Read [Relay Public Access](./relay-access) first, or ask in the QQ group / Discord. +::: + WebShopX connects outbound to WebShopX Relay, so the Minecraft host does not need to expose the web port directly. Current official service panel: **[Open the WebShopX Relay service panel](https://47.122.127.164/)**.