BlockProt Legacy

插件

· 作者 VictorGugug

适用于 Minecraft 1.18.2 至 1.20.4 及 Java 17 的 Paper、Purpur 和 Folia 服务器的箱子与实体保护。BlockProt Reloaded 的经典版本,拥有箱子菜单及相同的保护功能。

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

最新 1.4.0.2 · 1.20.4 · Folia / Paper

一键开服(送7天)
BlockProt Reloaded

BlockProt Legacy(适用于 Minecraft 1.18.2 - 1.20.4)。需要其他 Minecraft 版本?请参阅版本指南。 请保持在最新版本! 建议始终更新,即使仅落后一个构建版本,也能获得安全性、Folia 支持及兼容性修复。从 GitHub Releases 或 Modrinth 下载最新的 BlockProt Legacy 构建。

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

功能介绍

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

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

受保护的物件

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

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

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

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

所有方块列表均在 blocks.yml 中定义,并且可以在不重启服务器的情况下动态更改。

本分支新增的功能

修复了锁定菜单布局

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

实体保护

可以保护驯服的动物(狼、猫、鹦鹉、马、羊驼)和村民。手持配置好的菜单物品(默认:木棍)右键点击你的实体以打开保护 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:
  - "[*]"                        # 所有 tile entities
  - "[*-CHEST -*SIGN]"           # 所有箱子,不含告示牌
lockable_entities:
  - "[*-CHEST_BOATS ITEM_FRAME]" # 仅限带箱子的船和物品展示框

子家族分类:CHEST、FURNACE、SHELF、TRANSPORT、MISC、SIGN(tile entities);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 秒一次。区块加载保护器防止在 purgeStalePbsEntries 中进行同步区块加载。

性能

  • 对 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)。
  • 版本升级时自动生成备份 zip 文件。
  • 旧版文件夹迁移:在重命名后的首次启动时自动从 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 管理员命令和图形界面
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.18.2 - 1.20.4
服务端软件 Paper, Purpur, Folia
Java 需要 Java 17+
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 17+ 以及 Paper、Purpur 或 Folia 1.18.2 - 1.20.4。升级时会自动迁移配置键,无需手动编辑。

文档

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

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源