🧭 版本相容性與生命週期

技術參數	規範要求
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

---

相關頁面: 首頁面板 | 零依賴架構設計 | 開發者環境與編譯建置