Floyd-Backpack

插件

· 作者 codeNoob2281

适用于 Paper 服务器的简易背包插件

0 本站下载 0 关注 更新于 1 周前

最新 1.2.0 · 26.3 · Paper / Purpur

一键开服(送7天)

Floyd-Backpack

概述

Floyd-Backpack 是一款基于 PaperMC 的服务端背包插件,为每位玩家提供独立的 54 格存储空间。该插件基于 Floyd-Core 框架开发,支持数据持久化、通过工具物品快速访问背包,以及二次确认机制以防止误操作。

功能特性

  • 54 格背包:每位玩家拥有独立的双箱容量存储空间,按 UUID 隔离
  • 背包工具:玩家加入服务器或重生时会自动获得一个工具物品(末影之眼);右键点击即可打开背包;为防止误操作,该工具物品无法存入背包中
  • 数据持久化:玩家退出时自动保存,服务器关闭时批量持久化至 JSON 文件
  • 清空功能:一键清空背包,具备二次确认机制和可配置的超时时间
  • 国际化:内置英文和简体中文,可通过配置文件切换;背包标题会随语言动态更新
  • 热重载:支持无需重启服务器即可重新加载配置
  • 线程安全:背包数据使用 ReentrantLock 确保线程安全

命令

命令 别名 权限节点 描述
/backpack /bp floydbackpack.open 打开个人背包(默认操作)
/backpack open - floydbackpack.open 打开个人背包
/backpack clear - floydbackpack.clear 清空背包(需要二次确认)
/backpack clear confirm - floydbackpack.clear 确认清空背包
/backpack clear cancel - floydbackpack.clear 取消清空操作
/backpack reload - floydbackpack.reload 重新加载配置
/backpack help - floydbackpack.help 显示帮助信息

控制台无法执行与背包相关的命令。

使用示例

# 打开背包
/bp

# 或使用完整命令
/backpack

# 清空背包(触发二次确认)
/bp clear

# 确认清空(不可逆操作)
/bp clear confirm

# 取消清空
/bp clear cancel

# 重新加载配置
/bp reload

# 查看帮助
/bp help

清空操作流程

  1. 输入 /bp clear,系统显示确认消息和倒计时
  2. 输入 /bp clear confirm 确认清空(不可逆)
  3. 输入 /bp clear cancel 取消操作
  4. 如果在超时时间内未确认,操作将自动过期

权限

权限节点 默认值 描述
floydbackpack.open true (所有人) 允许玩家打开背包
floydbackpack.clear op (管理员) 允许玩家清空背包
floydbackpack.reload op (管理员) 允许重新加载配置
floydbackpack.help true (所有人) 显示帮助信息

背包工具

当玩家加入服务器或重生时,如果其物品栏中没有工具物品,系统将自动发放一个 末影之眼 作为背包工具。

  • 获取方式:玩家加入/重生时自动发放
  • 使用方法:手持工具物品时右键点击以打开背包
  • 锁定保护:通过点击、拖拽、Shift+移动或快捷键等方式,无法将该工具物品放入背包界面,防止意外存储
  • 识别机制:通过 PersistentDataContainer 标签进行识别,支持多语言环境;同时也保留了基于物品类型和附魔的向后兼容识别方式
  • 替代方法:也可以使用 /bp 命令来打开背包

配置

配置文件位置:plugins/FloydBackpack/config.yml。

完整配置项

logging:
  file:
    enable: true       # 是否启用文件日志记录
  level: INFO          # 日志级别

command:
  backpack:
    clear:
      enable: true         # 是否启用背包清空命令
      need-confirm: true   # 清空前是否需要二次确认
      confirm-interval: 30000  # 二次确认超时时间(毫秒)

i18n:
  locale: en           # 语言设置,选项:en / zh_cn

配置项说明

路径 类型 默认值 描述
logging.file.enable boolean true 是否输出日志到文件
logging.level string INFO 日志输出级别
command.backpack.clear.enable boolean true 是否启用 /bp clear 命令
command.backpack.clear.need-confirm boolean true 清空背包前是否需要二次确认
command.backpack.clear.confirm-interval long 30000 二次确认超时时间(毫秒)
i18n.locale string en 语言区域设置

热重载

修改配置文件后,无需重启服务器。执行以下命令即可应用更改:

/bp reload

国际化

插件包含两个内置语言文件:

语言 文件名 配置值
英文 language/en.yml en
简体中文 language/zh_cn.yml zh_cn

切换语言后执行 /bp reload 即可生效。背包界面标题会随语言设置动态更新。已打开的旧界面将在下次操作时使用新语言标题重建,且不会丢失物品内容。

自定义语言文件

要添加内置之外的语言(例如日语),您可以手动创建语言文件:

  1. 在 plugins/FloydBackpack/language/ 目录下创建一个新的 YAML 文件(如果目录不存在,请手动创建)
  2. 参考内置语言文件的结构,翻译所有的消息键。例如,创建一个日语文件 language/ja.yml:
command:
  backpack:
    console-not-allowed: "§c无法从控制台执行此命令。"
    reload:
      start: "§a正在重新加载配置..."
      success: "§a重新加载完成 ({0}ms)。"
      failure: "§c重新加载失败。请检查控制台。"
    help:
      line1: "§b[Floyd-Backpack] §a§l帮助"
      line2: "§6§n>> 命令"
      line3: "§3/bp open §e- §7打开背包"
      line4: "§3/bp clear §e- §7清空背包"
      line5: "§3/bp reload §e- §7重新加载配置"
      line6: "§e详情: §f§nhttps://github.com/codeNoob2281/Floyd-Backpack"
    clear:
      feature-disabled: "§c清空背包功能已禁用。"
      pending-operation-exists: "§e存在待处理的确认操作。请继续。"
      confirm-delete: "§a确定要清空背包吗?此操作不可撤销。"
      confirm-timeout: "§9请在剩余 {0} 秒内确认。"
      no-active-operation: "§e没有有效的确认操作。"
      operation-cancelled: "§e清空背包操作已取消。"
      cleared: "§a背包已清空。§c{0}§a 个物品被删除。"
      tip-confirm: "§6输入 §c/bp clear confirm §6以确认"
      tip-cancel: "§6输入 §c/bp clear cancel §6以取消"
      operation-expired: "§e[Floyd-Backpack] §6上一次操作已过期。"
chest-ui:
  backpack-title: "§6{0}的背包"
backpack-tool:
  item-name: "§b[Floyd-Backpack]§6 右键点击打开背包"
  lore-line1: "§a手持此物品右键点击可打开背包"
  lore-line2: "§a或使用 /bp 命令"
  1. 修改 config.yml 中的语言配置:
i18n:
  locale: ja
  1. 执行 /bp reload 使新语言生效

语言文件必须与内置文件保持相同的 YAML 结构和键名,否则插件可能无法正常加载。如果插件无法自动读取外部语言文件,请将文件放置在源代码 src/main/resources/language/ 目录中并重新构建。

数据存储

玩家背包数据的存储位置:

plugins/FloydBackpack/backpack/<player-UUID>.json
  • 每个玩家的背包数据独立保存,使用 UUID 命名
  • 保存时机:玩家退出服务器时自动保存;服务器关闭时批量保存所有在线玩家的数据
  • 加载方式:首次打开背包时从磁盘加载,后续操作使用内存缓存
  • 容错机制:如果 JSON 数据损坏,会自动备份为 .bak.<timestamp> 文件,并为玩家创建一个新的空背包
  • 线程安全:每个背包实例持有 ReentrantLock,确保多线程环境下的数据安全

使用说明

  1. 清空背包是不可逆操作;开启二次确认后,请务必在执行前进行确认
  2. 控制台无法执行任何背包命令
  3. Floyd-Core 作为 Maven 依赖嵌入到插件中,无需额外安装
  4. 背包工具物品不能存储在背包界面中;这可以防止误存导致无法打开背包的情况
  5. 切换语言后,请执行 /bp reload 使新的语言设置生效
  6. 建议定期备份 plugins/FloydBackpack/backpack/ 目录中的数据文件

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源