Configuration/Cultivation Configs·配
Cultivation Configs
The five files in mods/Siren_Cultivation/Cultivation/ are the progression core: where Qi comes from, what it costs to climb, what the heavens charge you for climbing, and what a rank-up pays out. Between them they cover Qi Gathering, Cultivation Realms, Tribulations, Races, and the Skill Tree.
Spirit Core Config
Drop chances and Qi values for Spirit, Profound, and Divine Cores, found in the path mods/Siren_Cultivation/Cultivation/SpiritCoreConfig.json.
| Variable Name | Default Value | Description |
|---|---|---|
| "ConfigName" | "Spirit Core Config" | The name given to this config file. |
| "ConfigVersion" | 1 | Current Version when you have loaded for the plugin. |
| "Spirit-Core-Drop-Chance" | 0.12 | Tier 1 (common) drop chance per creature kill, as a 0-1 fraction. |
| "Spirit-Core-Qi-Value" | 30.0 | Qi granted when a Spirit Core is absorbed. |
| "Profound-Core-Drop-Chance" | 0.035 | Tier 2 (rarer, tougher creatures) drop chance per kill. |
| "Profound-Core-Qi-Value" | 80.0 | Qi granted when a Profound Core is absorbed. |
| "Divine-Core-Drop-Chance" | 0.008 | Tier 3 (rare, powerful creatures) drop chance per kill. |
| "Divine-Core-Qi-Value" | 220.0 | Qi granted when a Divine Core is absorbed. |
| "Description-Drop-Chances" | A long string explaining the values above. | All three Drop-Chance values are a 0-1 fraction, rolled independently and rarest-tier-first on every creature kill - at most one core drops per kill. |
| "Meditation-Core-Bonus-Multiplier" | 1.1 | Multiplies a core's Qi value if it is absorbed while the player is currently meditating (the mix-of-both-methods bonus). 1.10 = 10% extra Qi. |
| "Description-Meditation-Core-Bonus-Multiplier" | A long string explaining the value above. | Restates that this is the reward for combining meditation with core absorption rather than picking one method. |
Spirit Vein Config
Spirit Vein tiers, meditation timing, and the Qi absorption item modifiers, found in the path mods/Siren_Cultivation/Cultivation/SpiritVeinConfig.json.
| Variable Name | Default Value | Description |
|---|---|---|
| "ConfigName" | "Spirit Vein Config" | The name given to this config file. |
| "ConfigVersion" | 7 | Current Version when you have loaded for the plugin. |
| "Spirit-Vein-Min-Qi" | 150.0 | Lower bound of the random maxQi a normal chunk's Spirit Vein seeds with. |
| "Spirit-Vein-Max-Qi" | 500.0 | Upper bound of that same random range. Every chunk starts full. |
| "Description-Spirit-Vein-Min-Max-Qi" | A long string explaining the values above. | Every chunk's vein is seeded on first access with a random maxQi between the two values, deterministically from the world seed, and starts full - unless it rolls as a rich or dragon vein instead. |
| "Spirit-Vein-Rich-Chance" | 0.03 | Odds (0-1) that a chunk's Spirit Vein rolls "rich" instead of normal, using the Rich-Min/Max-Qi range below. Rolled once per chunk, deterministically, off the world seed. |
| "Spirit-Vein-Rich-Min-Qi" | 1200.0 | Lower bound for a rich vein's Qi pool. |
| "Spirit-Vein-Rich-Max-Qi" | 2600.0 | Upper bound for a rich vein's Qi pool. |
| "Description-Spirit-Vein-Rich" | A long string explaining the values above. | Explains that a rich roll replaces the normal min/max range entirely, and is rolled once per chunk deterministically like the normal range. |
| "Spirit-Vein-Dragon-Chance" | 0.003 | Odds (0-1) that a chunk rolls a "dragon vein" - the rarest tier. Rolled before the rich-vein roll. |
| "Spirit-Vein-Dragon-Min-Qi" | 3500.0 | Lower bound for a dragon vein's Qi pool. |
| "Spirit-Vein-Dragon-Max-Qi" | 5500.0 | Upper bound for a dragon vein's Qi pool. |
| "Description-Spirit-Vein-Dragon" | A long string explaining the values above. | Notes that the dragon roll happens before the rich roll, and that meditating players are told when they sit on a rich or dragon vein. |
| "Spirit-Vein-Rich-Regen-Multiplier" | 1.25 | How much faster a rich vein regenerates than Spirit-Vein-Regen-Per-Second. |
| "Spirit-Vein-Dragon-Regen-Multiplier" | 1.6 | How much faster a dragon vein regenerates than Spirit-Vein-Regen-Per-Second. |
| "Description-Spirit-Vein-Regen-Multipliers" | A long string explaining the values above. | Warns that multiplier * Spirit-Vein-Regen-Per-Second must stay BELOW Spirit-Vein-Drain-Per-Second, or the vein refills faster than one meditator drains it and becomes an infinite Qi source. |
| "Spirit-Vein-Regen-Per-Second" | 1.5 | How much Qi a vein passively regenerates per second. |
| "Spirit-Vein-Drain-Per-Second" | 2.75 | How much Qi a meditating player drains from the vein per second. |
| "Spirit-Vein-Drain-Radius-Chunks" | 1 | How many rings of neighboring chunks a meditating player can also drain from once their own chunk runs low (0 = only their own chunk, 1 = a 3x3 area). |
| "Description-Spirit-Vein-Drain-Radius-Chunks" | A long string explaining the value above. | Restates the ring counting, with 0 meaning own chunk only and 1 meaning a 3x3 area. |
| "Meditation-Tick-Interval-Seconds" | 1.0 | How often, in seconds, a meditating player's Qi gain is calculated. |
| "Meditation-Movement-Cancel-Threshold" | 0.35 | How far, in blocks, a meditating player may drift from where they sat down before meditation is automatically cancelled. |
| "Description-Meditation-Movement-Cancel-Threshold" | A long string explaining the value above. | Restates the drift distance and that exceeding it cancels meditation automatically. |
| "Meditation-Movement-Check-Interval-Seconds" | 0.25 | How often, in seconds, meditating players are checked for movement and seating. |
| "Qi-Absorption-Item-Modifiers" | [{"ItemId": "Cultivation_QiGatheringTalisman", "Multiplier": 1.5}] | An array of item id / multiplier pairs. Holding a matching item in your hotbar's active slot while meditating multiplies your Spirit Vein absorption rate by that amount. |
| "Spirit-Sense-Enabled" | true | Master toggle for Spirit Sense. The sense only ever reads, so turning it off leaves Qi gathering entirely unchanged. |
| "Spirit-Sense-Min-Realm" | 2 | 0-based realm ordinal that unlocks the sense (2 = Foundation Establishment). Below it a cultivator perceives nothing. |
| "Spirit-Sense-Precise-Min-Realm" | 4 | Realm ordinal at which exact Qi numbers appear (4 = Nascent Soul). Below it the reading is words only — barren, thin, steady, ample, overflowing. |
| "Spirit-Sense-Radius-Per-Realm" | 1 | Extra chunks of reach per realm beyond the unlock realm. |
| "Spirit-Sense-Max-Radius-Chunks" | 4 | Ceiling on that reach. With the defaults a Foundation Establishment cultivator senses their own chunk and a Void Refinement one a 9×9 area. |
| "Spirit-Sense-Tick-Interval-Seconds" | 2.5 | How often the sense re-reads the world and re-pulses its particles. The assets are sized to finish inside one interval, so raising it thins the effect and lowering it thickens it — and costs more packets. |
| "Spirit-Sense-Mote-Budget" | 10 | Most ambient motes spawned per pulse for one player. The main cost knob; lower this before raising the interval. |
| "Spirit-Sense-Beacon-Min-Tier" | 1 | Lowest vein tier that raises a visible beacon column. 0 = every chunk, 1 = rich veins and better, 2 = dragon veins only, 3 = never. |
| "Description-Spirit-Sense" | A long string explaining the values above. | The two-step realm gate, how reach scales, and the word tiers used below the precise realm. |
| "Description-Spirit-Sense-Visuals" | A long string explaining the values above. | The particle cost knobs and what each beacon tier value means. |
| "Description-Qi-Absorption-Item-Modifiers" | A long string explaining the array above. | Only Spirit Vein absorption is affected, never core Qi values, and other mods may register additional entries in Java through the Cultivation API. |
Breakthrough Config
Timing and Qi-presence requirements for both sub-stage advancements and realm breakthroughs, plus the two tribulation trials, found in the path mods/Siren_Cultivation/Cultivation/BreakthroughConfig.json.
| Variable Name | Default Value | Description |
|---|---|---|
| "ConfigName" | "Breakthrough Config" | The name given to this config file. |
| "ConfigVersion" | 6 | Current Version when you have loaded for the plugin. |
| "Breakthrough-Min-Chunk-Qi" | 750.0 | The chunk a player is meditating in must hold at least this much Spirit Vein Qi for their realm-breakthrough attempt to make progress - a presence check, not a drain. |
| "Description-Breakthrough-Min-Chunk-Qi" | A long string explaining the value above. | Stresses that the vein is not consumed by the check, only required to be present. |
| "Breakthrough-Base-Seconds" | 24.0 | How long, in seconds, a realm breakthrough takes from the very first realm. |
| "Breakthrough-Duration-Realm-Multiplier" | 1.35 | Multiplies the breakthrough duration for each realm reached, stacking. |
| "Description-Breakthrough-Duration" | A long string explaining the values above. | Total duration in seconds = Breakthrough-Base-Seconds * Breakthrough-Duration-Realm-Multiplier ^ realmIndex, before any race speed bonus. |
| "Advancement-Min-Chunk-Qi" | 200.0 | Same presence-check mechanism as Breakthrough-Min-Chunk-Qi, just a lower bar since sub-stage advancements happen far more often. |
| "Description-Advancement-Min-Chunk-Qi" | A long string explaining the value above. | Restates that this is the same presence check at a lower threshold. |
| "Advancement-Base-Seconds" | 8.0 | How long, in seconds, a sub-stage advancement takes from the very first realm. |
| "Advancement-Duration-Realm-Multiplier" | 1.3 | Same formula shape as breakthroughs, just shorter. |
| "Description-Advancement-Duration" | A long string explaining the values above. | Total duration = Advancement-Base-Seconds * Advancement-Duration-Realm-Multiplier ^ realmIndex, before any race speed bonus. |
| "Tribulation-Enabled" | true | Master toggle for heavenly tribulation lightning during realm breakthrough rituals. |
| "Tribulation-Strike-Interval-Seconds" | 6.0 | How many seconds of ritual progress pass between lightning strikes. |
| "Tribulation-Damage-Percent-Of-Max-Health" | 15.0 | Percent of the cultivator's max health each breakthrough strike deals, before realm scaling. |
| "Tribulation-Damage-Realm-Multiplier" | 1.12 | Multiplies strike damage per realm reached, stacking. |
| "Tribulation-Lethal" | true | If false, a strike always leaves at least a sliver of health instead of killing. |
| "Description-Tribulation" | A long string explaining the values above. | Lays out the whole strike formula: damage percent of max health, multiplied by the realm multiplier raised to realmIndex, delivered on the strike interval, and whether it may kill. |
| "Advancement-Tribulation-Enabled" | false | Off by default - opt in to make routine sub-stage advancements also carry tribulation lightning. |
| "Advancement-Tribulation-Damage-Percent-Of-Max-Health" | 6.0 | The much lower damage percent used when advancement tribulation is enabled. |
| "Description-Advancement-Tribulation" | A long string explaining the values above. | Notes that advancement tribulation reuses the same interval, realm scaling, and lethality rule as breakthroughs, only with this lower percent. |
| "HeartDevil-Enabled" | true | Master toggle for the Heart-Devil Trial (心魔劫) - the inner-demon tribulation variant that replaces lightning for deeply leaned cultivators. |
| "HeartDevil-Lean-Threshold" | 0.5 | How deep (0-1) the stronger of the Yin/Yang lean must be before the heart-devil manifests instead of lightning. |
| "HeartDevil-Max-Composure" | 100.0 | The per-attempt composure (道心) pool the cultivator defends. |
| "HeartDevil-Composure-Drain-Per-Pulse" | 34.0 | Base composure lost per pulse. The actual drain is this multiplied by (0.5 + leanFraction), so a deeper lean faces a fiercer demon. |
| "HeartDevil-Debuff-Effect" | "Stun" | A vanilla EntityEffect asset id applied on each pulse. Real options include Stun, Root, Slow, and Poison. Leave blank to skip the debuff. |
| "HeartDevil-Debuff-Duration-Seconds" | 1.5 | How long that entity effect lasts per pulse. |
| "HeartDevil-Deviation-Demotes" | true | On Qi Deviation (走火入魔), demote one sub-stage - which wipes banked Qi, as any failed ritual does. If false, the stage is kept and only the Qi fraction below is lost. |
| "HeartDevil-Deviation-Qi-Loss-Percent" | 100.0 | Percent of banked Qi lost on Qi Deviation when HeartDevil-Deviation-Demotes is false. |
| "HeartDevil-On-Advancement" | false | Whether the heart-devil can also manifest during sub-stage advancement rituals. Off by default so routine advancements stay safe. |
| "Description-HeartDevil" | A long string explaining the values above. | Walks the whole trial: pulses fire on Tribulation-Strike-Interval-Seconds, drain scaled composure and apply the debuff, a banked Clear-Mind Pill charge negates one pulse, and composure reaching zero fails the ritual with Qi Deviation. |
| "Tribulation-Storm-Enabled" | true | Master toggle for the tribulation skies - night and a coloured cloud deck over the ritual ground. |
| "Tribulation-Storm-Radius" | 96.0 | Horizontal blocks. Everyone inside shares the storm; the rest of the server keeps its own weather and time of day. |
| "Tribulation-Storm-Transition-Seconds" | 2.5 | How long the sky takes to close in, and to clear afterwards. |
| "Tribulation-Storm-Weather-White" | "Cultivation_Tribulation_White" | The sky for Body Refinement through Foundation Establishment. |
| "Tribulation-Storm-Weather-Blue" | "Cultivation_Tribulation_Blue" | The sky for Golden Core Formation through Nascent Soul. |
| "Tribulation-Storm-Weather-Gold" | "Cultivation_Tribulation_Gold" | The sky for Soul Formation and above. |
| "Description-Tribulation-Storm" | A long string explaining the values above. | Explains the per-player sky override, the three realm bands, and that the lightning is coloured to match. |
Ascension
The capstone past Void Refinement Peak lives in the same file. It is one of the two sections wired into the in-game /cultivation admin editor in 0.8.0.
| Variable Name | Default Value | Description |
|---|---|---|
| "Ascension-Enabled" | true | Master toggle for the whole capstone. |
| "Ascension-Min-Chunk-Qi" | 4500.0 | The chunk-Qi presence check. Set high enough that only a Dragon vein can ever host it. |
| "Ascension-Base-Seconds" | 900.0 | Fifteen minutes, before any speed bonus. |
| "Ascension-Duration-Per-Ascension-Multiplier" | 1.2 | Multiplies the duration per Ascension already completed, so each prestige loop is longer than the last. |
| "Ascension-Strike-Interval-Seconds" | 20.0 | Seconds between crimson tribulation bolts. |
| "Ascension-Damage-Percent-Of-Max-Health" | 8.0 | The first bolt's damage, as a percent of max health. |
| "Ascension-Damage-Escalation-Per-Strike" | 1.015 | Compounds per bolt, so an attempt begins survivable and ends fearsome. |
| "Ascension-Lethal" | true | If false, a bolt leaves a sliver of health instead of killing - the same rule as Tribulation-Lethal. |
| "Ascension-Cooldown-Seconds-On-Failure" | 3600.0 | One hour before another attempt may begin. Walking away or dying also costs a stage. |
| "Ascension-Storm-Radius" | 160.0 | The crimson storm's reach - wider than a realm tribulation, because it is meant to be seen from further away. |
| "Ascension-Storm-Weather-Crimson" | "Cultivation_Tribulation_Crimson" | The Weather asset for the Ascension sky. Blank falls back to the shipped one. |
| "Ascension-Prestige-Enabled" | false | Whether /ascend prestige is offered at all. Deliberately off - whether a world has a prestige loop is the owner's call. |
| "Ascension-Prestige-Qi-Gain-Percent-Per-Stack" | 4.0 | Permanent extra Qi from every source, per completed loop. |
| "Ascension-Prestige-Ritual-Ease-Percent-Per-Stack" | 2.0 | Permanent easing of every timed ritual - shorter, and its bolts softer - per loop. |
| "Ascension-Prestige-Max-Stacks" | 10 | Where the bonus stops growing. The count itself may climb past this and still names the title tier. |
| "Description-Ascension-Min-Chunk-Qi" / "-Duration" / "-Tribulation" / "-Storm" / "-Prestige" | Long strings explaining the values above. | Five separate documentation blocks, one per group. |
Celestial Config
The server-wide celestial events, found in the path mods/Siren_Cultivation/Cultivation/CelestialConfig.json. JSON-only - not in the in-game editor yet.
| Variable Name | Default Value | Description |
|---|---|---|
| "ConfigName" | "Celestial Config" | The name given to this config file. |
| "ConfigVersion" | 1 | Current Version when you have loaded for the plugin. |
| "Celestial-Enabled" | true | Master toggle for the whole scheduler. |
| "Celestial-Interval-Min-Minutes" | 60.0 | The lower bound of the quiet interval after each event ends. |
| "Celestial-Interval-Max-Minutes" | 120.0 | The upper bound. A random point in the band, so it never feels metronomic. |
| "Celestial-Check-Interval-Seconds" | 30.0 | How often the scheduler re-reads whether to start or end an event. |
| "Celestial-Sky-Transition-Seconds" | 4.0 | How long the sky blend takes, each way. |
| "Celestial-Announce-Titles-Enabled" | true | Whether an event start raises an on-screen title as well as a chat line. |
| "Spirit-Tide-Enabled" | true | Whether Spirit Tide is in the random pool. |
| "Spirit-Tide-Weight" | 1.0 | Its relative odds against every other enabled event. |
| "Spirit-Tide-Duration-Minutes" | 15.0 | How long a tide runs. |
| "Spirit-Tide-Vein-Regen-Multiplier" | 2.5 | How much faster every Spirit Vein on the server regenerates while it runs. |
| "Spirit-Tide-Weather" | "" | Weather asset for its sky. Blank uses the shipped one. |
| "Meteor-Shower-Enabled" | true | Whether Meteor Shower is in the pool. |
| "Meteor-Shower-Weight" | 1.0 | Its relative odds. |
| "Meteor-Shower-Duration-Minutes" | 10.0 | How long a shower runs. |
| "Meteor-Shower-Site-Density-Percent" | 3.0 | Roughly what share of meditated chunks turn out to hold a fallen meteor. |
| "Meteor-Shower-Vein-Tier" | 1 | The tier a meteor site is temporarily raised to. 1 is a rich vein. |
| "Meteor-Shower-Vein-Qi" | 2000.0 | The Qi a meteor site holds - well clear of the 750 breakthrough bar. |
| "Meteor-Shower-Weather" | "" | Weather asset for its sky. |
| "Blood-Moon-Enabled" | true | Whether Blood Moon is in the pool. |
| "Blood-Moon-Weight" | 1.0 | Its relative odds. |
| "Blood-Moon-Duration-Minutes" | 12.0 | How long a Blood Moon runs. |
| "Blood-Moon-Devil-Damage-Bonus-Percent" | 20.0 | Extra damage dealt by a cultivator on the Devil path, in every fight. |
| "Blood-Moon-Righteous-Damage-Penalty-Percent" | 20.0 | Damage lost by one on the Righteous path. An unaligned cultivator is unaffected. |
| "Blood-Moon-Weather" | "" | Weather asset for its sky. |
| "Description-Celestial-Schedule" / "-Spirit-Tide" / "-Meteor-Shower" / "-Blood-Moon" | Long strings explaining the values above. | Includes the rule that a tribulation storm over a player's own position always wins the sky for that player. |
Qi Deviation Config
The lingering affliction a broken Heart-Devil Trial leaves behind - see Qi Deviation. Found in the path mods/Siren_Cultivation/Cultivation/QiDeviationConfig.json. JSON-only.
| Variable Name | Default Value | Description |
|---|---|---|
| "ConfigName" | "Qi Deviation Config" | The name given to this config file. |
| "ConfigVersion" | 1 | Current Version when you have loaded for the plugin. |
| "Deviation-Enabled" | true | Master toggle. Off leaves the Heart-Devil Trial's original demotion exactly as it was in v0.7.4. |
| "Deviation-Base-Duration-Minutes" | 15.0 | How long the affliction lasts. The clock runs while the player is logged off. |
| "Deviation-Qi-Gain-Penalty-Percent" | 35.0 | How much meditation Qi gain is cut while afflicted. |
| "Deviation-HeartDevil-Risk-Increase-Percent" | 50.0 | How much harder the next inner demon drains composure - an unstable cultivator inviting more instability. |
| "Deviation-Companion-Cure-Multiplier" | 3.0 | How much faster the clock runs while meditating beside a bonded companion - a spouse, a master, or a disciple - within that bond's own radius. |
| "Deviation-Reminder-Interval-Seconds" | 60.0 | How often the affliction reminds the player in chat, so a drop in yield is never a mystery. |
| "Description-Deviation" | A long string explaining the values above. | Names all three cures: waiting, a Clear-Mind Pill, and a bonded companion. |
Race System Config
Cross-race server behavior that is not specific to any one race's stats, found in the path mods/Siren_Cultivation/Cultivation/RaceSystemConfig.json. The per-race numbers themselves live in the Race Configs.
| Variable Name | Default Value | Description |
|---|---|---|
| "ConfigName" | "Race System Config" | The name given to this config file. |
| "ConfigVersion" | 1 | Current Version when you have loaded for the plugin. |
| "Race-Admin-Bypasses-Realm-Gate" | true | If true, /cultivation admin setrace (and the admin UI's Set Race action) can force any online player's race regardless of whether they have reached that race's own configured unlock realm. If false, the admin override is refused for players below that realm. |
| "Description-Race-Admin-Bypasses-Realm-Gate" | A long string explaining the value above. | Restates the override rule and points at each race file's own Unlock-Realm. |
Skill Tree Config
How skill points are earned and spent, found in the path mods/Siren_Cultivation/Cultivation/SkillTreeConfig.json. See the Skill Tree page for the tree itself.
| Variable Name | Default Value | Description |
|---|---|---|
| "ConfigName" | "Skill Tree Config" | The name given to this config file. |
| "ConfigVersion" | 2 | Current Version when you have loaded for the plugin. |
| "Points-Per-Advancement" | 1 | Skill points granted every time a player completes a regular sub-stage advancement. |
| "Description-Points-Per-Advancement" | A long string explaining the value above. | Clarifies that this covers sub-stage advancements only, and that realm breakthroughs pay this plus Points-Per-Breakthrough. |
| "Points-Per-Breakthrough" | 2 | Extra skill points granted, on top of Points-Per-Advancement, when a player breaks through into a new realm. |
| "Description-Points-Per-Breakthrough" | A long string explaining the value above. | Restates that the breakthrough award is additive on top of the advancement award. |
| "Qi-Cost-Reduction-Cap-Percent" | 40.0 | Ceiling for the stacked tier-8 Qi Cost Reduction skill stat, so rank-up Qi requirements can never collapse toward zero no matter how many capstones a build collects. |
| "Description-Qi-Cost-Reduction-Cap" | A long string explaining the value above. | Restates that the stat is clamped to this total percent however many capstones grant it. |
| "Respec-Enabled" | true | If true, players can run /cultivation respec to clear their entire skill tree and get every spent point refunded. |
| "Description-Respec-Enabled" | A long string explaining the value above. | Notes that setting this false makes skill choices permanent, and that admins can still grant extra points. |