XiaoXiang Realms Expansion

━━━━━━━━━━━━━━━━━━━━━━━━━ 🐉 ━━━━━━━━━━━━━━━━━━━━━━━━━

Follow And/Or Favorite To Stay Up To Date With Updates

⛰️ Xiaoxiang Realm Expansion ⛰️

Ninety Layers Between The Dirt Hut And The Heavens. 🌌⚡

━━━━━━━━━━━━━━━━━━━━━━━━━ 🐉 ━━━━━━━━━━━━━━━━━━━━━━━━━

Does your cultivation go from "Qi Refining Early" straight to "Qi Refining Middle" with three hours of absolutely nothing in between? 😴 One long silent bar, no sense of progress, no little victory to mark the climb?

That's not how cultivation works in any story you've ever read. 📖

In every cultivation novel worth the name, a realm isn't one flat stage — it's climbed a layer at a time. First layer. Second layer. Ninth layer. Each one a real breakthrough, each one felt.

⭐ Xiaoxiang Realm Expansion brings that to Minecraft. ⭐ Ten layers to every single realm, from Mortal all the way to Tribulation Transcendence — one hundred breakthroughs across a save instead of forty. And every single requirement is yours to set.

🔥 Nine small victories on the way up, instead of three long silences. 🔥

---

📜 What This Mod Does

An expansion for Xiaoxiang Cultivation World. It splits each realm's Early / Middle / Late sub-stages into three individual layers each, with Peak as the tenth — so every breakthrough feels like real progress instead of one long grind to the next sub-stage.

It reaches the base mod entirely through Mixins at runtime. 🔧 No file belonging to Xiaoxiang Cultivation World is ever modified, and you can pull this mod out at any time with no lasting effect on your save.

Works with or without Xiaoxiang Config Extension — with it, everything below is editable on a proper in-game screen with a written explanation on every setting. 🖥️

━━━━━━━━━━━━━━━━━━━━━━━━━ ⚡ Key Features ⚡ ━━━━━━━━━━━━━━━━━━━━━━━━━

🧗 Ten Layers To A Realm

The base mod gives a realm four steps — Early, Middle, Late, Peak — and a long quiet bar between them. This splits the first three into three layers each, with Peak as the tenth. 🪜

🆕 And Mortal Is A Real Realm Now 🆕

Mortal used to be one flat number. Bank it and you're a cultivator, with nothing in between — which made the opening hours of a save the one stretch with no rhythm in it at all. 😐

Now it has the same shape as everything above it — Early through Peak — and your sub-stage shows in the HUD as you climb it. ⛰️

Turn the layers off and the base mod is back, exactly as it was.

🎚️ Every Requirement Is Yours

Three tiers, and they always agree with each other. ⚖️

tier	what you say
🏔️ The whole realm	"Golden Core should take about fifteen thousand."
📊 One sub-stage	"Golden Core's Late is the wall — four thousand."
🎯 One layer	"This exact breakthrough costs seven hundred and seventy-seven."

⚡ Type a total and everything under it divides to match — in the file and on the screen, about a quarter of a second after you stop typing. Edit a layer instead and the sub-stage above it becomes the sum of its layers, and the realm total follows.

Whichever box you touched last wins, and the parts ALWAYS add back up to exactly what you typed. ✅

No button to press. Nothing to remember. Typing a number is taken as meaning it. ✍️

🎲 Nine Curves, One Click(Work In Progress)

Two hundred numbers is the right amount of control and the wrong amount of typing. 😅 So pick a curve and every layer of every realm fills in at once.

preset	the whole climb
🍃 Gentle	the realms as flavour around another mod — an evening
🌿 Gentle Plus	the same shape, a long weekend
⚖️ Standard	the intended pace. A realm is a project; a layer is an evening
🗿 Standard Plus	Standard with nine times the weight
🏮 Nine Heavens	the house curve — see below
💀 Brutal	cultivation as the whole game; the Peak route stops being optional
☠️ Brutal Plus	for a server expecting to run for months
🏃 Marathon	the upper realms become a group project
🌋 Marathon Plus	the ceiling

🚨 These are nowhere near each other. Each is at least three times the one below it at Qi Refining and nearly nine times across the whole climb. End to end the spread is about four hundred million fold. A preset list whose entries differ by a third is a list of one preset.

🏮 Nine Heavens — the house curve, priced in nines (WORK IN PROGRESS)

The figures below are final and are what a fresh install charges. What is still being finished is the visual side of it — the 25/50/75% marks drawn on the Peak bar. The thresholds themselves already work; you just cannot see them on the bar yet.

Mortal                              9,999
Qi Refining                        99,999
Foundation Establishment          999,999
Golden Core                     9,999,999
Nascent Soul                   99,999,999
Soul Formation                999,999,999
Void Refining               9,999,999,999
Body Integration           99,999,999,999
Mahayana                  999,999,999,999
Tribulation Transcendence   9,999,999,999,999

Every realm exactly ten times the one below it. ✨ Pick a curve, then hand-edit the three places you disagree with and leave the rest — a preset is a starting point, not a mode.

💪 A 99+ Breakthroughs That PAY

The distance between realms is the whole genre, and a flat reward can't express it. So every layer raises EVERY attribute, and the figure climbs with the realm: 📈

realm	per layer	per realm
⚪ Qi Refining	+3	+30 to every stat
🟡 Foundation Establishment	+5	+50
🟠 Golden Core	+7	+70
🔺 rising by two each realm to…
🔴 Tribulation Transcendence	+19	+190

🐲 A Mahayana cultivator is not a stronger Foundation cultivator. They are a different kind of thing. 🐲

Mortal pays differently, because a mortal has no Qi to allocate yet: one attribute per layer — rolled, or the one you nominate — and all five at once when you cross into the next sub-stage. Each Mortal layer pays once, ever. 🎁

💬 The breakthrough line tells you what it paid, so nothing is granted silently. Lifespan and spendable Zhenyuan are there too, per realm — and every one of these can be set to zero.

🛤️ Peak Is A Road, Not A Wall

The base mod gates a foundation on materials — zhuji pills, blood pills, dao fruit, a secret manual. That's a fair ask and a poor only-ask. 😤

A player who has cultivated to the top of a realm and can't find the items is stuck behind a loot table rather than behind their own cultivation — and the honest answer to "I've been at Peak for three hours" should not be "keep opening chests." 📦

⭐ So clear Peak and the materials are waived ⭐

For the foundation and the golden core, up to whichever tier you allow.

🆕 And it arrives in QUARTERS 🆕

The Peak bar isn't a switch that flips at the end. 🎯

progress	what opens
25% ▓░░░	first tier
50% ▓▓░░	second tier
75% ▓▓▓░	third tier
100% ▓▓▓▓	the last

So climbing through Peak is visibly buying you something the whole way up, instead of paying out all at once at the finish. The thresholds are worked out from however many tiers the base mod actually has rather than hardcoded — so a tier added by a future update slots itself in and the quarters become fifths on their own. 🔮

🔒 Heaven is off by default, which stops the road one step below the best tier. Cultivating should reach the second-best, not the best, or the materials stop meaning anything.

⚖️ And Peak is priced to match. With the floor on, it costs the whole Late stage over again, ten times — layers 7, 8 and 9 added together and multiplied. That's deliberately grindy. It's meant to be the choice you make when the loot won't drop, not a shortcut.

✅ Materials are never taken away. A player who has them is eligible exactly as they are now, whether or not they went near Peak.

❤️ A Health Bar, For When The Hearts Stop Fitting

Minecraft draws one heart per two health and starts a new row every ten hearts. Fine at twenty health. At twenty thousand it's rows of hearts climbing over your hotbar, over your chat, and over whatever you were trying to look at 💥 — and cultivation is exactly what takes you there.

So the hearts become a single bar with the figure written on it, in the hearts' own place, at the hearts' own width. Nothing else on the screen moves. 📊

🟢 On from the first moment of a new world, because a display that swaps itself out halfway through a save is one you have to learn twice.

Purely visual, and purely yours: nothing about your actual health changes, and nothing a server can see.

⌨️ Fifteen Commands

Eleven read, and need no permissions 👤 — your realm, sub-stage and layer; the Peak fraction and which tiers it's opened; a realm's whole curve laid out layer by layer; what the game would charge you for the next breakthrough right now; what a layer in that realm pays; the list of presets; and a check that every realm's parts still sum to its total.

Four write, and need operator 🔑 — set a character's layer, set a realm's total, apply a preset, force a resync.

/realmexp help lists them all. 📋

📖 Everything Is Explained, In Game

Install Xiaoxiang Config Extension alongside this and the whole thing gets a real screen: a page per realm, the tiers as groups inside it, and a written explanation on every single setting — what it does, what happens if you raise it, what happens if you lower it, and what to go and look at instead if this isn't the setting you meant. 💡

🏮 Nine Heavens is what you get out of the box — and it's a switch. [values] nineHeavensPreset, on by default. Not a suggestion sitting in a file — the shipped default, in force, from your first breakthrough. A fresh config already reads 9,999 for Mortal and ten times that for every realm above it.

⚙️ Prefer the original mod's own numbers? Turn Nine Heavens off and they come straight back — the two are one choice with two names and always opposites, so useGameNumbers = true does the same thing from the other end. Turning the preset off writes nothing: your numbers stay exactly where they are and simply stop being read, so flipping back and forth to compare costs you nothing. Turning it back on rewrites the whole curve. A save that has already run this mod keeps whatever its own config says; the default only decides what a fresh file starts at.

━━━━━━━━━━━━━━━━━━━━━━━━━ 📦 ━━━━━━━━━━━━━━━━━━━━━━━━━

✅ Compatibility

• 🧱 Minecraft 1.20.1 · ⚙️ Forge
• 🌍 Requires: Xiaoxiang Cultivation World — verified against 0.1.1480
• 🔧 Optional: Xiaoxiang Config Extension, for the in-game screen
• 🛡️ Touches no base mod file. Every hook is a runtime override
• 💾 Safe on existing saves. Characters already past Mortal keep their realm and sub-stage and simply gain layers from where they stand
• ⚠️ This mod ships with its own difficulty in force, not the base mod's. A fresh install cultivates on the Nine Heavens curve, and Peak is held at ten times the whole Late stage on top of that. [values] useGameNumbers = true hands difficulty back to the base mod; peakFloorMultiplier turns the Peak floor off

🔌 Network access: none. No sockets, no servers, no telemetry, no update check.

📖 "Is this obfuscated?" — No. Calls into Minecraft and into the base mod decompile as m_280666_ because every Forge mod is reobfuscated to intermediary names at build time. This mod's own classes keep full debug information, real names and original source filenames. A -sources.jar is built alongside every release, and there's a note saying so inside the jar as ABOUT_THIS_JAR.txt.

━━━━━━━━━━━━━━━━━━━━━━━━━ 📿 ━━━━━━━━━━━━━━━━━━━━━━━━━

📄 License

All Rights Reserved. 🔒

• ✅ Free to use, forever, for any purpose, at no cost
• ✅ Modpacks welcome — public or private, free or paid, on any platform or none. You do not need to ask. Credit is very, VERY much appreciated, but not required
• ✅ Videos, streams, screenshots and articles, including commercially — go ahead
• ✅ You may modify your own copy for your own use
• ❌ Please don't redistribute a modified copy, or publish this mod or any part of it as your own work
• 📄 Full text in the LICENSE file included with the source

💬 If you want something that notice doesn't allow — just ask. Permission that isn't written there can still be given, and it costs nothing to request it. 🙏

🙏 Credits

• 👑 Creator: Young Lorde
• 🐉 Built on: Xiaoxiang Cultivation World, created by the Xiaoxiang Cultivation team — this mod doesn't exist without their original work, and everyone who enjoys it owes them the credit. Go check out their mod if you haven't.
• ⚙️ Powered by: Minecraft Forge and Mixin

🐛 Issues & Support

Found a bug or have a suggestion? Report it on this page, the GitHub Issues page linked from this project's page, or message me. Reports with a latest.log attached get fixed fastest 🙏

━━━━━━━━━━━━━━━━━━━━━━━━━ 🐉 ━━━━━━━━━━━━━━━━━━━━━━━━━

✦ Ninety layers between the dirt hut and the heavens. 🏔️ Climb them one at a time. ⚡

━━━━━━━━━━━━━━━━━━━━━━━━━ 🐉 ━━━━━━━━━━━━━━━━━━━━━━━━━

XiaoXiang Realm Expansion Team