RptBackPack —— 一条指令开随身背包，关界面立刻落库，掉线崩服也不丢东西 [1.21 ~ 26.2]

关于这个插件​RptBackPack 解决的是「玩家需要一个随时能开、又不会弄丢东西的随身背包」。
大部分背包类插件的保存时机是退出游戏或关服，一旦服务端崩了，玩家刚放进背包的装备就没了。RptBackPack 把保存时机提前到关闭界面的一瞬间，并在关服时再兜一层底。
同时它是从设计之初就按 Folia 区域线程写的：读库写库走异步线程，开界面与读写玩家状态回到玩家自己的区域线程，跨线程传递的只有物品快照克隆。
功能说明​1. 一条指令，随时打开​

指令	权限	说明
/rptbp 或 /rptbp open	rptbp.use（默认所有玩家）	打开自己的随身背包
/rptbp <玩家>	rptbp.admin.others（默认 OP）	查看与编辑他人背包，目标可离线
/rptbp reload	rptbp.admin（默认 OP）	重载 config.yml，不必重启服务端
/rptbp help	无	显示指令帮助

主指令 /rptbp，兼容别名：/backpack、/bp、/bb；旧命令 /bpreload 不带参数时等价于 reload。

2. 关闭界面立刻落库（核心）​

• 玩家一关界面就写库，不需要等他退出游戏。
• 玩家退出游戏时按 auto-save-quit 再存一次（默认开）。
• 关服时对所有还在缓存里的背包做一次同步保存。
  

3. 容量可配，改小不丢数据​

• backpack-row 可设 1~6 行（9~54 格），改完 /rptbp reload 即可对新打开的界面生效。
• 把行数改小不会删东西：超出当前容量的物品仍然留在数据库里，把行数调回去就能重新看到，并会在控制台提示有多少格超出。
  

4. 管理员查看离线玩家背包​

• /rptbp <玩家> 可以直接打开离线玩家的背包，处理装备找回、违规物品清理这类事不用等人上线。
• 目标在线时也能查看；此时插件会把管理员改完的内容同步回该玩家手里的那份界面，避免两边看到的不是同一份数据。
• 若目标此刻也正开着背包，插件会给管理员一条提醒：对方的关闭动作会覆盖这次改动。
  

5. 界面标题可自定义​

• title（本人视角）与 title-other（管理员视角，{player} 会替换成该玩家名字）都支持 MiniMessage 富文本。
• 配置写错（空值或语法非法）只会退回默认标题并在控制台提示，不会影响使用。
  

6. 完全适配 Folia​

• 已声明 folia-supported: true。
• 读库/写库在异步线程；创建与读取界面、开界面、发消息都在玩家自己所在的区域线程。
• 跨线程传递的只有 Map<Integer, ItemStack> 克隆快照，绝不把 Inventory 本身带出线程。
• 写库带单调递增序号，异步池乱序完成时旧快照会被丢弃，不会出现「旧数据盖掉新改动」。
  

7. 数据与依赖​

• 内嵌 SQLite（WAL 模式），单文件 plugins/RptBackPack/backpack.db，不需要 MySQL。
• 物品按 ItemStack#serializeAsBytes() 存 BLOB，与 RPTCheckIn / RPTMarket 同一套存法。
• 无任何外部依赖：不需要经济插件、不需要 PlaceholderAPI。
  

支持版本与环境​

项目	说明
Minecraft 版本	1.21 ~ 26.2（api-version: 1.21，字节码目标 Java 21）
服务端核心	Folia、Paper（已声明 folia-supported: true）
Java 运行环境	Java 21 及以上
不支持	1.20.x 及以下（api-version 为 1.21，低版本核心会拒绝加载）
外部依赖	无

本轮实测环境：Folia 26.2-7（实现 API 26.2.build.7-beta）+ Java 25，插件加载、启用、reload 与优雅关服均无异常。

目标用户​

• 生存服 / 原版服服主 —— 给玩家一个随身背包，不用再回主城找箱子。
• 正在使用 Folia 核心的服主 —— 大量背包插件在 Folia 上会因跨线程操作实体或界面而报错，本插件按区域线程调度编写。
• 需要远程处理玩家物品的管理员 —— 离线玩家背包也能直接打开，找回装备、清理违规物品不用等他上线。
• 被「崩服丢装备」坑过的服主 —— 关闭界面立刻落库，把丢失窗口压到最小。
  

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

途径	内容
交流群	QQ 群 1124248111
作者 QQ	2221899680
游戏内	输入 /rptbp help 查看指令与说明

使用教程​安装​

• 将 RptBackPack-1.0.0.jar 放入服务端 plugins/ 目录。
• 重启服务端，首次启动会生成 plugins/RptBackPack/config.yml 与数据库文件 backpack.db。
• 需要调整配置时执行 /rptbp reload，无需重启服务端。
  

权限节点​

权限	默认值	说明
rptbp.use	所有玩家	打开自己的随身背包
rptbp.admin	仅 OP	/rptbp reload 重载配置
rptbp.admin.others	仅 OP	/rptbp <玩家> 查看与编辑他人背包

主要配置项（config.yml）​

配置项	默认值	说明
backpack-row	3	背包行数 1~6（每行 9 格）。改小不删数据
title	<gold><bold>RPT私人背包</bold></gold>	本人视角界面标题，支持 MiniMessage
title-other	…<white>{player}	管理员视角标题，{player} = 目标玩家名
auto-save-quit	true	退出游戏时是否再保存一次（关界面时始终会存）
database-file	backpack.db	数据库文件名（相对插件数据目录）
reload-msg / no-perm / no-perm-others / player-not-found / other-online-warn / load-failed	—	各类提示文案，均可改

常见问题​

• 问：/rptbp <玩家> 提示「找不到该玩家」？ 说明这个名字在背包数据库里没有记录（该玩家从未打开过随身背包）。在线玩家不受此限制。
• 问：/rptbp <玩家> 提示「该玩家在线，若他此刻也开着背包，他关闭时会覆盖你的改动」？ 这是在提醒并发编辑：对方手里的界面是同一份数据的另一个视图。让他先关掉背包，或者你改完让他重新打开一次即可。
• 问：我把 backpack-row 从 6 改成 3，超出的东西去哪了？ 还留在数据库里，没有删。调回 6 并 /rptbp reload 就能看到；控制台会提示「有 N 格物品超出当前容量」。
• 问：需要装 MySQL 或经济插件吗？ 都不需要，开箱即用。
• 问：支持 Folia 吗？ 支持，folia-supported: true，按区域线程调度编写。
  

声明​

• 本插件为原创作品，保留所有权利，默认不允许转载与整合。如需转载或整合进服务端整合包，请先通过上方交流群或作者 QQ 联系获取授权。
• 本插件未使用任何混淆手段，欢迎安全审查。
• 本插件不含任何后门、病毒或远程控制代码，不收集任何玩家数据。