⚠️ WARNING: READ THIS BEFORE PLAYING TO PREVENT LAG & FREEZES! ⚠️

Many players instantly close the game thinking the modpack is "broken" or "laggy" because their screen freezes when they generate a new world.

THIS IS COMPLETELY NORMAL! Combining Voxy's massive render distances with heavy shaders heavily stresses your CPU during the initial world generation. You only need to fix this ONCE, and it takes less than 10 seconds.

👉 FOLLOW THESE 3 EASY STEPS AS SOON AS YOU LOAD IN:

1. Open your in-game chat.
2. Type exactly: /chunky radius [YOUR NUMBER] (Press Enter)
3. Type exactly: /chunky start (Press Enter)

*Optional but recommended:* Type /chunky quiet to turn off spammy chat notifications.

💡 WHAT DOES THIS DO?
This commands Chunky to pre-render the map safely based on your own render distance. Instead of lagging while you fly and explore, your game will become rock-solid and buttery smooth after a few minutes. Don't panic if your game stutters for the first 2-3 minutes while Chunky does its magic. Just wait a brief moment, look around, and enjoy the ultimate cinematic Minecraft experience!

--------------------------------------------------

📊 CHUNK SETTING GUIDE (Match your Render Distance with the correct Radius):
Check your game's Render Distance in Video Settings and choose your number wisely:

• Low / Mid Systems (16 - 32 Chunks) -> Type: /chunky radius 500
• High-End Systems (32 - 64 Chunks) -> Type: /chunky radius 1000
• Cinematic Systems (64 - 128 Chunks) -> Type: /chunky radius 2000

*Tip: 128 Chunks equals exactly a 2048 block radius, so /chunky radius 2000 is the perfect sweet spot for the ultimate Voxy performance!*

Why Voxy with Shaders? (Multi-Version Edition) Most graphics modpacks lock you into a single Minecraft version or suffer from severe background freezes and CPU lockups when you try to update them. Voxy with Shaders is built from the ground up with a modular blueprint. Whether you are playing on the latest releases or slightly older stable versions, this pack provides a hand-picked, meticulously tested selection of performance mods that scale perfectly to deliver zero crashes and rock-solid stability.

🚀 Key Features:

Multi-Version Scalability: Optimized across multiple Minecraft versions, ensuring that core graphics and performance engines remain flawlessly synchronized.
Shader-Compatible Infinite Horizons (Voxy + Iris): Fully integrated with Iris Shaders, allowing you to enjoy voxel-based distant terrain rendering alongside heavy cinematic shaders without overwhelming your system.
The Ultimate Performance Framework: Powered by version-matched releases of Sodium, Lithium, and FerriteCore to keep RAM and CPU overhead at an absolute minimum for smooth, high-FPS gameplay.
Lag & Stuttering Eliminator (Chunky): Pre-generates world chunks silently in the background, preventing sudden frame drops and lag spikes while exploring massive render distances with shaders on.
Polished Vanilla Aesthetics: Includes Entity Model Features and OptiGUI to ensure that while your landscapes look next-gen, your mobs, textures, and user interfaces maintain a beautifully clean, polished vanilla look.

🛠️ Multi-Version Setup Guide & Tips:

Select your preferred Minecraft version from the modpack's "Versions" or "Files" tab on CurseForge/Modrinth.
Once you load into your world, open the chat and type /chunky silent followed by /chunky start to let the map load smoothly in the background.
Turn on your favorite shader (like Photon), crank up your Voxy distance, and witness Minecraft like never before!