🚀 TheFastLaunch (TFL)

🎬 Demonstration & Benchmark Video

Watch TheFastLaunch achieve a sub-1-minute boot and instant world loading with a heavy 200+ modpack:

👉 Watch Demonstration Video on YouTube

📖 Overview (English)

TheFastLaunch (TFL) is a modern, high-performance optimization mod specifically engineered for heavy Forge modpacks (200+ mods).This completely resolves the Windows-specific “Not Responding” (white screen/ghost window) freeze that occurs when launching the game or connecting to a world, and reduces the startup time—which normally takes 8 to 10 minutes or more—by about 1 to 2 minutes.

✨ Core Optimization Features

• 🛡️ Continuous GLFW Event Pumper: Runs a dedicated high-priority watchdog thread that continuously processes glfwPollEvents() at 60 FPS. This physically prevents Windows OS from triggering the "Not Responding" ghost window during heavy synchronous mod loading phases.
• ⚡ Pre-Extracted Asset Direct-Read Engine: Automatically primes heavy mod assets (Essential, ldlib, FantasyEnd, MBD2, etc.) into a pre-extracted cache directory on the first run, completely bypassing heavy runtime ZIP decompression on subsequent boots (saving 60–70s).
• 💾 Registry Snapshot Cache Engine: Binary-snapshots GameData registry rebinding results, reducing serialization bottlenecks from 45s down to 0.01s.
• 🚀 JEI Runtime Fast-Bypass: Snapshots JEI GUI handler scans, eliminating the 2-minute GUI reflection freeze during world connection.
• 🧹 Post-Login Full-GC Killer: Neutralizes aggressive System.gc() calls that cause 2-minute Stop-the-World pauses upon joining a world.
• ⚙️ Multi-Core Parallel Loaders: Fully distributes heavy mod loading tasks across all available CPU cores (Truly Modular variant generators, FantasyEnd classes, ModelBakery 3D baking).

🖥️ Verified Test Environment & Hardware Benchmark

Measured with a heavy 200+ ModPack:

⚠️ Important Requirements & Notes

High-Spec Multi-Core Hardware Recommended
TheFastLaunch is architected to utilize all available CPU cores, high-bandwidth RAM, and fast storage I/O. It is optimized primarily for multi-core, high-spec gaming PCs. Performance on low-end or single/dual-core systems is currently untested.

Beta Notice & Compatibility
This is a Beta release (b1.0). While tested extensively on standard 200+ modpack environments, exhaustive compatibility tests across every individual mod have not yet been completed. We recommend creating a world backup before first installation.

🗺️ Roadmap & Supported Versions

• ✅ Minecraft 1.20.1 (Forge 47.x / UniMixin) : Available Now (b1.0)
• 🔄 Minecraft 1.12.2 (Forge) : Planned
• 🔄 Minecraft 1.7.10 (Forge / MixinBooter) : Planned

📜 License & Credits

• License: Fully Open Source under the MIT License. Free to use, modify, and include in any modpack!
• Source Code & Issue Tracker: GitHub Repository
• Author: saburou8190
• Development Assistant: Google DeepMind Antigravity

---

🇯🇵 日本語説明 (Japanese Description)

📖 概要

TheFastLaunch (TFL) は、大規模な ModPack（200個以上の Mod 導入環境）向けに開発された次世代の超高速化・安定化 MOD です。
ゲーム起動中やワールド接続時に発生する Windows 特有の 「応答なし（白画面 / Ghost Window）」フリーズを完全根絶 し、通常 8〜10分以上かかる長大な起動時間を 1〜2分 程度短縮します。

✨ 主な最適化機能

• 🛡️ 常時 GLFW イベントポンプ: 専用の高優先度スレッドが glfwPollEvents() を 60FPS で常時駆動し、重い Mod の読み込み中も Windows OS による「応答なし」判定の発動を 100% 物理遮断します。
• ⚡ ZIP 事前展開ダイレクト直読キャッシュ: 初回起動時に Mod JAR 内のアセットを展開キャッシュし、2回目以降の起動における重い ZIP 解凍処理（60〜70秒の負荷）を完全 0 秒化します。
• 💾 レジストリスナップショットキャッシュ: レジストリのバインド計算結果をバイナリ保存し、45秒の再計算を 0.01秒で一括復元します。
• 🚀 JEI GUI ランタイム直接バイパス: ワールド接続時に発生していた JEI の 2分間の GUI 走査をスナップショット展開し、入室待機時間をゼロ化します。
• 🧹 ワールド入室フル GC キラー: ログイン直後に約 10GB のメモリ全体に対して 2分間の完全硬直（Stop-the-World）を引き起こす強制 GC を無効化します。
• ⚙️ マルチコア並列ロードエンジン: 巨大 Mod（Truly Modular、FantasyEnd、ModelBakery 3Dモデル等）の読み込み処理を CPU の全コアへ分散並列化します。

🖥️ 実証・動作検証環境

⚠️ 動作環境および注意事項

高スペック PC 推奨
本 Mod は CPU の全コア（マルチスレッド）と高速 I/O をフル稼働させる設計のため、マルチコア高スペック環境を前提としています。低スペック・省コア環境での動作は現在未検証です。

ベータ版および Mod 競合について
本バージョンはベータ版（b1.0）です。一般的な 200 Mod 環境でテストされておりますが、すべての個別 Mod との完全な競合確認は行えておりません。導入時はバックアップをお勧めいたします。

🗺️ 対応バージョンとロードマップ

• ✅ Minecraft 1.20.1 (Forge 47.x / UniMixin) : 対応完了 (v-b1.0)
• 🔄 Minecraft 1.12.2 (Forge) : 展開予定 (Planned)
• 🔄 Minecraft 1.7.10 (Forge / MixinBooter) : 展開予定 (Planned)

📜 ライセンス・クレジット

• ライセンス: MIT License（完全オープンソース / ModPack への同梱自由）
• ソースコード / 不具合報告: GitHub Repository
• 制作者: saburou8190
• 開発アシスタント: Google DeepMind Antigravity