Core Config
The three files that sit at the root of mods/Siren_Cultivation/, outside any folder: Config.json, UpdateConfig.json and WebStoreConfig.json. Config.json holds the Qi curve every realm and sub-stage requirement is derived from, the flat stat bonuses a cultivator earns for each rank climbed, and the six Breakthrough Quality dials. If you only ever change one file to make your server harder or gentler, this is it. See Cultivation Realms for what the curve produces, and Qi Gathering for where the Qi itself comes from.
UpdateConfig.json is the one switch for the update checker, and WebStoreConfig.json configures the Treasure Pavilion sync. Both sit at the root, beside Config.json, because they are about the server rather than about cultivating: a server owner looking for the network switch should meet it first.
Every file here has a section in the in-game /cultivation admin editor, though the editor does not reach every key - each section below says which. For the other config folders see Cultivation Configs, Arts Configs, Society Configs, Race Configs and Data Files; the overview lists every file.
Config
The core Qi curve, per-level stat bonuses, Breakthrough Quality dials, and the server-wide switches for auras, notices and the cultivation sheet, found in the path mods/Siren_Cultivation/Config.json.
In-game editor: the Cultivation section covers the Qi curve, both per-level bonuses and Admin-Backups-Per-Player. The Breakthrough Quality dials, the aura, notice and sheet switches and Npc-Interaction-Hints-Enabled are edited in the file.
| Variable Name | Default Value | Description |
|---|---|---|
| "ConfigName" | "Cultivation Config" | The name given to this config file. |
| "ConfigVersion" | 6 | Current Version when you have loaded for the plugin. |
| "Base-Qi-Requirement" | 175.0 | The amount of Qi needed to advance from the very first sub-stage (Body Refinement, Early-Stage). Every other requirement in the curve scales off of this base number. |
| "Description-Base-Qi-Requirement" | A long string explaining the value above. | Restates that this is the first sub-stage's requirement and that the whole curve scales from it. |
| "Substage-Growth-Rate" | 1.55 | Multiplies the Qi requirement for each sub-stage climbed within a realm (Early -> Middle -> Late -> Peak). |
| "Realm-Base-Multiplier" | 4.25 | Multiplies the Qi requirement per realm reached, stacking on top of the substage growth. |
| "Realm-Breakthrough-Multiplier" | 5.5 | An extra multiplier applied only to the Qi cost of a realm breakthrough (Peak -> the next realm's Early-Stage), on top of the normal curve. |
| "Description-Realm-Breakthrough-Multiplier" | A long string explaining the value above. | Explains that this extra multiplier is what makes a realm breakthrough feel like a much bigger deal than a routine sub-stage advancement. |
| "Health-Bonus-Per-Level" | 4.0 | Additive max health granted per total sub-level gained (realm * 4 + stage). |
| "Damage-Percent-Bonus-Per-Level" | 2.0 | Percent damage increase granted per total sub-level gained. |
| "Breakthrough-Impurity-Max-Penalty-Percent" | 10.0 | Qi Purity. The largest max-health and damage penalty a realm breakthrough funded entirely by Spirit, Profound and Divine Cores can carry. It scales linearly down to 0 for a breakthrough funded entirely by every other Qi source. |
| "Difficulty-Simple-QiCostPercent" | -7.0 | Cultivation Difficulty. Percent change to the Qi cost of every rank-up for a cultivator who picks Simple. Negative is cheaper. The Default difficulty has no key - it is fixed at 0, today's exact numbers. |
| "Difficulty-Simple-StrengthPercent" | -10.0 | Percent change to the strength a completed rank-up locks in under Simple. Negative is weaker. |
| "Difficulty-Difficult-QiCostPercent" | 10.0 | Percent change to the Qi cost of every rank-up for a cultivator who picks Difficult. Positive is pricier. |
| "Difficulty-Difficult-StrengthPercent" | 10.0 | Percent change to the strength a completed rank-up locks in under Difficult. Positive is stronger. |
| "Tribulation-Performance-Min-Percent" | -1.0 | How you handled it. The worst Breakthrough Quality modifier a tribulation can leave behind, in percent: reached at a third of max health or less combined with potion use at or above the cap below. |
| "Tribulation-Performance-Max-Percent" | 1.5 | The best modifier, in percent: reached by finishing the tribulation at full health without leaning on a potion. Everything between scales linearly. |
| "Tribulation-Performance-Potion-Cap" | 4 | How many pills (other than the Tribulation Ward Pill, which pays its own cost) it takes to count as fully leaning on potions for the modifier above. |
| "Auspicious-SecretRealm-Percent" | 1.5 | Timing. The bonus, in percent, for breaking through inside an open Secret Realm. |
| "Auspicious-WeatherResonance-Percent" | 1.0 | The bonus, in percent, for breaking through under the natural weather that resonates with your own Dao element. Timing is best-of - only the stronger of the two applies, never both. |
| "Sacrifice-Item-Penalty-Percent" | -3.0 | Sacrifice. The penalty, in percent, that each Tribulation Sacrifice Pill consumed during one ritual attempt adds. |
| "Sacrifice-Item-Penalty-Max-Percent" | -15.0 | The floor on the Sacrifice Pill penalty above, so heavy repeat use has a real but bounded cost. |
| "Sacrifice-WardPill-Penalty-Percent" | -1.0 | The flat penalty, in percent, for spending a banked Tribulation Ward Pill charge in the attempt. |
| "Sacrifice-Total-Penalty-Floor-Percent" | -20.0 | The one overall floor on the combined Sacrifice penalty (Sacrifice Pills plus Ward Pill). |
| "Breakthrough-Combined-Multiplier-Floor" | 0.25 | The overall floor on the final combined health and damage multiplier. Race, Qi Purity, Difficulty and the four more factors are each clamped to their own band, but nothing else stops their product from sinking toward zero at extreme settings; this does. |
| "Aura-Enabled" | true | Server-wide master switch for cultivation auras - both the realm aura and the meditation aura. Players who only want to hide their own, or stop seeing everyone else's, have their own three toggles in Settings instead. |
| "Aura-Pulse-Interval-Seconds" | 4.0 | How often each aura is re-spawned at its player's position. Clamped between 1.0 and 6.0 - the particle assets are sized so exactly two pulses overlap at the default. |
| "Aura-Desc" | A long string explaining the values above. | Restates the split between this server-wide switch and the per-player Settings toggles. |
| "Notice-Titles-Enabled" | true | The full-screen titles for breakthroughs, advancements, demotions and sect changes. Chat still says everything these show, so switching them off loses nothing. |
| "Notice-Notifications-Enabled" | true | The corner notifications for smaller moments - a skill node unlocked, a Life-Bound level, a respec, a ritual beginning. |
| "Breakthrough-Title-Radius-Chunks" | 9 | How far a realm breakthrough is announced to other cultivators, as a radial distance in chunks. Clamped between 0 and 32; 0 keeps every breakthrough private. |
| "Notice-Desc" | A long string explaining the values above. | Notes that Qi Deviation and the Heart-Devil Trial keep their own purpose-written titles regardless of these switches. |
| "Sheet-Hud-Enabled" | true | The cultivation sheet - a read-only HUD each player switches on and off with /cultivation sheet or from Settings, down the right-hand side of the screen. While it is up the small corner HUD is taken down. Renamed from Inventory-Hud-Enabled; the old key is simply ignored, so a file that still carries it just gets this default. |
| "Sheet-Hud-Desc" | A long string explaining the value above. | Notes that switching it off takes effect on the next tick, not at the next restart: it removes the sheet from everyone who has it up and hides the Settings row. The sheet refreshes every couple of seconds. Renamed from Description-Inventory-Hud. |
| "Npc-Interaction-Hints-Enabled" | true | Whether a player who tries and fails to open an NPC's interaction is told why, at most once every few seconds. It only fires in the cases the engine silently blocks - Creative mode without Allow NPC detection, spectating, or being intangible. |
| "Admin-Backups-Per-Player" | 10 | How many recent admin progress backups - the undo history /cultivation admin writes when it changes a player's progress, and restores from - are kept per player before the oldest is dropped. They are stored in Admin Backups Data. |
Update Config
The update checker, found in the path mods/Siren_Cultivation/UpdateConfig.json. Cultivation - and any installed add-on that registered with it, such as Jade Slip or Soul Rings - asks xianxia.dev what the current version of each is, so the Info tab can show it and administrators can be told. Nothing about your server is sent: each check is a plain GET of a static file, made on a background thread, and a failure of any kind is treated as "no update" rather than reported. This is the only thing in the mod that talks to the network on a server's behalf (besides the web store sync below), which is why it has its own file.
In-game editor: the Updates section covers all three settings. The two switches take effect as soon as they are saved; a changed interval applies from the next restart.
| Variable Name | Default Value | Description |
|---|---|---|
| "ConfigName" | "Update Config" | The name given to this config file. |
| "ConfigVersion" | 1 | Current Version when you have loaded for the plugin. |
| "Update-Check-Enabled" | true | The master switch. Off means no request is ever made - not a request whose answer is thrown away. |
| "Announce-Updates-To-Admins" | true | Whether the result reaches anyone in game. Off, the check still runs and still writes a line to the console at startup, but nobody is messaged on join. When on, players holding cultivation.admin are told once per session, with every mod that is behind named in one message. A mod whose installed version is listed in its own manifest's ignore array is never announced. |
| "Update-Check-Interval-Hours" | 6 | How long between re-checks. Clamped between 1 and 168 hours (a week). The first check runs shortly after startup regardless. |
| "Update-Check-Desc" | A long string explaining the values above. | Restates the three rules above: the switch makes no request at all, the announce switch only controls the in-game message, and the interval applies from the next restart. |
Web Store Config
The Treasure Pavilion benefit sync, found in the path mods/Siren_Cultivation/WebStoreConfig.json. The server periodically reads a public list of entitled player UUIDs per product - a plain GET; nothing is sent - and applies the matching benefit.
In-game editor: the Web Store section covers the four switches and numbers. Base-Url and Disabled-Benefits are edited in the file.
| Variable Name | Default Value | Description |
|---|---|---|
| "ConfigName" | "Web Store Config" | The name given to this config file. |
| "ConfigVersion" | 1 | Current Version when you have loaded for the plugin. |
| "Description" | A long string explaining the values below. | Restates what the sync does and which keys control it: the switch is checked live with no restart, the interval is 1-168 hours and needs a restart to apply, and the recheck command is gated and rate-limited. |
| "Web-Store-Enabled" | true | Master switch. Off means no fetch is ever made and no benefit is ever applied. |
| "Check-Interval-Hours" | 6 | How often the entitlement lists are re-read. A refund revokes itself at the next check. |
| "Allow-Recheck-Command" | true | Whether /cultivation store recheck may force an early read. |
| "Recheck-Cooldown-Seconds" | 60 | Rate limit on that command. |
| "Base-Url" | "https://xianxia.dev/api/get/entitlements/" | Where the public account-ID lists are read from. Nothing about your server is ever sent. |
| "Disabled-Benefits" | [] | Individual benefit keys to refuse on this server, leaving the rest of the sync working — a product slug (cultivation-sacred-bodies), a subscription family key (sub_cultivation), or an outright-purchase-only key (once_cultivation-sacred-bodies). |
The last successful read is cached in Web Store Data, so a server that boots while xianxia.dev is down keeps serving the last list it saw.
Endless Leveling Compatibility
The one file in the Compatibility/ folder, found in the path mods/Siren_Cultivation/Compatibility/EndlessLevelingConfig.json. It sits outside the root, but it is listed here because it is a single file about the server rather than about cultivating. Both Cultivation and Endless Leveling raise max health and outgoing damage, and left alone they multiply. With a handoff on, Cultivation stops applying that stat itself and publishes it into Endless Leveling's own external-bonus channel, so Endless Leveling runs one calculation that already contains Cultivation's share. The file is inert unless Endless Leveling is installed - every value is read only after the mod has been confirmed present. See Compatibility for how the handoff works.
In-game editor: the Endless Leveling section covers the four handoff settings other than Handoff-Protection, and is hidden entirely unless Endless Leveling is installed.
| Variable Name | Default Value | Description |
|---|---|---|
| "ConfigName" | "Endless Leveling Compatibility" | The name given to this config file. |
| "ConfigVersion" | 1 | Current Version when you have loaded for the plugin. |
| "Handoff-Health" | true | Hand max health to Endless Leveling's LIFE_FORCE channel. On by default: two mods silently multiplying each other's progression is a bug a server owner has to notice before they can opt out of it, whereas one combined calculation is what someone installing both would expect. |
| "Handoff-Damage" | true | Hand outgoing damage to Endless Leveling's external damage bonus. |
| "Handoff-Protection" | true | Hand Body Tempering's damage reduction to Endless Leveling's DEFENSE attribute, so the two mods do not each reduce incoming damage independently. |
| "Handoff-Health-Scale" | 1.0 | Trims what is handed over for health, so a server running both mods can be rebalanced without retuning the Cultivation config a Cultivation-only server also reads. 1 hands over exactly what Cultivation would have applied on its own; 0.5 hands over half of it. |
| "Handoff-Damage-Scale" | 1.0 | The same trim for damage. |
| "Description-EndlessLeveling" | A long string explaining the values above. | The multiplication problem and the handoff. Set a handoff to false to go back to Cultivation applying that stat on its own - correct in isolation, and stacked on top of Endless Leveling when both are installed. Cultivation's race, skill tree and technique multipliers are not handed over; they multiply Cultivation's own contribution before it is published, as they always have. |
Notes on the curve
The Qi requirement for a given rank-up is Base-Qi-Requirement, grown by Substage-Growth-Rate for each sub-stage inside the realm and by Realm-Base-Multiplier for each realm already reached, with Realm-Breakthrough-Multiplier layered on top only when the rank-up is a realm breakthrough. Raising Substage-Growth-Rate steepens the climb inside a realm; raising Realm-Base-Multiplier widens the gap between realms.
Two other systems reduce what a player actually pays: the tier-8 Qi Cost Reduction skill stat (capped by Qi-Cost-Reduction-Cap-Percent in the Skill Tree config), and a race's Qi-Gain-Rate-Percent-Bonus (see the Race Configs) which raises income rather than lowering cost. A player's chosen Difficulty then adds or removes a percent of what is left (Difficulty-*-QiCostPercent above).
The two stat bonuses are applied per total sub-level, counted as realm * 4 + stage, so they grow smoothly across the whole progression rather than jumping only at realm boundaries. Race bonuses from Health-Bonus-Percent and Damage-Bonus-Percent layer on top of these, as do the six Breakthrough Quality factors on a realm breakthrough - all multiplied together and held above Breakthrough-Combined-Multiplier-Floor.