diff --git a/README.md b/README.md
index eaa4065..ec6d565 100644
--- a/README.md
+++ b/README.md
@@ -14,29 +14,139 @@ A curated Minecraft modpack about airships, exploration, and tech progression.
## What's inside
-**Core (Create + Aeronautics)**
-- Create 6.0.10 · Create Aeronautics 1.3.1 (bundled) · Sable 2.0.5 · Flywheel (bundled) · kotlinforforge · Curios · geckolib · playeranimator · Placebo · Patchouli
+
+Core — Create + Aeronautics foundation
-**Airships / expansion**
-- aeroworks · aeronautics-covers · aeronautics-dyeable-components · aeronautics-gadgets-and-gizmos · aeronautics-portable-engine-liquid-fuel · aeronautics-propeller-blur · create-simulated-thrusters · create-the-air-war · deployer · simulated-gauges · jade-sable-compat · aero-shadow-fix
+| Mod | Notes |
+|-----|-------|
+| Create 6.0.10 | Machines, kinetics & contraptions (bundles Flywheel, Ponder, Registrate) |
+| Create Aeronautics 1.3.1 | Player-piloted airships & moving contraptions (bundled build) |
+| Sable 2.0.5 | Physics/simulation library behind Aeronautics |
+| kotlinforforge | Kotlin runtime for NeoForge |
+| Curios 9.5.1 | Wearable accessory slots |
+| geckolib 4.9.2 | 3D entity animation library |
+| playeranimator 2.0.4 | Player animation support |
+| Placebo 9.9.2 | Library (required by Apotheosis) |
+| Patchouli 93 | In-game guidebook framework |
-**Tech**
-- railways · create-new-age · createbigcannons · createdieselgenerators · copycats · create_connected · Design-n-Decor · create_jetpack · cable_facades · ritchiesprojectilelib
+
-**Magic**
-- Iron's Spells 'n Spellbooks (irons_spellbooks + irons_lib) · Ars Nouveau
+
+Airships / expansion — Aeronautics addons
-**Exploration**
-- Terralith (lithostitched) · YUNG's Better Strongholds / Better Desert Temples / Better Dungeons (YungsApi) · Explorer's Compass · Nature's Compass · Xaero's Minimap · Xaero's World Map · waystones
+| Mod | Notes |
+|-----|-------|
+| aeroworks 1.4.2 | Advanced airship workshop tools |
+| aeronautics-covers 1.0.1 | Extra block covers for ships |
+| aeronautics-dyeable-components 1.0.4 | Dyeable ship components |
+| aeronautics-gadgets-and-gizmos 1.1.3 | More airship gadgets |
+| aeronautics-portable-engine-liquid-fuel 2.0.0 | Liquid-fuel portable engines |
+| aeronautics-propeller-blur 1.0a | Propeller blur effect |
+| create-simulated-thrusters 1.0.1 | Simulated thruster blocks |
+| create-the-air-war 4.67 | Aerial combat / air war content |
+| deployer 0.1.2 | Extra deployer behaviours |
+| simulated-gauges 1.1.0 | Gauges for simulated systems |
+| jade-sable-compat 1.3.0 | Jade HUD compat for Sable |
+| aero-shadow-fix 2.1.0 | Fixes shader ghosting (balloon) |
-**Survival / QoL**
-- Tough As Nails (GlitchCore) · Farmer's Delight · Apotheosis (Placebo, Apothic Attributes, Apothic Enchanting, Apothic Spawners) · corpse · carry-on · JEI · appleskin · MouseTweaks · Controlling (Searchables) · Jade · WeightedInventory · balm
+
-**Performance**
-- Sodium · lithium · ferritecore · ImmediatelyFast · entityculling · dynamic-fps · modernfix · Clumps · spark
+
+Tech — Create expansion
-**Visuals**
-- Iris + EuphoriaPatcher + Complementary Reimagined (Euphoria-patched) shader · iris-flywheel-compat · 3D Skin Layers · Fresh Animations (resource pack, enable in-game)
+| Mod | Notes |
+|-----|-------|
+| railways 0.3.0-beta.2 | Trains & rail transport |
+| create-new-age 1.2.0 | Nuclear / advanced power |
+| createbigcannons 5.11.7 | Cannons & artillery |
+| createdieselgenerators 1.3.15 | Diesel generators |
+| copycats 3.0.6 | Copycat block variants |
+| create_connected 1.3.2 | Connected textures & bridges |
+| Design-n-Decor 2.2b | Decorative blocks |
+| create_jetpack 5.2.1 | Jetpacks |
+| cable_facades 2.1.3 | Hide cables/trains under facades |
+| ritchiesprojectilelib 2.1.2 | Projectile library (createbigcannons) |
+
+
+
+
+Magic
+
+| Mod | Notes |
+|-----|-------|
+| Iron's Spells 'n Spellbooks 3.16.3 | Spell-casting (uses irons_lib 2.1.0) |
+| Ars Nouveau 5.13.0 | Glyph-based spellcrafting & familiars |
+
+
+
+
+Exploration
+
+| Mod | Notes |
+|-----|-------|
+| Terralith 2.6.2 | 95+ new biomes (via lithostitched 1.8.0) |
+| YUNG's Better Strongholds 5.1.3 | Overhauled strongholds |
+| YUNG's Better Desert Temples 4.1.5 | Overhauled desert temples |
+| YUNG's Better Dungeons 5.1.4 | Overhauled dungeons |
+| YungsApi 5.1.7 | Library for the YUNG's mods |
+| Explorer's Compass 3.4.0 | Find structures |
+| Nature's Compass 3.4.0 | Find biomes |
+| Xaero's Minimap 26.4.2 | Minimap |
+| Xaero's World Map 1.44.2 | Full world map |
+| waystones 21.1.41 | Teleport waypoints |
+
+
+
+
+Survival / QoL
+
+| Mod | Notes |
+|-----|-------|
+| Tough As Nails 10.1.0.13 | Temperature & thirst (GlitchCore 2.1.0.2) |
+| Farmer's Delight 1.3.3 | Cooking & farming |
+| Apotheosis 8.7.0 | Affixes & enchanting (Placebo, Apothic Attributes 2.10.1, Apothic Enchanting 1.6.1, Apothic Spawners 1.4.0) |
+| corpse 1.1.13 | Death marker & grave |
+| carry-on 2.2.6 | Carry chests & mobs |
+| JEI 19.44.0.403 | Recipe viewer |
+| appleskin 3.0.9 | Food/hunger HUD |
+| MouseTweaks 2.26.1 | Inventory mouse controls |
+| Controlling 19.0.5 | Searchable keybinds (Searchables 1.0.2) |
+| Jade 15.10.6 | "What am I looking at" HUD |
+| WeightedInventory 2.2.0 | Inventory weight/encumbrance |
+| balm 21.0.65 | Cross-loader library |
+
+
+
+
+Performance
+
+| Mod | Notes |
+|-----|-------|
+| Sodium 0.8.12 | Rendering performance |
+| lithium 0.15.4 | Game logic performance |
+| ferritecore 7.0.3 | Memory optimization |
+| ImmediatelyFast 1.6.12 | Faster rendering |
+| entityculling 1.10.5 | Cull off-screen entities |
+| dynamic-fps 3.11.4 | Auto-lower FPS when unfocused |
+| modernfix 5.27.20 | Boot & memory fixes |
+| Clumps 19.0.0.1 | Group XP orbs |
+| spark 1.10.124 | Profiler |
+
+
+
+
+Visuals
+
+| Mod | Notes |
+|-----|-------|
+| Iris 1.8.14-beta.1 | Shader loader |
+| EuphoriaPatcher 1.9.3 | Patches Complementary shaders |
+| iris-flywheel-compat 2.3.1 | Iris + Flywheel backend compat |
+| 3D Skin Layers 1.11.2 | 3D player/mob skins |
+| Fresh Animations 1.10.4 | Animated mobs (resource pack — enable in-game) |
+| Complementary Reimagined r5.8.1 | Shaderpack (Euphoria-patched, included) |
+
+
## Key config already applied