XiaoXiang Config Extension

━━━━━━━━━━━━━━━━━━━━━━━━━ 🪷 ━━━━━━━━━━━━━━━━━━━━━━━━━

Updated Quickly, Follow And/Or Favorite To Stay Up To Date With Updates

✨ Xiaoxiang Config Extension ✨

Your Dao. Your Rules. ⚔️🌙

━━━━━━━━━━━━━━━━━━━━━━━━━ 🪷 ━━━━━━━━━━━━━━━━━━━━━━━━━

Do you find your cultivation journey too smooth? Too easy? Every realm breezed through, every tribulation barely a scratch? Or maybe it's the opposite — you're dying to a wandering rogue cultivator by session two and just want to survive long enough to see a golden core. 💫

⭐ Xiaoxiang Config Extension hands you the dial. ⭐ Want a brutal, unforgiving path where every breakthrough is earned and every tribulation might be your last? Or a peaceful cultivation life where the grind steps aside and the story takes the wheel? This is the tool that makes either one possible — and everything in between.

🔥 "How hard do you want this to be?" — ask yourself once, then answer it with 1,596 settings. 🔥

---

📜 What This Mod Does

Xiaoxiang Config Extension started as a companion mod for Xiaoxiang Cultivation World. It hooks in at runtime through Mixins — no files from the base mod are ever modified — and exposes 1,596 previously-hardcoded values as real, editable config options, all wrapped in a purpose-built in-game config screen.

💎 Realm power curves · Spell damage · Alchemy timings · Sect economies · NPC behavior · Tribulation difficulty 💎

If it drives the cultivation experience, you can now tune it instead of living with the defaults.

🆕 …and now it doesn't even need the cultivation mod 🆕

This is the big one. The cultivation mod is optional now.

Install this on its own and you still get the whole Minecraft side, the inventory work, the stack sizes, the themes — plus every other mod in your pack's settings, found automatically. 🔍 Install the cultivation mod as well and its tabs appear. Remove it later and they disappear cleanly. Nothing breaks. Nothing is left behind claiming to configure something that isn't there.

🐉 Actively maintained, and well past its tenth release. Stable and feature-complete for daily use.

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

🌐 One Screen For Your WHOLE Pack

This is not a settings screen for one mod anymore. ⚡

• ✦ Any mod in your pack that has settings shows up here — arranged into tabs, explained in plain words, and editable in the same place as everything else
• ✦ No work needed on their side. That mod doesn't even know this one exists 👻
• ✦ Mods are found by looking, not by a list — so there's nothing to declare and nothing to keep up to date. Install a mod, open this screen, it's there
• ✦ Remove it and it's gone, with every other mod's page untouched
• ✦ Some mods ship no settings at all. Those get a page here too 📄

🎛️ A Real Config Screen, Not Just a Wall of Numbers

• ✦ Custom in-game UI with 21 top-level tabs, 103 sub-tabs and grouped sections — organized the way you'd actually look for something, not a flat TOML dump
• ✦ Every single setting explains itself. 💡 Hover any row and a panel tells you what it does, what happens if you raise it, and what happens if you lower it
• ✦ 🔗 Words in cyan have their OWN explanation. Rest on one and a second panel opens beside the first. Rest on a word in that panel and a third opens. Four levels deep — learn what a Spirit Vein is without ever leaving the setting you came for
• ✦ Rest on a tooltip for 5 seconds and it becomes a window you can drag 🪟
• ✦ Live search with per-tab memory and history, plus filters for Modified / Boolean / Numeric / Color / String / Over-Max / Favorites
• ✦ ⭐ Favorites and locking — most-tuned values one click away, finished settings safe from an accidental bump
• ✦ ↩️ Undo/redo (Ctrl+Z / Ctrl+Y) with 50-step history, and a value-change flash so you see exactly what moved
• ✦ 🖱️ Ctrl+scroll to change a number. Shift for ×10, Ctrl+C for ×0.01, Alt for ×100000 — and a badge on the row shows your current step size while you hold the keys
• ✦ Config export/import to JSON via clipboard, a checksum for sharing verified setups, and a full diff of everything you've changed from default
• ✦ 📦 Modpack presets — save and load whole configurations
• ✦ Custom tabs pulling configs from multiple categories into one view, plus tab reordering
• ✦ 🌍 Per-world config overrides, applied automatically when that world loads
• ✦ Config dependencies (show/hide/enable one setting based on another), inline help icons, and tooltips that tell you what a value does in practical terms — an HP multiplier tells you it scales the real ~20 HP base, not some placeholder number
• ✦ 🔔 Toast notifications for saves and value changes, and a minimap-style tree view so you always know where you are
• ✦ 🎨 52 built-in visual themes, each with its own living background — no two share an animation — plus a full HSV color wheel for an accent entirely your own

🐉 Realm Progression (Mortal through Loose Immortal)

Per-realm max Qi, base lifespan, Qi shield reduction, and tribulation strike damage, laid out in genuine breakthrough order — plus global multipliers to scale every realm at once without hand-editing all twelve. 📈

⚔️ Spells & Combat

Global damage / Qi-cost / charge-time multipliers, per-spell constants for named spells (sword flight upkeep, void step, palm thunder, Buddha Fire Lotus, glacier burial, and more), weapon damage and tier-based Qi cost reduction, and full NPC combat tuning — dodge chance, scan ticks, reaction time, and dodge cooldown, broken out per realm. 🗡️

⚗️ Crafting & Alchemy

Furnace Qi capacity and XP gain per tier for both alchemy and refining, individual pill values (Qi recovery, blood burn, clear mind, divine stride, and more), storage bag dimensions, and material Qi yields for foundation- and golden-core-tier ingredients. 🧪

🌱 World & Growth

Biome Qi density, spirit vein tiers, spirit plant growth rates and yields, and formation cores — Qi gathering, growth, barrier strength, rejuvenation, and harvest intervals across all tiers. 🍃

🧘 Cultivation Paths

Spirit root and physique rarity weights and bonuses, and full Foundation Dao / Golden Core Dao tuning — lifespan bonuses, spell multipliers, body defense, cultivation efficiency, and tribulation waves per path. ☯️

🏯 Sects, NPCs & the Living World

Sect generation, shop pricing, departments, schedules, defense, ambient social behavior, and population; NPC AI behavior and trade tables; loot tables and drop weights; and trial tuning for the Heart Demon and Inner World trials. 🏮

🎭 Identity & Custom Identities

Create your own custom cultivator identity — name, description, and a hand-picked starting item loadout pulled from a full item browser covering both vanilla Minecraft and Xiaoxiang Cultivation items. 📝

━━━━━━━━━━━━━━━━━━━━━━━━━ 🎒 ━━━━━━━━━━━━━━━━━━━━━━━━━

🆕 NEW: It Changes Plain Minecraft Too 🆕

Everything below works with or without the cultivation mod — and all of it is off by default.

🎒 Inventory Handling

Every move is the same click the game already makes for a shift-click, sent one slot at a time — so none of it can put an item anywhere you couldn't have put it yourself, and none of it can duplicate or lose one. ✅

• 🖐️ Drag to move — hold a button with an empty hand and drag across a row. Each slot you pass does exactly what shift-clicking it would
• 🎡 Scroll to move — point at a slot, turn the wheel. One way sends it across, the other brings more back. Direction, search order and slots-per-notch are separate switches, because they're separate opinions
• 🗂️ Sort — loose stacks merge first, then order by mod, name, registry id or count. Armour, off-hand and crafting grid are never touched
• 🔦 Search — type and the matching slots stay lit while the rest go dark. @mekanism matches only that mod, -iron excludes. Nothing moves, nothing hides
• 🔁 Auto refill — last item used, another stack goes into your hand. Only on the real signature of the last item being used — never on throwing a stack away
• 📥 Quick stack & restock — one key empties what belongs in the open container into it, the other fills you back up. Matching-only by default
• 🗑️ Discard box — a box beside the container that really destroys what you drop on it. Two clicks, and the arming lapses on its own

🤝 Each mouse feature stands down on its own while a mod that already does the same thing is installed — so you can switch them on and live with them before uninstalling anything.

📦 Stack Sizes

How many of a thing fits in one slot — one of the biggest levers on how a world plays, and one Minecraft never exposes.

• Separate figures for the 1s, the 16s, the 64s and modded oddities
• ⬆️ Raising just the 16s — snowballs, eggs, ender pearls, signs — removes most of vanilla's inventory friction and touches nothing else
• ⬇️ Lowering the 64s is the single hardest change you can make to how a world feels, because every trip out becomes a decision about what's worth bringing back
• 🎯 Or name exact items as namespace:id=count. Those beat the groups — an item you took the trouble to name is an item you meant

🔒 Inventory Slots As A Difficulty Dial

A player who starts with nine slots and earns the rest plays a different game. Rows you always have, hotbar slots counted separately, and slots earned per experience level.

🛡️ One rule makes it safe: a locked slot you can always empty and never fill. Turn this on with a full pack and your things are exactly where you left them. The lock closes behind your items, never on top of them — no combination of these settings, in any order, can put an item somewhere you can't reach it.

💧 Infinite Fluid Sources

One switch per fluid, built from what's actually installed rather than a list somebody has to maintain. Oil, fuel, hydrogen, oxygen, and whatever a mod added while you weren't looking. 🛢️

Yes or no, per fluid. Flow speed, buckets, pumps, world generation and every recipe are left exactly as they were.

❤️ A HUD That Survives Cultivation

Health, hunger, armour, breath and experience as filling bars with the real numbers on them — in vanilla's own positions, or stacked wherever you choose.

Why? Because icons stop working at large numbers. 💥 Raise max health past a hundred and vanilla answers with rows of hearts climbing over your hotbar, over your chat, and over whatever you were trying to look at. A bar just fills and tells you 12,480 / 18,000. 📊

━━━━━━━━━━━━━━━━━━━━━━━━━ 🌏 ━━━━━━━━━━━━━━━━━━━━━━━━━

🌏 Languages

Three in the cycle, switched with a button under the title — this screen only, with no reload. 🔄

🇬🇧 English	finished
🇧🇷 Português (Brasil)	finished — all 7,978 strings
🇪🇸 Español	every word on screen — tabs, sub-tabs, groups, buttons and all 1,534 setting names. Hover explanations still in English while they're written

No language is offered until every word drawn on the screen is translated in it — a screen you can't navigate is worse than one you have to read twice. Nine more are written and parked (Português de Portugal, Français, Deutsch, Русский, 简体中文, 繁體中文, Kiswahili, Soomaali) and each joins the cycle the same way. 🌐

Plenty of people play in English on purpose, because every guide and video they've ever used is written that way — and would still rather read sixteen hundred settings in their own language. There's no reason those should be the same choice, so they aren't.

🎨 Accessibility & UI

Adjustable text scale 50%–200% and weight (Chinese and English tracked separately), full color customization across 52 themes, a bar-style HUD, high-contrast mode, and a reduce-motion toggle that actually freezes animation rather than merely slowing it. ♿

High Contrast, Monochrome and Gentle Focus are built for eyes that need them, and are deliberately given the quietest treatments in the whole set. Every theme is contrast-checked so descriptions stay legible whether or not you're hovering.

🚨 If Something Breaks, Your Game Doesn't

This mod owns no gameplay of its own — every setting reaches into another mod and changes a number on its way past. Those mods update on their own schedule. ⏳

When one moves something, this mod does NOT take your game down with it. 🛡️ The affected setting is skipped, everything else loads, and the tab it lives on carries a slow red pulse — so you can see what's idle instead of wondering why a slider does nothing. Follow the pulse down and hover the row to read why.

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

📦 Requirements

• 🧱 Minecraft 1.20.1
• ⚙️ Forge 47.x (built and tested against 47.4.22)
• 🌍 Xiaoxiang Cultivation World — optional now! Its tabs appear when it's installed and disappear cleanly when it isn't
• 🔧 Configured (optional) — provides the in-game button that opens this mod's config screen from the Mods menu; without it you can still edit the TOML directly
• 🧩 Every other mod in your pack — discovered automatically, nothing to install

🛠️ Installation

1. Drop this mod's jar into your mods folder. (Install Xiaoxiang Cultivation World too, if you want its tabs.)
2. Launch the game once to generate the config files.
3. Open the config screen from Mods menu → Xiaoxiang Config Extension → Config (needs the Configured mod), or edit xiaoxiang_config_ext-common.toml / xiaoxiang_config_ext-client.toml directly in your config folder.

⚙️ How It Works

This mod never modifies a single file belonging to any other mod. Every override is applied through Mixins injecting into the original mod's compiled classes at runtime, and each category of override can be independently disabled via its own enable... flag if you'd rather fall back to the original defaults for that piece. 🔧

🔌 Network access: none. No sockets, no servers, no telemetry, no update check. Nothing leaves your machine.

📖 "Is this obfuscated?" — No. Calls into Minecraft 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 is available on request, 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 🙏

━━━━━━━━━━━━━━━━━━━━━━━━━ 🪷 ━━━━━━━━━━━━━━━━━━━━━━━━━

✦ May your Dao be steady, your Qi be plentiful, and your tribulations survivable. ⛵🌌⚡

━━━━━━━━━━━━━━━━━━━━━━━━━ 🪷 ━━━━━━━━━━━━━━━━━━━━━━━━━

XiaoXiang Config Extension Team