BackPackManager(玩家背包管理)

插件

· 作者 lsfdc233

适用于支持 Bukkit API 1.21.1 的服务器(包括 Youer 的 Bukkit + NeoForge 环境)的玩家背包管理插件。

0 本站下载 0 关注 更新于 3 个月前

最新 1.2.0 · 26.2 · Bukkit / Paper

一键开服(送7天)

BackPackManager 1.2.0

兼容 Bukkit/Paper/Youer 服务器(版本 1.19.2–26.2);主要在 Youer 1.21.1(Bukkit + NeoForge)上测试并验证。 项目地址:

config.yaml: debug=true。启用后,服务器控制台会记录每条 /bpm 命令的执行者、完整参数以及结果(或失败原因)。

构建

需要 JDK 17 或更高版本;项目已包含 Gradle Wrapper:

.\gradlew.bat build

将 build/libs/BackPackManager-1.0.0.jar 放入服务器的 plugins 目录中。

命令

/backpackmanager(别名:/bpm)

  • /bpm export -p <player> -n <name>:保存在线玩家的背包。
  • /bpm setpublic -p <player> -n <name> [-pn <public_name>]:将私有备份转换为公共备份。
  • /bpm clear -p <player>:清空在线玩家的背包、盔甲栏和副手栏。
  • /bpm import -n <name>:将自己的私有备份导入到背包中。
  • /bpm import -p <player> -n <name>:将公共备份导入到指定在线玩家的物品栏中。
  • /bpm rm -player <player> -n <name> 或 /bpm rm -public -n <name>:删除备份。
  • /bpm -cn -player <player> -n <name> -en <new_name>:重命名私有备份。
  • /bpm -cn -public -n <name> -en <new_name>:重命名公共备份。
  • /bpm help:查看帮助。

-p 可以写为 -player,-n 可以写为 -name。名称仅允许使用字母、数字、下划线和连字符,以防止路径遍历漏洞。

数据与模组兼容性

.bpm 格式基于 YAML,而物品使用原生 Bukkit/Paper 二进制 ItemStack 数据进行存储。因此,原版物品组件、附魔、“不可破坏”属性、PDC 数据以及服务器识别的模组物品 NBT 均会被保留。该插件会保存原版的主体物品栏、盔甲栏和副手栏。由于 NeoForge 额外的饰品栏没有统一的 Bukkit API,如果相应模组提供了 Bukkit 接口,可以通过注册 BackPackExtraSlotProvider 来实现对其的支持。

当前构建以 Bukkit 1.19.2 API 作为编译基线。虽然主要运行和验证在 Minecraft 1.21.1 上进行,但插件保持了对 Minecraft 1.26.2 的前向兼容性。实现中避免直接使用服务器内部的 NMS 类;现代服务器自动使用原生物品字节格式,而 1.19.2 则回退到 Bukkit 兼容的序列化方式。这种方法保留了 1.21.1 及更高版本的物品组件、附魔、“不可破坏”属性、PDC 以及服务器识别的模组数据,同时确保标准 Bukkit 物品仍能在 1.19.2 上保存和恢复。请注意,当跨越主要版本差距导入时,无法保证保留服务器无法识别的物品或数据组件。此构建不支持 1.8.9 版本;由于与 1.19.2+ 相比存在 Java 版本、物品数据模型和 Bukkit API 的不兼容性,需要单独的构建和序列化适配层。

适用于 Bukkit/Paper/Youer 1.19.2–26.2 的服务器;主要运行与验证版本为 Youer 1.21.1(Bukkit + NeoForge)。 项目地址:

config.yaml: debug=true。开启后,服务器控制台会记录每一条 /bpm 命令的执行者、完整参数、操作结果或失败原因。

构建

需要 JDK 17 或更高版本;项目已附带 Gradle Wrapper:

.\gradlew.bat build

将 build/libs/BackPackManager-1.0.0.jar 放入服务器的 plugins 目录。

命令

/backpackmanager(别名:/bpm)

  • /bpm export -p <玩家> -n <名称>:保存在线玩家的背包。
  • /bpm setpublic -p <玩家> -n <名称> [-pn <公开名称>]:将私有备份转为公开备份。
  • /bpm clear -p <玩家>:清空在线玩家背包、盔甲和副手。
  • /bpm import -n <名称>:将自己的私有备份导入自己背包。
  • /bpm import -p <玩家> -n <名称>:将公开备份导入指定在线玩家。
  • /bpm rm -player <玩家> -n <名称> 或 /bpm rm -public -n <名称>:删除备份。
  • /bpm -cn -player <玩家> -n <名称> -en <新名称>:重命名私有备份。
  • /bpm -cn -public -n <名称> -en <新名称>:重命名公开备份。
  • /bpm help:查看帮助。

-p 可写作 -player,-n 可写作 -name。名称只允许字母、数字、下划线和连字符,避免路径穿越。

数据与模组兼容性

.bpm 是 YAML 格式,物品以 Bukkit/Paper 原生二进制 ItemStack 数据保存,因此原版物品组件、附魔、不可破坏属性、PDC 和服务器能识别的模组物品 NBT 会被保留。插件保存原版的主背包、盔甲栏、副手。NeoForge 额外饰品栏没有统一 Bukkit API;若其模组提供 Bukkit 接口,可通过 BackPackExtraSlotProvider 注册实现以纳入备份。

当前构建以 Bukkit 1.19.2 API 作为编译基线,主要运行与验证版本保持 Youer 1.21.1,并尽可能向上兼容至 Minecraft 26.2。实现不使用服务端内部 NMS 类;现代服务端会自动采用原生物品字节格式,1.19.2 则自动回退到 Bukkit 兼容序列化。这样既保留 1.21.1+ 的物品组件、附魔、不可破坏属性、PDC 和服务端可识别模组数据,也可在 1.19.2 中正常保存和恢复 Bukkit 物品。跨不同大版本导入时,服务器不认识的物品或数据组件无法保证保留。1.8.9 不在本构建支持范围内:其 Java 版本、物品数据模型和 Bukkit API 与 1.19.2+ 不兼容,需单独维护旧版构建及序列化适配层。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源