SirenHytale
In this section
  1. Cultivation
  2. Run a server
  3. Overview

Config

Everything the Cultivation mod can be tuned with lives under mods/Siren_Cultivation/, updated here for Cultivation v0.11.2. Rather than one enormous file, the settings are split into themed files and grouped into folders - three files at the root, the progression core in Cultivation/, everything a cultivator practices in Arts/, everything that only matters because other cultivators exist in Society/, v0.11.2 the rare structures in World/, the Endless Leveling handoff in Compatibility/, one file per playable race in Race/, and the server's own runtime save state in Data/. That is 107 settings files in all, plus 56 data files; the folder layout below lists every one and the page that documents it.

Every settings file carries its own ConfigName and ConfigVersion. The version increases automatically whenever that file's layout or balance changes, and your existing settings are migrated for you - you never need to edit ConfigVersion by hand, and setting it backwards only causes the migration to run again. Files also contain Description-* string fields, which are documentation rather than settings: the mod rewrites them to their current text on load, so editing one does nothing.

Most of the values on these pages can also be changed live, in game, with /cultivation admin instead of touching JSON - the note below says what the editor does not reach. See the Commands and Permissions pages for how to reach it.

As of 0.5.0, other mods can add their own sections to that editor, appearing beside Cultivation's own on the Config tab and in an admin-only block of the settings menu. Anything you see there that is not documented on these pages belongs to another mod - see API Addons.

The editor covers checkboxes, whole numbers, decimals and dropdowns; most text-valued settings (asset ids, weather ids, world names, comma-separated lists) stay in the files. v0.11.2 The one text row so far is Death-Penalty-Loss-Percents. As of v0.11.2 it has 80 sections and 1,069 settings, and 75 of the 107 settings files have a section of their own. The totals are the v0.11.1 figures plus the additions below, counted from the 0.11.2 source. v0.11.1 Five sections are new - Dao Seals (22 settings), Dao Domains (21), Spirit Vein Compass (8), Sect Array Domains (8) and Breach Rewards (16) - and the Spirit Cores section gained two, which is where the 77 more settings of the first pass come from. A second batch of v0.11.1 content added three more sections - Boss Domains (22 settings), Domain Resonance (3) and Vein-Tapping Arrays (28) - and rows to two existing ones: nine Luopan-* settings in the Spirit Vein Compass section (now 17) and Meditation-Lava-Qi-Multiplier in Spirit Veins, which is 63 more. v0.11.2 Ten sections are new - Spirit Stones (11 settings), Aura Sight and Pressure (31), Retainers (54), Death Penalty (10), Rare Structures (29), Spirit Stone Mines (25), Sword Tomb (19), Fallen Cultivator's Cave (13), Tribulation Crater (5) and Ancient Pill Furnace (4) - which is 201 settings, and the existing Breakthrough section gained four rows and the Sects section fourteen, which is 18 more. Each new file has exactly one section; DuelConfig.json's new Duel-Default-Lethal has no row. The Endless Leveling section (4 settings) is hidden unless that mod is installed. Cultivation's own sections are ordinary API registrations, which is what lets an add-on reorder, hide or replace one - see Registries.

Not every setting is in the editor

Each config page says what its editor section covers; the rest of that file is edited as JSON. Thirty-two files have no editor section at all (v0.11.2 still thirty-two - every file added in 0.11.2 has a section): in Cultivation/, the Meridian, Cleanse Rite, Divination, Solar Term and Inner Demon configs; in Arts/, Combat Depth, Fist, Hearth, Forage and Herb Scatter; in Society/, Merit, Guardian, Sermon, Rogue, Land, Dao Duel, Dao Duel Tournament, Wager, Legacy, Dao Inheritance, Grand Tournament, Depths, World Boss, Rift, Sea of Consciousness, Pagoda, Bounty, Leaderboard and Dao Mastery; and the three Race/ files. Every settings file is written with working defaults and its own in-file Description-* documentation the first time the server starts, so nothing has to be created by hand.

v0.11.0 The Config tab (Config Values) of /cultivation admin has a search bar above its panes. Type a word or two and press Enter or Search, and the editor finds every matching setting across all of Cultivation's configs - and any add-on's sections - without you knowing which file it lives in.

  • What it matches. A setting's name, its tooltip, its config-file key, and the name of the config it belongs to. Names are matched in your own language and in English, so either works. Punctuation is ignored, so Qi-Cost, qi cost and QiCost all find the same setting, and a key copied straight from a JSON file (Array-Base-Qi-Cost) works as typed.
  • More than one word. Every word must match somewhere in the setting or its config's name. A short word (three letters or fewer) must start a word of the name - tea finds Tea Buff Minutes but not Steady; a word of four letters or more can match anywhere inside it. Chinese, which has no spaces to split on, also matches anywhere.
  • Searching a config's name shows that whole config.
  • Results are the real rows. They are grouped under each config's name with a count, they are editable in place, and Save works from the results without ever opening the config's own section. The list stops at 150 rows with a note to add a word and narrow it.
  • All Configs or This Config. While a search is active, two buttons appear: All Configs (the default) shows every group, and This Config narrows the results to the one config picked on the left. Either way the list on the left shrinks to only the configs that have a match.
  • No match shows No Matches and keeps the full list on the left; clicking a config there leaves the search and opens it. Clear also leaves the search and returns to the normal view.

Search finds only what the editor can edit. The settings and files listed in the note above still have to be edited as files.

The folder groups

GroupFilesCovers
Core Config3: Config.json, UpdateConfig.json, WebStoreConfig.jsonThe Qi curve, the per-level health/damage bonuses, the Breakthrough Quality dials, the update checker, and the Treasure Pavilion sync.
Cultivation Configs27, in Cultivation/Where Qi comes from, what advancing costs, what a rank-up pays out, what the sky is doing, v0.11.2 what a Spirit Stone holds, and the trials, ordeals and capstones that sit alongside the ladder.
Arts Configs20, in Arts/What a cultivator practices, crafts, tempers, and binds to themselves - v0.11.2 and the Aura Sight and Pressure they read and wield.
Society Configs47, in Society/Sects, the ground they hold, the homes they build, the bonds they form, v0.11.2 the retainers they hire and what dying costs, and the fights, events and ladders they take part in.
World Configs6, in World/v0.11.2 Where the rare structures generate, and how the Spirit Stone Mine, Sword Tomb, Fallen Cultivator's Cave, Tribulation Crater and Ancient Pill Furnace play.
Compatibility1: Compatibility/EndlessLevelingConfig.jsonHow Cultivation shares the stats it raises with other mods. Inert unless that mod is installed. Its keys are listed under Core Config.
Race Configs3, in Race/One independent stat file per playable race.
Data Files56, in Data/Runtime save state. Not settings - do not hand-edit these.

Folder layout

Every file below lives under mods/Siren_Cultivation/. The last column says whether the in-game /cultivation admin editor has a section for the file - for many, it covers only part of the file; the file's page says which part.

Root

FileControlsIn-game editor
Config.jsonThe Qi curve, the per-level health and damage bonuses, the Breakthrough Quality dials, and the aura, notice and sheet switches.Yes
UpdateConfig.jsonThe update checker and the join-time notice to administrators.Yes
WebStoreConfig.jsonThe Treasure Pavilion benefit sync.Yes

Cultivation/

FileControlsIn-game editor
SpiritCoreConfig.jsonSpirit, Profound and Divine Core drop chances and Qi values.Yes
SpiritVeinConfig.jsonVein tiers, regeneration, meditation timing, Spirit Sense and its Waystones.Yes
SpiritStoneConfig.jsonv0.11.2 The four Spirit Stone grades: Qi per grade, realm gates, the break ratio, the condense price and the daily condense cap.Yes
VeinCompassConfig.jsonv0.11.1 The Spirit Vein Compass and the Heaven-Seeking Luopan: the held items that point to the nearest rich or dragon vein, and further.Yes
VeinTapConfig.jsonv0.11.1 Vein-Tapping Arrays: planted on rich and dragon veins to gather Spirit Stones and Qi, and raided by rivals.Yes
BreakthroughConfig.jsonBreakthrough and advancement rituals, tribulations, Heart-Devil, Ascension, Storm Omen, tribulation variants and ritual withdrawal. v0.11.2 Also the cap on how much harder or easier a tribulation can get, and whether players may hold back an automatic breakthrough.Yes
ReincarnationConfig.jsonThe alternate capstone: give up realms early for a lineage-wide bloodline bonus.Yes
GrandDaoConfig.jsonThe breadth-mastery capstone.Yes
CelestialConfig.jsonServer-wide celestial events.Yes
QiDeviationConfig.jsonThe lingering Qi Deviation affliction, and the risk of rushing a rank-up.Yes
MeridianConfig.jsonThe six Meridian Injuries.No
OathConfig.jsonHeavenly Oaths and the Dao-Heart Flaw.Yes
TeaConfig.jsonThe two-player Tea Ceremony.Yes
BodyTemperingConfig.jsonThe second ladder, climbed by taking hits, and the protection score.Yes
LifespanConfig.jsonThe optional online-play-hour budget.Yes
RaceSystemConfig.jsonCross-race server behavior.Yes
SkillTreeConfig.jsonSkill points and respec.Yes
DivinationConfig.jsonThe /divine oracle.No
SolarTermConfig.jsonThe five-term wall-clock calendar.No
ReclusiveConfig.jsonThe solo-server preset.Yes
RetreatConfig.jsonClosed-Door Retreat.Yes
CompassConfig.jsonThe Progression Compass.Yes
RevealConfig.jsonProgressive Reveal: which systems stay hidden until a realm is reached.Yes
CampaignConfig.jsonThe five-chapter narrative campaign.Yes
DreamTrialConfig.jsonThe Hollow Mirror ordeal.Yes
InnerDemonConfig.jsonThe Inner Demon rival duel.No
CleanseRiteConfig.jsonThe Marrow-Cleansing Rite that cures an injury.No

Arts/

FileControlsIn-game editor
DaoConfig.jsonThe Elemental Dao and the Yin-Yang balance meter.Yes
DaoComprehensionConfig.jsonThe Heavenly Dao track, Personal Daos and Dao Enlightenment.Yes
TechniqueConfig.jsonThe active arts: per-technique rules, mastery and fusion. v0.11.2 Five new rules: Aura Sight, Pressure, Pressure Burst and the two soul arts.Yes
AuraPressureConfig.jsonv0.11.2 Aura Sight (reading a cultivator by rank gap) and Pressure (the weight of a realm, and its burst).Yes
CombatDepthConfig.jsonTechnique interrupts, punish windows and the Wu Xing PvP reward.No
FistConfig.jsonThe fist art, climbed by striking with bare hands.No
DaoSealConfig.jsonv0.11.1 The ten Dao Seal runes: realm floors, Qi costs, resonance and the Wu Xing reactions.Yes
DaoDomainConfig.jsonv0.11.1 The Dao Domain a Nascent Soul cultivator unfolds: three tiers, allies, bonuses and clashes, plus the domains of bosses and allied-domain resonance.Yes
ManualConfig.jsonLootable cultivation manuals. v0.11.2 Two soul-art manuals added.Yes
AlchemyConfig.jsonThe Pill Cauldron ritual, pill grades, mastery and the pills' effects.Yes
TalismanConfig.jsonThe Talisman Desk ritual, grades and mastery.Yes
ForgingConfig.jsonThe Forge ritual that tempers weapons and armor tier by tier.Yes
HearthConfig.jsonThe Spirit Hearth and its cooking effects.No
ForageConfig.jsonWild forage plants scattered through the world.No
HerbScatterConfig.jsonWild Spirit Herb bush scatter.No
RefinementConfig.jsonWeapon refinement in tribulation lightning.Yes
LifeBoundConfig.jsonLife-Bound Treasures that level from combat.Yes
WeaponSpiritConfig.jsonWeapon Spirits awakened in refined Life-Bound treasures.Yes
BeastConfig.jsonSpirit Beast companions: taming, growth and species.Yes
BreedingConfig.jsonSpirit beast breeding and eggs.Yes

Society/

FileControlsIn-game editor
SectConfig.jsonSects: membership, halls, the sect Qi bonus, buildings and the sect economy. v0.11.2 Halls on any land, the spawn no-claim radius and the sect vein overlay.Yes
RetainerConfig.jsonv0.11.2 Retainers: hiring, wages, growth, defeat, posts, rogue yields and their bodies.Yes
DeathPenaltyConfig.jsonv0.11.2 What dying costs in Qi: the strike ladder, demotion and the exemptions.Yes
MarketConfig.jsonThe Auction House and the Traveling Merchant.Yes
MeritConfig.jsonThe Merit axis, earned through service.No
FormationConfig.jsonPlaceable formations that extend territory control.Yes
DwellingConfig.jsonCave Abodes, Spirit Springs and Spirit Fields.Yes
WarConfig.jsonSect vein wars and sieges.Yes
GuardianConfig.jsonSect Guardian puppets stationed at a hall.No
SectArrayConfig.jsonv0.11.1 The Sect Array Domain: a sect's wartime ward over its claimed ground.Yes
SermonConfig.jsonDao Sermon.No
WeiqiConfig.jsonWeiqi (Go) between two players.Yes
SoulEscapeConfig.jsonNascent Soul Escape.Yes
RogueConfig.jsonRogue Cultivator NPCs.No
AllianceConfig.jsonInter-sect diplomacy: relations and rivalries.Yes
LandConfig.jsonLand protection on claimed ground.No
DuelConfig.jsonConsensual Qi-wager duels. v0.11.2 Duel-Default-Lethal (no editor row).Yes
DaoDuelConfig.jsonElemental Dao Duels with Spirit Stone wagers.No
DaoDuelTournamentConfig.jsonThe server-wide Dao Duel Tournament.No
WagerConfig.jsonSpectator wagers on tournament matches.No
LegacyConfig.jsonCultivation Legacy: passing a breakthrough buff to an heir.No
PartnerConfig.jsonPartnered Cultivation (needs the Marriage mod).Yes
MasterDiscipleConfig.jsonMaster-Disciple bonds.Yes
DaoInheritanceConfig.jsonThe Dao Inheritance web and rival-house stakes.No
TournamentConfig.jsonThe sect tournament.Yes
GrandTournamentConfig.jsonThe server-wide Grand Tournament, a separate bracket from the Dao Duel Tournament. v0.11.1 Now live: an admin opens it with /cultivation duel opengrandtournament, players join with /cultivation duel grandtournament register, and Grand-Tournament-Interval-Hours opens it on a timer (0, the default, is off).No
SecretRealmConfig.jsonSecret Realms: timed, discoverable sites.Yes
DepthsConfig.jsonSecret Realm Depths, the solo escalating run.No
TideConfig.jsonThe Beast Tide event and its rewards.Yes
WorldBossConfig.jsonThe Calamity Beast world boss.No
PathWarConfig.jsonPath War, the Righteous versus Devil contest.Yes
SeasonConfig.jsonThe Seasonal Cycle and Hall of Fame.Yes
RiftConfig.jsonThe Void Rift world event.No
BreachRewardConfig.jsonv0.11.1 What the Goblin Breach, Goblin Coffer and Voidtaken Hunt events and dungeon bosses pay the players who fought them.Yes
DungeonConfig.jsonParty dungeons: entrance, sizing, timeout, rewards and the boss.Yes
HeavenlyRealmConfig.jsonThe Heavenly Realm.Yes
SeaOfConsciousnessConfig.jsonThe per-player Sea of Consciousness.No
ArrayConfig.jsonThe Transmission Array network.Yes
RivalConfig.jsonWandering Rival Cultivators and Nemesis.Yes
TreasureConfig.jsonBuried Caches and Ruin Vaults.Yes
PagodaConfig.jsonThe Trial Pagoda.No
BountyConfig.jsonThe Bounty Board.No
LeaderboardConfig.jsonThe /top and Rankings leaderboard.No
DaoMasteryConfig.jsonThe Dao Mastery leaderboard score.No
QuestConfig.jsonWandering-NPC quest lines.Yes
PartyConfig.jsonAd-hoc parties.Yes
FactionConfig.jsonNPC factions and reputation.Yes

World/

v0.11.2 A new folder, for the Rare Places.

FileControlsIn-game editor
StructureConfig.jsonWhere and how often each rare structure generates: on/off, chance, grid cell, minimum spacing, zones and height.Yes
SpiritMineConfig.jsonThe Spirit Stone Mine: grades, Qi reserve, crystal regrowth, the collapse and the sect claim.Yes
SwordTombConfig.jsonThe Sword Tomb: pulling swords, the sword spirit's trial and the bond.Yes
FallenCaveConfig.jsonThe Fallen Cultivator's Cave: the seal's offering, the legacy and the remnant soul.Yes
TribulationCraterConfig.jsonThe Tribulation Crater: the softer tribulation and the Thunder Residue regrowth.Yes
PillFurnaceConfig.jsonThe Ancient Pill Furnace: the refining bonus and the herb garden.Yes

Compatibility/

FileControlsIn-game editor
EndlessLevelingConfig.jsonHow Cultivation shares the stats it raises with Endless Leveling. Inert unless that mod is installed.Yes

Race/

FileControlsIn-game editor
Human.jsonThe Human race: unlock realm and stat bonuses.No
Demon.jsonThe Demon race.No
Deity.jsonThe Deity race.No

Data/

The 56 files in Data/ are save state, not settings. Data Files says what each one stores and what deleting it costs.

Where to start

mods/
Siren_Cultivation/

Config.json
the Qi curve

Cultivation/
gaining and spending Qi

Arts/
daos, techniques, crafts

Society/
sects, land, conflict

Race/
per-race stats

World/
rare structures

Data/
save state, do not edit