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.jar into your server's plugins/ folder.
- Restart (or reload) the server.
- (Optional) Copy
resource-pack/ contents, host the pack, and set it as your
server resource pack in server.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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧