Backpack plugin

插件

· 作者 bugwizzz

一款轻量且功能强大的 Minecraft 服务器背包插件。为玩家提供可自定义大小、权限和管理员工具的个性化虚拟背包。

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

最新 1.0.0 · 26.2 · Folia

一键开服(送7天)

? Backpack

支持的加载器: Bukkit、Spigot、Paper、Purpur、Folia 支持版本: 1.21.x、26.1.x、26.2.x(Java 21+)


? 兼容性与核心支持

加载器 兼容性状态 备注
Paper / Purpur ? 原生 100% 支持 推荐。性能最佳并支持 MiniMessage。
Spigot / Bukkit ? 原生 100% 支持 完全兼容。传统颜色代码和 API 完美运行。
Folia ? 原生 100% 支持 完全支持! 使用基于区域的调度,防止线程错误。

✨ 功能特性

  • 6 种背包尺寸 — 从 1 行(9 格)到 6 行(54 格)
  • 基于权限的尺寸控制 — 插件会自动给予玩家其拥有权限的最大尺寸背包
  • 死亡清空 — 默认情况下,玩家死亡时背包物品会丢失(可通过 backpack.keep 权限配置)
  • 管理工具 — 实时查看和编辑任何玩家的背包,即使他们离线
  • 按玩家存储 — 每个玩家的背包独立存储,以实现最佳性能
  • 异步保存 — 所有文件 I/O 均在主线程之外运行,以防止卡顿
  • 自动保存 — 定期保存以防止物品丢失(可配置间隔时间)
  • MiniMessage 支持 — 所有消息中均支持完整的十六进制颜色、渐变色和富文本格式
  • PlaceholderAPI 支持 — 可在背包标题中使用任何 PAPI 占位符(可选)
  • 音效 — 可配置的打开/关闭音效
  • 完全可配置 — 每条消息、标题、音效和间隔时间均可在 config.yml 中更改
  • 轻量级 — 无需依赖项,针对大型服务器进行了优化

? 命令

命令 描述
/backpack 打开你的背包
/bp /backpack 的别名
/bpack /backpack 的别名
/backpack reload 重新加载插件配置
/backpack <player> 打开其他玩家的背包(实时编辑)
/backpack give <player> <rows> 显示如何授予背包权限的信息

? 权限

玩家权限

权限 描述 默认值
backpack.row.1 1 行 — 9 格 false
backpack.row.2 2 行 — 18 格 false
backpack.row.3 3 行 — 27 格 false
backpack.row.4 4 行 — 36 格 false
backpack.row.5 5 行 — 45 格 false
backpack.row.6 6 行 — 54 格 false
backpack.keep 死亡时保留背包物品 false

工作原理: 插件会自动检测玩家拥有的最高行数权限。

例如,如果玩家拥有 backpack.row.1、backpack.row.2 和 backpack.row.3,他们的背包将是 27 格(3 行)。

如果玩家没有任何 backpack.row.* 权限,则 /backpack 命令将无法打开背包,并将看到“无权限”的消息。

死亡行为

默认情况下,当玩家死亡时,其背包内容会被清空。若要允许某些玩家(如捐赠者、VIP)在死亡时保留背包物品,请授予他们 backpack.keep 权限。

管理员权限

权限 描述 默认值
backpack.admin 所有管理功能 op
backpack.reload 重新加载配置文件 op
backpack.bypass 绕过限制(始终获得最大尺寸) op
backpack.view 查看和编辑其他玩家的背包 op
backpack.give 使用给予信息命令 op
backpack.* 授予上述所有权限 + 所有行数 + 死亡保留 op

⚙️ 配置

插件首次运行时会在 config.yml 生成带有完整注释的配置。以下是关键选项:

设置项 描述 默认值
prefix 消息前缀(支持 MiniMessage) 渐变 "Backpack"
messages.no-permission 玩家无背包权限时显示 可配置
messages.death-clear 背包在死亡时被清空时显示 可配置
gui.title 背包窗口标题(支持 %player%) <gold>%player%'s Backpack
sounds.open 打开背包时的音效 BLOCK_CHEST_OPEN
sounds.close 关闭背包时的音效 BLOCK_CHEST_CLOSE
autosave.interval 自动保存间隔(秒) 300(5 分钟)
cache.timeout 离线 X 分钟后卸载背包 10
debug 启用调试日志 false

所有消息均支持 MiniMessage 格式,包括十六进制颜色如 <color:#FF5555> 和渐变色如 <gradient:#FF6B6B:#4ECDC4>。


? 安装

  1. 从 versions 文件夹中选择与您的服务器加载器和版本匹配的 JAR 文件:
    • 适用于 Paper / Purpur / Folia / Spigot / Bukkit
    • 适用于 1.21.x / 26.1.x / 26.2
  2. 将其放入服务器的 plugins/ 文件夹(或等效的 mods/plugins 目录)
  3. 重启服务器
  4. 编辑 plugins/Backpack/config.yml 以自定义消息和设置
  5. 使用您的权限插件(例如 LuckPerms)向玩家授予 backpack.row.* 权限

LuckPerms 示例设置:

/lp group default permission set backpack.row.3 true    # 所有玩家获得 3 行
/lp group vip permission set backpack.row.6 true        # VIP 获得 6 行
/lp group vip permission set backpack.keep true          # VIP 死亡时保留物品

? 存储

每个玩家的背包都存储为单独的 YAML 文件:

plugins/Backpack/data/<uuid>.yml

这意味着:

  • ✅ 无需数据库设置
  • ✅ 易于备份和迁移
  • ✅ 大量玩家数量下无性能问题
  • ✅ 所有保存均为异步操作(无卡顿)

❓ 常见问题

Q: 如果服务器崩溃会发生什么? A: 插件会定期自动保存所有背包(默认:每 5 分钟)。正常关机时,所有内容会立即保存。

Q: 管理员可以编辑离线玩家的背包吗? A: 是的!使用 /backpack <playername> 命令并拥有 backpack.view 权限,即可打开并编辑任何玩家的背包,即使他们处于离线状态。

问:该插件会导致延迟吗? 答:不会。所有文件操作均为异步执行。该插件专为拥有数百名玩家的大型服务器设计。

问:必须安装 PlaceholderAPI 吗? 答:不需要。PlaceholderAPI 是可选的。如果已安装,您可以在背包标题中使用任何 PAPI 占位符。即使不安装它,插件也能完美运行。

问:玩家死亡时会丢失背包物品吗? 答:默认情况下会丢失。授予 backpack.keep 权限可以让玩家在死亡时保留背包物品。


? 支持

如果您遇到任何问题,请提供以下信息以进行报告:

  • 服务器版本(输入 /version)
  • 插件版本
  • logs/latest.log 中的错误日志
  • 重现问题的步骤

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源