原创 付费 ArcaneBazaar-藏宝阁交易系统：游戏内寄售 + 网站市场 + 管理员中介 1.12.2

藏宝阁交易系统功能介绍

1. 项目概述​

藏宝阁交易系统是一套面向 Minecraft 服务器的玩家物品交易方案，由游戏内插件和网页交易站两部分组成。

玩家可以在游戏内把物品存入藏宝阁，通过网站完成上架、议价、购买、收购和交易管理。管理员可以在网站后台处理订单、管理信誉分，并通过游戏内暂存箱完成物品交付。

本项目适合需要“玩家寄售 + 网站展示 + 管理员中介交易 + 信誉约束”的服务器使用。

2. 系统组成​

2.1 游戏内插件​

插件运行在 Spigot/Paper 1.12.2 服务端，主要负责游戏内物品存取、ItemStack 完整保存、物品状态锁定、交易暂存箱、管理员操作和游戏内通知。

玩家通过 `/cbg` 打开自己的藏宝阁空间，把要交易的物品放入指定界面。插件会把物品完整序列化保存到数据库，确保附魔、NBT、名称、描述、数量等信息能够被保留。

2.2 网页交易站​

网站用于展示市场、登录玩家账号、发布商品、发送议价、直接购买、发布收购需求、查看个人交易和后台管理。

网站通过 AuthMe 账号验证玩家身份，玩家使用自己的游戏账号登录后即可管理自己的商品和订单。

2.3 数据库​

插件和网站连接同一个 MySQL/MariaDB 数据库。数据库负责保存物品、订单、议价、信誉分、收购需求和交易暂存箱数据。

发布包只提供空表结构脚本，不包含任何现有玩家数据。

3. 核心功能​

3.1 玩家寄售物品​

玩家在游戏内输入 `/cbg` 打开藏宝阁，把需要寄售的物品放入界面。

插件会自动保存物品数据，并在网站中显示该玩家的待上架物品。物品未上架前可以从游戏内取回；上架后会被锁定，避免重复取回或重复交易。

功能特点：

• 支持完整保存 ItemStack 数据。

• 支持物品名称、描述、数量同步到网站。

• 上架后的物品会在游戏内显示锁定状态。

• 管理员可以查看指定玩家藏宝阁。

3.2 网站上架商品​

玩家登录网站后，可以在个人中心查看自己放入藏宝阁的物品，并为物品填写价格和备注。

提交后，商品会进入市场展示，其他玩家可以查看并发起购买或议价。

功能特点：

• 支持设置商品价格。

• 支持填写商品备注。

• 支持按上架时间展示商品。

• 支持分页浏览，适合商品数量较多的服务器。

玩家可以在网站市场页浏览所有已上架商品，查看商品名称、描述、数量、卖家、价格、卖家信誉和成交次数。

买家可以选择直接购买商品。购买后商品状态会变为交易中，等待管理员中介处理。

功能特点：

• 展示商品价格和卖家信息。

• 展示卖家信誉分和成交次数。

• 购买后自动锁定商品。

• 通知卖家和在线管理员处理交易。

3.4 玩家议价​

买家可以对已上架商品发送议价请求，填写出价和留言。

卖家可以在个人中心查看收到的议价，并选择接受或拒绝。接受议价后，系统会把商品进入交易锁定状态，等待管理员处理。

功能特点：

• 支持买家出价。

• 支持留言说明。

• 支持卖家接受或拒绝。

• 游戏内可通知在线卖家。

除了卖家寄售，买家也可以发布收购需求，说明自己想收的物品、预算价格和需求描述。

其他玩家看到收购需求后，可以选择接单出售。接单后该收购单会进入交易锁定状态，由管理员继续中介处理。

功能特点：

• 支持买家发布收购标题。

• 支持填写详细需求描述。

• 支持设置收购预算。

• 支持卖家接单并填写出售价格或备注。

管理员可以登录网站后台，集中查看商品、议价、交易订单、收购订单和玩家信誉。

管理员可以确认交易完成、取消交易、调整订单状态、查看指定玩家数据，并手动调整玩家信誉分。

功能特点：

• 查看全部活跃订单。

• 查看已完成订单。

• 管理普通商品交易。

• 管理收购需求交易。

• 支持手动设置信誉分或增减信誉分。

• 支持按玩家查看交易记录和上架信息。

管理员在网站确认交易完成后，系统会把对应物品写入买家的交易暂存箱。

买家在游戏内输入 `/cbg claim` 打开暂存箱，点击物品即可领取到背包。如果背包空间不足，系统会阻止领取，避免物品丢失。

功能特点：

• 交易完成后自动生成待领取物品。

• 买家上线时可收到暂存箱提醒。

• 背包满时不会错误领取。

• 已领取物品会标记为已领取，避免重复领取。

3.8 信誉分系统​

系统内置信誉分规则，用于限制低信誉玩家的交易能力。

默认规则：

• 初始信誉分为 100。

• 信誉分最高为 200。

• 管理员确认交易完成后增加信誉分。

• 取消或违规交易可以扣除信誉分。

• 低于设定分数时，玩家不能寄售或购买。

信誉门槛可以通过配置调整。

3.9 绑定物品描述替换​

部分绑定物品会在描述底部出现类似“已签名 XXXX”的文本。为了避免交付给买家时保留旧签名，插件支持在领取前替换指定描述。

默认配置：

delivery:

loreReplacement:

targetDescription: "&7&o已签名"

replacementDescription: "&7&o获取后自动签名"

系统会忽略颜色码并按前缀匹配，所以包含玩家名或其他后缀的签名描述也能被识别。

4. 主要业务流程​

4.1 商品寄售流程​

1. 卖家在游戏内输入 `/cbg`。

2. 卖家把物品放入藏宝阁。

3. 插件保存物品到数据库。

4. 卖家登录网站，在个人中心填写价格并上架。

5. 商品出现在市场页。

6. 买家购买或发送议价。

7. 管理员中介处理交易。

8. 管理员确认完成后，物品进入买家暂存箱。

9. 买家输入 `/cbg claim` 领取物品。

4.2 收购流程​

1. 买家在网站发布收购需求。

2. 卖家在市场中查看收购需求。

3. 卖家选择接单出售。

4. 收购单进入交易锁定状态。

5. 管理员中介处理交易。

6. 管理员确认完成后，信誉分按规则变化。

5. 适用场景​

本系统适合以下服务器场景：

• 需要玩家自主寄售装备、材料、道具。

• 需要网站展示商品，方便玩家离线浏览。

• 需要管理员作为中介，降低交易纠纷。

• 需要信誉分机制限制恶意交易。

• 需要保留物品完整 NBT 和描述信息。

• 需要支持 AuthMe 账号登录。

6. 项目亮点​

• 游戏内和网站联动，玩家操作路径清晰。

• 使用数据库保存完整交易状态，便于追踪。

• 支持商品寄售、议价、购买和收购多种交易形式。

• 管理员后台集中处理交易和信誉。

• 交易暂存箱降低人工发货压力。

• 可配置绑定物品描述替换，适配特殊物品规则。

• 发布包不包含任何已有数据库数据，便于分发部署。

7. 后续可扩展方向​

后续可以根据服务器需求继续扩展：

• 商品分类与搜索。

• 支持更多排序方式。

• 交易手续费。

• 管理员操作日志。

• 更细的权限配置。

• 对接服务器经济插件。

• 商品审核机制。