🚀 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: sabu8190
• Development Assistant: Google DeepMind Antigravity

## ---

🤝 Credits & Special Thanks

TheFastLaunch incorporates and builds upon ideas, techniques, and optimizations inspired by the following amazing projects and developers in the Minecraft modding community. We would like to express our deepest gratitude to them:

• Just Enough Freezes (FastJEI) — Developed by Misanthropy

  • Inspiration and technique for multi-threaded JEI search index building and asynchronous brewing recipe optimization.

• Tinkers' JEI Pre-Filter — Developed by MikhaXOXO

  • Inspiration and approach for pre-filtering generated Tinkers' Construct tools and part variants before JEI global indexing.

All respective code and implementations in TheFastLaunch are independently written, respecting the hard work and innovations of these brilliant creators. Thank you for making Minecraft performance better for everyone! 💖

🇯🇵 日本語説明 (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

🤝 クレジット・Special Thanks

TheFastLaunch は、Minecraft MOD コミュニティの素晴らしい開発者様方によるアイデアや最適化技術に深くインスパイアされ、それらを参考に独自実装を行っております。心より感謝と敬意を表します：

• Just Enough Freezes (FastJEI) — 作者: Misanthropy 氏
  • JEI 検索インデックスのマルチスレッド並列化およびポーション醸造レシピ最適化の着眼点とアプローチ
• Tinkers' JEI Pre-Filter — 作者: MikhaXOXO 氏
  • Tinkers' Construct のツール・パーツ素材バリアントを JEI インデックスから事前除外する着眼点とアプローチ

素晴らしい MOD を制作し、マイクラのパフォーマンス向上に貢献してくださっているクリエイターの皆様に深く感謝！