Add-ons & Compatible Mods
Since v0.5.0 Cultivation is a foundation as much as a mod. Another plugin can replace the entire progression ladder, re-word every message, add a playable race or register new techniques — and everything else keeps working on top.
How Compatibility Works
Cultivation exposes four extension points that matter to players. An add-on picks whichever it needs; it does not have to take all of them.
Replace the ladder
A mod supplies its own levels, rank names and curve. Cultivation stops reading its own realms and reads that mod's numbers instead.
Re-word everything
Chat, HUD, menus, item names and tooltips can all be renamed without changing a single behaviour.
Add a race
New races appear in the race menu beside Human, Demon and Deity, with their own unlock realm, bonuses and Yin bias.
Add techniques
Third-party arts register into the same open registry the built-in nine use, with their own realm gates, Qi costs and cooldowns.
Your original Cultivation progress is never overwritten while an add-on is running. It sits untouched underneath, so removing that add-on hands you straight back the realm you had. The realm an add-on says you count as is never written to your save file.
Known Add-ons
A full re-theme that swaps the Xianxia ladder for a Soul Land one — martial souls, soul rings absorbed from slain spirit beasts, and a 1–100 curve in place of seven realms and twenty-eight sub-stages.
It uses the progression hook to replace the ladder, the theme hook to re-word the mod's vocabulary, registers its own techniques, and adds its own sections to Cultivation's admin config editor. Sects, formations, abodes, duels, alchemy, spirit beasts and the skill tree all continue to work unchanged on top of it — which is the scenario the 0.5.0 API was built for.
in developmentsame authorRegisters Merfolk as a playable Cultivation race. It appears in /cultivation race alongside the built-in three, with its own unlock realm, stat bonuses and Yin bias, and runs through exactly the same code path as Human, Demon and Deity.
A paid add-on, included with a Cultivation subscription: five hand-made palettes that recolor every menu, the HUD and the skill tree, brighter auras, eight more sect banners, six cosmetic titles and four Codex articles.
It is purely cosmetic — nothing in it changes progression, balance, or what any player can do, and a server without it plays exactly the same game. See Jade Slip.
cosmetic onlysubscriptionsame authorA paid add-on, available with a Cultivation subscription or bought outright. The rare constitutions a cultivator is born with. Sixteen sacred bodies and eight stackable anatomical physiques, each rolled once on a player's first login and carried for life — re-pricing Qi, damage, charge time, rituals and the aura.
Unlike Jade Slip this one is not cosmetic, so it is worth knowing what it does before installing it: roughly one cultivator in forty is born with a sacred body, and every body, physique and rate can be disabled individually. It is built entirely on the standing-modifier registry added in 0.7.4. See Sacred Bodies.
changes balancesubscription or one-timesame authorInstall it the same way as Cultivation — the jar goes in your server's mods\ folder. Cultivation must be installed too; add-ons extend it rather than replace it. Only one mod may replace the progression ladder at a time.
Purchases reach the buyer in game
New in 0.8.0. Anything bought from the Treasure Pavilion at xianxia.dev/store now applies on any server running Cultivation, not only one you own — and brings its own cosmetic title with it.
v0.10.3 This is not only for one-time, name-bound purchases. A live family subscription, and an addon bought outright, both reach the game the same way — as a Treasure Pavilion title. Only a purchase's own account-binding rules differ; whether it applies in game does not.
How it works, and what it does not do:
- The mod reads a public list of account IDs from
https://xianxia.dev/api/get/entitlements/, every 6 hours by default (Check-Interval-Hours). - Nothing about your server is ever sent. It is a plain read of a static list; there is no telemetry, no server identifier, no player list going the other way.
- A refund revokes itself at the next check, because the account simply stops appearing on the list.
- It fails open. An offline server, an unreachable endpoint or a malformed response leaves everybody exactly as they were.
Web-Store-Enabled in WebStoreConfig.json switches the whole thing off in one line. Admins can inspect it with /cultivation admin store status and force an early read with /cultivation admin store recheck (rate-limited, and disablable with Allow-Recheck-Command).
A benefit is registered through the same public API Cultivation's own product uses — CultivationAPI.registerStoreBenefit(StoreBenefit.builder("myMod:store:crown", "my-mod-crown")...). Your add-on names its product key and, optionally, a title to unlock; the shared sync does the fetching, the caching and the revoking for you. See Registries.
Web Store is one of the two config sections wired into the in-game /cultivation admin editor in 0.8.0 (the other is Ascension).
Compatibility Notes
| Situation | What happens |
|---|---|
| You remove a progression add-on | You return to the Cultivation realm you had before it was installed. Nothing was overwritten. |
| Two add-ons both try to replace the ladder | Only one can hold the hook. Run one at a time. |
| An add-on renames things only partially | Anything it does not rename keeps Cultivation's own wording — and stays translated in every language Cultivation ships. |
| You see settings not documented on this wiki | They belong to an add-on. Any mod can add its own section to the /cultivation admin config editor. |
| A language pack tries to override Cultivation's text | It is silently discarded. The engine merges language files first-come, and Cultivation's own pack always loads first — which is exactly why the theme hook exists. |
Building Your Own
Everything above is public API, documented in full with its threading rules. Start with the API Overview, then:
- Add-ons — replacing the ladder, re-wording the vocabulary, and adding your own admin config sections.
- Registries — adding races, techniques and other open registry entries.
- Events — 173 pre-events and post-events covering nearly every mechanic in the mod.
- Reference — the facade methods and their contracts.
If you have built a mod that works with Cultivation and want it listed here, get in touch through the CurseForge page.