Home

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