VeryMcProto

VeryMcProto 26.1.2-b4（上游对齐缺口修复 + 文档体系重构）

以纯 Paper 插件形式移植 Fabric 端协议 Mod（Servux / JEI / Syncmatica），面向 Minecraft 26.1.2 / Paper 26.1.2（Java 25）。

本版为 26.1.2 线内的修复批次（4 个 fix + 1 个 refactor 提交），主线是补齐移植遗漏的上游行为对齐缺口与清理文档/注释对源码的真值漂移。上游最新 release 已至 26.2，本版起 26.1.2 线冻结为维护对（ver/26.1.2 / ver/26.1.2-dev），后续该线 Bug 修复在 ver/26.1.2-dev 提交。

修复

Servux

• servux_main 配置主通道可被运行时停用：「恒启用」不变量此前仅配置加载期强制，/servux disable servux_main 可停用并落盘 false（重启自愈）——DataProviderManager 新增 ALWAYS_ENABLED 运行时总闸 + 命令层停用前置拒绝；search 子命令重写为上游三臂（分词 AND + name/comment/provider + 大小写敏感）+ 两态输出
• 13 处上游对齐缺口：HUD spawn 刷新权限复检（注册后撤权即拒发）、Structures 发送三门早退、InfoHud task 组删自创标题条目（原占 maxLines 一位致客户端少渲染一行）、paste 拒绝文案常量化对齐 en_us、SchematicPlacement 坏 NBT 条目 Pos 守卫（坏帧不再 NPE 穿透）、NOT_PLAYER 判定统一为 litematica 同构 instanceof 形等；删 selection/ 四个零引用死文件
• 热路径日志刷屏：C2S 每包异常日志全堆栈 WARNING 降单行（防恶意畸形包刷屏，上游同范式）；4 处 Handler javadoc 协议版本裸值（1.21.11 残值 1/1/1/2）改 {@value} 真值引用——26.2 适配零同步成本
• 文档真值漂移 16 处：五通道协议版本对齐真值 3/2/2/3/2（docs/03/10 钉守）、MOD_STRING 表述翻转为 fabric 前缀硬门禁（docs/01/07）、docs/40 litematic_data 键表补 3 键 + 权限表补 task.fill / task.delete 两节点

JEI

• fabric 配方同步腿过滤 minecraft 命名空间：按 serializer registry key 过滤（对齐上游 JustEnoughItems:38-48；getKey 为 null 的条目跳过）

Syncmatica

• console load 广播臂 + 竞态闭合：console load 走 addPlacement 广播（复刻上游意图并修复其 fromExistingPlayer(null) NPE 缺陷）、load 结果广播管理员、onPlayerLeave try/finally 化 + onPlayerJoin 清陈旧 broadcastTargets

文档体系重构

• README 754→~290 行英文瘦身门面，命令/权限/配置全键/排错迁入新建 docs/40-configuration.md（docs 内唯一运维权威）
• 物理删除 9 个历史文档（docs/06、08、11 与 docs/research/×6，~270KB，恢复走 git revert）；包结构三拷贝收敛为 docs/20 §2 唯一权威；14 处断链清扫；净减 ~3600 行

验证

• 113/113 单元测试全绿（19 个测试类，较上版 +3 用例：SchematicPlacementGuardTest 3——SchematicPlacement 坏 NBT 守卫）
• 版本注入终检通过：产物 jar 内 plugin.yml / version.properties 与构建版本一致（VeryMcProto-26.1.2-b4.jar 内部版本 = 26.1.2-b4）
• 产物为 Mojang 映射 jar（26.1 起无 reobf）

产物

VeryMcProto-26.1.2-b4.jar —— Mojang 映射 jar，标准 Paper 26.1.2 服务器放入 plugins/ 直接加载。

上一版本：v26.1.2-b3；旧版本（MC 1.21.11）见 v1.21.11-b1。