🗺️ 版本相容性與跨時代生命週期矩陣

📌 程式碼儲存庫原始碼聲明：本 Wiki 中的文件反映了程式碼儲存庫目前的最新原始碼狀態，可能包含尚未在 CurseForge 和 Modrinth 上發布的開發中功能或最新提交。

🏛️ 1 Jar 1 Version（單版本單 Jar）執行規範

True Sleep 嚴格執行 1 Jar 1 Version（單版本單 Jar）政策：每個受支援的 Minecraft 目標版本均擁有獨立編譯的專屬 JAR 檔案，原生針對該版本的 Loom 工具鏈與位元組碼進行建置。

根據 強制性多版本全生命週期支援規範，未經明確公告，任何已受支援的版本均絕不會被遺棄、終止維護或標記廢棄。

📊 完整的 Minecraft 版本支援矩陣

Minecraft 錨點版本	時代階段	Java 工具鏈	建置套件	模組版本標籤	運行狀態
MC 26.3	Modern Lead	Java 25+ (`release = 25`)	Loom 1.15+, Gradle 9.3+	`1.3.23+26.3`	🟢 活躍支援與生產建置
MC 26.2	Modern Predecessor	Java 25+ (`release = 25`)	Loom 1.15+, Gradle 9.3+	`1.3.22+26.2`	🟢 活躍支援與生產建置
MC 26.1 / 26.1.2	Modern Anchor	Java 25+ (`release = 25`)	Loom 1.15+, Gradle 9.3+	`1.3.22+26.1.2`	🟢 活躍支援與生產建置
MC 1.21.11	Winter Drop	Java 21 (`release = 21`)	Loom 1.15-SNAPSHOT	`1.1.2+1.21.11`	🟡 歸檔維護建置
MC 1.21.1	Transitional Early	Java 21 (`release = 21`)	Loom 1.10+	`1.1.2+1.21.1`	🟡 歸檔維護建置
MC 1.20.1	Legacy Anchor	Java 17 (`release = 17`)	Loom 1.4+, Gradle 8.x	`1.0.3+1.20.1`	🟡 歸檔維護建置

🛡️ ModVersionGuard 啟動安全驗證

為保護玩家持久化的存檔資料與資料附件免受類別載入器不符或 API 損壞的影響，True Sleep 在模組初始化 onInitialize() 階段執行零依賴位元組碼安全驗證：

java

public class TrueSleep implements ModInitializer {
    @Override
    public void onInitialize() {
        net.vanillaoutsider.truesleep.util.ModVersionGuard.checkClass(
            "True Sleep", 
            "net.minecraft.world.entity.player.Player"
        );
        LOGGER.info("Initializing True Sleep (Time Warp)...");
        TrueSleepRules.init();
        CommandRegistrationCallback.EVENT.register((dispatcher, registryAccess, environment) -> 
            TrueSleepCommand.register(dispatcher)
        );
    }
}

Knot 類別載入器解析機制

驗證過程呼叫 Thread.currentThread().getContextClassLoader() 透過 Fabric 的 Knot 類別載入器解析原版核心類別。如果檢測到不相容的遊戲引擎環境，模組會在任何區塊或實體資料被修改之前立即安全中止啟動，並輸出明確的診斷報錯資訊。

📦 模組依賴矩陣

依賴項	最低版本	必需 / 可選	用途與職責
Fabric Loader	`>=0.16.10`	必需	模組載入與 Mixin 位元組碼轉換引擎。
Java Runtime	`>=25` (26.x) / `>=21` (1.21) / `>=17` (1.20)	必需	核心 JVM 運行環境。
Fabric API	`*` (Open Lower Bound)	必需	指令註冊與生命週期事件掛鉤。
Dasik Library	`>=1.8.0`	必需	動態 GameRule 引擎與社交系統調控。
Cloth Config	`*`	可選	遊戲內圖形化設定編輯介面。
ModMenu	`*`	可選	模組列表整合與設定按鈕。

🗺️ 版本相容性與跨時代生命週期矩陣 ​

🏛️ 1 Jar 1 Version（單版本單 Jar）執行規範 ​

📊 完整的 Minecraft 版本支援矩陣 ​

🛡️ ModVersionGuard 啟動安全驗證 ​