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

R***

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

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

2. 上架​

方式	指令	说明
上架手上物品	/rptm 上架 <价格>	把主手整组物品按一口价挂出
指定数量	/rptm 上架 <价格> <数量>	只挂出手上的一部分，其余留在背包

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

3. 购买​

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

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

情况	说明
挂单过期	超过上架时长自动下架，物品进待领取
主动下架	玩家自己或管理员强制下架，物品进待领取
背包满	购买 / 领取时背包放不下，放不下的部分进待领取
结算瞬间掉线	买家恰好在这个瞬间离线，商品直接转进待领取

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

5. 我的上架​

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

6. 成交记录​

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

7. 管理员功能​

指令	权限	说明
/rptm 强制下架 <编号>	rptm.admin	强制下架任意商品，物品归还原主
/rptm 重载	rptm.admin	重载配置与物品名表，不需要重启服务端

支持版本与环境​

项目	说明
Minecraft 版本	1.21 ~ 26.2（实测通过：1.21 / 1.21.4 / 1.21.11 / 26.1.2 / 26.2）
服务端核心	Paper、Folia（已声明 folia-supported: true）
Java 运行环境	Java 21 及以上
不支持	1.20.x 及以下（插件 api-version 为 1.21，低版本核心会拒绝加载）
前置插件	Vault（必需，depend 声明）＋ 一个提供经济的插件（如 EssentialsX）。市场所有金额都通过 Vault 读写
数据库	无外部依赖，使用内嵌 SQLite，不需要 MySQL

目标用户​

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

是否付费​完全免费。 不需要授权、不需要联网校验，下载即用。
获取作者帮助​

途径	内容
交流群	QQ 群 1124248111
作者 QQ	2221899680
游戏内	输入 /rptm 帮助 查看全部指令与说明

使用教程​安装​

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

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

指令列表​

指令	权限	说明
/rptm	rptm.use	直接打开市场界面
/市场 /市場	rptm.use	同上（中文别名）
/rptm 上架 <价格> [数量]	rptm.sell	上架主手物品
/rptm 我的	rptm.use	查看我的上架
/rptm 待领取	rptm.use	领取退回的物品
/rptm 搜索 <关键词>	rptm.use	搜索商品
/rptm 余额	rptm.use	查看余额
/rptm 记录	rptm.use	查看最近的成交记录
/rptm 下架 <编号>	rptm.use	下架自己的商品
/rptm 帮助	默认	显示指令帮助
/rptm 重载	rptm.admin	重载配置
/rptm 强制下架 <编号>	rptm.admin	强制下架任意商品

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

权限节点​

权限	默认值	说明
rptm.use	所有玩家	打开并使用市场
rptm.sell	所有玩家	上架物品
rptm.admin	仅 OP	强制下架、重载配置

主要配置项（config.yml）​

配置项	默认值	说明
listing-days	3	上架时长（天），到期自动下架进待领取
max-listings-per-player	10	每人最多同时上架的件数
min-price / max-price	1.0 / 1000000.0	价格区间（整组一口价）
fee-percent	0.0	上架手续费百分比（0 = 不收费）
fee-min / fee-max	0.0 / 0.0	手续费上下限
broadcast-sales	true	成交时是否全服广播
expire-check-minutes	5	过期检查间隔（分钟）
database-file	market.db	SQLite 数据文件名
page-size	45	界面每页件数（最多 45）

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

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

声明​

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

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