BackPackSSS
BackPackSSS 是一款轻量级、适合生存模式的背包插件,适用于 PaperMC 1.21+。 它具备 3 阶制作进阶系统、自定义 3D 资源包模型、 SQLite 数据持久化以及强大的防刷机制 —— 服务器开销极小。
当前版本:1.9
功能特性
| 功能 | 详情 |
|---|---|
| 3 种背包等级 | 弱等(18 格)→ 良等(27 格)→ 强等(54 格) |
| 等级升级制作 | 使用上一级背包作为核心材料来合成更高等级的背包 |
| 3D 资源包 | 每个等级都有自定义的线团模型(棕色 / 黄色 / 红色) |
| SQLite 持久化 | 数据重启后保留;异步脏标记保存,关机时同步保存 |
| 防刷保护 | 会话锁定、打开冷却时间、死亡/退出时保存 |
| 嵌套防止 | 阻止在背包内放入背包、潜影盒和线团 |
| 物品过滤 | 明确禁止放置护甲、工具、武器和附魔书 |
| 最大背包数量限制 | 可配置的玩家持有上限(默认:1) |
| 基于权限的管理员功能 | backpack.admin 用于给予/重载;兼容 LuckPerms 等权限插件 |
环境要求
- 服务端: PaperMC 1.21 或更高版本
- Java: 21+
- SQLite JDBC: PaperMC 已内置 — 无需额外 jar 包
从源码构建
git clone <repo-url>
cd BackPackSSS
mvn clean package
# 输出: target/BackPackSSS-1.9.jar
需要 Maven 3.8+ 和 JDK 21。
安装
- 将
BackPackSSS-1.9.jar放入服务端的plugins/文件夹中。 - 重启(或重载)服务器。
- (可选) 复制
resource-pack/目录内容,托管该资源包,并在server.properties中将其设置为服务器的资源包。
命令
| 命令 | 权限节点 | 描述 |
|---|---|---|
/backpack 或 /bp |
backpack.use |
显示制作提醒 |
/bp give <tier> |
backpack.admin |
给自己一个背包(1–3 级) |
/bp give <tier> <player> |
backpack.admin |
给另一名在线玩家一个背包 |
/bp reload |
backpack.admin |
不重启服务器即可重载配置 |
权限节点
| 节点 | 默认值 | 描述 |
|---|---|---|
backpack.use |
everyone | 允许打开背包 |
backpack.admin |
OP | 访问 give 和 reload 子命令 |
制作配方
第 1 级 — 弱等背包 (18 格)
[L][L][L]
[L][C][L]
[L][L][L]
L = 皮革 | C = 箱子
第 2 级 — 良等背包 (27 格)
[I][R][I]
[R][B1][R]
[I][R][I]
I = 铁锭 | R = 红石粉 | B1 = 第 1 级背包
第 3 级 — 强等背包 (54 格)
[S][D][S]
[D][B2][D]
[S][D][S]
S = 潜影壳 | D = 钻石 | B2 = 第 2 级背包
配置文件 (config.yml)
auto-discover-recipes: true # 加入服务器时在食谱书中显示配方
restrictions:
max-backpacks: 1 # 每个玩家背包栏的最大背包数量(0 = 无限)
allow-nesting: false # 阻止在背包内放入背包/潜影盒/线团
filter-special-items: true # 阻止护甲、工具、武器、附魔书
tiers:
1:
name: "&fWeak Backpack"
size: 18 # 必须是 9 的倍数(最大 54)
cmd: 10101 # CustomModelData 需与你的资源包匹配
lore:
- "&7Level: &fWeak"
- "&7Capacity: &b18 slots"
- ""
- "&a右键点击以打开!"
# 第 2 和第 3 级遵循相同的结构
关于 size 的说明: 在玩家已经存入物品后更改等级的 size 是安全的——插件会裁剪多余物品并记录警告日志,而不会导致崩溃。
物品过滤 (filter-special-items)
启用后,以下物品类别不能放入背包中:
- 护甲(头盔、胸甲、护腿、靴子 — 所有材质)
- 近战武器(剑 — 所有材质)
- 工具(斧头、镐、锹、锄 — 所有材质)
- 远程武器(弓、弩、三叉戟)
- 盾牌、鞘翅、剪刀、打火石
- 附魔书
- 不死图腾
来自其他插件且堆叠大小为 1 的常规物品不会被阻止,除非它们属于上述类别之一。
更新日志
有关完整的变更历史,请参见 CHANGELOG.md。
作者
Duong2012G — 欢迎提供反馈和漏洞报告。
BackPackSSS
BackPackSSS is a lightweight, survival-friendly backpack plugin for PaperMC 1.21+. It features a 3-tier crafting progression system, custom 3D resource-pack models, SQLite persistence, and robust anti-dupe protection — with minimal server overhead.
Current version: 1.9
Features
| Feature | Details |
|---|---|
| 3 backpack tiers | Weak (18 slots) → Good (27 slots) → Strong (54 slots) |
| Tier upgrade crafting | Craft a higher tier using the previous tier as center ingredient |
| 3D resource pack | Custom bundle model per tier (brown / yellow / red) |
| SQLite persistence | Data survives restarts; async dirty-flag saves, sync save on shutdown |
| Anti-dupe protection | Session lock, opening cooldown, death/quit save |
| Nesting prevention | Blocks backpacks, shulker boxes, and bundles inside backpacks |
| Item filter | Explicitly blocks armor, tools, weapons, and enchanted books |
| Max backpack limit | Configurable per-player limit (default: 1) |
| Permission-based admin | backpack.admin for give/reload; works with LuckPerms etc. |
Requirements
- Server: PaperMC 1.21 or later
- Java: 21+
- SQLite JDBC: bundled by PaperMC — no extra jars needed
Building from Source
git clone <repo-url>
cd BackPackSSS
mvn clean package
# Output: target/BackPackSSS-1.9.jar
Requires Maven 3.8+ and JDK 21.
Installation
- Drop
BackPackSSS-1.9.jarinto your server'splugins/folder. - Restart (or reload) the server.
- (Optional) Copy
resource-pack/contents, host the pack, and set it as your server resource pack inserver.properties.
Commands
| Command | Permission | Description |
|---|---|---|
/backpack or /bp |
backpack.use |
Show craft reminder |
/bp give <tier> |
backpack.admin |
Give yourself a backpack (tier 1–3) |
/bp give <tier> <player> |
backpack.admin |
Give a backpack to another online player |
/bp reload |
backpack.admin |
Reload config without restarting |
Permissions
| Node | Default | Description |
|---|---|---|
backpack.use |
everyone | Allows opening a backpack |
backpack.admin |
OP | Access to give and reload sub-commands |
Crafting Recipes
Tier 1 — Weak Backpack (18 slots)
[L][L][L]
[L][C][L]
[L][L][L]
L = Leather | C = Chest
Tier 2 — Good Backpack (27 slots)
[I][R][I]
[R][B1][R]
[I][R][I]
I = Iron Ingot | R = Redstone | B1 = Tier 1 Backpack
Tier 3 — Strong Backpack (54 slots)
[S][D][S]
[D][B2][D]
[S][D][S]
S = Shulker Shell | D = Diamond | B2 = Tier 2 Backpack
Configuration (config.yml)
auto-discover-recipes: true # Show recipes in recipe book on join
restrictions:
max-backpacks: 1 # Max backpacks per player inventory (0 = unlimited)
allow-nesting: false # Block backpacks/shulkers/bundles inside backpacks
filter-special-items: true # Block armor, tools, weapons, enchanted books
tiers:
1:
name: "&fWeak Backpack"
size: 18 # Must be a multiple of 9 (max 54)
cmd: 10101 # CustomModelData matching your resource pack
lore:
- "&7Level: &fWeak"
- "&7Capacity: &b18 slots"
- ""
- "&aRight-click to open!"
# tiers 2 and 3 follow the same structure
Notes on size: Changing a tier's size after players have already stored items is
safe — the plugin will trim excess items and log a warning rather than crash.
Item Filter (filter-special-items)
When enabled, the following item categories cannot be placed inside a backpack:
- Armor (helmets, chestplates, leggings, boots — all materials)
- Melee weapons (swords — all materials)
- Tools (axes, pickaxes, shovels, hoes — all materials)
- Ranged weapons (bows, crossbows, tridents)
- Shields, elytras, shears, flint and steel
- Enchanted books
- Totems of undying
Regular items with a stack size of 1 from other plugins are not blocked unless they match one of the categories above.
Changelog
See CHANGELOG.md for the full history of changes.
Author
Duong2012G — feedback and bug reports welcome.
下载 BackPackSSS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BackPackSSS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BackPackSSS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BackPackSSS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BackPackSSS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BackPackSSS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BackPackSSS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BackPackSSS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BackPackSSS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BackPackSSS
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
BackPackSSS v1.9 → v1.9.1
报告的症状
- 背包的升级配方在合成配方书中表现不正确。
- 即使拥有正确的材料,玩家也无法合成优质背包(“中型”,第 2 阶)。
这两个症状都源于同一个根本原因。
BUG-11(严重):升级配方的 ExactChoice NBT 锁定
文件: BackPackSSS.java → registerRecipes()
根本原因
第 2 阶和第 3 阶的配方中心原料槽 ('B') 的使用方式如下:
ItemStack centerItem = backpackManager.createBackpack(1); // 新创建的,尚无 BP_ID
...
recipe.setIngredient('B', new RecipeChoice.ExactChoice(centerItem));
RecipeChoice.ExactChoice 要求放入合成网格的物品必须与 centerItem 字节级 NBT 完全相同(通过 ItemStack.isSimilar 判断)。当 registerRecipes() 运行时,centerItem 的 PersistentDataContainer 中仅包含 BP_TIER_KEY —— 它从未被打开过,因此还没有 BP_ID_KEY。
问题出在 BackpackListener#onInteract:
if (!pdc.has(BackpackManager.BP_ID_KEY, PersistentDataType.STRING)) {
UUID newId = UUID.randomUUID();
pdc.set(BackpackManager.BP_ID_KEY, PersistentDataType.STRING, newId.toString());
item.setItemMeta(meta);
}
当玩家第一次右键点击其劣质背包以打开它时(这是每个玩家的常规操作),一个随机的 BP_ID_KEY 会被永久地烙印到该特定物品的 NBT 上。从此以后,该物品将永远无法与用于注册配方的“干净” centerItem 满足 isSimilar() 条件 —— 世界中每一个曾经使用过的真实背包,其 NBT 快照都与创建配方时所基于的那个不同。
一旦发生这种情况,Bukkit 自身的配方匹配器会在 BackpackListener#onPrepareCraft(插件自身的阶位验证处理器,它已经只检查 BP_TIER_KEY 且逻辑正确)有机会运行之前,就完全拒绝该形状配方:
- 合成台完全不显示输出结果 → “无法合成中型背包”。
- 配方书自动填充/高亮功能找不到任何满足精确 NBT 要求的库存物品,因此即使玩家手持有效的劣质背包,升级配方也不会亮起显示为可合成状态 → “配方在配方书中不显示/不可用”。
简而言之:插件在 onPrepareCraft() 中已经具备正确的验证逻辑,但 ExactChoice 原料在它前面充当了一个更严格的关卡,一旦任何背包被使用过一次,就会静默地阻断所有内容。
修复方法
将原料替换为普通的 MaterialChoice,这与代码在 centerItem 为 null 时已使用的回退分支一致:
recipe.setIngredient('B', new RecipeChoice.MaterialChoice(Material.BUNDLE));
现在 Bukkit 的匹配器仅检查“中心槽是否是一个 Bundle”,而现有的 onPrepareCraft() 逻辑(isBackpackTier(center, 1) / isBackpackTier(center, 2))—— 它正确地仅读取 BP_TIER_KEY并忽略每个实例的BP_ID_KEY—— 才是实际决定合成是否有效并设置结果的逻辑。一个使用过的背包、一个新合成的背包,或通过/backpack give` 获得的背包,现在作为升级材料的表现完全一致。放置在中心槽的原版 vanilla Bundle 或错误阶位的背包仍然正确地不会产生结果。
更改的文件
BackPackSSS.java(registerRecipes()),第 2 阶和第 3 阶代码块。
测试验证步骤
/backpack give 1 <player>→ 此检查不需要进行合成。- 右键点击劣质背包一次以打开它(这将烙印
BP_ID_KEY)。 - 将其放在合成台中心,周围放置铁锭和红石。
- 确认优质背包(第 2 阶 / “中型”)现在作为输出结果出现并可被取走。
- 确认配方在配方书中可被发现且高亮显示正确。
- 对第 2 阶 → 第 3 阶重复上述操作,使用潜影壳 + 钻石。
版本更新: 1.9 → 1.9.1 (pom.xml, plugin.yml, config.yml 头部)。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧