? BackpackPlugin
适用于 Paper 1.21 服务器的完全可配置的层级背包插件。玩家可通过 6 种内置层级 购买和升级背包 —— 每种层级都有独特的自定义头颅外观、自动拾取、物品整理、NPC 商店,以及通过游戏内命令无限创建自定义类型的能力。无需资源包。
✨ 功能特性
- 6 种内置背包层级 — 破旧挎包 → 皮革 → 铁 → 金 → 钻石 → 末影
- 无限自定义背包类型 — 通过
backpacks.yml 或游戏内向导添加任意背包
- 每层级自定义玩家头颅外观 — 无需资源包
- 可在胸甲槽位穿戴 — 穿戴时提供护甲值;Shift+右键点击进行穿戴/卸下
- 支持在主手、副手和胸甲槽位中使用
- 自动拾取开关(每个背包独立设置)— 物品直接存入包中
- GUI 内的整理按钮 — 按物品类型字母顺序整理内容
- 重命名系统 — 可配置经验值消耗,支持颜色代码
- FancyNPCs 商人 — 从世界中的 NPC 处购买和升级背包
- 单背包升级系统 — 存储行数、自动拾取解锁和护甲值 —— 每项都有独立的成本和倍率
- 分页 GUI — 共 9 页,每页最多 54 行存储空间
- 内容以 NBT 格式保存在物品本身 — 重启、掉落和转移后数据不丢失
- 可配置的死亡行为:
DROP(掉落)、KEEP(保留)或 DELETE(删除)
- ItemsAdder 支持 — 使用任何自定义物品作为背包视觉外观(若不可用则回退到头颅)
- 完整的 Bedrock 支持 — 通过 Geyser 实现,输入
/bp 打开你装备的背包
? 背包层级
| 层级 |
初始行数 |
最大行数 |
商店价格 |
| 破旧挎包 (Worn Satchel) |
1 |
3 |
$500 |
| 皮革背包 (Leather Backpack) |
2 |
5 |
$2,000 |
| 铁背包 (Iron Backpack) |
3 |
8 |
$5,000 |
| 金背包 (Gold Backpack) |
4 |
12 |
$12,000 |
| 钻石背包 (Diamond Backpack) |
5 |
18 |
$30,000 |
| 末影背包 (Ender Backpack) |
6 |
24 |
$75,000 |
所有层级、价格、行数及升级成本均可在 backpacks.yml 中完全自定义。
? 安装方法
- 将
BackpackPlugin.jar 放入服务器的 plugins/ 文件夹中
- 确保已安装 Vault 和一个经济类插件
- 重启服务器 ——
config.yml 和 backpacks.yml 将自动生成
- 可选安装 FancyNPCs 以获取商人 NPC,以及 ItemsAdder 以支持自定义视觉外观
- 对配置文件进行任何更改后,运行
/backpack reload
? 使用方法
打开背包
| 方式 |
Java 版 |
Bedrock 版 |
| 手持于主手 |
右键点击 |
长按 |
| 手持于副手 |
右键点击 |
长按 |
| 穿戴于胸甲槽 |
/bp |
/bp |
穿戴至胸甲槽位
将背包持于主手中,然后按住 Shift + 右键点击 将其穿戴至胸甲槽位。再次按住 Shift + 右键点击 即可卸下。
GUI 内部操作
| 按钮 |
功能 |
| Sort (整理) |
按字母顺序整理内容 |
| Auto-Pickup (自动拾取) |
切换自动拾取的开启/关闭状态 |
| Rename (重命名) |
重命名你的背包(消耗经验等级) |
| Prev / Next (上一页/下一页) |
在存储页面间导航 |
? NPC 商店
在任何位置生成一个商人 NPC:
/backpack spawnnpc <n>
玩家可以在 Buy(购买)标签页浏览层级,并在 Upgrade(升级)标签页升级他们的背包。商店会自动从 backpacks.yml 填充内容 —— 添加新类型后无需额外设置。
➕ 添加自定义背包
选项 1 — 游戏内向导(推荐):
/backpack create mythic_backpack
在聊天栏回答 9 个提示问题(显示名称、头颅纹理、ItemsAdder ID、行数、护甲、升级成本等)。完成后会出现可点击的 [Give to yourself](给予自己)和 [Edit fields](编辑字段)按钮。
选项 2 — 直接编辑 backpacks.yml:
backpacks:
mythic_backpack:
display: "&d&lMythic Backpack"
price: 150000.0
skull_texture: "eyJ..." # 来自 minecraft-heads.com 的 Base64 值
itemsadder_id: "" # 例如 mynamespace:my_item —— 留空则使用头颅
initial_rows: 6
max_rows: 36
armor_base: 5
upgrades:
storage:
enabled: true
max_purchases: 30
rows_per_purchase: 1
base_cost: 20000.0
cost_multiplier: 1.6
autopickup:
enabled: true
cost: 40000.0
armor:
enabled: true
max_purchases: 8
points_per_purchase: 1
base_cost: 15000.0
cost_multiplier: 1.6
运行 /backpack reload —— 新类型会立即出现在 NPC 商店中。
? 命令
权限:backpack.admin(默认 OP 拥有)
| 命令 |
描述 |
/bp |
打开你当前装备的背包 |
/backpack shop |
手动打开 NPC 商店 |
/backpack give <player> <id> |
给予某玩家一个背包 |
/backpack create <id> |
启动游戏内创建向导 |
/backpack cancel |
中止当前的创建向导 |
/backpack bpedit <id> <field> <value> |
实时编辑背包类型的任意字段 |
/backpack bpdelete <id> |
删除一个背包类型 |
/backpack list |
列出所有已加载的背包 ID |
/backpack reload |
重新加载 config.yml 和 backpacks.yml |
/backpack spawnnpc <n> |
生成一个商人 NPC |
/backpack removenpc <n> |
移除一个商人 NPC |
⚙️ Lore 占位符
| 占位符 |
值 |
{name} |
自定义名称(若未重命名则显示默认名称) |
{type} |
始终为原始类型 ID |
{slots_used} / {slots_total} |
存储占用情况 |
{rows} |
当前行数 |
{autopickup} |
On / Off |
{level} / {max_level} |
升级进度 |
{armor} |
当前护甲值 |
? 权限
| 权限 |
默认值 |
描述 |
backpack.use |
Everyone |
打开并使用背包 |
backpack.autopickup |
Everyone |
使用自动拾取功能 |
backpack.bypass.blacklist |
false |
绕过自动拾取的物品黑名单 |
backpack.admin |
OP |
所有管理命令 |
? 依赖要求
- Paper 1.21.x (不支持 Spigot) · Java 21+
- Vault + 一个经济插件(EssentialsX、CMI 等)
- FancyNPCs 2.9+ (可选,用于商人 NPC)
- ItemsAdder 3.6+ (可选,用于自定义物品外观)
- Geyser (可选,用于基岩版支持 — 自动生效)
? 加入我们的 Discord 获取支持、下载和更新
? Treamhiler 的其他插件
? GitHub
? BackpackPlugin
A fully configurable tiered backpack plugin for Paper 1.21 servers. Players can purchase and upgrade backpacks through 6 built-in tiers — each with a unique custom head appearance, auto-pickup, inventory sorting, NPC shop, and unlimited custom types via in-game commands. No resource pack required.
✨ Features
- 6 built-in backpack tiers — Worn Satchel → Leather → Iron → Gold → Diamond → Ender
- Unlimited custom backpack types — add any backpack via
backpacks.yml or the in-game wizard
- Custom player head appearance per tier — no resource pack needed
- Equippable in the chestplate slot — grants armor points when worn; Shift+Right-click to equip/unequip
- Works in mainhand, offhand, and chestplate slot
- Auto-pickup toggle per backpack — items go directly into the bag
- Sort button inside the GUI — sorts contents alphabetically by item type
- Rename system — configurable XP cost, supports colour codes
- FancyNPCs merchant — buy and upgrade backpacks from in-world NPCs
- Per-backpack upgrade system — storage rows, auto-pickup unlock, and armor points — each with its own cost and multiplier
- Paginated GUI — up to 54 rows of storage across 9 pages
- Contents saved as NBT on the item itself — survives restarts, drops, and transfers
- Configurable death behavior:
DROP, KEEP, or DELETE
- ItemsAdder support — use any custom item as the backpack visual (falls back to skull if unavailable)
- Full Bedrock support via Geyser —
/bp opens your equipped backpack
? Backpack Tiers
| Tier |
Starting Rows |
Max Rows |
Shop Price |
| Worn Satchel |
1 |
3 |
$500 |
| Leather Backpack |
2 |
5 |
$2,000 |
| Iron Backpack |
3 |
8 |
$5,000 |
| Gold Backpack |
4 |
12 |
$12,000 |
| Diamond Backpack |
5 |
18 |
$30,000 |
| Ender Backpack |
6 |
24 |
$75,000 |
All tiers, prices, rows, and upgrade costs are fully configurable in backpacks.yml.
? Installation
- Drop
BackpackPlugin.jar into your server's plugins/ folder
- Ensure Vault + an economy plugin are installed
- Restart the server —
config.yml and backpacks.yml are generated automatically
- Optionally install FancyNPCs for the merchant NPC and ItemsAdder for custom visuals
- Run
/backpack reload after any config changes
? How to Use
Opening a Backpack
| Method |
Java |
Bedrock |
| Hold in mainhand |
Right-click |
Long-press |
| Hold in offhand |
Right-click |
Long-press |
| Worn in chest slot |
/bp |
/bp |
Equipping to Chest Slot
Hold the backpack in your mainhand, then Shift + Right-click to equip it to your chestplate slot. Shift + Right-click again to unequip.
Inside the GUI
| Button |
Function |
| Sort |
Sorts contents alphabetically |
| Auto-Pickup |
Toggles auto-pickup ON/OFF |
| Rename |
Rename your backpack (costs XP levels) |
| Prev / Next |
Navigate between storage pages |
? NPC Shop
Spawn a merchant NPC anywhere with:
/backpack spawnnpc <n>
Players browse tiers in the Buy tab and upgrade their backpacks in the Upgrade tab. The shop auto-populates from backpacks.yml — no extra setup needed after adding new types.
➕ Adding Custom Backpacks
Option 1 — In-game wizard (recommended):
/backpack create mythic_backpack
Answer 9 prompts in chat (display name, skull texture, ItemsAdder ID, rows, armor, upgrade costs). Clickable [Give to yourself] and [Edit fields] buttons appear when done.
Option 2 — Edit backpacks.yml directly:
backpacks:
mythic_backpack:
display: "&d&lMythic Backpack"
price: 150000.0
skull_texture: "eyJ..." # Base64 value from minecraft-heads.com
itemsadder_id: "" # e.g. mynamespace:my_item — leave blank to use skull
initial_rows: 6
max_rows: 36
armor_base: 5
upgrades:
storage:
enabled: true
max_purchases: 30
rows_per_purchase: 1
base_cost: 20000.0
cost_multiplier: 1.6
autopickup:
enabled: true
cost: 40000.0
armor:
enabled: true
max_purchases: 8
points_per_purchase: 1
base_cost: 15000.0
cost_multiplier: 1.6
Run /backpack reload — the new type instantly appears in the NPC shop.
? Commands
Permission: backpack.admin (OP by default)
| Command |
Description |
/bp |
Open your equipped backpack |
/backpack shop |
Open the NPC shop manually |
/backpack give <player> <id> |
Give a backpack to a player |
/backpack create <id> |
Start the in-game creation wizard |
/backpack cancel |
Abort an active creation wizard |
/backpack bpedit <id> <field> <value> |
Edit any field of a backpack type live |
/backpack bpdelete <id> |
Delete a backpack type |
/backpack list |
List all loaded backpack IDs |
/backpack reload |
Reload config.yml and backpacks.yml |
/backpack spawnnpc <n> |
Spawn a merchant NPC |
/backpack removenpc <n> |
Remove a merchant NPC |
⚙️ Lore Placeholders
| Placeholder |
Value |
{name} |
Custom name (or default if not renamed) |
{type} |
Always the original type ID |
{slots_used} / {slots_total} |
Storage fill |
{rows} |
Current row count |
{autopickup} |
On / Off |
{level} / {max_level} |
Upgrade progress |
{armor} |
Current armor points |
? Permissions
| Permission |
Default |
Description |
backpack.use |
Everyone |
Open and use backpacks |
backpack.autopickup |
Everyone |
Use auto-pickup feature |
backpack.bypass.blacklist |
false |
Bypass autopickup item blacklist |
backpack.admin |
OP |
All admin commands |
? Requirements
- Paper 1.21.x (Spigot not supported) · Java 21+
- Vault + an economy plugin (EssentialsX, CMI, etc.)
- FancyNPCs 2.9+ (optional, for merchant NPCs)
- ItemsAdder 3.6+ (optional, for custom item visuals)
- Geyser (optional, for Bedrock support — works automatically)
? Join our Discord for support, downloads, and updates
? More plugins by Treamhiler
? GitHub
评论 0
登录后参与评分
还没有评论,来抢沙发吧