IridescentCraft Wiki
Living documentation for IridescentCraft, a progression-focused expert-lite Minecraft 1.20.1 Forge modpack with 450+ mods.
Sections
Design
The canonical design reference for all modpack systems.
- Master Design Document: Complete system specifications (Parts I to XVI; Part III is the token economy)
- Design Changelog: Tracked changes to design across sessions
Progression
- Progression Overview: Tier system, dimension gates, unlock paths
- Boss Catalog: Every boss by tier, where to find it, and how hard it is to find
Classes & Races
- Classes & Races Overview: 13 classes, 11 races, 13 origins, glass cannon mechanics
Systems
- Systems Overview: Death penalty, scaling, enchantments, affixes, skills, loot, food
- Controls: The pack's default keybind layout, with every important function on its own working key
KubeJS & Technical
- KubeJS Overview: Script reference, event compatibility, datapack loading
Mods
- Mod Overview: Key mods by tier, config changes
- Mod List: Every mod in the pack, generated from the mod index
Known Issues
- Issue Tracker: Active bugs, testing needed, resolved
Meta
- Style Guide: Writing conventions for wiki pages
- License: Standard's Petty Software License v2.0
Implementation Status
| System | Status | Notes |
|---|---|---|
| Tier gating (AStages) | Implemented | Per-player tier gating for items, dimensions, and recipes |
| Dimension scaling | Implemented | Mob stats scale per dimension |
| Death penalty | Implemented | Custom on-death penalty |
| Loot tables (LootJS) | Implemented | LootJS-driven custom loot tables |
| Skill trees (Pufferfish) | Implemented | Skill-point investment trees |
| Custom enchantments | Implemented | 29 custom enchantments |
| Apotheosis affixes | Implemented | Custom gear affix system |
Difficulty engine (iridescent_difficulty) | Implemented | Time-based per-dimension mob scaling |
| AStages derivative gating | Implemented | Diamond, netherite, and End derivatives gated behind progression |
| Origin layer cleanup | Implemented | 3-prompt flow: Origin (13) → Race (11) → Class (13) |
| Class respec | Implemented | Respec your class |
| Equipment HP halving | Implemented | Glass-cannon: equipment max-HP bonuses halved |
| Progression: token economy (Codex/Heracles) | In progress | Four-lane token economy (Engineering / Magic / Exploration / Combat). Submitting, the token bank and the boss rush work since October 2026; a tier is bought only with the tier below held |
| Heracles quest tree | In progress | Quest tree driving the token economy |
| Engineering questline | Implemented | 14-quest Heracles engineering line (intro through T4 fusion/antimatter capstone) plus an Engineering Lane Codex category with 5 entries |
| Patchouli Codex | Working | 14 categories, 113 entries (as of 2026-10-18), advancement-gated |
| Book suppression | Working | Duplicate mod guidebooks suppressed |
| Endgame loops (Part VIII) | Partly | Rift Shards drop from late bosses and the Mythic Forge crafts the five catalysts; Oblivion's Rift and the Mythic Uniques are not built |
| Prestige/Ascension (Part IX) | In progress | 5 ascension levels with mob scaling and stat bonuses. Built, but not open to players yet. Operators: do not set a level above 0 on the live world before the rehearsal on a copy; a reset does not take the buff off mobs already scaled |
| Loot table overhaul | Implemented | 35+ structure mods, boss drops, tier tokens |
| Villager trade rework | Implemented (October 2026) | No villager sells enchanted books or diamond / netherite gear; clerics sell XP bottles from journeyman; a villager keeps the trades it already offers |
| Waystone recipes | Implemented | Boss-drop gated crafting |
| Cross-mod recipe audit | Implemented | Tier-breaking recipes blocked to preserve progression |
| Mod config audit | Implemented | Mod balance configs aligned to design |
| Config review pass | Implemented | Disenchanting, Table of XP, and DarkOrb T2-gated; Icarus T3; Aethersteel T4 |
| Tetra integration | Implemented | 27 modded metal materials (T1 to T4) |
| Serene Seasons documentation | Implemented | Patchouli Codex entry for seasonal farming |
| Mekanism balance overhaul | Implemented | Generator nerfs, 2× RF costs, tool/armor removal; ERA-4 pass buffs fusion/fission output, disables radiation + meltdowns (force-shutdown), and T4-pins the fusion/antimatter/Digital-Miner/ultimate facilities |
| Food system overhaul | Implemented | Faster hunger drain, reduced structure food, spawn protection |
| Farmer's Delight cooking conversion | Implemented | 70 recipes converted to Farmer's Delight cooking |
| Ad Astra integration | In progress | 5 planets and 6 orbits as Tier 4 dimensions (gated, Tier 4 difficulty curve), planetary extraction; loot and space enchantments in progress |
| Blue Skies balance pass | Implemented | Materials rebalanced to T2 + Tetra integration |
| Undergarden balance pass | Implemented | Tetra stat overrides for 4 metals |
| Aether dimension mechanics | Implemented | Thin air, vertigo, updrafts |
| The Abyss (TATOS) dimension mechanics | Implemented | Oppressive darkness, corruption, fear aura, void whispers |
| End overhaul | Implemented | Dragon Exploration Gate, End-themed loot and affixes (the End Compass → End Bastion route is planned, not built) |
| TF portal activator | Implemented | The Twilight Forest portal is lit with a Codex Token I (the Tier 1 Codex token) or a diamond; stepping through needs Tier 2 (since 17 October 2026, from the next server restart) |
| Custom Abyss-themed curio rings | Implemented | 8 curio rings as a curated T3 chain |
| Server distribution | Implemented | Dedicated server distribution with a unified launcher |
| Vanilla Origins overhaul | Implemented | All 9 origins rebalanced; no lethal environmental effects; food preferences, not restrictions |
| Race layer rebalance | Implemented | Race stat adjustments and functional effects |
| Origins expansion | Implemented | 4 new races (Demi-God, Ryu, Fallen Angel, Kirin), 11 in total; 4 custom origins (Witch of Ink, Artificial Construct, Witherborn, Slimebodied), 13 in total |
| Class descriptions update | Implemented | Class descriptions match in-game power |
| Codex expansion | Implemented | Build guide, Origins guide, and updated entries |
| Tectonic terrain tuning | Implemented | Flatter vertical terrain |
| Early magic access | Implemented | Iron's Spells scrolls + copper spell book in Overworld chests |
| Walkable Mekanism cables | Implemented | Mekanism cables are walkable |
| HDPE/rubber pipeline | Implemented | HDPE Circuit Board + alternative Mekanism rubber recipes |
| LootJS clutter/food tuning | Implemented | Clutter loot removed, food drops reduced |
| Apotheosis affix tuning | Implemented | Overworld affix generation reduced |
| Relics curation | Implemented | Curated Relics pool; 3 special boss drops: Ender's Hand, Space Dissector, Shadow Glaive |
| Village loot overhaul | Implemented | Gear removed, T1 materials added, food capped |
| Epic RPG Class Artifacts integration | Implemented | 14 class artifacts + awakening variants + 25 relics; drops only, T2/T4 gated |