? PrivateChest - 完整的容器保护系统
PrivateChest 是一款轻量级但功能强大的容器保护插件,允许玩家使用个人密码锁定箱子、 barrel(木桶)和潜影盒。无需复杂的领地系统——只需简单、安全且经过优化的保护方案,适用于生存服务器、SMP 和阵营服!
✨ 核心功能
? 密码保护系统
- 锁定普通箱子、带锁箱子、木桶以及全部 17 种潜影盒变体
- 使用盐值进行安全的 SHA-256 密码加密
- 仅所有者可访问受保护的容器
- 自动检测并保护双箱结构
?️ 高级安全性
- 爆炸保护:TNT、苦力怕及其他爆炸无法摧毁已上锁的容器
- 漏斗保护:阻止漏斗、投掷器和发射器绕过安全限制
- 方块放置保护:防止玩家在受保护容器附近放置自动化提取装置
- 可配置的漏斗访问权限:为需要自动化分拣系统的服务器提供可选设置
? 信任系统
- 在不泄露密码的情况下与其他玩家共享容器访问权限
/trust <player>- 授予特定玩家访问权限/trust list- 查看所有被信任的玩家/untrust <player>- 移除某玩家的访问权限/untrust all- 一次性移除所有被信任玩家的权限- 被信任的玩家在访问共享容器时会收到通知
?️ 容器重命名
- 为您的上锁容器设置自定义名称(最多 16 个字符)
/renamecontainer <name>- 设置自定义名称/renamecontainer remove- 移除自定义名称- 智能验证名称兼容性
? 灵活的限额系统
- 基础限额:为所有类型的容器设置全局上限
- 细粒度限额:针对不同类型的容器(箱子、木桶、潜影盒)分别配置限额
- 基于权限:通过
privatechest.limit.chest.10等权限精细调整限额 - 为 VIP 玩家提供无限选项
? 告示牌保护(替代方法)
- 在第一行放置带有
[Private]的告示牌即可锁定容器 - 无需密码——基于所有权的保护
- 可与密码保护配合使用
? 跨平台兼容性
Minecraft 版本
支持: 1.16.5 → 1.21.x(及未来更新)
服务器软件
标准版(单线程):
- CraftBukkit, Spigot, Paper
- Purpur, Pufferfish
- 任何 Spigot/Paper 分支版本
区域化版(多线程):
- Folia, Luminol, LightingLuminol
- LeafMC, Kaiiju
- 任何基于 Folia 的分支版本
基岩版支持
- 通过 Geyser 和 Floodgate 实现完全兼容
- 自动检测基岩版玩家
- 消息适配以在各平台上获得最佳显示效果
- Java 版和基岩版玩家可以无缝交互同一个受保护的容器
? 命令
| 命令 | 描述 | 权限 |
|---|---|---|
/lockchest <password> |
锁定你正在查看的容器 | privatechest.use |
/unlockchest <password> |
解锁你上锁的容器 | privatechest.use |
/trust <player> |
授予玩家访问你容器的权限 | privatechest.use |
/trust list |
查看你信任的玩家列表 | privatechest.use |
/untrust <player> |
移除玩家的访问权限 | privatechest.use |
/untrust all |
移除所有被信任玩家的权限 | privatechest.use |
/renamecontainer <name> |
为容器设置自定义名称 | privatechest.use |
/renamecontainer remove |
移除自定义名称 | privatechest.use |
/privatechest reload |
重新加载配置和消息文件 | privatechest.admin |
/clearchests |
清理孤立的容器数据 | privatechest.admin |
别名: /privatechest → /pc, /renamecontainer → /renamechest
? 权限
基本权限
| 权限 | 描述 | 默认值 |
|---|---|---|
privatechest.use |
使用所有玩家命令 | true |
privatechest.admin |
管理员命令 + 绕过保护 | op |
限额权限(示例)
| 权限 | 描述 |
|---|---|
privatechest.limit.unlimited |
无限制的容器锁定数量 |
privatechest.limit.50 |
最多可锁定 50 个容器 |
privatechest.limit.chest.25 |
专门最多可锁定 25 个箱子 |
privatechest.limit.barrel.10 |
专门最多可锁定 10 个木桶 |
privatechest.limit.shulker_box.5 |
专门最多可锁定 5 个潜影盒 |
⚙️ 配置亮点
存储选项
- YAML:简单的基于文件的存储(默认)
- SQLite:数据库存储,适用于拥有大量上锁容器的大型服务器
关键设置
# 存储系统
storage-type: yaml # 或 'sqlite'
# 消息前缀
use-prefix: true
prefix: "&7[&6PrivateChest&7] "
# 告示牌保护
enable-sign-protection: true
# 容器限额
enable-chest-limits: false
default-chest-limit: 5
# 每种容器类型的细粒度限额
container-limits:
enabled: false
types:
chest: 10
barrel: 5
shulker_box: 2
# 通知设置
notify-owner-on-open: true
notify-admin-on-open: true
notify-trusted-on-open: true
# 自动清理孤立数据
auto-cleanup:
periodic-enabled: true
# 漏斗保护(可根据分拣系统进行配置)
hopper-protection:
allow-hopper-access: false # 对于自动化系统设为 true
? 开发者 API
PrivateChest 为开发者提供了简单的 API,以便集成对受保护容器的操作:
import me.tuplugin.privatechest.api.PrivateChestAPI;
// 检查方块是否已上锁
boolean isLocked = PrivateChestAPI.isLocked(block);
// 检查玩家是否为方块的所有者
boolean isOwner = PrivateChestAPI.isOwner(block, player);
// 以编程方式锁定容器
PrivateChestAPI.lockBlock(block, player, "password");
// 解锁容器
PrivateChestAPI.unlockBlock(block);
// 获取所有者 UUID
UUID owner = PrivateChestAPI.getOwner(block);
?️ 安装
- 下载 JAR 文件并将其放入
/plugins文件夹 - 启动或重载服务器
- 编辑
config.yml和messages.yml进行自定义设置 - 完成!所有玩家都可以开始保护他们的容器
? 多语言支持
PrivateChest 完全支持翻译!您可以编辑 messages.yml 和 config.yml,将所有消息翻译成任何语言。默认语言为英语,但您可以轻松调整以符合服务器的风格和社区需求。
? 插件统计信息
监控匿名使用统计数据: ? bStats - PrivateChest
? 为什么选择 PrivateChest?
- 轻量且优化:代码高效,对服务器影响极小
- 无依赖项:独立运行,无需其他插件
- 面向未来:定期更新以适配新的 Minecraft 版本
- 活跃开发:根据社区反馈修复错误并添加新功能
- 轻松迁移:随时在 YAML 和 SQLite 存储之间切换
- 自动清理:自动清理孤立数据以保持性能
? 截图
? 感谢您使用 PrivateChest!
如果您喜欢这款插件,请留下 ⭐ 评分并分享您的反馈!
✨ 想要更多功能和增强体验吗?
PrivateChest Plus 现已推出!
解锁高级功能,包括:
- ✅ 共享箱子访问权限及高级权限控制
- ✅ 定时自动解锁
- ✅ 基于 GUI 的锁定系统
- ✅ 音效与全息投影
- ✅ 以及更多……
通过 PrivateChest Plus 提升您的服务器防护等级!
? PrivateChest - Complete Container Protection System
PrivateChest is a lightweight yet powerful container protection plugin that lets players secure their chests, barrels, and shulker boxes with personal passwords. No complicated land-claim systems needed — just simple, secure, and optimized protection for survival servers, SMPs, and factions!
✨ Core Features
? Password Protection System
- Lock chests, trapped chests, barrels, and all 17 shulker box variants
- Secure SHA-256 password encryption with salt
- Only the owner can access protected containers
- Automatic double chest detection and protection
?️ Advanced Security
- Explosion Protection: TNT, Creepers, and other explosions cannot destroy locked containers
- Hopper Protection: Blocks hoppers, droppers, and dispensers from bypassing security
- Block Placement Protection: Prevents players from placing automated extraction blocks near protected containers
- Configurable Hopper Access: Optional setting for servers that want automated sorting systems
? Trust System
- Share container access with other players without revealing your password
/trust <player>- Grant access to specific players/trust list- View all trusted players/untrust <player>- Remove access from a player/untrust all- Remove all trusted players at once- Trusted players receive notifications when accessing shared containers
?️ Container Renaming
- Give your locked containers custom names (up to 16 characters)
/renamecontainer <name>- Set a custom name/renamecontainer remove- Remove custom name- Smart validation for name compatibility
? Flexible Limit System
- Basic Limits: Set a global limit for all container types
- Granular Limits: Configure different limits per container type (chests, barrels, shulker boxes)
- Permission-Based: Fine-tune limits with permissions like
privatechest.limit.chest.10 - Unlimited option available for VIP players
? Sign Protection (Alternative Method)
- Lock containers by placing a sign with
[Private]on the first line - No password required — ownership-based protection
- Works alongside password protection
? Cross-Platform Compatibility
Minecraft Versions
Supported: 1.16.5 → 1.21.x (and future updates)
Server Software
Standard (Single-threaded):
- CraftBukkit, Spigot, Paper
- Purpur, Pufferfish
- Any Spigot/Paper fork
Regionized (Multi-threaded):
- Folia, Luminol, LightingLuminol
- LeafMC, Kaiiju
- Any Folia-based fork
Bedrock Edition Support
- Full compatibility via Geyser and Floodgate
- Automatic detection of Bedrock players
- Messages adapted for optimal display on each platform
- Java and Bedrock players can seamlessly interact with the same protected containers
? Commands
| Command | Description | Permission |
|---|---|---|
/lockchest <password> |
Lock the container you're looking at | privatechest.use |
/unlockchest <password> |
Unlock your locked container | privatechest.use |
/trust <player> |
Give a player access to your containers | privatechest.use |
/trust list |
View your trusted players | privatechest.use |
/untrust <player> |
Remove a player's access | privatechest.use |
/untrust all |
Remove all trusted players | privatechest.use |
/renamecontainer <name> |
Set a custom name for a container | privatechest.use |
/renamecontainer remove |
Remove custom name | privatechest.use |
/privatechest reload |
Reload configuration and messages | privatechest.admin |
/clearchests |
Clean orphaned container data | privatechest.admin |
Aliases: /privatechest → /pc, /renamecontainer → /renamechest
? Permissions
Basic Permissions
| Permission | Description | Default |
|---|---|---|
privatechest.use |
Use all player commands | true |
privatechest.admin |
Admin commands + bypass protection | op |
Limit Permissions (Examples)
| Permission | Description |
|---|---|
privatechest.limit.unlimited |
Unlimited container locks |
privatechest.limit.50 |
Lock up to 50 containers |
privatechest.limit.chest.25 |
Lock up to 25 chests specifically |
privatechest.limit.barrel.10 |
Lock up to 10 barrels specifically |
privatechest.limit.shulker_box.5 |
Lock up to 5 shulker boxes specifically |
⚙️ Configuration Highlights
Storage Options
- YAML: Simple file-based storage (default)
- SQLite: Database storage for large servers with many locked containers
Key Settings
# Storage system
storage-type: yaml # or 'sqlite'
# Message prefix
use-prefix: true
prefix: "&7[&6PrivateChest&7] "
# Sign protection
enable-sign-protection: true
# Container limits
enable-chest-limits: false
default-chest-limit: 5
# Granular limits per container type
container-limits:
enabled: false
types:
chest: 10
barrel: 5
shulker_box: 2
# Notifications
notify-owner-on-open: true
notify-admin-on-open: true
notify-trusted-on-open: true
# Auto-cleanup of orphaned data
auto-cleanup:
periodic-enabled: true
# Hopper protection (configurable for sorting systems)
hopper-protection:
allow-hopper-access: false # true for automated systems
? Developer API
PrivateChest offers a simple API for developers to integrate with protected containers:
import me.tuplugin.privatechest.api.PrivateChestAPI;
// Check if a block is locked
boolean isLocked = PrivateChestAPI.isLocked(block);
// Check if a player owns a block
boolean isOwner = PrivateChestAPI.isOwner(block, player);
// Lock a container programmatically
PrivateChestAPI.lockBlock(block, player, "password");
// Unlock a container
PrivateChestAPI.unlockBlock(block);
// Get the owner UUID
UUID owner = PrivateChestAPI.getOwner(block);
?️ Installation
- Download the JAR and place it in your
/pluginsfolder - Start or reload your server
- Edit
config.ymlandmessages.ymlto customize - Done! All players can start protecting their containers
? Multilingual Support
PrivateChest is fully translatable! Edit messages.yml and config.yml to translate all messages to any language. The default language is English, but you can easily adapt it to fit your server's style and community.
? Plugin Statistics
Monitor anonymous usage statistics: ? bStats - PrivateChest
? Why Choose PrivateChest?
- Lightweight & Optimized: Minimal server impact with efficient code
- No Dependencies: Works standalone, no other plugins required
- Future-Proof: Regular updates for new Minecraft versions
- Active Development: Bug fixes and new features based on community feedback
- Easy Migration: Switch between YAML and SQLite storage anytime
- Automatic Cleanup: Orphaned data is cleaned automatically to maintain performance
? Screenshots
? Thank you for using PrivateChest!
If you enjoy the plugin, please leave a ⭐ rating and share your feedback!
✨ Looking for more power and features?
PrivateChest Plus is now available!
Unlock premium features including:
- ✅ Shared chest access with advanced permissions
- ✅ Timed auto-unlock
- ✅ GUI-based lock system
- ✅ Sounds and holograms
- ✅ And much more...
Level up your server protection with PrivateChest Plus!
下载 PrivateChestFree
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PrivateChestFree
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PrivateChestFree
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PrivateChestFree
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PrivateChestFree
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PrivateChestFree
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PrivateChestFree
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PrivateChestFree
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PrivateChestFree
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PrivateChestFree
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
PrivateChest 3.0
迄今为止最大的版本。插件的每个部分都经过了重构:存储、保护、线程处理、版本支持和翻译。2.x 中可配置但实际无效的几个功能现已关联生效,同时修复了可能导致数据丢失或绕过保护的多种漏洞。
从 2.x 升级
备份你的 plugins/PrivateChest/ 文件夹。 然后放入新的 jar 包并重启服务器。无需手动转换,无需停机,数据文件也不会发生变化。
自动完成
| 备份 | data.yml.v2-backup,或者 privatechest.db.v2-backup 加上一个 privatechest_data_v2_backup 表 |
| 数据格式 | 保持不变,按原样读取 |
| 密码 | 旧格式仍然有效,每次正确输入时会自动升级为 PBKDF2 |
| 明文密码 | 在首次启动时被哈希化(仅限 2.0 之前的数据) |
| 新配置选项 | 已添加至 config.yml,你原有的值保持不变 |
| 新消息 | 已添加至 messages.yml,你自定义的用词保持不变 |
需要你关注
1. SQLite 用户:信任关系和容器名称在 2.x 中从未被保存过。 SQLite 后端虽然接受了这些参数,但在每次重启时都会将其丢弃。3.0 会正确存储它们,但无法恢复早期版本丢弃的数据。你的玩家可能需要重新运行一次 /trust。
2. 基于潜影盒颜色的单独限制已移除。 如果你曾配置过 container-limits.types.white_shulker_box 等类似项,请将其替换为单一的 shulker_box 条目。旧的键名和旧的按颜色划分的权限节点将被忽略。
3. 四项行为变更。 所有变更都旨在使插件更严格或修复损坏的功能:
| 变更 | 原因 |
|---|---|
| 受信任的玩家不再能破坏容器,只能使用它们 | 信任机制错误地授予了破坏权限 |
| 破坏半个双层箱子不再解锁另一半 | 之前会导致幸存的那一半箱子保持开放状态 |
| 漏斗可以放置在你有访问权限的容器旁边 | 2.x 拒绝将漏斗放置在你的箱子旁边,这会破坏玩家自己的分拣系统 |
/privatechest 需要有效的子命令 |
之前任何参数(包括拼写错误)都会触发重载 |
4. 可选: 设置 language: es(或你自己的翻译语言),如果希望以其他语言重新生成 messages.yml,请删除该文件。
数据安全
四种导致保护失效的途径已全部封堵。
- 启动时未加载的世界会丢失其中所有的保护记录。 记录会从内存中被丢弃,下一次保存会将这种丢失永久写入磁盘。这会影响卸载世界或使用插件之后才加载世界的世界管理器的用户。
- 中断的保存操作可能会截断
data.yml并摧毁服务器上的所有保护记录。现在的写入是原子性的:先写入临时文件,再移动到位。 - 名称中包含点号的世界(如
world.old)其记录会被静默篡改。 - 包含
:字符的 2.0 之前版本的明文密码 会被误认为是哈希值,永远不会被升级,导致永远无法验证,从而永久锁定所有者。
此外:不可读的记录现在会在启动时被计数并报告,而不是消失;如果在锁定过程中双层箱子锁定失败,整个操作会回滚,而不是留下一半受保护的状态。
性能
- 保存不再针对每次操作发生。 之前的每次锁定、解锁、破坏、
/trust和重命名都会在主线程上重写整个数据集。现在更改会被收集,并由后台线程按间隔写入。一秒钟内十个玩家锁定箱子只会产生一次写入,而不是十次完整重写。 InventoryMoveItemEvent曾是插件最大的每刻开销。 它会在服务器上进行每一次物品转移时触发,而 2.x 会为源和目标构建完整的容器快照,包括复制其库存。现在的处理器只需在一个分块索引中进行一次查找即可开始。- 热路径中移除了区块加载。 限制检查在每次尝试锁定时都会从世界中读取玩家记录的每一个位置。
/clearchests会对服务器上的每条记录执行相同的操作。现在两者都不再这样做,清理工作仅检查已经加载的区块。 - 双层箱子检测改为读取方块数据而非方块状态。
- SQLite 仅在事务中写入更改的行,启用 WAL 模式并使用索引化的拥有者列。如果无法打开数据库,它会回退到 YAML 格式,而不是从没有保护的状态开始。
save-interval-seconds: 5 # 正常关闭始终会写入所有内容
保护漏洞修补
| 漏洞 | 详情 |
|---|---|
| 活塞 | barrels(桶)和潜影盒是可推动的。恶意玩家可以将一个上锁的桶推一格:记录仍停留在旧坐标,而容器最终处于无保护状态 |
| 仅检查右键点击 | 进入容器内容的任何其他途径都会直接通过。现在在库存层面也进行了防护 |
| 火焰和生物 | 没有任何机制阻止受保护的容器燃烧或被生物移除 |
| 漏斗矿车 | 未涵盖向受保护容器拾取物品的情况 |
| 重复消息 | 右键点击会针对每只手触发一次,而处理器未检查是哪只手,因此每条消息都会出现两次 |
密码
存储方式改为使用随机盐值的 PBKDF2-HMAC-SHA256,取代了之前足够快以至于容易被离线暴力破解的单次 SHA-256。稍后提高迭代次数可以在用户使用现有密码时增强其安全性,且无需迁移步骤。默认配置下的测量成本约为每次 /unlockchest 9 毫秒。
猜测次数以前是无限制的且不可见。现在有速率限制,并且可选择性地记录玩家名称和容器位置。
security:
password-hash-iterations: 20000
max-password-attempts: 5
attempt-window-seconds: 60
lockout-seconds: 300
log-failed-attempts: true
Minecraft 版本支持
一个 jar 包支持 1.16.5 到 26.2。 所有特定于版本的内容都在启动时解析。
- 铜箱可以受到保护,包括所有氧化和上蜡阶段,以及制作者。在 2.x 中这两者均不可能实现,因为其容器列表是硬编码的二十种类型。
- 氧化的铜箱仍归你所有。 其方块类型会随风化改变;每个阶段都视为同一个容器,因此它保持锁定状态,且你的计数不会发生变化。
[Private]告示牌正反两面均可读取。 自 1.20 起告示牌背面即可书写,而在背面上写入标签实际上并未锁定任何东西,只是看起来像锁住了。- 容器列表由你掌控,未来的容器无需插件更新即可工作:
containers:
auto-discover: true # 保护未来版本添加的容器
discovery-patterns: ["*_CHEST", "*_SHULKER_BOX"]
additional: [] # 例如 FURNACE, BLAST_FURNACE, BREWING_STAND
excluded: ["ENDER_CHEST"]
disabled: [] # 停止新锁,保留现有锁
disabled 永远不会删除现有数据:清理程序会将已禁用的类型视为仍然是容器。
Folia
Folia 支持在 2.x 中被宣传但实际并不存在。/renamecontainer 完全失败,清理程序从异步计时器读取方块,/clearchests 跨区域读取,且重复任务无法取消,导致它们在插件禁用后仍然存在。
现在,区块访问在拥有该区块的线程上运行,适用于 Folia、Luminol、LightingLuminol、LeafMC 和 Kaiiju。在普通服务器上还有两个额外好处:清理操作分散在多个刻(ticks)中执行,而不是在一个刻内完成,并且不再强制加载区块。
从未生效的功能
三个子系统在 2.x 中完全编写完成但从未被调用。
- 按容器类型限制。 整个
container-limits部分及每种类型的权限节点均无效。/lockchest和[Private]告示牌现在共享一个限制检查,因此它们不会相互矛盾。 - 容器名称。
/renamecontainer存储了一个从未显示的名称。现在名称会通过{container}出现在访问和拒绝消息中,与{owner}并列。 - 基岩版消息适配。 没有任何一条消息曾真正发送给它,因此基岩版玩家收到了相同的文本。现在它为每条消息运行,并修复了其中的三个错误:它在 100 个字符处截断(短于插件本身的几条消息),每次调用时重新解析 Floodgate,以及其符号列表未覆盖插件实际使用的字符。
限制修复
- 限制权限现在优先于默认值。
default-chest-limit首先应用,两者中较大的值获胜,因此在默认值为 5 的服务器上,privatechest.limit.1授予了 5。低于默认值的权限无法限制任何人。 - 任意数值均有效。 过去只检查十一个值,因此
privatechest.limit.7静默失效。
限制和权限现在基于容器 家族 进行键控:chest、trapped_chest、copper_chest、barrel、shulker_box、crafter、other。按材质设置的限制对于自身材质会发生变化的容器永远无法生效。
命令
/privatechest 增加了真正的子命令,全部受 privatechest.admin 权限控制:
| 命令 | 描述 |
|---|---|
reload |
重新加载配置和消息 |
status |
后端使用情况、受保护的容器、信任关系、可保护的类型、未保存的更改 |
save |
立即写入待处理的更改 |
migrate <yaml|sqlite> |
将所有数据迁移到另一种后端并实时切换 |
migrate 在 2.x 的 config.yml 中有文档说明但不存在。它会为你更新 storage-type 而不删除你的注释,并将旧文件保留为备份。如果它在任何步骤失败,当前后端将继续使用,不受影响。
Tab 补全
每个命令和子命令均可补全,并根据权限过滤:无法运行某项操作的玩家将看不到相关补全选项。
- 密码永远不会被建议。 没有补全器的命令会回退到服务器默认行为,即建议玩家名称,因此 2.x 会将你玩家的名称作为密码候选项提供。
- 尊重隐身状态。 你看不到玩家不会被列出。
/untrust仅建议那些你确实信任过的玩家;/trust会排除那些你已经信任过的玩家。
较小修复
- 破坏你自己的
[Private]告示牌会提示这是管理员操作,因为所有权是在记录已被移除后才进行检查的。 /lockchest和/unlockchest使用了控制台硬编码的英文消息。/trust list中无法解析的玩家名称使用消息键而非硬编码单词。- 缺失的消息键会被记录其名称并显示为
[key_name],而不是英文正文。
清理不再删除信任列表
2.x 会在每次遍历中清除玩家的所有信任列表,只要他们当时不拥有任何容器。在锁定第一个容器之前运行 /trust 的玩家会在半小时内失去其信任列表,暂时破坏所有容器的玩家也是如此。现在默认为关闭,其余部分可配置而非硬编码:
auto-cleanup:
startup-enabled: true
startup-delay-seconds: 10 # 让世界管理器挂载他们的世界
periodic-enabled: true
interval-minutes: 30 # 0 表示禁用
max-chunks-per-pass: 200
chunks-per-tick: 20
remove-unused-trust: false
在任何设置下,未加载区块中的位置都不会被触碰。
翻译
没有任何显示给玩家的内容是硬编码的。 这些都被烘焙进了代码中:[Private] 告示牌标签、容器类型名称、“Unlimited”、漏斗/投掷器/发射器名称、仅控制台的拒绝消息、禁止的容器名称以及缺失键的占位符。
# messages.yml
sign_tag: "[Private]"
sign_tag_aliases: ["[Private]", "[Privado]"]
sign_tag_locked: "&4[&cPrivate&4]"
标签匹配忽略大小写、颜色代码和空格。别名列表允许你更改语言而不会使玩家已放置的告示牌失效。
容器名称支持带重音符号的字符。 之前的规则是 a-zA-Z0-9,这会拒绝所有重音符号,导致使用西班牙语、法语、德语或葡萄牙语服务器的玩家无法使用自己的语言。现在默认值已支持 Unicode,且整个规则和禁止词列表均可配置。
英语和西班牙语随包附带,位于 plugins/PrivateChest/lang/ 目录下:
language: en # 用于初始化 messages.yml 并提供新键值的翻译语言
use-player-locale: false # 或者根据每位玩家的 Minecraft 语言进行匹配
以前,更新总是会将英语注入到已翻译的文件中。启用 use-player-locale 后,缺失的条目会回退到 messages.yml,因此部分翻译也是安全的。复制 lang/ 中的文件即可添加新语言。
对于单语言服务器没有任何变化:messages.yml 仍然是你的文件,你的修改依然有效。
已知漏洞:铜傀儡
铜傀儡(1.21.9+)会自行将物品从铜箱中取出。如果你的服务器将其报告为正常的物品传输,现有的保护机制已经可以阻止它,因为涉及受保护容器的传输无论由谁发起都会被取消。如果该行为纯粹实现为生物行为,则没有事件可供拦截,也没有插件能阻止它。
由于这一点无法验证,因此不声称已被覆盖。在依赖此功能前请先进行测试。
此外未包含: 针对 Bedrock 版原生的密码输入表单。Bedrock 版玩家通过输入命令来使用所有功能,而 [Private] 告示牌完全不需要任何命令。
新增配置项
security、containers、container-names、language、use-player-locale、save-interval-seconds,以及扩展后的 auto-cleanup。每个选项均在 config.yml 中有内联文档说明。
新增消息键
自动添加,保留你现有的措辞:
sign_tag, sign_tag_aliases, sign_tag_locked, unknown_player, limit_unlimited,
container_generic_name, container_type_*, block_name_*, too_many_attempts,
limit_exceeded_type, sign_limit_exceeded_type, clean_skipped_unloaded,
cleanup_already_running, usage_privatechest, usage_migrate, migrate_*, save_*, status_*
移除,因为这些键永远无法被触发:limit_error、sign_not_your_chest。
重新措辞了默认值,除非你删除了相应键,否则你的文件会保留这些修改:locked、not_your_chest、sign_chest_locked,所有的 limit_* 消息,以及访问和破坏通知,现在均支持 {container} 和 {owner} 占位符。
兼容性
| Minecraft | 1.16.5 – 26.2 |
| Java | 8 或更高版本 |
| 单线程 | CraftBukkit、Spigot、Paper、Purpur、Pufferfish、衍生版本 |
| 区域化 | Folia、Luminol、LightingLuminol、LeafMC、Kaiiju、衍生版本 |
| 跨平台 | Java 版与 Bedrock 版,通过 Geyser 和 Floodgate |
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
ExyliaPlugins 的库。
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
使床在所有维度中爆炸的模组
插件
为 Armor Poser 模组添加兼容性
插件
SkyBlock、OneBlock、Boxed、SkyGrid、AcidIsland、CaveBlock、Poseidon、StrangerRealms——以及更多!这些只是由 BentoBox 支持的基于岛屿的游戏模式之一。来自原版 ASkyBlock 的作者。
插件
一个在游戏内运行的 Minecraft 地图编辑器! 支持选区、蓝图、复制粘贴、笔刷和脚本。 可在创造模式中使用,也可在生存模式中临时使用。
评论 0
登录后参与评分
还没有评论,来抢沙发吧