World Configs

v0.11.2

The six files in mods/Siren_Cultivation/World/ belong to the Rare Places - the structures that now generate in newly explored terrain. One file, StructureConfig.json, decides where and how often each of them appears. The other five each hold how one structure plays once a cultivator finds it: the Spirit Stone Mine, the Sword Tomb, the Fallen Cultivator's Cave, the Tribulation Crater and the Ancient Pill Furnace.

How to read it

• Each section is one file. Its first two rows are ConfigName and ConfigVersion; the mod resets the name and every Description-* text to its default whenever it loads the file, so do not hand-edit those. A Description-* row stands for the explanatory string written beside the values above it.
• A key missing from a file reads as the default shown here, so an update never needs a manual edit. Defaults are what the mod writes on a fresh install. Out-of-range values are pulled back into the listed range when the file loads.
• Placement and mechanic are separate files. A structure's own file never says how often it generates; its row in StructureConfig.json does. Placement edits (everything in a Structure-Types row, plus Structure-Min-Gap-Blocks and Structure-Avoid-Spawn-Protection) are read once when the server starts and apply only to terrain generated afterwards - chunks that already exist never change. Mechanic edits apply on the next use, with no restart.
• Every file in this folder has its own section in the in-game admin menu (/cultivation admin), as noted under each heading. The menu edits switches and numbers only; text and list values stay in the JSON.
• The sites that exist in a world are saved in Data/StructureSitesData.json, and two structures keep per-player records of their own - see Data Files.

Contents

Structure Config

Where and how often the rare structures generate, found in the path mods/Siren_Cultivation/World/StructureConfig.json. Structures generate in newly generated overworld terrain only. For an older world, or for testing, an admin pastes one where they stand with /cultivation admin structure place <type>; the admin place, list, info, remove and locate commands work whatever this file says.

Every structure carries a marker block. The first time its chunk is active near a player it is recorded as a site. A site that stands in world-spawn protection, an admin-protected area, sect land, a Cave Abode or an open Secret Realm is recorded as dormant: its mechanic stays off until the ground is free and the chunk loads again.

In-game editor: the Rare Structures section has 29 rows - the five global settings, then four per structure type (on/off, chance, grid cell size and minimum spacing). The chance reads as a percent. Placement changes still apply only after a restart. Jitter, zones and height bounds are edited in the file.

A row is written with that type's own defaults the first time the type is seen. A key missing from a row - or a row missing entirely - falls back to the type's default, never to a generic one. A row whose Id no installed type uses is kept untouched. Each row has these keys.

The built-in rows. Every type has Jitter 0.5 and Chance 0.5.

Spirit Mine Config

The Spirit Stone Mine's mechanic - mine grades, the Qi reserve, crystal regrowth, the collapse and the sect claim - found in the path mods/Siren_Cultivation/World/SpiritMineConfig.json. Where mines generate is the spirit_stone_mine row of Structure Config. See the Spirit Stone Mine.

Every value is read live, except the grade weights, which apply to mines discovered after the change.

In-game editor: the Spirit Stone Mines section has 25 rows: Mine-Enabled, Heart-Glow, the four per-grade values Grade-Weight, Reserve-Max, Regen-Per-Hour and Crystal-Qi-Cost for each grade, and seven timing and claim values (Regrow-Delay-Full-Seconds, Regrow-Delay-Empty-Seconds, Collapse-Grace-Seconds, Claim-Share-Percent, Claim-Take-Seconds, Claim-Regen-Bonus-Per-Sect-Level-Percent, Claim-Announce-Cooldown-Seconds).

Where a key ends in a grade name, there is one key per grade - Grade-Weight-Low, Grade-Weight-Mid, Grade-Weight-High, Grade-Weight-Supreme - and the default column reads Low / Mid / High / Supreme.

Sword Tomb Config

The Sword Tomb's mechanic - pulling tomb swords for forging materials, the sword spirit's trial, and the bond - found in the path mods/Siren_Cultivation/World/SwordTombConfig.json. Where tombs generate is the sword_tomb row of Structure Config. See the Sword Tomb. Each player's pull cooldown, trial lockouts, wins and pending bonds are saved in Data/SwordTombData.json; each tomb's own pull count and spirit state live in its site record.

Read live, so an edit applies on the next pull.

In-game editor: the Sword Tomb section has 19 rows - every key below except the six Loot-*-Min and Loot-*-Max values.

Fallen Cave Config

The Fallen Cultivator's Cave - the seal's offering, the door, the legacy granted once per player, and the remnant soul's question - found in the path mods/Siren_Cultivation/World/FallenCaveConfig.json. Where caves generate is the fallen_cultivator_cave row of Structure Config. See the Fallen Cultivator's Cave. Who has paid, looted and answered at which cave is saved in Data/FallenCaveData.json.

In-game editor: the Fallen Cultivator's Cave section has 13 rows. Fallen-Cave-Offering-Grade-Step-Percent, Fallen-Cave-Grade-Weights, Fallen-Cave-Loot-Pill-Ids and Fallen-Cave-Ambient-Fx are edited in the file.

Rewards go to each player once per cave the first time an acknowledged player reaches the dais. Nothing is granted to a sandbox profile or a fleeing Nascent Soul, and nothing is recorded for them, so they may return.

Tribulation Crater Config

How a Tribulation Crater softens the tribulation fought inside it, and how its Thunder Residue regrows, found in the path mods/Siren_Cultivation/World/TribulationCraterConfig.json. Where craters generate is the tribulation_crater row of Structure Config. See the Tribulation Crater.

In-game editor: the Tribulation Crater section has 5 rows. It shows the softening as a percent - Softer % is (1 - Tribulation-Crater-Easier-Multiplier) x 100, so the default reads 10. The margin, the weather keyword lists and the watch radius are edited in the file.

Pill Furnace Config

The Ancient Pill Furnace Ruins' refining bonus and herb garden, found in the path mods/Siren_Cultivation/World/PillFurnaceConfig.json. Where the ruins generate is the ancient_pill_furnace row of Structure Config. See the Ancient Pill Furnace.

In-game editor: the Ancient Pill Furnace section covers all four settings.