promotional bannermobile promotional banner

StartupFlow

Accelerates 1.12.2 launch times with multi-threaded model baking, parallel texture mipmapping, and smart startup caching.

⚡ Startup Flow

High-Performance Startup Optimizer for Minecraft 1.12.2

CleanroomMC • Minecraft Forge • Client • Dedicated Server

Minecraft 1.12.2 Cleanroom and Forge Client and Server GPL 3.0


🌟 What is Startup Flow?

Tired of waiting minutes every time you boot up large Minecraft 1.12.2 modpacks like RLCraft, MeatballCraft, or GreedyCraft?

Startup Flow is a dual-purpose optimization mod designed specifically to eliminate startup lag on both CleanroomMC and standard Minecraft Forge 1.12.2. It tackles two of the heaviest launch bottlenecks:

  1. Caching FermiumBooter's Startup Scan: Bypasses the repetitive, disk-heavy ClassGraph scanning of hundreds of mod JAR files on every boot by caching the results to disk.
  2. Multi-Threaded Model Baking: Parallelizes block and item model compilation across multiple worker threads instead of forcing everything through a single CPU core.

⚡ Key Benefits & Features

  • Instant Replay of Jar Scans: On warm boots, Startup Flow pre-loads cached mod IDs and @MixinConfig toggles into FermiumBooter in just ~24 milliseconds, completely skipping the expensive disk scan.
  • Multi-Core Model Baking: Automatically detects your CPU cores and bakes block/item models concurrently, dramatically speeding up client loading on packs with tens of thousands of model variants.
  • Smart Invalidation Fingerprint: Automatically detects changes in your mods/ directory (including nested folders like mods/1.12.2/) as well as config/fermiumbooter.cfg content changes. The cache updates itself only when your mod setup actually changes.
  • Universal Compatibility: Works natively on both Cleanroom and standard Forge instances.
  • Client & Server Friendly: Caching benefits both client launches and dedicated servers. Model baking optimizations safely stand by on headless servers.
  • Safe & Non-Intrusive: Uses reflection with zero compile-time dependencies on FermiumBooter. If FermiumBooter is absent, Startup Flow steps aside gracefully without logging scary errors.
  • Built-in OptiFine & VintageFix Protection: Automatically detects OptiFine and disables conflicting texture mixins to preserve custom shaders and textures. Fully compatible with VintageFix's dynamic resources.

📊 Real Benchmark Results

Measured on a real-world modpack with 234 mods and 564 @MixinConfig toggles (Cleanroom 0.6.13-alpha, identical hardware):

Boot State Cache Status Log Span (Start → Done) Wall Time (±0.5s) Toggle Scan Processing
Baseline (No StartupFlow) None 56.0 s 60.4 s Full ClassGraph JAR scan across disk
StartupFlow (Cold Boot) Miss → Write 55.0 s 59.0 s Scans once and caches to disk
StartupFlow (Warm Boot 1) Cache Hit 53.0 s 57.6 s 564 toggles applied in 24 ms
StartupFlow (Warm Boot 2) Cache Hit 53.0 s 57.0 s 564 toggles applied in 24 ms

Correctness Guarantee: 0 Mixin errors, 0 crashes, and identical toggle evaluation verified between cold and warm boots.


🧩 Compatibility Matrix

  • CleanroomMC: Fully supported and recommended.
  • Minecraft Forge 1.12.2: Fully supported on Forge 14.23.5.2847 or higher.
  • FermiumBooter: Supported automatically. The scan cache activates when FermiumBooter is installed.
  • OptiFine: Fully compatible. Startup Flow detects OptiFine at runtime and dynamically disables its texture atlas mixin so OptiFine's shader and texture pipelines remain 100% untouched.
  • VintageFix: Fully compatible. If VintageFix has dynamic_resources enabled (loading models on-demand), Startup Flow's model baker safely idles while the FermiumBooter scan cache continues speeding up startup.
  • Surge / CensoredASM: Fully compatible with no conflicting transformations.

📋 Requirements & Installation

Requirements:

  • Minecraft 1.12.2
  • Minecraft Forge (14.23.5.2847+) OR Cleanroom (0.6.x+)
  • MixinBooter (10.0 or newer)
  • Optional: FermiumBooter (required only if you want scan caching)
  • Java 8 up to Java 25

Installation:

  1. Ensure MixinBooter is present in your mods folder.
  2. Download startupflow-1.0.1.jar and place it into your mods folder.
  3. Launch the game. The first boot records the cache; every launch thereafter will automatically benefit from warm boots!

⚙️ Configuration & Commands

Configuration file: config/startupflow.cfg

"Model Baking" {
    # Bake block and item models across multiple worker threads instead of a single thread.
    B:"Enable Parallel Model Baking"=true
# Number of threads for model baking (0 = auto-detect CPU cores).
I:"Model Baking Threads"=0

# Compute texture atlas mipmap levels concurrently across multiple threads.
B:"Enable Parallel Mipmaps"=true

# Number of threads for mipmap generation (0 = auto-detect CPU cores).
I:"Mipmap Threads"=0
 

}

 

Cache Management:

  • Disable Cache via JVM flag: Add -Dfermiumscancache.disable=true to your launcher arguments.
  • Disable Cache via File Marker: Place an empty file at config/fermiumscancache.disabled.
  • Force Rescan: Delete config/fermiumscancache.json.

In-Game Commands:

  • /startupflow status — View current model baking threads and status.
  • /startupflow toggle — Toggle parallel model baking on or off.

📜 License

Startup Flow is open-source software licensed under the GNU General Public License v3.0 (GPL-3.0). Source code is available on GitHub.

StartupFlow Team

profile avatar
Owner
  • 1
    Followers
  • 12
    Projects
  • 1.6K
    Downloads

Electronic & Computer Engineering student and open-source developer. Crafting performant mods, tools, and systems. Passionate about quality-of-life utilities, clean code, and bringing great mechanics across ecosystems.

Donate

More from AelfwifView all

  • OpenTerrainGenerator: Flow Edition project image

    OpenTerrainGenerator: Flow Edition

    A thread-safe, allocation-optimized OpenTerrainGenerator fork engineered for crash-free parallel worldgen and high-speed pregeneration.

    • 1
    • October 26, 2026
  • Divine Enchantments project image

    Divine Enchantments

    Expands Minecraft 1.12.2 with 71 handcrafted enchantments that add deeper combat, ranged skill shots, summoned allies, and rare rune and ancient blades enchants.

    • 28
    • October 26, 2026
  • ChunkFlow: Fast Chunk I/O project image

    ChunkFlow: Fast Chunk I/O

    Multi-threaded chunk loading from disk with directional streaming that prevents unrendered void holes during fast travel.

    • 91
    • October 25, 2026
  • WorldFlow project image

    WorldFlow

    Multi-threaded world generation engine that eliminates cascading structure lag and speeds up terrain creation across all CPU cores.

    • 60
    • October 25, 2026
  • OpenTerrainGenerator: Flow Edition project image

    OpenTerrainGenerator: Flow Edition

    A thread-safe, allocation-optimized OpenTerrainGenerator fork engineered for crash-free parallel worldgen and high-speed pregeneration.

    • 1
    • October 26, 2026
  • Divine Enchantments project image

    Divine Enchantments

    Expands Minecraft 1.12.2 with 71 handcrafted enchantments that add deeper combat, ranged skill shots, summoned allies, and rare rune and ancient blades enchants.

    • 28
    • October 26, 2026
  • ChunkFlow: Fast Chunk I/O project image

    ChunkFlow: Fast Chunk I/O

    Multi-threaded chunk loading from disk with directional streaming that prevents unrendered void holes during fast travel.

    • 91
    • October 25, 2026
  • WorldFlow project image

    WorldFlow

    Multi-threaded world generation engine that eliminates cascading structure lag and speeds up terrain creation across all CPU cores.

    • 60
    • October 25, 2026