- 版权类型
- 原创
- 插件中文名称
- WarZ背包
- 插件英文名称
- WarZBackPack
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- PufferFish
- Leaves
- 其他核心
- 语言支持
- 中文(简体)
- 适配版本(Java)
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
WIki
【1.12-1.21+|Folia】
WarZBackPack|多形态背包插件|支持绑定物品|支持黑名单物品|用插件实现mod般的体验
为 生存 / RPG / 战术 / 末日类服务器 而生的高性能背包解决方案
插件定位
面向 生存 / RPG / 战术 / 末日 / 混合服
强调 策略性存储,而非无脑扩容
商业级性能与数据安全标准
同时满足:- GUI 背包党
- 战术物品 / 次元袋玩法
- 高负载 & Mod 混合服环境
核心特性一览
1. 商业级性能架构
真正为高在线与混合服准备
- 全异步数据流
- MySQL:HikariCP 连接池
- 文件:NIO 异步 I/O
所有读写均不阻塞主线程
- GZIP 智能压缩
- 所有背包数据统一压缩存储
- 数据体积减少 70%~90%
- 有效避免 NBT 过大导致的踢出、卡顿问题
- Folia 完整兼容
- 遵循区域线程安全规范
- 支持现代 Paper / Folia 架构
2. 多形态背包体系(插件最大亮点)
🖥 GUI 终端模式(Hub)
- /bp menu 打开背包终端
- 支持:
- 多背包并存
- 翻页浏览
- 图标 + Lore 描述
- 适合 RPG / 生存服的“背包系统”
战术物品模式(ITEM 绑定)
- 背包直接绑定在 物品上
- 数据存储于 物品 NBT
- 支持:
- 交易
- 丢弃
- 抢夺
真正的“实体战术背包 / 次元袋”玩法
多页背包系统
- 单个背包支持 无限分页
- 内置 GUI 翻页导航
- 在保证平衡性的前提下实现“移动仓库”
3. 安全与限制协议(为高端服兜底)
从设计层面防刷、防炸库
- 防背包套娃(Anti-Nesting)
- 内置递归检查
- 严禁背包放入背包
- 从根源杜绝数据膨胀 / Zip Bomb
- 混合服防刷机制
- Double Active Validation(双重主动验证)
- Real-time Async Save(实时异步保存)
- 即使:
- Mod 强制关闭 GUI
- 客户端异常
- 时序错乱
依旧 零丢失 / 零复制
- 黑名单系统
全局黑名单(所有背包通用)
局部黑名单(单背包限制)- 支持:
- 物品 ID
- Lore 精确 / 模糊匹配
- 战斗锁定机制
- PVP / PVE 状态禁止开包
- 防止“次元袋逃生流”
- 提升公平性与战术博弈
4. 沉浸式战术体验
- 战术读条开包
- 可配置延迟
- ActionBar / Title / Chat 动态进度条
- 行为中断
- 移动 / 受击立即打断
- 高度贴合末日、生存场景
- 像素机能风 GUI
- 商业服级 UI 风格
- 所有标题、图标、文本高度可定制
- 适配材质包 / 战术 UI
指令与权限
[MD]
## ▣ 命令与权限 (Commands & Permissions)
### 玩家指令
| 命令 | 别名 | 描述 | 权限 |
| :--- | :--- | :--- | :--- |
| `/backpack` | `/bp` | 查看帮助信息 | - |
| `/bp menu` | - | 打开随身背包终端 (Hub) | `warz.backpack.open` |
### 管理员指令
| 命令 | 描述 | 权限 |
| :--- | :--- | :--- |
| `/bp get <id>` | 获取指定 ID 的背包绑定物品 | `warz.backpack.admin` |
| `/bp open <玩家> <id>` | 强制打开指定玩家的特定背包 | `warz.backpack.admin` |
| `/bp reload` | 重载配置文件 | `warz.backpack.admin` |
### 权限节点详解
* **基础权限**
* `warz.backpack.open` —— 允许打开背包主菜单。
* `warz.backpack.<id>` —— 允许使用特定 ID 的背包(如 `warz.backpack.default`)。
* `warz.backpack.vip` —— 示例 VIP 权限,对应配置中的 VIP 背包。
* **管理权限**
* `warz.backpack.admin` —— 允许使用所有管理指令。
[/MD]
配置示例(节选)
代码:
# ==============================================================================
# WarZBackPack Configuration
# 商业级战术背包插件配置文件
# 版本: 1.0 | 作者: Crazy_Jky
# ==============================================================================
# ------------------------------------------------------------------------------
# 存储系统设置 (Storage System)
# ------------------------------------------------------------------------------
storage:
# 存储后端类型
# 可选值:
# - FILE: 本地文件存储 (推荐中小型服务器使用,性能稳定,易于备份)
# - MYSQL: 数据库存储 (推荐大型/跨服网络使用,支持数据同步)
type: FILE
# 自动保存间隔 (单位: 秒)
# 设置为 0 或负数可禁用自动保存 (不推荐)
auto-save-interval: 300
# MySQL 数据库配置 (仅在 type: MYSQL 时生效)
mysql:
host: "localhost"
port: 3306
database: "minecraft"
username: "root"
password: "password"
# 数据库表前缀 (默认: warz_)
table-prefix: "warz_"
# 是否启用 SSL 连接 (建议内网连接设为 false)
use-ssl: false
# ------------------------------------------------------------------------------
# 交互与行为设置 (Interaction & Behavior)
# ------------------------------------------------------------------------------
open:
# 允许的打开方式列表
method:
- ITEM_RIGHT_CLICK # 允许右键绑定物品打开
- COMMAND # 允许使用指令 /bp 打开
# 打开背包前的读条延迟 (单位: 秒)
# 模拟“解开背囊”的动作时间,增加战术沉浸感
delay: 2.0
# 读条提示设置
notification:
# 提示类型: ACTION_BAR (屏幕下方), TITLE (屏幕中央), CHAT (聊天栏)
type: ACTION_BAR
# 提示格式 (%progress% 为进度条, %time% 为剩余时间)
format: "&8[&3%progress%&8] &b正在解开背囊... &7%time%s"
# 进度条样式
progress-bar:
length: 20
symbol: "|"
filled-color: "&3"
empty-color: "&8"
# 打断读条的条件
interrupt:
- MOVE # 玩家移动时打断
- DAMAGE # 玩家受到伤害时打断
# ------------------------------------------------------------------------------
# 战斗平衡设置 (Combat Balance)
# ------------------------------------------------------------------------------
combat:
# 战斗状态锁定时间 (单位: 秒)
# 在造成伤害或受到伤害后,N秒内无法打开背包
# 如果设置为 0,则禁用战斗锁定功能
lock-time: 10
# ------------------------------------------------------------------------------
# 全局黑名单设置 (Global Blacklist)
# ------------------------------------------------------------------------------
# 此处定义的规则将应用于所有背包
global-blacklist:
# 示例: 禁止放置基岩
- material: BEDROCK
# 示例: 禁止放置含有 "绑定" 字样的物品 (模糊匹配)
- lore: "绑定"
match-mode: CONTAINS # 可选: CONTAINS (默认, 包含) / EXACT (完全匹配)
# 示例: 禁止特定 CustomModelData 的物品
#- material: DIAMOND_SWORD
# custom-model-data: 1001
# ------------------------------------------------------------------------------
# 背包实例定义 (Backpack Instances)
# ------------------------------------------------------------------------------
# 在此处定义服务器中存在的所有背包类型
# 每个节点名 (如 default, tactical_large) 即为背包的唯一 ID
backpacks:
# [默认战术背囊]
# 基础款背包,适合新人或初级装备
default:
# GUI 标题 (支持颜色代码)
title: "&8[&3▣&8] &3战术背囊 &7I"
# 背包大小 (必须是 9 的倍数,最大 54)
size: 27
# 绑定类型
# ACCOUNT: 账号绑定 (每个人独立,默认)
# ITEM: 物品绑定
bind-type: ACCOUNT
# 使用权限
# 拥有此权限的玩家才能打开该背包
permission: warz.backpack.default
# 在主菜单 (Hub) 中显示的图标材质
icon: CHEST
# 自定义模型数据 (CustomModelData)
# 仅在 1.14+ 版本生效,低版本会自动忽略
# 设置为 0 表示不启用
custom-model-data: 0
# 死亡掉落规则 (drop-rule)
# ALWAYS: 总是掉落 (硬核模式)
# NEVER: 从不掉落 (安全模式)
# WORLD: 跟随世界规则 (如果世界开启 keepInventory 则不掉落,否则掉落)
drop-rule: WORLD
# [可选] 局部黑名单 (Local Blacklist)
# 仅针对该背包生效的限制规则
blacklist:
- material: TNT
# 菜单图标的 Lore 描述
# 支持 WarZ 风格的像素风排版
lore:
- ""
- "&8[◆] &7容量 &a||||||||&8|||||||| &727格"
- ""
- "&7• 标准制式战术储物单元"
- "&7• 适配单兵作战携行需求"
- ""
- "&7• 死亡掉落:&c开启"
- ""
- "&a✔ 当前状态:可用"
# [大型战术背囊]
# 高级扩容背包,适合通过任务或商店解锁
tactical_large:
title: "&8[&3▣&8] &3战术背囊 &7II"
size: 54
bind-type: ACCOUNT
permission: warz.backpack.large
icon: ENDER_CHEST
custom-model-data: 1001
drop-rule: ALWAYS
lore:
- ""
- "&8[◆] &7容量 &a|||||||||||||||| &754格"
- ""
- "&7• 扩容型战术储物单元"
- "&7• 增强型物资携行模组"
- ""
- "&7• 死亡掉落:&c开启"
- ""
- "&a✔ 当前状态:可用"
# [物品绑定示例]
# 右键手持物品打开的背包
tactical_item:
title: "&8[&3▣&8] &3战术挂包"
size: 27
bind-type: ITEM
permission: warz.backpack.item
icon: LEATHER
drop-rule: ALWAYS
lore:
- ""
- "&8[◆] &7类型 &a物品绑定"
- ""
- "&7• 数据存储于物品NBT"
- "&7• 随物品移动/掉落"
# [多页背包示例]
# 支持翻页的超大容量仓库
warehouse_vip:
title: "&8[&3▣&8] &6VIP 移动仓库"
size: 45
pages: 2
bind-type: ACCOUNT
permission: warz.backpack.vip
icon: TRAPPED_CHEST
drop-rule: NEVER
lore:
- ""
- "&8[◆] &7容量 &e|||||||||||||||| &63页"
- ""
- "&7• 尊贵会员专属空间"
- "&7• 支持多页存储管理"
- ""
- "&a✔ 当前状态:可用"
代码:
prefix: "&8[&3WarZ&8] &7"
messages:
no-permission: "&c✘ 权限不足,系统拒绝访问。"
reload-success: "&a✔ 系统配置重载完毕。"
backpack-locked: "&e⚠ 存储单元锁定中,请稍候。"
combat-locked: "&c✘ 战斗锁定生效中 &8| &7剩余 &c%time%s"
open-delay: "&b[▣] &7正在展开战术背囊 &8... &f%time%s"
open-cancelled: "&c✘ 操作已中断 &8(移动/受伤)"
inventory-full: "&c✘ 容器空间不足。"
data-error: "&c✘ 数据流读取严重错误。"
# Command Messages
only-players: "&c✘ 此指令仅限战术终端用户(玩家)执行。"
player-not-found: "&c✘ 目标单位不存在或不在线。"
backpack-not-found: "&c✘ 目标存储单元未找到: &f%id%"
backpack-given: "&a✔ 已配发战术存储单元: &f%id%"
console-error: "&c✘ 控制台无法执行图形化界面操作。"
# Usage Help
usage-get: "&e⚠ 语法错误,用法: &f/bp get <ID>"
usage-open: "&e⚠ 语法错误,用法: &f/bp open <玩家> <ID>"
# Error Messages
backpack-nesting: "&c✘ 禁止将战术背囊放入另一个背囊中 (维度坍缩警告)。"
item-blacklisted: "&c✘ 目标物品被禁止存入该存储单元 (安全协议拦截)。"
backpack-lost: "&c⚠ 信号丢失:战术背囊已脱离控制范围,操作强制中断。"
常见问题
Q:ITEM 模式背包数据存哪?
A:直接存储在物品 NBT(PDC)中,随物品一起交易、掉落。
Q:MySQL 需要手动建表吗?
A:不需要,插件自动创建并管理数据结构。
Q:支持 Mod 混合服吗?
A:完全支持,已针对混合服刷物场景深度优化。
A:直接存储在物品 NBT(PDC)中,随物品一起交易、掉落。
Q:MySQL 需要手动建表吗?
A:不需要,插件自动创建并管理数据结构。
Q:支持 Mod 混合服吗?
A:完全支持,已针对混合服刷物场景深度优化。
插件信息
作者:Crazy_Jky
技术交流群:398893720
末日服交流群:1063544727
插件定制开发:QQ 1285988665
如需:
- 商业服定制
- 深度玩法整合
- UI / 背包规则专属设计