Lumin

✨ Lumin — Optimization Modpack

See more. Do more. Lag less.

Lumin is a client-side only optimization modpack for Minecraft Java Edition 26.2. Built on Fabric, it delivers a massive FPS boost, smoother gameplay, and reduced RAM usage — without changing vanilla gameplay or getting you banned from servers.

Works on every server. No server-side installation required. Hypixel, vanilla, Paper, Spigot — all compatible.

---

🚀 What Lumin Does

Category	What's Optimized
GPU / FPS	Complete rendering pipeline rewrite, entity & face culling, draw call batching
CPU / Logic	Mob AI, physics, chunk loading, lighting engine rewrite
RAM	Block state deduplication, dynamic model loading, memory leak patches
Network	Packet compression and pipeline reordering
Background	Near-zero CPU/GPU when minimized or AFK

---

📊 Performance at a Glance

• 2–3× the FPS of OptiFine on the same hardware
• 50%+ reduction in tick times (Lithium)
• 500 MB – 1 GB+ RAM savings in vanilla (FerriteCore)
• ~90% CPU/GPU reduction when alt-tabbed (Dynamic FPS)
• No GC stutter — optimized via Aikar's Flags

---

🖥️ Real-World Benchmark

Tested on the developer's machine — mid-range laptop hardware, 4 GB RAM allocated to Minecraft.

System: Intel Core i5-11400H · NVIDIA GeForce RTX 3050 Mobile (4 GB VRAM) · 16 GB RAM

Configuration	Render Distance	FPS
No shaders (VSync OFF)	64 chunks	300+ FPS ✅
No shaders (VSync ON, 144Hz)	64 chunks	144 FPS (capped)
Complementary Reimagined (default)	64 chunks	60 – 70 FPS
Complementary Reimagined (optimized settings)	24 chunks	~85 – 95 FPS
Photon Shaders (medium)	24 chunks	~100 – 115 FPS
BSL Shaders (medium)	24 chunks	~100 – 120 FPS

💡 Shader tip: If you use Complementary Reimagined, reduce Shadow Distance to 64, set Volumetric Clouds to Fast, and turn off Ambient Occlusion for a ~20 FPS boost with minimal visual difference.

💡 Render distance tip: The pack includes Bobby — it caches chunks so lowering your render distance while using shaders won't leave the world looking empty on servers.

---

🧩 Included Mods (27 mods + 5 dependencies)

🖥️ Rendering / GPU

Mod	Version	Purpose
Sodium	0.9.1	Modern rendering engine — the backbone of Lumin
Iris Shaders	1.11.2	Shader support alongside Sodium (OptiFine packs work too)
EntityCulling	1.10.5	Skip rendering entities hidden behind walls
ImmediatelyFast	1.16.2	Batch draw calls — faster HUD, particles, entity rendering
More Culling	1.8.1	Cull hidden inner faces of leaves, slabs, stairs
Particle Core	0.3.3	Frustum-cull particles, cap spawn counts

⚙️ Game Logic / CPU

Mod	Version	Purpose
Lithium	0.25.3	AI, physics, chunk ticking — 50%+ tick improvement
C2ME	0.4.2-alpha.0.35	Multi-threaded chunk generation & loading
ScalableLux	0.3.0-alpha.0.3	Full lighting engine rewrite (Starlight successor)

💾 Memory / RAM

Mod	Version	Purpose
FerriteCore	9.0.0	Deduplicate block state objects — 500 MB+ RAM savings

🌐 Network / Background

Mod	Version	Purpose
Krypton	0.3.1	Network stack rewrite — faster packet handling
Dynamic FPS	3.11.9	Reduce CPU/GPU usage when alt-tabbed or AFK

✨ OptiFine Replacements

Mod	Version	Replaces
Continuity	3.0.1	Connected Textures (CTM)
BetterGrassify	1.8.7	Better Grass
LambDynamicLights	4.12.2	Dynamic Lights
Entity Model Features (EMF)	3.2.6	Custom Entity Models
Entity Texture Features (ETF)	7.1.1	Custom Entity Textures
Zoomify	2.16.1	Zoom
Sodium Extra	0.9.3	Advanced graphics toggles
Reese's Sodium Options	2.2.3	Better settings UI

🎯 Quality of Life & Utility

Mod	Version	Purpose
Mod Menu	20.0.1	View installed mods from title screen
Clumps	26.2.1	Merge XP orbs — prevents farm FPS drops
Bobby	5.2.15	Cache chunks to maintain render distance on servers
ViaFabricPlus	4.6.1	Connect to servers running older Minecraft versions
No Resource Pack Warnings	1.5.0	Suppress incompatible pack warnings
Resource Pack Profiles	1.0.0	Save and switch resource pack presets

📦 Dependencies (auto-installed)

Mod	Purpose
Fabric API	Core Fabric mod API
Cloth Config	Config screen library
YetAnotherConfigLib	Config library (Zoomify, Dynamic FPS)
Fabric Language Kotlin	Kotlin runtime for Fabric mods
Fzzy Config	Config library (Particle Core)

---

🛡️ Server Compatibility & Anti-Cheat

Every mod in Lumin is rendering, memory, or network optimization only. Zero gameplay changes. Zero movement/range/ESP modifications.

Server Type	Status
Hypixel (Watchdog)	✅ Safe — explicitly allowed
PaperMC	✅ Safe
Vanilla / Spigot	✅ Safe
Strict anti-cheat	✅ Safe — no competitive advantage

---

🌟 Included Shader Packs (11 total)

All shaders are pre-bundled. Select your shader in Options → Video Settings → Shader Packs.

Shader	Performance Tier	Best For
Mellow	⚡ Potato	Lightest option. Warm soft shadows. Any GPU.
Miniature Shader	⚡ Potato	Real shadows + reflections at very low cost.
MakeUp — Ultra Fast	⚡ Lite	Full shadows & reflections on low-end GPUs.
Super Duper Vanilla	🟢 Lite	Mojang's cancelled "Super Duper" pack reborn. PBR, stars.
Sildur's Vibrant Shaders	🟢 Low–Med	Colorful, vibrant look. Easy to configure.
BSL Shaders	🟡 Medium	Warm cinematic lighting. Depth of field, bloom.
Photon Shaders	🟡 Medium	Built from scratch for Iris. GI-style atmosphere.
Complementary — Reimagined	🟡 Medium	Best all-rounder. Colored block lighting. Potato→Ultra presets.
Complementary — Unbound	🟡 Medium	More cinematic/dramatic version of Reimagined.
Bliss Shaders	🟠 Med–High	Moody volumetric fog. Stunning forests and rain.
Rethinking Voxels	🔴 Ultra	Voxel-based colored shadows. Iris-exclusive. RTX 3080+ recommended.

💡 GPU recommendation:

• iGPU / Low-end → Mellow, Miniature, MakeUp Ultra Fast
• GTX 1060 / RX 580 → BSL, Super Duper Vanilla
• RTX 2060 / RX 6600 → Photon, Complementary (Medium)
• RTX 3050–3060 → Complementary Reimagined (High), Bliss
• RTX 3080+ → Rethinking Voxels

---

🎨 Included Resource Packs (8 total)

All resource packs are pre-bundled. Enable/disable them in Options → Resource Packs.

Resource Pack	Purpose
Fresh Animations	Dynamic mob animations — makes creatures feel alive
Fresh Animations: Extensions	Additional mob animations (official extension)
Dramatic Skys	HD sky textures and realistic clouds
New Glowing Ores	Glowing ore outlines — easier to spot while mining
Simple Grass Flowers	Adds subtle flowers and clovers to grass blocks
Low On Fire	Lowers fire overlay so it doesn't block your view
Low Shield	Lowers shield so it doesn't obstruct your screen
Translations for Sodium	Adds translated text to Sodium's video settings UI

---

⚙️ JVM Arguments

Add these to your launcher's JVM Arguments (Aikar's Flags — eliminates GC stutter):

-XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200
-XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch
-XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M
-XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4
-XX:InitiatingHeapOccupancyPercent=15 -XX:G1MixedGCLiveThresholdPercent=90
-XX:G1RSetUpdatingPauseTimePercent=5 -XX:SurvivorRatio=32
-XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1
-Dusing.aikars.flags=https://mcflags.emc.gs -Daikars.new.flags=true

Set your RAM allocation separately in your launcher settings.

---

❓ FAQ

Q: Does this work on multiplayer servers? A: Yes. All mods are client-side only. No server installation needed.

Q: Will I get banned on Hypixel? A: No. Every mod is on Hypixel's allowed list. None give competitive advantages.

Q: Can I use OptiFine with Lumin? A: No. OptiFine is incompatible with Sodium and will crash. All OptiFine features are already included via dedicated alternatives.

Q: Can I add shaders? A: Yes! Install any Iris-compatible shader pack. Options → Video Settings → Shader Packs.

Q: How much RAM should I allocate? A: 4 GB minimum, 6 GB recommended, 8 GB+ with resource packs and shaders.

---

Lumin — Built for performance. Designed to look good.