- 版权类型
- 原创
- 插件中文名称
- WarZ安全箱
- 插件英文名称
- WarZSafeBox
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- Folia
- Purpur
- PufferFish
- Leaves
- 其他核心
- 语言支持
- 多语言
- 前置组件
- Vault
- 适配版本（Java）
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
- 1.11
- 1.10
- 1.9
- 1.8
- 1.7
复刻逃离塔科夫安全箱机制，死亡不掉落的安心存储体验！WarZSafeBox 插件升级至 v1.2.0，新增全版本兼容、Folia原生支持、自定义GUI布局等核心功能，为你的服务器打造更灵活、更稳定的安全存储系统！图片展示:
核心功能升级，体验再升级-
多级安全箱系统 - 从基础到终极5个等级，存储空间逐步提升，满足不同玩家需求-
双经济系统支持 - 完美兼容Vault经济
和PlayerPoints点券
，升级支付更灵活-
全版本兼容适配 - 内置XSeries库，支持Minecraft 1.7-1.21+所有版本，材质名称自动兼容-
Folia原生支持 - 内置调度器适配器，自动识别RegionScheduler，适配Paper/Folia多线程服务端-
自定义GUI布局 - 支持完全自定义的GUI排版、装饰图标和材质模型，打造专属界面风格-
灵活权限控制 - 可通过权限节点控制安全箱等级，也可选择经济系统自由升级-
精准物品限制 - 可配置禁止存储特定物品、自定义模型物品及含特定描述的物品-
过期机制可选 - 高级安全箱可设置过期时间
，适配服务器运营策略
安全箱等级详情-
基础安全箱 - 1格存储空间 (免费，永不过期)，默认赠送新玩家-
标准安全箱 - 2格存储空间 (1000游戏币/100点券)，2x1简洁布局-
高级安全箱 - 4格存储空间 (2000游戏币/200点券)，2x2实用布局-
精英安全箱 - 6格存储空间 (3000游戏币/300点券)，2x3扩展布局-
终极安全箱 - 9格存储空间 (5000游戏币/500点券)，3x3全格布局，顶级存储体验升级路径：基础 → 标准 → 高级 → 精英 → 终极，等级提升平滑过渡
自定义布局指南（v1.2.0+新特性）从v1.2.0版本开始，可为每个等级安全箱自定义专属GUI界面，打造独特视觉体验：
1. 布局结构定义
使用layout列表定义GUI每行布局（最多6行），支持三种字符标识：
- $ (默认)：代表玩家的存储槽位，插件按顺序映射实际存储空间
- 空格：代表空气（无物品），用于界面留白
- 其他字符（如#、X等）：对应icons部分配置的装饰物品
2. 图标个性化配置
在icons部分定义布局字符对应的物品属性，支持多种自定义方式：
- 材质设置：支持原版材质（如GRAY_STAINED_GLASS_PANE）和自定义模型材质
- 自定义模型：使用PAPER{model-data:1001}格式加载带CustomModelData的物品（适配Paper/ItemsAdder）
- 显示设置：可自定义物品名称（支持颜色代码）和描述文本
高度灵活的配置体系-
多存储方式支持：目前支持YAML文件存储，数据自动保存至plugins/WarZSafeBox/data/目录-
等级完全自定义：可配置无限个安全箱等级，自由设定每个等级的名称、槽位数和升级价格-
多语言适配：默认中文，支持自定义语言文件，适配不同服务器氛围-
经济优先级可调：同时启用两种经济系统时，可自由设定优先支付方式-
过期时间配置：可为各等级安全箱单独设置过期时长，基础等级支持永不过期
核心命令与权限命令
描述
所需权限
默认拥有者
/safebox open
打开个人安全箱
warzsafebox.use
所有玩家
/safebox upgrade
升级安全箱等级
warzsafebox.upgrade
所有玩家
/safebox downgrade
降级安全箱等级（可退款）
warzsafebox.downgrade
所有玩家
/safebox info
查看安全箱当前信息
warzsafebox.use
所有玩家
/safebox admin view <玩家>
查看指定玩家的安全箱
warzsafebox.admin
OP/管理员
/safebox admin settier <玩家> <等级>
设置指定玩家的安全箱等级
warzsafebox.admin
OP/管理员
/safebox reload
重载插件配置文件
warzsafebox.admin
OP/管理员
权限补充说明：warzsafebox.tier.<tier_id>（精准控制玩家安全箱等级），开启权限控制后玩家无法通过经济系统升级
适用场景-
生存服务器 - 保护玩家珍贵物资，避免死亡掉落损失，提升玩家留存-
RPG服务器 - 作为VIP特权核心功能，差异化运营，增强付费吸引力-
战争服务器 - 战略物资安全存储，保障玩家核心战力，平衡游戏体验-
综合服务器 - 适配多种玩法模式，为玩家提供基础保障，丰富服务器功能体系 核心配置文件示例（v1.2.0）# ========================================
# WarZ安全箱插件配置文件
# 版本: 1.2.0
# ========================================
# 语言设置 (支持: zh_CN, en_US)
# 语言文件位于 plugins/WarZSafeBox/languages/ 目录下
language: "zh_CN"
# 经济系统设置
economy:
# 是否启用Vault经济系统（需要安装Vault插件和经济插件）
enable-vault: true
# 是否启用PlayerPoints点券系统（需要安装PlayerPoints插件）
enable-player-points: false
# 如果两者都启用，优先使用哪个系统（可选值: "vault", "player-points"）
priority: "vault"
# 权限控制设置
permissions:
# 是否启用权限节点控制安全箱大小（true=权限控制，false=经济升级）
enable-permission-control: false
# 权限节点格式: warzsafebox.tier.<tier_id>（如warzsafebox.tier.premium）
# 安全箱等级配置
tiers:
# 基础安全箱 - 默认等级
basic:
name: "基础安全箱"
slots: 1
upgrade-cost: 1000
player-points-cost: 100
layout:
- '####$####'
icons:
'#':
display:
material: GRAY_STAINED_GLASS_PANE
name: "&7装饰"
# 标准安全箱
standard:
name: "标准安全箱"
slots: 2
upgrade-cost: 2000
player-points-cost: 200
layout:
- '####$$###'
icons:
'#':
display:
material: GRAY_STAINED_GLASS_PANE
name: "&7装饰"
# 高级安全箱
premium:
name: "高级安全箱"
slots: 4
upgrade-cost: 3000
player-points-cost: 300
layout:
- '####$$###'
- '####$$###'
icons:
'#':
display:
material: GRAY_STAINED_GLASS_PANE
name: "&7装饰"
# 精英安全箱
elite:
name: "精英安全箱"
slots: 6
upgrade-cost: 5000
player-points-cost: 500
layout:
- '####$$###'
- '####$$###'
- '####$$###'
icons:
'#':
display:
material: GRAY_STAINED_GLASS_PANE
name: "&7装饰"
# 终极安全箱 - 最高等级
ultimate:
name: "终极安全箱"
slots: 9
upgrade-cost: 999999
player-points-cost: 999999
layout:
- '###$$$###'
- '###$$$###'
- '###$$$###'
icons:
'#':
display:
material: BLACK_STAINED_GLASS_PANE
name: "&8装饰边框"
# 默认安全箱等级 - 新玩家第一次使用时获得的等级
default-tier: "basic"
# 升级路径 (按顺序)
tier-progression:
- "basic"
- "standard"
- "premium"
- "elite"
- "ultimate"
# 物品限制设置
item-restrictions:
# 禁止放入的物品ID列表（格式: "命名空间:物品ID"）
banned-items:
- "minecraft:bedrock"
- "minecraft:command_block"
- "minecraft:barrier"
# 禁止放入的CustomModelData值
banned-custom-model-data:
- 1001
- 1002
# 禁止放入含有特定lore的物品
banned-lore-contains:
- "不可存储"
- "绑定物品"
- "任务物品"
# 数据存储设置
storage:
# 存储类型: yaml (目前支持YAML文件存储)
type: "yaml"
# 安全箱过期设置
expiry:
# 是否启用过期功能（启用后经济购买的安全箱会过期）
enabled: true
# 各等级的过期时间（秒，-1=永不过期）
durations:
basic: -1 # 基础安全箱永不过期
standard: 259200 # 3天 (3 * 24 * 60 * 60)
premium: 604800 # 7天 (7 * 24 * 60 * 60)
elite: 1209600 # 14天 (14 * 24 * 60 * 60)
ultimate: 2592000 # 30天 (30 * 24 * 60 * 60)
# 调试设置（true=输出详细日志，false=只输出重要日志）
debug: false
常见问题解答（FAQ）- Q：如何修改安全箱的GUI界面样式？
A：在config.yml的对应等级配置中，通过layout字段定义界面布局，icons字段配置装饰物品的材质、名称和模型数据即可。
- Q：插件支持哪些Minecraft版本？
A：内置XSeries库，全面兼容1.7-1.21+所有版本，材质名称会自动适配对应版本。
- Q：是否支持Folia服务器？
A：支持！v1.2.0版本已实现Folia原生适配，内置调度器适配器，可稳定运行在多线程服务端。
- Q：可以使用自定义模型材质作为装饰或槽位图标吗？
A：可以。在材质配置时使用PAPER{model-data:123}格式，即可加载带有指定CustomModelData的物品。
- Q：为什么无法升级安全箱？
A：请检查两点：1. 是否拥有warzsafebox.upgrade权限；2. 若服务器启用权限控制模式，需通过管理员分配对应等级权限，无法通过经济升级。
- Q：需要安装哪些前置插件？
A：默认无强制前置；启用Vault经济需安装Vault插件及对应经济插件，启用点券系统需安装PlayerPoints插件。
下载安装步骤1. 下载 WarZSafeBox v1.2.0 最新版jar文件；
2. 将jar文件放入服务器 plugins 文件夹；
3. 重启服务器，插件会自动生成配置文件和数据目录；
4. 按需调整 config.yml 中的参数（经济设置、等级配置、界面布局等）；
5. 使用 /safebox open 命令即可打开安全箱，开始使用！
支持与反馈插件技术交流群: 398893720
如有问题请联系作者 @Crazy_Jky
QQ: 1285988665 (添加注明来意)
版本: v1.2.0 | 适用MC版本: 1.7-1.21+ | 支持Folia/Paper服务端
![[全版本] WarZShiTu — 高自定义重制版师徒系统 | 全中文GUI | 名师商店 | Folia适配 | 旧数据兼容](/data/resource_icons/17/17141.jpg?1783773407){kind=icon}
