BlockProt Reloaded Legacy

插件

· 作者 VictorGugug

适用于 Minecraft 1.20.5 至 1.21.6 的 Paper、Purpur 和 Folia 的箱子与实体保护。BlockProt Reloaded 的经典版本,拥有箱子菜单和相同的保护功能。

0 本站下载 0 关注 更新于 3 天前

最新 1.4.0.2 · 1.21.6 · Folia / Paper

一键开服(送7天)
BlockProt Reloaded

BlockProt Reloaded Legacy(适用于 Minecraft 1.20.5 - 1.21.6)。正在寻找其他 Minecraft 版本?请参阅版本指南。 保持使用最新版本! 即使只落后一个构建版本,也始终建议更新,以获取安全性、Folia 兼容性及修复补丁。请从 GitHub Releases 或 Modrinth 下载最新的 BlockProt Reloaded Legacy 构建版本。

BlockProt Reloaded Legacy 是 BlockProt 的一个维护分支,适用于 Paper、Purpur 和 Folia 服务器(Minecraft 1.20.5 - 1.21.6)。它在保留原始基于 NBT 的保护核心功能的同时,增加了稳定性修复、性能提升以及上游版本中不存在的新特性。

主要功能

玩家只需潜行并右键点击任何可锁定的方块或实体,即可打开保护界面 GUI:无需使用命令。在界面中,玩家可以锁定或解锁、管理每个方块的友方列表并将方块设为公开状态、控制红石和漏斗的访问权限、检查访问审计记录,以及在方块之间复制和粘贴设置。

管理员拥有独立的管理工具集:分页方块浏览器(/bp lockables)、按玩家划分的方块列表(/bp info)、解锁界面(/bp unlock)、员工角色管理(/bp tiers)、诊断工具(/bp debug run)以及每个受保护方块的完整审计日志。

受保护的对象

只有存在于您当前 Minecraft 版本中的方块和实体才能被锁定;以下列表列出了各版本中完整的受保护对象集合。

方块实体(存储类): 所有种类的箱子、全部 17 种潜影盒颜色、全部 12 种书架变体(1.21.9+)、熔炉、烟熏炉、高炉、漏斗、发射器、投掷器、 barrels、酿造台、装饰罐、雕纹书架、工匠台、唱片机、讲台、蜂巢、蜂窝。

交互类方块: 门、陷阱门和栅栏门(所有木材变体以及铁质和所有铜锈蚀阶段)、铁砧、炼药锅、附魔台、砂轮、切石机、织布机、制图台、锻造台、堆肥桶、钟、音符盒、龙蛋。

实体: 物品展示框、发光物品展示框、箱船(所有木材变体)、箱矿车、漏斗矿车。通过实体保护系统,可以保护驯服的动物(狼、猫、鹦鹉、马、羊驼)以及不可驯服但可保护的实体(村民)。

所有方块列表均在 blocks.yml 中定义,并且可以在运行时更改而无需重启服务器。

本分支新增的功能

修复了锁定菜单布局

现在,Block Lock GUI 中的每个按钮在所有方块和实体类型中都占据固定的槽位。此前,如果缺少某个按钮(例如工作台没有红石按钮),会导致后续所有按钮向左移位,使得不同方块类型的菜单布局不一致。

实体保护

可以保护驯服的动物(狼、猫、鹦鹉、马、羊驼)和村民。手持配置好的菜单物品(默认:木棍)右键点击您的实体即可打开保护界面。默认情况下此功能已禁用;请在 config.yml 的 entity_protection 下启用。此功能在早期版本中名为 pet_protection:升级时旧键值会自动迁移,无需手动编辑。

村民工作站保护

其工作站点记忆指向受保护工作站方块的村民,将自动继承该方块的保护状态。非所有者无法损坏或与关联的村民进行交易,也无法破坏或与该工作站周围配置区域内的方块进行交互。在工作站的锁定菜单中会出现一个“定位关联村民”的绿宝石按钮,会在村民所在位置显示仅对点击玩家可见的短粒子效果。可在 config.yml 中配置:

villager_workstation_protection:
  enabled: true
  radius: 2           # 水平搜索半径 (0-8)
  vertical_radius: 1  # 垂直搜索半径 (0-4)

物品展示框保护与自动方块链接

物品展示框和发光物品展示框采用相同的潜行加右键点击流程进行保护。放置在可锁定方块面上的展示框会自动与该方块链接:它完全共享该方块的拥有者、友方列表和锁定状态,与其交互会直接打开该方块的锁定菜单。未安装在可锁定方块上的展示框则保持独立的实体保护流程。

运输载具保护

箱船、存储矿车和漏斗矿车支持相同的潜行加右键点击流程。一旦受到保护,非所有者无法打开其容器,且载具会受到损坏和破坏防护。可以通过界面内的红石按钮为每个漏斗矿车单独切换漏斗抽取功能。

方块家族表达式系统

blocks.yml 和 worlds.yml 支持紧凑的家族表达式, alongside 标准的扁平材质列表:

lockable_tile_entities:
  - "[*]"                        # 所有方块实体
  - "[*-CHEST -*SIGN]"           # 所有箱子,排除告示牌
lockable_entities:
  - "[*-CHEST_BOATS ITEM_FRAME]" # 仅限箱船和物品展示框

子家族分类:CHEST、FURNACE、SHELF、TRANSPORT、MISC、SIGN(方块实体);SHULKERS;ANVIL、CAULDRON、WORKSTATION、TRAPDOOR、FENCE_GATE(方块);DOORS;CHEST_BOATS、CHEST_MINECARTS、HOPPER_MINECARTS、ITEM_FRAMES(实体)。

完整语法说明:docs/MODERN SYNTAX AND LEGACY/BLOCK_FAMILY_SYNTAX.md。完整材质列表:docs/MODERN SYNTAX AND LEGACY/LOCKABLE_BLOCKS_REFERENCE.md。

配置与方块在每次重载时自动合并

在每次启动和 /bp reload 时,缺失的键会从 JAR 默认值中添加,重命名的键会进行迁移。现有值(包括 blocks.yml 中已编写的所有家族表达式)永远不会被覆盖或重新排序。在传统扁平列表模式下,来自较新 JAR 的新材料条目会自动追加,从而使新的方块类型无需手动编辑即可锁定。

袭击检测

监控锁定方块附近的爆炸。记录事件,如果所有者在线则通过动作栏和聊天发送警报,否则将警报排队以待下次登录时交付。可通过 raid_detection.enabled 进行配置。

StatHandler 稳定性

saveFile() 重写为使用临时写入、验证、备份、替换序列,并为不支持原子跨目录移动的文件系统提供回退机制(修复了 Windows 上出现的“Failed to swap backup NBT file”错误)。Caffeine 缓存将对每个玩家的过期条目扫描节流至每玩家每 60 秒一次。区块加载守卫防止在 purueStalePbsEntries 中进行同步区块加载。

性能

  • 对 HopperEventListener 和 HybridDatabase 上的 Caffeine 缓存进行限制,通过 ProtectedBlockCache 实现漏斗的 O(1) 提前退出,而不会阻塞服务器或 Folia 区域线程。
  • purgeStalePbsEntries 完全跳过未加载的区块,以防止主线程停滞。
  • 线程安全的 SQLite 审计日志 (blockprot_audit.sqlite),具有序列化 WAL 连接处理功能。

其他新增内容

  • 访问审计日志 (/bp logs [here|player <name>|<page>]):分页的 SQLite 审计历史记录,用于检查容器开启、物品交易和拒绝的访问。
  • 双向漏斗和拾取物品保护:防止在未授权的提取、非法物品插入以及锁定容器和存储车辆上的 InventoryPickupItemEvent 窃取。
  • 环境和特殊容器保护:保护装饰花盆免受投射物攻击,强制执行切制书架的每槽位 READ/WRITE 访问权限,阻止火焰点燃/蔓延、液体流动 (BlockFromToEvent)、未经授权的水桶注水、掉落方块,以及针对受保护容器的发射器红石激活,并保护实体免受伤害、投射物和拴绳的影响。
  • 活塞挤压和移动保护:防止活塞移动或挤压锁定的方块和容器。
  • 离线模式 UUID 隔离:当 online-mode: false 时绕过 Mojang HTTP 查找,并在 Bedrock 前缀检查时剥离握手查询参数。
  • 动态功能门控和管理员层级继承:干净地隐藏禁用的命令 (/bp tiers, /bp friends, /bp logs),将玩家 use_menus 聊天命令限制为 /bp user 和 /bp admin,强制执行 t2 继承,并允许显式的权限否定覆盖 OP 回退。
  • 多层级管理员权限 (admin_tiers.enabled) 和独立的 admins.yml 层级结构。
  • 原生 Paper 对话框:此版本不可用。所有菜单均以箱子库存形式打开。
  • Bedrock 触摸表单(通过 Geyser 和 Floodgate 的 Cumulus API)。
  • 所有权转移:/bp transferall <player> 将你所有方块的所有权转移给另一个玩家。
  • 通过 worlds.yml 按世界配置 (per_worlds_config: true)。
  • 通过 ConfigFileWatcher 自动重载 (auto_reload_configs,默认为 true)。
  • 版本升级时自动生成备份压缩包。
  • 旧版文件夹迁移:重命名后首次启动时自动从 BlockProt 或 BlockProtPlus 文件夹复制数据。
  • SQLite 用户缓存移至插件数据文件夹;旧文件会自动迁移。
  • 不活跃清理:移除长期不活跃玩家拥有的保护 (inactivity_cleanup_days,默认禁用)。
  • WorldEdit 粘贴自动锁定(默认禁用)。
  • PlaceholderAPI 占位符:%blockprot_global_block_count%、%blockprot_own_block_count%、%blockprot_default_friends%。
  • 通过 FoliaLib 兼容 Folia。
  • ViaVersion、ViaBackwards 和 ViaRewind 检测。

命令

命令 权限 描述
/bp user blockprot.user 主要个人用户菜单或对话框
/bp admin blockprot.user.admin 管理控制菜单或对话框
/bp friends blockprot.user 管理全局默认好友列表
/bp settings blockprot.user 个人玩家偏好设置界面
/bp logs [here|player <name>|<page>] blockprot.user / Admin 查看自身、目标方块或其他玩家的访问审计日志
/bp transferall <player> blockprot.user 将你所有受保护的方块的所有权转移给另一个玩家
/bp lockables blockprot.user.admin 分页 GUI 列出所有具有活动/非活动状态的方块和实体
/bp tiers blockprot.user.admin 或 blockprot.user.admin.owner 员工角色 GUI 和自定义权限管理器
/bp info <player> blockprot.user.admin 某玩家拥有的所有带有传送链接的方块
/bp unlock <player> blockprot.user.admin 检查或移除任何玩家的保护(控制台:列出它们)
/bp protdel [world] blockprot.user.admin 批量删除世界中的保护,支持撤销
/bp reload blockprot.user.admin 重载所有配置文件并合并缺失的键
/bp update blockprot.user.admin 检查和下载 GitHub 发行版更新
/bp integrations blockprot.user.admin 检查所有第三方集成的状态
/bp recommended <blocks|config|all> blockprot.user.admin.owner 应用推荐的配置配置文件
/bp debug run blockprot.user.admin 或 blockprot.debug 运行内部诊断(也可从控制台运行)

权限

权限 默认值 描述
blockprot.user true 所有标准玩家功能
blockprot.user.admin op 管理员命令与 GUI
blockprot.user.admin.t1 false 初级员工层级(封锁列表、只读方块信息与审计日志)
blockprot.user.admin.t2 false 中级员工层级(解锁、锁具管理、破坏受保护的方块)
blockprot.user.admin.t3 false 高级员工层级(世界保护删除、配置、调试)
blockprot.user.admin.owner op 完全所有者控制权及员工角色分配
blockprot.lockmax false 免除方块数量限制(无上限)
blockprot.locklimit.<N> false 单个玩家的计数上限覆盖(例如:blockprot.locklimit.500)
blockprot.blocks.tp op 从统计数据和管理员 GUI 传送至方块处
blockprot.debug op 访问 /bp debug 命令

员工层级节点仅在 admin_tiers.enabled: true 时生效。

兼容性

Minecraft 1.20.5 - 1.21.6
服务端软件 Paper, Purpur, Folia
Java 需要 Java 21+
MySQL MySQL 8+, MariaDB 10.5+(可选)
语言 GitLocalize 上提供 25 种语言:AR, CS, DE, EN, ES, FI, FR, HE, HU, ID, IT, JA, KO, NL, PL, PT-BR, RO, RU, SK, SV, TH, TR, UK, ZH-CN, ZH-TW

集成支持

Towny, WorldGuard, Zelly's Guard, Lands, ClaimChunk, GriefPrevention, Residence, PlaceholderAPI, SkinsRestorer, WorldEdit/FAWE, Floodgate/Geyser, ViaVersion/ViaBackwards/ViaRewind, Folia.

安装

将 JAR 文件放入 plugins/ 目录并重启服务器。需要 Java 21+ 以及 Paper、Purpur 或 Folia 1.20.5 - 1.21.6。升级时,配置文件键会自动迁移,无需手动编辑。

文档

仓库地址: 问题反馈与贡献: 许可证:GNU General Public License v3 - 基于 spnda 开发的 BlockProt。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源