原创 工具 RPTMarket —— 玩家市场 · 全 GUI 买卖 · 分类筛选与搜索 · 过期自动退回 [1.21 ~ 26.2] 1.0.0

关于这个插件​

RPTMarket 是一个GUI界面的玩家交易市场。
玩家把手上的物品一条指令挂上去，其他人打开市场就能浏览、筛选、搜索、购买；整个过程都在 GUI 里点，不需要记复杂指令。物品从挂出的那一刻起就被插件接管，下架、过期、背包放不下都不会让它消失，统一进「待领取」等玩家来取。数据存在插件自带的 SQLite 里，不需要 MySQL，装上就能用。

功能说明​

1. 市场主界面​

• 一页最多展示 45 件商品，物品图标直接就是真实物品，鼠标悬停即可看到售价 / 卖家 / 剩余时间 / 分类 / 编号。
• 翻页：底部左右箭头切换上一页 / 下一页，页码栏显示「第 x / y 页 · 共 N 件」。
• 分类筛选：点分类按钮在 全部 / 方块 / 武器工具 / 装备 / 食物 / 矿物 / 材料 之间循环切换，商品按材质自动归类。
• 关键词搜索：点搜索按钮后聊天栏输入关键词即可（不会真的发到公屏），支持中文物品名，也支持搜卖家名。
• 余额常驻显示：界面底部直接显示你当前的钱。
• 我的上架 / 待领取按钮上带数量角标，有多少一目了然。

2. 上架​

• 价格是整组一口价，区间可在配置里限制（默认 1 ~ 1000000）。
• 可配置每人同时上架上限（默认 10 件）与上架时长（默认 3 天）。
• 支持上架手续费（按价格百分比，默认 0 不收费）。
• 物品先从手上取走再挂单，中途任何一步失败都会原样退回，不会出现复制或吞物品。

3. 购买​

• 点商品进入购买确认界面，左边是确认、右边是取消，中间展示商品详情与你当前余额 —— 避免手抖误买。
• 余额不足、商品已被别人买走、这是你自己挂的，都会给出明确提示。
• 购买成功后，卖家即使离线也能自动收到钱（通过 Vault 直接入账）。
• 成交可选全服广播（默认开启）：XX 买走了 YY 上架的 ZZ ×N，成交 xxx。

4. 「待领取」——物品永不丢失​

这是本插件最花心思的地方。以下四种情况，物品都会自动进入「待领取」区，绝不会凭空消失：

• /rptm 待领取 打开领取界面，可单件领取也可一键全部领取。
• 领取界面显示每件物品的来源（过期退回 / 主动下架 / 背包满退回），来源清楚可追溯。
• 上线自动提醒：有待领取物品的玩家一进服就会收到提示，不会忘记。
• 领取前会预判背包能否完整装下：装不下就一点都不给、记录也不删，从根上杜绝「反复点击刷物品」。

5. 我的上架​

• /rptm 我的 打开列表，每件商品显示编号 · 售价，点击即可下架，下架后物品进待领取。
• 指令 /rptm 下架 <编号> 也能下架，输入编号时支持 Tab 补全你自己的商品。

6. 成交记录​

• /rptm 记录 查看自己最近 10 条买卖记录，区分「卖出 / 买入」，显示时间、物品、数量、金额与交易对手。

7. 管理员功能​

支持版本与环境​

目标用户​

• 想让玩家之间自由贸易的生存服 / 长期服服主 —— 比起全服商店，玩家市场更能带动经济循环。
• 正在使用 Folia 核心的服主 —— 市面上的市场插件普遍不支持 Folia，本插件从设计之初就双端兼容。
• 不想为了一个市场功能额外维护 MySQL 的服主 —— 数据就是一个本地文件。
• 在意「玩家物品不能丢」的服主 —— 下架、过期、背包满、掉线四种边界情况全部有兜底。

是否付费​

完全免费。 不需要授权、不需要联网校验，下载即用。

获取作者帮助​

使用教程​

安装​

1. 确认服务端已装好 Vault 与一个经济插件（如 EssentialsX）。
2. 将 RPTMarket-1.0.0.jar 放入服务端 plugins/ 目录。
3. 重启服务端，首次启动会生成 plugins/RPTMarket/config.yml、messages.yml、zh_names.yml 与数据库文件。
4. 按需修改 config.yml，然后执行 /rptm 重载 生效，不需要重启服务端。

玩家打开市场的最快方式：直接输入 /rptm（不带参数），或输入 /市场、/市場。

点击展开...

指令列表​

主指令为 /rptm，别名 /rptmarket、/market、/sc、/市场、/市場。

点击展开...

权限节点​

主要配置项（config.yml）​

messages.yml 里所有提示文案 —— 包括界面上每一行 —— 都支持 MiniMessage 格式，可自由改色改字。 物品中文名内置随插件分发（覆盖原版全部物品，合并 1.21 ~ 26.2 四版语言文件），影响搜索与提示文案；如需增删或改名，编辑 plugins/RPTMarket/zh_names.yml（在内置库基础上覆盖或补充，可加模组物品）。

常见问题​

• 市场打不开 / 提示没有可用经济？ 服务端没有装 Vault 或经济插件。市场所有金额都走 Vault，必须先装好。
• 为什么我上架后物品从手上消失了？ 这是设计行为：物品被插件接管、挂到了市场上。下架或过期后会进「待领取」。
• 玩家说买的东西背包放不下，物品去哪了？ 在「待领取」里。玩家进服会收到提示，也可以输入 /rptm 待领取 领取。
• 怎么看某件商品是谁卖的、还剩多久？ 鼠标悬停在商品图标上，lore 里会显示卖家与剩余时间。
• 搜索支持中文吗？ 支持。内置全部原版物品的中文名，用中文关键词也能搜到。
• 数据在哪、怎么备份？ plugins/RPTMarket/market.db，复制该文件即可备份或迁移全部挂单、待领取与成交记录。

声明​

• 本插件为原创作品，保留所有权利，默认不允许转载与整合。如需转载或整合进服务端整合包，请先通过上方交流群或作者 QQ 联系获取授权。
• 本插件未使用任何混淆手段，欢迎安全审查。

• 本插件不含任何后门、病毒或远程控制代码，所有数据仅保存在服务器本地 plugins/RPTMarket/ 目录中。