VeryMcProto

VeryMcProto 26.2-b4（Carpet 模块全量落地 + 三线文档体系重构）

以纯 Paper 插件形式移植 Fabric 端 Mod Protocol——协议投递型（Servux / JEI / Syncmatica）+ 行为注入型可移植子集（Carpet），面向 Minecraft 26.2 / Paper 26.2（Java 25，开发线 dev → main）。

本版内容（自 v26.2-b3 以来）

• Carpet 模块全量落地（可完整等价子集，移植范围终局定案）：
  • P1 模块地基（97e488e）：注解规则框架（上游 SettingsManager 同构——carpet.conf 纯文本 + locked 语义 + validator 链）+ /carpet list|setDefault|query|removeDefault 四子命令（静态 carpet.command + 动态 carpetCommandPermissionLevel 双层门禁）+ 8 条地基规则实名接入；
  • P2 假人 /player 全族（1b044a0）：patches 三件套纯子类（spawn 走原版 placeNewPlayer 链——tab 栏/入睡跳夜/playerdata 持久//tp /ban 识别全部原生承载）+ EntityPlayerActionPack 动作状态机（侧表 + BukkitRunnable tick 驱动）+ /player 全子命令（Paper Brigadier）；掉落/环境接触伤害双免疫修复（2f79429：26.2 线 Paper 关闭服务端玩家物理——tick 手动累积 fallDistance + 落地直调 causeFallDamage，per-line 决策勿跨线互抄）；
  • P3 carpet:hello 协议（5084843）：单 CompoundTag 载体通道，S2C 全 NMS DiscardedPayload 直发，进服 HI（版本串 = 上游 mod_version 逐字 "26.2"，禁发插件版本号）+ hello 应答 + Rules 全量/增量同步 + clientCommand 请求-回执（Snoopy 移植）；
  • P4 /log 日志框架（811a8de）：LoggerRegistry 上游同构订阅框架 + tps/mobcaps 两条 HUD logger（公式与热力色上游逐字、MAGIC_NUMBER=289）——HUD 走 tab 脚每 20 tick（Bukkit setPlayerListFooter，零协议路径），订阅跨会话持久（carpet-logs.json 双信号模型：显式订阅 + 退订墓碑）；
  • P5 纯计算命令族（402a79c）：/distance /info block /perimeterinfo /draw /spawn mobcaps|entities 五命令 + Messenger 组件输出层（含可点击 tp 坐标）+ 五条 commandXxx 规则；
  • 移植范围终局定案（f3b3840）：可完整等价的子集全部实现完毕；其余面（Scarpet / TNT 与红石活塞优化类 Mixin / 近似规则池与 chat logger 等）在纯 Paper 形态下技术上不可能实现或无法等价，永不纳入——预研/推进规划文档已删除（历史见 git）。
• 三线文档体系重构（6095243 + f3b3840）：docs/ 重构为三线同构模块子目录树（servux/ syncmatica/ jei/ carpet/ + 全局四件留根 + 冻结归档 archive/），index.md 双层历史锚点映射表；版本字串策略三件套（README 活值位=最近已发版语义 / AGENTS+docs 内 buildNumber 占位化 / operations.md §0 落库）——发版文档同步面从 8 文件 17 行/线收缩至 README 2 位/线。
• 其他：/servux set 非法值静默伪成功修复（78dd25c）；AGENTS.md 本机信息分离为不入库的 AGENTS.local.md（983f0cf）与工具链路径勘误（d4b172c）；IDEA 索引排除（034a766）。
• 发版提交（1c4da22）：buildNumber 3 → 4。

验证

• ./gradlew build 全绿（含 verifyVersionInjection）；./gradlew test 175/175 全绿（28 测试类，含 Carpet 7 类）
• runServer 实机：四模块注册 + /carpet 18 规则往返 + 假人全链（spawn→/tp→掉落→kill）+ /log console 拒绝链 + 五命令输出逐字判据通过
• 文档电池：旧路径引用零命中 + 全盘 .md 链接解析零断链 + src 锚点目标存在性全过

产物

VeryMcProto-26.2-b4.jar —— Mojang 映射 jar（26.1 起无 reobf），标准 Paper 26.2 服务器放入 plugins/ 直接加载。可选依赖 PacketEvents 2.14.0（仅 EasyPlace 需要，未装自动跳过）。

上一版本：v26.2-b3。