🧭 版本兼容性与生命周期

技术参数	规范要求
Minecraft 时代	现代主权时代 (MC 26.2+)
目标版本依赖	minecraft: >=26.2- (开放向前兼容)
Fabric Loader Requirement	fabricloader: >=0.16.9
Java 开发套件	Java 25+ (release = 25, Eclipse Adoptium Hotspot)
运行期依赖	零运行期依赖 (无需 Fabric API)
构建工具链	Loom 1.15+ / Gradle 9.3+ (--no-daemon)
活跃版本策略	1 JAR 1 Version 铁律 (聚焦当前活跃版本)

---

📌 主权时代版本策略

Vanilla Outsider: Bed Chat Hider 严格遵循 1 JAR 1 Version 开发规范：

• 活跃开发与缺陷修复专门聚焦于最新目标发布版本 (Minecraft 26.2+)。
• 当推出年度大版本更新（如 26.3）时，旧版本分支将直接封存归档，不进行向后移植循环。
• 得益于开放式版本界限 (>=26.2-)，兼容的小版本更新可无缝运行，无需人为催促模组更新。

---

🛡️ ModVersionGuard Architecture

为保护世界存档并确保启动零崩溃，Bed Chat Hider 内置了零依赖的运行期类加载校验机制：

                  [ Game Launch / Mod Init ]
                              │
                              ▼
            [ BedChatHiderClient.onInitializeClient ]
                              │
                              ▼
              [ ModVersionGuard.checkClass ]
                              │
               ┌──────────────┴──────────────┐
               ▼                             ▼
       [ Class Found ]              [ Class Not Found ]
       (Compatible API)             (Incompatible API)
               │                             │
               ▼                             ▼
    [ Load Client Success ]      [ Halt Game with ASCII Banner ]
                                 (Prevent World Save Corruption)

Verification Implementation

// Verified in BedChatHiderClient.java
ModVersionGuard.checkClass("Bed Chat Hider", "net.minecraft.client.gui.screens.ChatScreen");

若检测到不兼容的游戏运行环境，模组会打印清晰的 ASCII 诊断横幅并安全终止，防止静默区块损坏或难以排查的字节码崩溃。

---

📊 Compatibility Matrix

Minecraft 版本	模组构建版本	Fabric Loader	Java 目标	运行期 Fabric API	支持状态
26.2	1.0.4+26.2	0.19.3+	Java 25	Not Required	🟢 Active / Supported
26.2	1.0.3+26.2	0.19.3+	Java 25	Not Required	🟡 Archived
26.2	1.0.2-26.2	0.19.3+	Java 25	Not Required	🟡 Archived
26.2	1.0.1-26.2	0.19.3+	Java 25	Required (v0.152.2)	🔴 Yanked
26.2	1.0.0-26.2	0.19.3+	Java 25	Required (v0.152.2)	🟡 Archived

---

相关页面: 首页面板 | 零依赖架构设计 | 开发者环境与编译构建