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" | 5 | 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. |
| "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" | 4 | 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. |
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. |