Xiaoxiang Config Extension
Hover over any setting in the config screen and an instant tooltip tells you exactly what it does and how it affects your world - no more guessing what a raw number in a TOML file actually controls, or digging through wikis to find out.
Formations power a huge part of sect life, and this tab puts every tier under your control - core max Qi, Qi gathering and growth multipliers, barrier strength, rejuvenation amplifiers, and harvest intervals, all configurable across all five tiers.
Fine-tune the core resource of the entire mod - how fast players attract ambient Qi, how much Qi shields reduce incoming damage, and how quickly spirit stone ore regenerates its Qi supply across every tier in the world.
Shape how the cultivators living in your world behave and fight - dodge chance, scan ticks, reaction time, and cooldowns per realm for combat tactics, plus full control over AI behavior, spawn rates, and trade tables.
Control the starting lifespan ranges for every identity category, and go further by building your own custom cultivator identity from scratch - give it a name, a description, and a hand-picked starting item loadout.
Pick exactly what a cultivator starts with by browsing a full item library covering both vanilla Minecraft and every item from Xiaoxiang Cultivation World - search, filter by category, and double-click to add anything you want.
Rebalance every spell in the game at once with global damage, Qi cost, and charge time multipliers, or reach in and adjust individual spell constants directly - things like sword flight upkeep, void step cost, and the channel time on Buddha Fire Lotus.
Make the config screen and cultivation HUD work the way you need them to - adjust text scale and weight for Chinese and English separately, customize colors across the board, switch on high-contrast mode, or turn off animations with the reduce-motion toggl
The foundation of the whole experience lives here - per-realm max Qi, base lifespan, Qi shield reduction, and tribulation strike damage across all twelve realms from Mortal to True Immortal, plus global multipliers to scale everything at once.
Fine-tune how fast characters age, when aging slows dramatically near immortality, the death penalty for dying of old age, and the starting age range for new characters.
Adjust the Heart Demon boss's vitality multiplier for every morality alignment, from Great Evil to Great Righteous, to tune the difficulty of this pivotal trial.
Configure furnace Qi capacity, input and output slot counts, batch size limits, and crafting time per pill, plus XP gains across every pill tier.
Set how much Qi is available for cultivation in every biome type, from Qi-sparse deserts to Qi-rich forests, shaping where players will want to cultivate.
Control whether beasts and monsters cultivate alongside players, how fast they gain Qi, and the Qi cost to advance through every beast rank from Spirit Soldier to Spirit Lord.
Tune growth rates, spread radius, and special effects for the world's spirit plants, from the Flame Pepper's snow-melting radius to the Snow Soul Lotus's snow placement.
Description
Xiaoxiang Config Extension
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.
What This Mod Does
Xiaoxiang Config Extension is a companion mod for Xiaoxiang Cultivation World. It hooks into the original mod at runtime through Mixins — no files from the base mod are ever modified — and exposes over 300 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, the works: if it drives the cultivation experience, you can now tune it instead of living with the defaults.
Actively maintained and now on its third release. It's stable and feature-complete for daily use; a couple of forward-looking features (noted below) are intentionally held back for a future update rather than shipped half-finished.
Key Features
A Real Config Screen, Not Just a Wall of Numbers
- Custom in-game UI with top-level tabs, sub-tabs, and grouped sections — organized the way you'd actually look for something, not just a flat TOML dump
- Live search with per-tab memory and search history, plus filters for Modified / Boolean / Numeric / Color / String / Over-Max / Favorites
- Favorites and locking, so your most-tuned values are one click away and your finished settings can't be bumped by accident
- Undo/redo (Ctrl+Z / Ctrl+Y) with 50-step history, and a value-change flash so you can see exactly what just moved
- Config export/import to JSON via clipboard, a config checksum for sharing verified setups, and a full diff view of everything you've changed from default
- Modpack presets — save and load whole configurations, useful if you run more than one instance or want to share a balance pass
- Custom tabs that pull configs from multiple categories into one view, plus tab reordering, so the screen can match how you think about your settings
- Per-world config overrides, applied automatically when that world loads
- Config dependencies (show/hide/enable one setting based on another), inline help icons, and hover tooltips that explain what a value actually 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 in the hierarchy
Realm Progression (Mortal through True 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. Identity duplication and adding custom identities into the in-game origin-draw roster are built but deliberately switched off for this release — they're coming in a future update once they're properly polished, rather than shipped rough.
Accessibility & UI
Adjustable text scale and weight (Chinese and English tracked separately), full color customization, a bar-style HUD option, high-contrast mode, and a reduce-motion toggle for players sensitive to animation.
Requirements
- Minecraft 1.20.1
- Forge 47.x (built and tested against 47.4.22)
- Xiaoxiang Cultivation World — required, must be installed and loaded alongside this mod
- 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 files directly
Installation
- Install Xiaoxiang Cultivation World first.
- Drop this mod's jar into your
modsfolder alongside it. - Launch the game once to generate the config files.
- 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.tomldirectly in your config folder.
How It Works
This mod never modifies a single file belonging to Xiaoxiang Cultivation World. 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 in the config if you'd rather fall back to the original mod's defaults for that piece.
License
Licensed under the GNU General Public License v3.0 (GPL-3.0).
- Free to use, modify, and redistribute, including in modpacks
- Derivative works must also be licensed under GPL-3.0
- Source code and the original copyright notice must be preserved
- Full text in the LICENSE file included with the source
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 or message me.
The Xiaoxiang Config Extension Team
