**正在寻找其他 Minecraft 版本?**请参阅版本指南。 **从 1.4.1-hotfix.2 或更早版本更新?**这些旧构建版仍会检查旧的仓库 URL,并且由于 GitHub 的重定向机制,无法自动通知您。请手动从 GitHub Releases、Modrinth、CurseForge 或 Hangar 下载 1.4.5 以恢复自动更新提醒、启动备份以及最新的修复。即使仅落后一个构建版本,也建议始终进行更新。
BlockProt Reloaded 是 BlockProt 的一个维护分支,适用于 Paper、Purpur 和 Folia 服务器(Minecraft 1.21.7 至 26.3)。它在保留原始基于 NBT 的保护核心的同时,增加了稳定性修复、性能改进以及上游未提供的新功能。
功能介绍
玩家潜行并右键点击任何可锁定的方块或实体即可打开保护 GUI:无需使用命令。在 GUI 中,玩家可以锁定或解锁、管理每个方块的好友列表并将方块设为公开、控制红石和漏斗访问权限、查看访问审计记录,并在方块之间复制和粘贴设置。
管理员拥有独立的管理工具集:分页方块浏览器(/bp lockables)、按玩家分组的方块列表(/bp info)、解锁 GUI(/bp unlock)、工作人员角色管理(/bp tiers)、诊断工具(/bp debug run)以及每个受保护方块的完整审计日志。
受保护的内容
Tile entities(存储类实体): 所有箱子变体、所有 17 种潜影盒颜色、所有 12 种架子变体(1.21.9+)、熔炉、烟熏炉、高炉、漏斗、发射器、投掷器、 barrel(木桶)、酿造台、装饰罐、雕刻书架、合成器、唱片机、讲台、蜂巢、蜂箱。
交互方块: 门、陷阱门和栅栏门(所有木材变体以及铁质和所有铜氧化阶段)、铁砧、炼药锅、附魔台、砂轮、切石机、织布机、制图台、锻造台、堆肥桶、钟、音符盒、龙蛋。
实体: 物品展示框、发光物品展示框、带箱子的船(所有木材变体)、带箱子的矿车、漏斗矿车。驯服动物(狼、猫、鹦鹉、马、羊驼)和不可驯服但可保护的实体(村民)通过实体保护系统进行保护。
所有方块列表均在 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 上出现的“无法交换备份 NBT 文件”错误)。Caffeine 缓存将对每个玩家的过期条目扫描限制为每玩家每秒一次。区块加载守卫防止在 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 查找,并在基岩版前缀检查时剥离握手查询参数。 - 动态功能门控和管理员层级继承:隐藏禁用的命令 (
/bp tiers,/bp friends,/bp logs),将玩家use_menus聊天命令限制为/bp user和/bp admin,强制执行t2继承,并允许显式的权限否定覆盖 OP 回退。 - 多层级管理员权限 (
admin_tiers.enabled) 和独立的admins.yml层级结构。 - 原生 Paper 对话框 (
use_dialogs: true),带有柔和色彩调色板。 - 基岩版触摸表单(通过 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 | 管理员命令和 GUI |
blockprot.user.admin.t1 |
false | 低级员工层级(方块列表、只读方块信息和审计日志) |
blockprot.user.admin.t2 |
false | 中级员工层级(解锁、lockables、破坏受保护的方块) |
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.21.7 - 26.3(在运行时以数字检测) |
| 服务器软件 | Paper, Purpur, Folia |
| Java | 需要 Java 21+(JDK 25 工具链) |
| 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.21.7 - 26.3。升级时,配置键会自动迁移:无需手动编辑。
文档
- 发布记录:
docs/RELEASE_NOTES/ - 方块家族语法:
docs/MODERN SYNTAX AND LEGACY/BLOCK_FAMILY_SYNTAX.md - 完整可锁定材料参考:
docs/MODERN SYNTAX AND LEGACY/LOCKABLE_BLOCKS_REFERENCE.md - 管理员指南:
docs/READ_MEs/ADMIN_GUIDE.md - 玩家指南:
docs/READ_MEs/PLAYER_GUIDE.md
仓库地址: 问题与贡献: 许可证:GNU General Public License v3 - 基于 spnda 开发的 BlockProt。
Looking for another Minecraft version? See the version guide. Updating from 1.4.1-hotfix.2 or older? Those older builds still check the previous repository URL and will not notify you automatically due to the GitHub redirect. Download 1.4.5 manually from GitHub Releases, Modrinth, CurseForge, or Hangar to restore automatic update alerts, startup backups, and the latest fixes. Updating is always recommended, even when only 1 build behind.
BlockProt Reloaded is a maintained fork of BlockProt for Paper, Purpur, and Folia servers (Minecraft 1.21.7 through 26.3). It preserves the original NBT-based protection core while adding stability fixes, performance improvements, and new features not present upstream.
What it does
Players sneak and right-click any lockable block or entity to open the protection GUI: no commands required. From the GUI they can lock or unlock, manage a per-block friend list and make blocks public, control redstone and hopper access, inspect the access audit trail, and copy and paste settings between blocks.
Admins get a separate toolset: a paged block browser (/bp lockables), per-player block lists (/bp info), an unlock GUI (/bp unlock), staff roles management (/bp tiers), diagnostics (/bp debug run), and a full audit log per protected block.
What is protected
Tile entities (storage): all chest variants, all 17 shulker box colors, all 12 shelf variants (1.21.9+), furnace, smoker, blast furnace, hopper, dispenser, dropper, barrel, brewing stand, decorated pot, chiseled bookshelf, crafter, jukebox, lectern, beehive, bee nest.
Interactive blocks: doors, trapdoors, and fence gates (all wood variants plus iron and all copper oxidation stages), anvils, cauldrons, enchanting table, grindstone, stonecutter, loom, cartography table, smithing table, composter, bell, note block, dragon egg.
Entities: item frames, glowing item frames, chest boats (all wood variants), chest minecarts, hopper minecarts. Tamed animals (wolves, cats, parrots, horses, llamas) and non-tameable protectable entities (villagers) via the entity protection system.
All block lists are defined in blocks.yml and can be changed at runtime without restarting.
Features added in this fork
Fixed lock menu layout
Every button in the Block Lock GUI now occupies a fixed slot across all block and entity types. Previously, a missing button (for example, no Redstone button on a workstation) caused all subsequent buttons to shift left, making the menu inconsistent between block types.
Entity protection
Tamed animals (wolves, cats, parrots, horses, llamas) and villagers can be protected. Right-click your entity while holding the configured menu item (default: Stick) to open the protection GUI. Disabled by default; enable under entity_protection in config.yml. Renamed from pet_protection in earlier versions: the old key is migrated automatically on upgrade, no manual edit needed.
Villager workstation protection
A villager whose job-site memory points to a protected workstation block inherits that block's protection automatically. Non-owners cannot damage or trade with the linked villager and cannot break or interact with blocks in a configurable area around the workstation. A "Locate linked villager" Emerald button appears in the workstation's lock menu, showing a short particle effect at the villager's location visible only to the clicking player. Configurable in config.yml:
villager_workstation_protection:
enabled: true
radius: 2 # horizontal search radius (0-8)
vertical_radius: 1 # vertical search radius (0-4)
Item frame protection with automatic block linking
Item frames and glowing item frames are protected with the same sneak-and-right-click flow. A frame placed on the face of a lockable block is automatically linked to that block: it shares the block's owner, friends, and lock state exactly, and interacting with it opens the block's lock menu directly. Frames not mounted on a lockable block keep the standalone entity-protection flow.
Storage vehicle protection
Chest boats, storage minecarts, and hopper minecarts support the same sneak-and-right-click flow. Once protected, non-owners cannot open the inventory, and the vehicle is protected from damage and destruction. Hopper extraction can be toggled per vehicle from the in-menu Redstone button.
Block family expression system
blocks.yml and worlds.yml support compact family expressions alongside standard flat material lists:
lockable_tile_entities:
- "[*]" # all tile entities
- "[*-CHEST -*SIGN]" # all chests, no signs
lockable_entities:
- "[*-CHEST_BOATS ITEM_FRAME]" # chest boats and item frames only
Sub-families: CHEST, FURNACE, SHELF, TRANSPORT, MISC, SIGN (tile entities); SHULKERS; ANVIL, CAULDRON, WORKSTATION, TRAPDOOR, FENCE_GATE (blocks); DOORS; CHEST_BOATS, CHEST_MINECARTS, HOPPER_MINECARTS, ITEM_FRAMES (entities).
Full syntax: docs/MODERN SYNTAX AND LEGACY/BLOCK_FAMILY_SYNTAX.md. Full material list: docs/MODERN SYNTAX AND LEGACY/LOCKABLE_BLOCKS_REFERENCE.md.
Config and blocks auto-merge on every reload
On every startup and /bp reload, missing keys are added from JAR defaults and renamed keys are migrated. Existing values: including every family expression already written in blocks.yml: are never overwritten or reordered. In legacy flat-list mode, new material entries from a newer JAR are appended automatically so new block types become lockable without manual edits.
Raid detection
Monitors explosions near lockable blocks. Logs the event, alerts the owner via action bar and chat if online, or queues the alert for delivery at next login. Configurable via raid_detection.enabled.
StatHandler stability
saveFile() was rewritten to use a temp-write, validate, backup, replace sequence with a fallback for filesystems that do not support atomic cross-directory moves (fixes Failed to swap backup NBT file on Windows). A Caffeine cache throttles the per-player stale-entry scan to once per 60 seconds per player. A chunk-load guard prevents synchronous chunk loads in purgeStalePbsEntries.
Performance
- Bounded Caffeine caches on
HopperEventListenerandHybridDatabasefor O(1) hopper early-exit viaProtectedBlockCachewithout stalling server or Folia region threads. purgeStalePbsEntriesskips unloaded chunks entirely to prevent main-thread stalls.- Thread-safe SQLite audit logging (
blockprot_audit.sqlite) with serialized WAL connection handling.
Other additions
- Access audit logs (
/bp logs [here|player <name>|<page>]): paginated SQLite audit history for inspecting container opens, item transactions, and denied accesses. - Bidirectional hopper and item-pickup protection: prevents unauthorized extraction, illegal item insertion, and
InventoryPickupItemEventsiphoning on locked containers and storage vehicles. - Environmental and special container protection: shields decorated pots from projectiles, enforces per-slot
READ/WRITEaccess on chiseled bookshelves, blocks fire ignition/spread, liquid flow (BlockFromToEvent), unauthorized bucket waterlogging, falling blocks, and dispenser redstone activation against protected containers, and protects entities from damage, projectiles, and leashes. - Piston crushing and movement protection: prevents pistons from moving or crushing locked blocks and containers.
- Offline-mode UUID isolation: bypasses Mojang HTTP lookups when
online-mode: falseand strips handshake query parameters on Bedrock prefix checks. - Dynamic feature gating and staff tier inheritance: hides disabled commands (
/bp tiers,/bp friends,/bp logs) cleanly, restricts playeruse_menuschat commands to/bp userand/bp admin, enforcest2inheritance, and lets explicit permission negations override OP fallback. - Multi-tier staff permissions (
admin_tiers.enabled) and standaloneadmins.ymlhierarchy. - Native Paper Dialogs (
use_dialogs: true) with pastel color palettes. - Bedrock touch forms (Cumulus API via Geyser and Floodgate).
- Ownership transfer:
/bp transferall <player>moves ownership of all your blocks to another player. - Per-world configuration via
worlds.yml(per_worlds_config: true). - Auto-reload via
ConfigFileWatcher(auto_reload_configs, defaulttrue). - Automatic backup zip on version upgrade.
- Legacy folder migration: copies data from
BlockProtorBlockProtPlusfolders automatically on first boot after rename. - SQLite usercache moved into the plugin data folder; old file is migrated automatically.
- Inactivity cleanup: removes protections owned by long-inactive players (
inactivity_cleanup_days, disabled by default). - WorldEdit paste auto-lock (disabled by default).
- PlaceholderAPI placeholders:
%blockprot_global_block_count%,%blockprot_own_block_count%,%blockprot_default_friends%. - Folia compatibility via FoliaLib.
- ViaVersion, ViaBackwards, and ViaRewind detection.
Commands
| Command | Permission | Description |
|---|---|---|
/bp user |
blockprot.user |
Main personal user menu or dialog |
/bp admin |
blockprot.user.admin |
Administrative control menu or dialog |
/bp friends |
blockprot.user |
Manage global default friends list |
/bp settings |
blockprot.user |
Personal player preferences interface |
/bp logs [here|player <name>|<page>] |
blockprot.user / Admin |
View access audit logs for self, targeted block, or another player |
/bp transferall <player> |
blockprot.user |
Transfer ownership of all your protected blocks to another player |
/bp lockables |
blockprot.user.admin |
Paged GUI listing all blocks and entities with active/inactive status |
/bp tiers |
blockprot.user.admin or blockprot.user.admin.owner |
Staff roles GUI and custom permissions manager |
/bp info <player> |
blockprot.user.admin |
All blocks owned by a player with teleport links |
/bp unlock <player> |
blockprot.user.admin |
Inspect or remove any player's protections (console: lists them) |
/bp protdel [world] |
blockprot.user.admin |
Bulk delete protections in a world with undo support |
/bp reload |
blockprot.user.admin |
Reload all config files and merge missing keys |
/bp update |
blockprot.user.admin |
Check and download GitHub release updates |
/bp integrations |
blockprot.user.admin |
Inspect status of all third-party integrations |
/bp recommended <blocks|config|all> |
blockprot.user.admin.owner |
Apply recommended configuration profiles |
/bp debug run |
blockprot.user.admin or blockprot.debug |
Run internal diagnostics (also from the console) |
Permissions
| Permission | Default | Description |
|---|---|---|
blockprot.user |
true | All standard player features |
blockprot.user.admin |
op | Admin commands and GUIs |
blockprot.user.admin.t1 |
false | Low staff tier (block lists, read-only block info and audit logs) |
blockprot.user.admin.t2 |
false | Medium staff tier (unlock, lockables, break protected blocks) |
blockprot.user.admin.t3 |
false | High staff tier (world protection deletion, config, debug) |
blockprot.user.admin.owner |
op | Full owner control and staff role assignment |
blockprot.lockmax |
false | Exempt from the block count limit (unlimited) |
blockprot.locklimit.<N> |
false | Per-player cap override (e.g. blockprot.locklimit.500) |
blockprot.blocks.tp |
op | Teleport to blocks from stats and admin GUIs |
blockprot.debug |
op | Access to /bp debug |
The staff tier nodes only apply with admin_tiers.enabled: true.
Compatibility
| Minecraft | 1.21.7 - 26.3 (detected numerically at runtime) |
| Server software | Paper, Purpur, Folia |
| Java | 21+ required (JDK 25 toolchain) |
| MySQL | MySQL 8+, MariaDB 10.5+ (optional) |
| Languages | 25 languages on GitLocalize: 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 |
Integrations
Towny, WorldGuard, Zelly's Guard, Lands, ClaimChunk, GriefPrevention, Residence, PlaceholderAPI, SkinsRestorer, WorldEdit/FAWE, Floodgate/Geyser, ViaVersion/ViaBackwards/ViaRewind, Folia.
Install
Place the JAR in plugins/ and restart. Requires Java 21+ and Paper, Purpur, or Folia 1.21.7 - 26.3. On upgrade, config keys are migrated automatically: no manual edits required.
Documentation
- Release history:
docs/RELEASE_NOTES/ - Block family syntax:
docs/MODERN SYNTAX AND LEGACY/BLOCK_FAMILY_SYNTAX.md - Full lockable materials reference:
docs/MODERN SYNTAX AND LEGACY/LOCKABLE_BLOCKS_REFERENCE.md - Administrator guide:
docs/READ_MEs/ADMIN_GUIDE.md - Player guide:
docs/READ_MEs/PLAYER_GUIDE.md
Repository: Issues and contributions: License: GNU General Public License v3 - based on BlockProt by spnda.
下载 BlockProt Reloaded
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BlockProt Reloaded
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BlockProt Reloaded
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BlockProt Reloaded
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BlockProt Reloaded
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BlockProt Reloaded
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BlockProt Reloaded
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BlockProt Reloaded
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BlockProt Reloaded
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BlockProt Reloaded
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
BlockProt Reloaded 1.4.6 版本说明
欢迎使用 BlockProt Reloaded 1.4.6。此版本将加入服务器时自动向 OP/管理员发送的更新通知从聊天栏移至快捷栏上方的操作栏(ActionBar),在所有配置界面中于 notify_op_of_updates 下引入了子配置选项 notify_admins_on_join,确保游戏内被动更新的横幅遵循 notify_op_of_updates 设置,并保留了在 Paper、Purpur 和 Folia 上针对 Minecraft 1.21.7 至 26.3 版本的始终开启的控制台更新日志记录功能。
亮点
- 操作栏加入更新警报:针对 OP 和管理员的自动加入更新警报(
JoinEventListener和UpdateChecker.forJoinActionBar)现在通过TemporaryActionBar(使用runAtEntityLater在玩家实体线程上调度)干净地显示在操作栏中,而不是每次加入时发送多行聊天消息。 - 子配置开关(
notify_admins_on_join):在config.yml中的notify_op_of_updates下添加了notify_admins_on_join: true作为子选项,以便服务器管理员可以独立禁用加入时的操作栏通知,而不影响常规的游戏内更新警报。 - 始终开启的控制台日志记录:无论是否禁用了
notify_op_of_updates或notify_admins_on_join,服务器控制台的更新检查和警告仍会继续运行。 - 完整的菜单与对话框一致性:在 Paper 对话框(
AdminConfigNotificationsDialog)、箱子库存 GUI(AdminConfigNotificationsInventory)以及 Floodgate/Bedrock 表单(BedrockAdminConfigForm)中暴露了notify_admins_on_join选项。 - 高可见性的过时构建警报:将控制台(
BlockProtConsole.BOLD_RED/BRIGHT_RED)、操作栏、/bp admin库存(AdminMenuInventory)以及 Paper 对话框(AdminMenuDialog,UpdateDialog)中的过时更新警报切换为警示红色(控制台为#FF3B3B,UI 为#FF6B6B),同时将较新的BEDev构建以红金色(#FF8C69)高亮显示。
变更日志
改进
- 添加了
UpdateChecker.forJoinActionBar(...),UpdateChecker.actionBarOutdatedKey(...)和UpdateChecker.buildActionBarUpdateComponent(...),以便在有可用更新时渲染简洁的粉彩色操作栏警报(messages.update.actionbar_outdated,actionbar_outdated_hotfix,actionbar_outdated_dev),而在已更新或领先时不在加入时进行打扰。 - 通过
UpdateChecker.outdatedAlertColor(...),UpdateChecker.formatOutdatedText(...)和BlockProtConsole.updateAlert(...)标准化了过时构建的警报方式,使得启动/运行时控制台警告、操作栏加入警报、/bp admin物品标题和描述、Paper 对话框横幅/按钮以及UpdateDialog读数对于稳定版/热修复版更新显示为警示红色,对于BEDev更新显示为红金色。 - 在运行
/bp update(UpdateCommand) 或在/bp admin中点击更新按钮时,保持完整的可点击下载链接和更新日志摘要不变。 - 添加了
DefaultConfig.shouldNotifyAdminsOnJoin(),isNotifyAdminsOnJoinSettingEnabled()和setNotifyAdminsOnJoin(boolean),模仿owner_notifications的父子级门控机制,同时保持现有config.yml文件不受影响。 - 更新了
AdminMenuDialog和AdminMenuInventory,使/bp admin中的被动待更新横幅遵循notify_op_of_updates设置。 - 在
translations_en.yml,translations_es.yml,translations_de.yml和translations_fr.yml中添加了本地化文本并更新了过时警报颜色,以澄清游戏内更新警报与始终开启的控制台日志记录之间的区别。
测试
- 扩展了
TranslatorTest以验证notify_op_of_updates和notify_admins_on_join的父子级默认值、显式覆盖以及英语/西班牙语翻译加载。 - 扩展了
UpdateCheckerSelectionTest以验证稳定版、热修复版和BEDev频道下的操作栏翻译键选择、渲染的操作栏文本以及#FF6B6B/#FF8C69警报颜色。
版本支持
BlockProt Reloaded 支持 Minecraft 1.21.7 至 26.3。有关版本支持的详细信息,请参阅 版本指南。
状态
- 发布状态:1.4.6 已准备好用于 Paper、Purpur 和 Folia 上的 Minecraft 1.21.7 至 26.3 版本。
验证
在发布之前,该构建已在 GitHub Actions 中进行了测试 (运行 43774079711)。所有受支持的 Minecraft 版本(1.21.7 - 26.3)均在真实的 Paper、Folia 和 Purpur 服务器上启动成功,只要该软件发布了构建(声明的版本若无自身构建,则在其最新的热修复版上运行),并且通过了插件控制台诊断。在测试客户端支持的每个版本上,双人保护测试也均通过:房主保护并打开一个箱子,而第二名玩家既无法打开也无法破坏它。
BlockProt Reloaded 1.4.5 更新日志
欢迎使用 BlockProt Reloaded 1.4.5。本次发布增强了更新可见性,让管理员能立即知晓有新构建版本可用;默认启用针对操作员(operator)的自动更新通知;确保在每次插件版本更新(包括补丁升级)和旧的 data/ 目录迁移时可靠地运行自动 ZIP 备份;并继续全面支持 Paper、Purpur 和 Folia 上的 Minecraft 1.21.7 至 26.3 版本。
适用于
1.4.1-hotfix.2或更早版本服务器的注意事项: 早于1.4.2的旧构建仍会查询之前的仓库 URL 且不跟随重定向,因此它们不会自动通知您有关新版本的发布。请从 GitHub Releases、Modrinth、CurseForge 或 Hangar 手动更新至1.4.5,以恢复自动更新警报并获取最近的安全修复、Folia 兼容性、备份及界面修复。
亮点
- 主动更新提醒 (
notify_op_of_updates: true):为新安装默认启用操作员加入时的更新通知,更新了en/es/de/fr翻译副本,强调即使仅落后 1 个构建也值得更新的重要性,并在/bp admin命令中添加了待处理更新横幅和高亮的“更新”按钮(同时支持 Paper Dialogs 和 Chest Inventory UI)。 - 每次版本升级自动备份:
BackupTask现在不仅在版本过渡、主版本号/次版本号提升以及BEDev构建时触发,还在补丁版本变更时(例如从1.4.4到1.4.5)触发,即使在尚未存在audit.sqlite数据库的情况下也会备份您的配置文件。 - 数据布局迁移备份触发器:
BlockProt现在会跟踪onLoad()期间PluginDataLayout.migrateAll(...)重新定位旧版数据库或点文件的情况,确保在自动存储迁移的同时创建启动 ZIP 备份。 - 全新服务器零噪音:没有先前版本标记或迁移文件的全新安装将继续干净地跳过启动 ZIP 备份。
更改记录
改进
- 在
config.yml和DefaultConfig.shouldNotifyOpOfUpdates()中默认启用notify_op_of_updates: true。配置了notify_op_of_updates: false的现有服务器配置永远不会被覆盖。 - 添加了
UpdateChecker.getAvailableUpdate(...),并在检测到更新的稳定版本时,在AdminMenuDialog和AdminMenuInventory中显示明显的过期提示和高亮更新按钮。 - 澄清了
translations_en.yml、translations_es.yml、translations_de.yml和translations_fr.yml中的更新提醒字符串,以便管理员看到即使落后 1 个构建也值得更新。
修复
- 当任何版本在其支持的 Minecraft 范围之外(低于或高于)启动时,添加醒目的红色控制台横幅和干净的插件自我禁用(
disablePlugin),指明匹配的编辑版(BlockProt Legacy、BlockProt Reloaded Legacy或BlockProt Reloaded)及其直接的 Modrinth 下载 URL,同时让服务器正常运行。 - 保留
BlockProt中来自onLoad()的dataLayoutMigrated,以便在内部 SQLite 或标记文件从根目录/mysql/迁移到data/时,在onEnable()期间运行BackupTask。 - 添加了
BackupTask.isVersionChanged、BackupTask.isStartupUpgradeOrMigration和BackupTask.forStartupUpgrade,以便补丁升级可以归档现有配置(config.yml、blocks.yml、worlds.yml、integrations.yml、lang/、data/),而不会破坏Transition.migration()的版本检查。
测试
-
在
UnsupportedVersionBannerTest中添加了回归测试,涵盖不匹配的编辑版和 Minecraft 版本检测、推荐编辑版选择、Modrinth 下载链接以及所有三个编辑版的横幅格式。 -
在
BackupTaskEditionMarkerTest中添加了回归测试,涵盖补丁升级(1.4.4到1.4.5)、未更改的重启、data/布局迁移、全新安装以及通过BackupTask.forStartupUpgrade创建 ZIP 文件。 -
在
UpdateCheckerSelectionTest中添加了回归测试,涵盖UpdateChecker.getAvailableUpdate(...)和DefaultConfig.shouldNotifyOpOfUpdates()的默认值。
编辑版
BlockProt Reloaded 覆盖 Minecraft 1.21.7 至 26.3 版本。请参阅 版本指南 以获取编辑版详情。
状态
- 发布:1.4.5 已准备好作为安全升级和自动备份可靠性更新,适用于 Minecraft 1.21.7 至 26.3。
验证
在发布之前,此构建已在 GitHub Actions 中进行了测试 (run 43681937596)。每个受支持的 Minecraft 版本(1.21.7 - 26.3)均在真实的 Paper、Folia 和 Purpur 服务器上启动成功,无论该软件在哪里发布构建(声明的版本若无自身构建则运行其最新的 hotfix),并通过插件控制台诊断。在每个测试客户端支持的版本上,双人保护测试也顺利通过:所有者保护并打开一个箱子,第二个玩家既不能打开也不能破坏它。
BlockProt Reloaded 1.4.4 更新日志
欢迎使用 BlockProt Reloaded 1.4.4。本次更新将内部 SQLite 存储和状态标记整理到整洁的 data/ 文件夹中,并实现了自动迁移;增加了游戏内更新日志查看器,支持通过 Paper Dialogs、聊天、箱子菜单和基岩版表单直接链接至 GitHub Release;并扩展了匿名 bStats 图表以测量配置和功能的使用情况。继续完全支持 Minecraft 1.21.7 至 26.3 版本的 Paper、Purpur 和 Folia。
亮点
- 组织化的
data/内部存储:将blockprot_usercache.sqlite(移至data/usercache.sqlite)、blockprot_audit.sqlite(从mysql/移至data/audit.sqlite)以及内部根目录点文件(.edition、.first_start_done、.recommended_state.yml整合进data/state.yml),同时保持人类可编辑的配置在plugins/BlockProtReloaded/中保持整洁。 - 游戏内更新日志与 GitHub Release 查看器:
UpdateChecker现在从 GitHub Releases 捕获更新日志,并在UpdateDialog、箱子管理员菜单更新、CLI/bp update和基岩版管理员表单中以清晰格式化的摘要形式呈现,附带可直接点击的链接。 - 一次性升级后管理员通知:在
data/state.yml(changelog.last_seen_version) 中跟踪的升级,会在管理员加入时显示一次可点击的更新摘要通知,而不会在新安装时触发。 - 扩展的 bStats 遥测数据 (
#31548):添加了ui_mode(Dialogs, Menus, Menus + Dialogs, Commands)、recommended_setup(追踪/bp recommended与手动设置的使用情况)以及feature_usage(按功能统计的柱状图)。 - 配置卫生审计:验证了
config.yml、blocks.yml、worlds.yml、integrations.yml和mysql/mysql.yml中所有活动的配置键,并修正了config.yml中BLOCK_FAMILY_SYNTAX.md文档路径引用的错误。
更新内容
新增
PluginDataLayout集中化了内部存储和启动迁移辅助功能(包括 SQLite-wal和-shm伴随文件处理,以及在mysql.yml不存在时清理空的mysql/目录)。:common模块中的ReleaseNotesFormatter用于纯 Java Markdown 转摘要格式化,以及UpdateChecker.installedRelease追踪和tagReleaseUrl备用链接。- 在
UpdateDialog中增加了专门的“更新日志”视图和内联高亮显示;在JoinEventListener中增加了升级后的一次性管理员加入通知;为箱子/CLI 更新提供了聊天摘要传递;在BedrockAdminMenuForm中增加了更新与更新日志表单。 - 三个匿名 bStats 图表:
UiModePieChart(ui_mode)、RecommendedUsagePieChart(recommended_setup)和FeatureUsageBarChart(feature_usage)。 - 跨英语、西班牙语、德语和法语的本地化翻译条目(
translations_en.yml、translations_es.yml、translations_de.yml、translations_fr.yml)。
更改
- 更新了
BlockProt、AuditLogger、LegacyMigrationManager、RecommendedCommand、BackupTask和EnvironmentDiagnostics,使其通过data/下的PluginDataLayout读取和写入内部运行时文件。 BackupTask.hasPriorData现在在新安装时跳过受管理的data/usercache.sqlite和data/state.yml,同时将data/audit.sqlite识别为现有历史记录。- 将
.recommended_state.yml移入data/state.yml以避免误触文件监听器的配置重载。 - 更新了
docs/READ_MEs/ADMIN_GUIDE.md和docs/READ_MEs/VERSION_GUIDE.md以记录新的data/路径和自动迁移功能。
修复
- 修复了
spigot/src/main/resources/config.yml中损坏的相对docs/BLOCK_FAMILY_SYNTAX.md注释路径,使其指向docs/MODERN SYNTAX AND LEGACY/BLOCK_FAMILY_SYNTAX.md。 - 在聊天和
UpdateDialog组件中将原始发布 URL 隐藏在带有悬停提示的可点击本地化标签后,并在尚未发布更新日志时省略空的更新日志标题。 - 修复了
UserSettingsDialog、UserSettingsInventory、BedrockUserSettingsForm和BlockProtInventory中/bp user对话框/库存模式切换的问题,确保启用或禁用 Paper Dialogs 时保留父级来源,并且在返回时不会重新打开箱子菜单。
版本说明
BlockProt Reloaded 覆盖 Minecraft 1.21.7 至 26.3。有关版本详情,请参阅 版本指南。
状态
- 发布:1.4.4 已准备就绪,作为针对 Minecraft 1.21.7 至 26.3 的组织结构、遥测数据和发布可见性更新。
验证
在发布之前,此构建已在 GitHub Actions 中进行测试 (run 43642223886)。每个支持的 Minecraft 版本(1.21.7 - 26.3)在真实的 Paper、Folia 和 Purpur 服务器上启动成功(无论该软件在哪里发布构建,即声明的版本在没有自身构建时使用其最新的热修复版本),并通过插件控制台诊断。在每个测试客户端支持的版本上,双人保护测试也全部通过:所有者保护并打开一个箱子,另一名玩家既无法打开也无法破坏它。
BlockProt Reloaded 1.4.3 发布说明
欢迎使用 BlockProt Reloaded 1.4.3。本次版本彻底重构了热修复的更新通知引擎,扩展了对方块、容器、流体、火焰、实体和投射物的保护,增强了 Folia 的区域线程安全性以及 SQLite/缓存的可靠性,完善了员工层级的继承与命令门控机制,实现了德语和法语翻译的完全对齐(936/936 个声明的 TranslationKey 条目;960/960 个总键值),并整合了 GitHub Actions CI 流程。它保持了声明的支持范围:Minecraft 1.21.7 至 26.3,适用于 Paper、Purpur 和 Folia。
亮点
- 更新检查器与热修复检测重构:更新引擎现在遵循 HTTP 301 和 302 重定向,以 30 分钟的 TTL 缓存发布数据,识别在 GitHub 上标记的热修复版本,确保即使存在完成回调也能在启动时显示控制台警告,并以原生 MiniMessage 格式展示状态消息,配色采用柔和色调(
<#98FF98>)。 - 动态命令与菜单功能门控:子命令、Tab 补全条目、箱子菜单和 Paper Dialog 按钮均尊重
config.yml中的配置开关。当admin_tiers.enabled、disable_friend_functionality、world_expiry.enabled或enable_session_log禁用某项功能时,相应的子命令和按钮将被隐藏并进行安全管控。启用use_menus: true时,玩家访问权限仅限于/bp user和/bp admin(包括管理员更新视图),而控制台保留直接的/bp update和 CLI 访问权限。 - 扩展的方块、容器、环境与实体保护:
- 装饰陶罐与雕纹书架:投射物无法击碎或触发已锁定的装饰陶罐,雕纹书架强制执行按槽位的
READ/WRITE访问权限,而不是允许未经授权的槽位编辑。 - 火焰、流体、掉落方块与发射器:火焰点燃/蔓延(
BlockIgniteEvent,BlockSpreadEvent)、水/岩浆流动(BlockFromToEvent)、未经授权的桶排空/填充或水体填充、掉落方块落在已锁定方块上,以及受保护容器上的发射器红石激活,现在均会被阻止。 - 实体、物品框架与漏斗:受保护的实体可阻挡伤害、投射物和拴绳;链接的物品框架会触发
BlockAccessMenuEvent;InventoryPickupItemEvent阻止未经授权的漏斗吸取;simplified_hopper_logic保留了容器吸取检查。
- 装饰陶罐与雕纹书架:投射物无法击碎或触发已锁定的装饰陶罐,雕纹书架强制执行按槽位的
- Folia 区域安全、SQLite 并发与缓存边界:
AuditLogger中同步序列化的 WAL SQLite 池化与连接复用,HybridDatabase中非阻塞且有界 TTL 查找,ProtectedBlockCache中有界的 Caffeine 清理,InventoryState/DialogState中的线程安全状态,以及在TownyIntegration、WorldExpiryTask、InactivityCleanupTask和VillagerLocateTask中正确处理 Folia 实体/区域分发。 - 员工层级与权限优先级:
blockprot.user.admin.t2现在明确包含blockprot.user.admin(在admin_tiers.enabled: true下限制为 T2 操作),明确的权限否定在所有命令和 GUI 中一致地覆盖 OP 回退机制,plugin.yml将Residence和GriefPrevention添加到softdepend中。 - 离线模式优化与前向兼容性准备:离线模式服务器(
online-mode: false)在CachedProfileService中跳过 Mojang HTTP 查找,BedrockBridge在前缀检测期间剥离握手查询字符串,BlockFamilyParser/VersionCompat安全忽略未知的未来方块材质而不导致启动失败。 - 完整的德语与法语翻译对齐:
translations_de.yml和translations_fr.yml达到 100% 对齐(936/936 个声明的TranslationKey条目;960/960 个 YAML 总键值),与translations_en.yml和translations_es.yml保持一致。 - 统一的 GitHub Actions CI 与测试覆盖率:将构建、服务器冒烟测试和 Mineflayer 玩家测试整合到 blockprot.yml 中,包含作业超时时间和 JAR 排除过滤器;添加了带有 53 个 Python CI 脚本测试的 translations.yml;并将 JUnit 覆盖率扩展到 88 个测试(包括
TranslatorTest和AuditAndRegressionTest)。
变更日志
新增
- 针对受保护方块和实体的投射物、火焰(
ignite/spread)、流体(BlockFromToEvent/ 桶排空与填充)、掉落方块、发射器红石以及实体拴绳/投射物/伤害保护。 CHISELED_BOOKSHELF的按槽位保护(READ/WRITE)以及DECORATED_POT的投射物/交互保护。- 链接物品框架上的
BlockAccessMenuEvent分发以及漏斗物品拾取上的InventoryPickupItemEvent守卫。 - 专用的
translations.yml工作流、.github/scripts/audit_translations.py、53 个 Python CI 单元测试以及AuditAndRegressionTest回归测试。 VersionCompat和BlockFamilyParser(铜格栅子系列就绪性)中的防御性运行时解析,以及BedrockBridge中的握手查询参数剥离。plugin.yml中将Residence和GriefPrevention添加到softdepend。
更改
- 将
player-tests.yml中的模拟玩家机器人矩阵测试整合至.github/workflows/blockprot.yml,添加了作业超时时间(timeout-minutes)限制,在冒烟上传中排除了-javadoc/-sources制品,并标准化了plugins/*/logs/制品路径。 - 更新了
spigot/build.gradle.kts中的依赖项:com.github.ben-manes.caffeine:caffeine升级至3.3.1,com.mysql:mysql-connector-j升级至26.10.0。 - 重构了
AuditLogger的 SQLite 处理逻辑,采用序列化的 WAL 连接管理以及安全的/bp logs查询执行机制。 - 更新了
plugin.yml中的blockprot.user.admin.t2继承关系,并在AdminTierManager中强制执行显式权限否定优先于 OP 回退的逻辑。 - 通过兼容 Folia 的区域和实体调度器分发了
TownyIntegration取消保护清理、WorldExpiryTask、InactivityCleanupTask和VillagerLocateTask。 - 配置了更新器的
HttpClient,启用.followRedirects(HttpClient.Redirect.NORMAL),并在UpdateChecker中为latestVersion设置了 30 分钟的缓存 TTL。 - 升级了
ComponentMessages和UpdateChecker中的 MiniMessage / 旧版序列化支持,改用官方调色板颜色(<#98FF98>、<#F0E6A0>、<#7EC8E3>、<#FF6B6B>、<#B39DDB>)。
已修复
- GitHub 上的热修复版本标签现在能在稳定服务器中被正确识别,并且即使提供了
onComplete回调,启动控制台警告也会始终记录。 - 在
InventoryEventListener、InteractEventListener以及AdminUnlockCommand//bp tiers//bp lockables之间严格实施了容器绕过功能的对等性(/bp lockables支持左键实时切换和右键复制令牌)。 - 限制后的
ProtectedBlockCache和非阻塞的HybridDatabase负值/TTL 缓存防止了在漏斗和区块操作期间主线程或区域线程出现停滞。 - 通过在离线模式服务器上通过
Bukkit.getOnlineMode()进行门控控制,消除了 Mojang HTTP 调用的卡顿问题。 - 同步了
InventoryState/DialogState的访问,并修复了/bp logs分页的安全性问题。 - 填补了
translations_de.yml和translations_fr.yml中缺失及为空的项目,并修复了docs/READ_MEs/editions/中生成的版本描述的一致性。
版本说明
BlockProt Reloaded 覆盖 Minecraft 1.21.7 至 26.3。BlockProt Reloaded Legacy(Minecraft 1.20.5 至 1.21.6)和 BlockProt Legacy(Minecraft 1.18.2 至 1.20.4)也已接收适用的安全更新、Folia 兼容、缓存优化和逻辑回溯移植,并统一了 CI 工作流(请注意,新功能如 /bp logs 和 Paper Dialogs 仍仅适用于 BlockProt Reloaded)。请参阅 版本指南 以获取各版本的详细信息。
状态
- 发布:1.4.3 已准备好作为面向 Minecraft 1.21.7 至 26.3 的稳定维护、安全和质量更新版本。
验证
在发布之前,此构建已在 GitHub Actions 中进行了测试(运行 43637074493)。所有支持的 Minecraft 版本(1.21.7 - 26.3)均在真实的 Paper、Folia 和 Purpur 服务器上成功启动(对于未提供独立构建的声明版本,则在其最新的修复版本上运行),并通过了插件控制台诊断。在每个受测试客户端支持的版本上,双人保护测试也均顺利通过:所有者保护和打开一个箱子,而第二名玩家既无法打开也无法破坏它。
BlockProt Reloaded 1.4.2 更新日志
欢迎使用 BlockProt Reloaded 1.4.2。本次更新为每个好友添加了自定义权限,封堵了受保护方块周围剩余的物品和活塞路径,并增加了可通过 /bp logs 命令查看的分页访问日志。本版本保持与 1.4.0 系列相同的兼容范围:支持 Minecraft 1.21.7 至 Paper、Purpur 和 Folia 的 26.3 版本。
关于版本号: 1.4.0 系列的第二个热修复版发布为
1.4.1-hotfix.2,但本应为1.4.0-hotfix.2,因为1.4.1已预留给下一个功能更新。由于已发布的修复版优先级高于同版本的普通更新,因此普通的1.4.1永远不会被视为更新。因此,本功能更新的编号为 1.4.2,后续版本号将继续正常递增。
亮点
- 自定义好友权限:可将好友设置为“自定义”级别,拥有四项独立权限:打开容器、存入物品、取出物品和红石访问。这些权限在打开容器、进出物品以及使用门、陷阱门和其他红石控制方块时生效。
- 全路径防护:漏斗检查现在覆盖双向,物品不再能从受保护方块中被抽出或推入;漏斗不再能将物品送入受保护的载具;活塞也无法移动受保护的方块。
- 访问日志:
/bp logs [here|player <name>|<page>]可打开分页访问审计日志,用于查看特定玩家、当前注视的方块或最近条目的记录,同样支持 Paper 对话框视图。 - 区域保护互操作性:尊重由其他插件(如区域或领地保护插件)取消或拒绝的交互行为。
- 线程安全的基岩版表单处理:基岩版(Geyser/Floodgate)表单提交现在会分发到所属实体和区域线程,消除了 Paper 和 Folia 服务器上的
BlockEntity NBT needs to be accessed sync!错误。
详细变更
新增
- 每个好友的自定义权限:“自定义”级别独立授予打开容器、存入物品、取出物品和红石访问权限。
/bp logs命令及 Paper 对话框视图,用于访问审计日志,支持按玩家和方块位置筛选,并具备分页功能。- 对受保护载具(带箱子或漏斗的矿车)的漏斗防护。
- 对所有受保护方块类型的活塞防护:活塞无法推动、拉动或破坏任何被锁定的方块。
- bStats 语言图表及指标文档。
更改
- 重构配置处理为更小的组件并优化锁查找;现有的
config.yml、blocks.yml和worlds.yml文件保持不变。 - 将
/bp debug诊断信息拆分为领域套件,使报告按区域分组。 - 将启动迁移和修复操作移出主插件类。
- 将控制台和仓库链接指向 Zaynr-Ecosystem 组织。
- 将遗留的
javax.annotation导入替换为org.jetbrains.annotations,以便在现代 Spigot 和 Paper 26.3 工具链上干净编译。 - 将
runServer中测试服务器的 LuckPerms 依赖解析切换至 Modrinth。 - 将
Kir-Antipov/mc-publish发布工作流动作从 3.3.1 升级至 3.3.2。
修复
- 现在尊重由其他插件取消或拒绝的交互,而非继续处理。
- 文件操作和任务引发的异常现在通过插件日志记录。
- 基岩版表单响应现在在正确的区域和实体线程上处理,解决了 Floodgate 和 Geyser 玩家可能触发的
BlockEntity NBT needs to be accessed sync!错误(问题 #26)。 DoubleChest库存点击现在正确解析容器方块并强制执行自定义权限(canDeposit、canWithdraw、canOpenContainer)。- 在点击事件中用区域任务分发(
RegionTasks.runFor(player, player::closeInventory))替换直接关闭库存,以防止事件循环递归。 - 拥有写入权限(
canWrite)的好友和管理员现在可以编辑受保护的告示牌。 - 修复模拟玩家机器人测试套件:消除了同步 mineflayer 攻击拒绝并隔离和平难度。
版本说明
BlockProt Reloaded 涵盖 Minecraft 1.21.7 及更高版本。BlockProt Reloaded Legacy(Minecraft 1.20.5 至 1.21.6)和 BlockProt Legacy(Minecraft 1.18.2 至 1.20.4)在本版本中未作更改。版本指南 解释了应下载哪个版本以及如何在其间迁移。
状态
- 维护中:维护者暂时休息以专注于其他项目。欢迎提交任何更改的问题报告和拉取请求,我们将根据时间进行审查。
验证
发布前,此构建已在 GitHub Actions 中进行测试 (运行 41523889802)。在每个支持的 Minecraft 版本(1.21.7 - 26.3)上,只要该软件发布了构建(声明的版本若无自身构建则运行其最新热修复版),均能在真实的 Paper、Folia 和 Purpur 服务器上启动,并通过插件控制台诊断。在每个测试客户端支持的版本上,双人保护测试也顺利通过:所有者保护和打开一个箱子,而另一名玩家既无法打开也无法破坏它。
BlockProt Reloaded 1.4.1-hotfix.2 发布说明
注意: 作为一次针对性的维护更新,此热修复版本不包含发布说明横幅。
1.4.1-hotfix.2 修复了服务器重启后锁定方块失去保护的问题。无配置或数据格式变更。
已修复
- 重启后漏斗抽取了锁定的箱子 (#22):受保护方块的列表在启动时从后台线程重建,且仅从统计文件中读取,因此未找到的锁定方块会保持未保护状态,直到再次被锁定。这样,位于锁定箱下方的漏斗就可以抽取其中的物品。现在,当某个位置尚未被记录时,会直接针对该方块本身进行保护验证。
- 相同原因导致的其他保护失效:重启后,锁定方块还会暴露于活塞、爆炸、火焰、红石以及其他玩家的方块破坏之下。它们均使用相同的检查机制,现已一并修复。
- 双层箱子:锁定的双层箱子的另一半从未被注册为受保护状态。现在它像其他方块一样接受验证。
验证
在本次发布前,该构建已在 GitHub Actions 中进行了测试(运行 37131912140)。所有支持的 Minecraft 版本(1.21.7 - 26.3)均在真实的 Paper、Folia 和 Purpur 服务器上成功启动,前提是这些软件发布了构建(对于没有独立构建的声明版本,则在其最新的熱修復版本上运行),并且通过了插件控制台诊断。在测试客户端支持的所有版本上,双人保护测试也顺利通过:房主保护和打开一个箱子,而第二名玩家既无法打开也无法破坏它。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧