Configuration/Society Configs·

Society Configs

The five files in mods/Siren_Cultivation/Society/ cover everything that only matters because other cultivators exist - the Sects they gather into, the Formations they inscribe on ground they hold, the Cave Abodes they retreat to, the Sect Wars they fight over halls, and the Duels they stake Qi on.

Sect Config

Sect rosters, halls, and the sect-wide Qi bonus, found in the path mods/Siren_Cultivation/Society/SectConfig.json.

Variable NameDefault ValueDescription
"ConfigName""Sect Config"The name given to this config file.
"ConfigVersion"4Current Version when you have loaded for the plugin.
"Sects-Enabled"trueMaster toggle for the whole sect system.
"Description-Sects-Enabled"A long string explaining the value above.When false every /sect command refuses politely, the sect Qi bonus stops applying, and sects vanish from the rankings - but existing sect data is kept on disk untouched for if you re-enable.
"Sect-Max-Members"12Caps each sect's roster, leader included.
"Sect-Hall-Min-Vein-Tier"1The minimum Spirit Vein quality a chunk must have rolled for /sect claim to succeed there. 1 = rich veins and above, 2 = dragon veins only. Normal chunks can never host a hall.
"Description-Sect-Hall"A long string explaining the values above.Restates the roster cap and vein tier gate, and notes that a sect holds one hall - claiming again moves it.
"Sect-Hall-Beacon-Enabled"trueThe standing column of light over every claimed sect hall, visible to anyone walking past - not just members. Switching it off does not remove the hall's pin on the world map.
"Sect-Hall-Beacon-Interval-Seconds"2.5How often the beacon re-pulses at the hall. The banner particle assets are sized to burn out inside one interval.
"Description-Sect-Hall-Beacon"A long string explaining the values above.Notes that a sect's leader or elders can color the light by flying a banner with /sect banner, and that losing the hall to a siege drops the light back to the vein's own.
"Sect-Qi-Bonus-Percent-Rich-Hall"5.0Percent extra Qi from all sources every member gains while the sect's hall sits on a rich vein.
"Sect-Qi-Bonus-Percent-Dragon-Hall"8.0The same bonus for a hall on a dragon vein.
"Description-Sect-Qi-Bonus"A long string explaining the values above.The bonus applies server-wide to every member wherever they are, and a sect with no hall gets nothing - the hall is the point.
"Sect-Invite-Expiry-Seconds"300How long a pending sect invite stays open before it lapses.
"Sect-Inscription-Enabled"trueWhether a leader may carve a technique manual into their hall, lending that art to every member.
"Description-Sect-Inscription"A long string explaining the value above.A leader standing in their hall consumes a technique manual with /sect inscribe; every member then knows that art for exactly as long as the sect HOLDS the hall. Only one may be inscribed at a time, and only technique manuals work - skill-tree manuals grant permanent nodes and cannot be lent out.

The sect Dao, shared progression and buildings

See The Sect Dao, Shared Progression and Sect Buildings.

Variable NameDefault ValueDescription
Sect-Dao-EnabledtrueWhether a sect may name a Dao at all.
Sect-Dao-Matched-Multiplier1.3Qi gained on sect ground when the cultivator already walks its element.
Sect-Dao-Ambient-Multiplier1.1Qi gained on sect ground when they do not.
Sect-Dao-Affinity-Interval-Seconds8How often meditating there pulls affinity toward the sect's element.
Sect-Dao-Affinity-Per-Interval2.5How much it pulls. Deliberately stronger than terrain's 1.5 per 10s.
Sect-Buildings-EnabledtrueWhole-system switch for holdings beyond the hall.
Sect-Xp-Per-Member-Advancement10Sect XP banked when a member advances a stage.
Sect-Xp-Per-Member-Breakthrough60Sect XP banked when a member breaks through a realm.
Sect-Level-Base-Xp200Cost of level 2; level N costs this × growth(N−1).
Sect-Level-Growth-Rate1.6How steeply each sect level costs more than the last.
Sect-Buildings-Per-Level1Building slots granted per sect level.
Sect-Buildings-Max6Hard ceiling on holdings, however high the sect climbs.
Sect-Building-Types6 entriesEach carries Id, MeditationMultiplier, RequiredSectLevel and DaoActiveByDefault.

DaoActiveByDefault is the one to think about: false makes that kind of building neutral ground, so a member who walks a different element can cultivate there untouched. It is why Guest Court, Alchemy Garden and Forge ship as false. Players can toggle any individual building afterwards with /sect building dao.

The sect economy

New in 0.8.0. See Contribution Points, The Pavilion and The Mission Board.

Variable NameDefault ValueDescription
Sect-Contribution-Per-Spirit-Stone5.0Contribution points banked per Spirit Stone handed over with /sect donate.
Sect-Pavilion-EnabledtrueMaster toggle for the pavilion. What is on a given shelf is each Patriarch's own configuration, not server tuning, so it lives on the sect rather than here.
Sect-Missions-EnabledtrueMaster toggle for the mission board.
Sect-Mission-Types4 entriesThe board itself - shared by every sect on the server. Each carries Id, Metric, TargetItemId, TargetCount, RewardContribution, MinRank and CooldownHours.

Metric is a free string, not a closed enum. Four are credited by this mod's own hooks — gather_item, slay_beast, meditate_seconds and win_duel — but an add-on may credit any string of its own through MissionManager.creditProgress and list a mission naming it. TargetItemId only matters for gather_item, which is the one metric with no passive hook and so needs /sect mission deposit. An Id may not contain :, ; or | — those are the delimiters the persisted progress rows use.

Formation Config

The three placeable spirit arrays, found in the path mods/Siren_Cultivation/Society/FormationConfig.json.

Variable NameDefault ValueDescription
"ConfigName""Formation Config"The name given to this config file.
"ConfigVersion"1Current Version when you have loaded for the plugin.
"Formations-Enabled"trueMaster toggle for the whole formation system.
"Max-Formations-Per-Controller"3How many formations one controller - a sect, or a soloist by UUID - may hold placed at once. Placing while at the cap is refused.
"Description-Formations"A long string explaining the values above.A formation is placed by using its Flag item while standing in a chunk, anchors to that chunk with a square (Chebyshev) radius, and is controlled by the placer's sect if they have one, otherwise personally. Using the same Flag again on a chunk you already control that type at removes it.
"QiGathering-Radius-Chunks"2Square radius, in chunks, of the Qi-Gathering formation (聚灵阵).
"QiGathering-Regen-Multiplier"1.4Multiplies meditation Qi regen for its controllers inside that radius.
"QiGathering-Benefits-Everyone"falseIf true, any meditator in range benefits rather than only the controllers.
"Description-QiGathering"A long string explaining the values above.Restates who benefits by default (the sect's members, or the personal owner) and what the everyone toggle changes.
"Warding-Radius-Chunks"2Square radius, in chunks, of the Warding formation (护山大阵).
"Warding-Outsider-Regen-Multiplier"0.25Multiplies meditation Qi regen for OUTSIDERS inside that radius. Controllers are unaffected.
"Description-Warding"A long string explaining the values above.Adds that outsiders also cannot place their own formations on a warded chunk.
"Trapping-Radius-Chunks"1Square radius, in chunks, of the Trapping formation (困仙阵).
"Trapping-Interval-Seconds"3.0How often the trap fires on intruders inside that radius.
"Trapping-Damage-Percent-Of-Max-Health"4.0Percent of max health each trap tick deals, through the normal damage pipeline so armor and reductions apply.
"Trapping-Debuff-Effect""Root"A vanilla EntityEffect asset id applied each tick. Real options include Root, Slow, Stun, and Poison. Leave blank to skip the debuff.
"Trapping-Debuff-Duration-Seconds"2.5How long that effect lasts per tick.
"Trapping-Lethal"falseOff by default - a trap wounds and roots intruders but leaves them a sliver of health, so they must flee its bounds. Set true to let it finish off a persistent trespasser.
"Description-Trapping"A long string explaining the values above.The full trap tick: who it fires on, what it applies, that controllers pass through freely, and what the lethality toggle changes.

Dwelling Config

Cave Abodes (洞府), their Spirit Springs, their upkeep, and closed-door seclusion, found in the path mods/Siren_Cultivation/Society/DwellingConfig.json.

Variable NameDefault ValueDescription
"ConfigName""Dwelling Config"The name given to this config file.
"ConfigVersion"3Current Version when you have loaded for the plugin.
"Dwellings-Enabled"trueMaster toggle for Cave Abodes.
"Dwelling-Radius-Chunks"1Square (Chebyshev) radius in chunks around the claimed chunk. 1 = a 3x3 chunk pocket, which is the "cave" an abode is meant to be.
"Dwelling-Owner-Regen-Multiplier"1.25Meditation Qi multiplier for the owner inside their own abode.
"Dwelling-Outsider-Regen-Multiplier"0.5Meditation Qi multiplier for anyone who does not belong there.
"Description-Dwellings"A long string explaining the values above.Claiming with /cultivation abode claim, one abode per cultivator, both regen multipliers, and that outsiders cannot inscribe formations on its ground.
"Spring-Qi-Per-Hour"60.0Qi the Spirit Spring gathers per real-world hour, online or not.
"Spring-Rich-Vein-Multiplier"1.5Multiplies that rate when the abode sits on a rich Spirit Vein.
"Spring-Dragon-Vein-Multiplier"2.5Multiplies that rate when it sits on a dragon vein.
"Spring-Pool-Base-Cap"500.0Base ceiling on the banked pool.
"Spring-Pool-Cap-Per-Realm"250.0Added to that ceiling per realm the owner has reached.
"Description-Spring"A long string explaining the values above.The spring fills whether or not the owner is online but overflows and wastes anything past the cap, and the pool must be collected in person with /cultivation abode collect while standing inside.
"Upkeep-Enabled"trueWhether an abode must be fed at all. False makes abodes permanent and free.
"Upkeep-Item-Hours""Cultivation_SpiritStone:24,Cultivation_DivineCore:36,Cultivation_ProfoundCore:12,Cultivation_SpiritCore:4,Cultivation_QiGatheringPill:6,Cultivation_ClarityPill:6,Cultivation_TribulationWardPill:8,Cultivation_ClearMindPill:8"Comma-separated itemId:hours tribute pairs. Anything not listed here is refused as tribute, so a server owner can add their own currency simply by naming it.
"Upkeep-Initial-Free-Hours"0.0Upkeep a newly claimed abode starts with. Zero on purpose: any non-zero grant is re-granted on every new claim, so raising it lets a player abandon and re-claim in a loop to dwell for free.
"Upkeep-Max-Banked-Hours"720.0The most upkeep an abode may hold banked at once.
"Upkeep-Grace-Hours"168.0How long after upkeep runs out before the claim is released entirely and the banked pool is lost.
"Description-Upkeep"A long string explaining the values above.Depositing tribute, the initial-grant exploit warning, the bank cap, and the two-stage lapse - the spring stops immediately, the claim releases after grace. A sect hall's spring is never released this way; it simply stops gathering until fed.
"Sect-Hall-Spring-Enabled"trueWhether a sect's claimed hall grows its own shared Spirit Spring, on top of every member's personal abode.
"Sect-Spring-Rate-Multiplier"1.5How much faster the hall's spring gathers than a personal one.
"Sect-Spring-Pool-Cap-Multiplier"2.0How much deeper the hall's pool is than a personal one.
"Description-SectSpring"A long string explaining the values above.A hall spring is collectable by ANY member standing in the hall - first there takes it - follows the hall when it moves, passes to the victor of a siege, and takes upkeep like a personal abode.
"SpiritStone-Kill-Drop-Chance"0.04Chance a Spirit Stone (灵石) drops when a cultivator slays a creature, rolled independently of the cultivation-core roll so a kill can yield both.
"SpiritStone-Tribulation-Drop-Chance"0.35Chance a Spirit Stone drops when a cultivator SURVIVES a tribulation strike.
"Description-SpiritStone"A long string explaining the values above.Spirit Stones are the currency abodes are sustained with, and the tribulation drop is framed as the heavens' lightning crystallizing the Qi it scatters.
"Seclusion-Enabled"trueMaster toggle for closed-door seclusion (闭关).
"Seclusion-Qi-Per-Hour"25.0Qi gathered per real-world hour while secluded offline, credited on next login. Deliberately well below what sitting awake earns.
"Seclusion-Max-Hours"24.0The most hours of any one absence that count.
"Seclusion-Drains-Spring"trueWith this on, secluded Qi is DRAWN FROM the abode's spring rather than conjured, so seclusion and collecting the pool compete for the same reserve and an abode cannot pay out twice for the same hours.
"Description-Seclusion"A long string explaining the values above.Begin meditating inside your own abode (or your sect's hall) and log out to enter seclusion. It requires upkeep to still be paid, is capped per absence, and exists so a cultivator who cannot sit for forty minutes still advances.
"Fields-Enabled"trueMaster toggle for Spirit Field plots. One plot per abode.
"Field-Herbs-Per-Hour"0.5Spirit Herb progress accrued per real-world hour, online or not.
"Field-Rich-Vein-Multiplier"1.6Yield multiplier on a rich vein.
"Field-Dragon-Vein-Multiplier"2.5Yield multiplier on a dragon vein.
"Field-Pool-Cap"8.0The flat ceiling a plot may accrue to before it stops.
"Herb-Quality-Normal-Base"0.35Quality stamped on a herb harvested over a common vein.
"Herb-Quality-Rich-Base"0.6Over a rich vein.
"Herb-Quality-Dragon-Base"0.9Over a dragon vein. Quality is read at harvest time, not planting time.
"Herb-Quality-Formation-Bonus-Scale"0.5How much a Qi-Gathering formation over the chunk adds - it lifts quality as well as yield, which is new in 0.8.0.
"Description-Fields"A long string explaining the values above.Notes that a plot only accrues while upkeep is sustained and is dropped if the abode lapses, the same self-healing rule Dwellings applies to itself, and that the quality feeds directly into the Pill Cauldron's grade roll.

Master-Disciple Config

The Master-Disciple bond, found in the path mods/Siren_Cultivation/Society/MasterDiscipleConfig.json. JSON-only - not in the in-game editor yet.

Variable NameDefault ValueDescription
"ConfigName""Master Disciple Config"The name given to this config file.
"ConfigVersion"1Current Version when you have loaded for the plugin.
"Master-Disciple-Enabled"trueMaster toggle for the whole system.
"Bond-Min-Realm-Gap"2How many realms the master's must lead the disciple's by.
"Bond-Max-Disciples-Per-Master"3The cap on one master's disciples. A disciple always has exactly one master.
"Bond-Radius-Blocks"8.0How close the two must meditate for the shared bonus - and the radius Qi Deviation's companion cure uses for this bond.
"Bond-Qi-Multiplier"1.15The multiplier both of them draw while meditating together. Multiplies with every other source.
"Bond-Offer-Expiry-Seconds"120.0How long an unanswered offer of apprenticeship stays open.
"Bond-Teach-Cooldown-Hours"24.0How often a master may teach that disciple an art.
"Bond-Dissolve-Cooldown-Hours"1.0How long both parties are barred from a new bond after dissolving one.
"Bond-Breakthrough-Qi-Reward-Base"15.0Qi credited to the master when their disciple breaks through, scaled by the new realm.
"Bond-Breakthrough-Sect-Contribution-Enabled"trueWhether that breakthrough also feeds the master's own sect progression.
"Description-Master-Disciple"A long string explaining the values above.The whole flow: offer, accept, the realm gap and capacity rules, shared meditation, teaching, the breakthrough credit, and dissolving.

Tournament Config

Sect tournaments, found in the path mods/Siren_Cultivation/Society/TournamentConfig.json. JSON-only.

Variable NameDefault ValueDescription
"ConfigName""Tournament Config"The name given to this config file.
"ConfigVersion"1Current Version when you have loaded for the plugin.
"Tournaments-Enabled"trueMaster toggle for /sect tournament.
"Tournament-Min-Entrants"2The fewest online members a start requires - a tournament of one crowns nobody.
"Tournament-Champion-Contribution"150Contribution paid to the champion, who may also wear the Tournament Champion title.
"Tournament-Manual-Cooldown-Hours"4.0Rate limit on a Patriarch's own /sect tournament start.
"Tournament-Auto-Start-Enabled"falseWhether tournaments also run automatically on a clock.
"Tournament-Auto-Start-Interval-Hours"24.0That clock, when auto-start is on.
"Description-Tournaments"A long string explaining the values above.Notes there is no signup step, that each pair runs as a real duel at a 0 Qi wager, and how a mid-match disconnect is resolved.

Secret Realm Config

Secret Realms, found in the path mods/Siren_Cultivation/Society/SecretRealmConfig.json. JSON-only.

Variable NameDefault ValueDescription
"ConfigName""Secret Realm Config"The name given to this config file.
"ConfigVersion"1Current Version when you have loaded for the plugin.
"Realm-Enabled"trueMaster toggle for the whole system.
"Realm-Presence-Tick-Interval-Seconds"2.0How often the mod re-reads who is inside a realm.
"Realm-Schedule-Tick-Interval-Seconds"30.0How often it re-reads whether one should open or close.
"Schedule-Enabled"trueWhether the heavens open realms on their own.
"Schedule-Interval-Min-Minutes"120.0Lower bound of the band a new site is rolled in.
"Schedule-Interval-Max-Minutes"240.0Upper bound. A random point in the band, so it never feels metronomic.
"Schedule-Anchor-Min-Radius-Chunks"8Closest a scheduled realm anchors to a randomly chosen online player.
"Schedule-Anchor-Max-Radius-Chunks"24Furthest. Rolls landing on claimed or warded ground are retried.
"Max-Concurrent-Per-World"1How many realms may stand open in one world at once.
"Fragment-Enabled"trueWhether a Realm Map Fragment may tear one open.
"Fragment-Kill-Drop-Chance"0.003Chance a creature kill anywhere drops a fragment.
"Fragment-Restricted-To-Opener-Sect"falseWhether a fragment-opened realm admits only the opener's sect. Off, because a found realm is meant to be a shared discovery.
"Radius-Chunks"3The realm's Chebyshev footprint - a 7 × 7 chunk square.
"Duration-Minutes"45.0How long it stays open.
"Warning-Seconds"60.0How long before sealing everyone inside is warned, once.
"Grace-Seconds"30.0How long after sealing stragglers are walked out to the boundary rather than yanked out of where they stood.
"Min-Entry-Realm"2The realm floor to set foot inside. 2 is Foundation Establishment.
"Visitor-Permissions""interact,entities"What every visitor may do - there is no owner tier, since nobody owns a realm. all opens it completely; blank forbids everything but standing there.
"Qi-Multiplier"1.75How much better meditating inside is. Stacks with the vein tier, formations, abodes and sect halls rather than replacing them.
"Beast-Count-Min"4Fewest wild beasts stocked, once, on first entry.
"Beast-Count-Max"7Most. They are ordinary tameable NPCs and are not despawned when the realm closes.
"Beast-Min-Species-Realm"2Filters the roster to its rarer, stronger half.
"Manual-Bonus-Drop-Chance"0.05An extra manual roll, on top of the ordinary table, for a kill landed inside.
"Announce-Enabled"trueServer-wide broadcast and a world-map marker whenever one opens.
"Atmosphere-Weather-Id""Cultivation_SecretRealm"The per-player sky pushed to visitors, restored the moment they leave.
"Atmosphere-Transition-Seconds"3.0How long that blend takes, each way.
"Description-Realm" / "-Schedule" / "-Fragment" / "-Lifecycle" / "-Entry" / "-Qi" / "-Beasts" / "-Loot" / "-Atmosphere"Long strings explaining the values above.Nine separate documentation blocks, one per group.

War Config

Sect sieges over rival halls, found in the path mods/Siren_Cultivation/Society/WarConfig.json.

Variable NameDefault ValueDescription
"ConfigName""War Config"The name given to this config file.
"ConfigVersion"2Current Version when you have loaded for the plugin.
"Wars-Enabled"trueMaster toggle for sect wars.
"War-Required-Hold-Seconds"120.0Total seconds an attacker must hold the contested hall chunk, uncontested, within the window to capture it.
"War-Window-Seconds"600.0How long the siege stays open from declaration. If the hold is not reached in time the siege fails.
"War-Defender-Grace-Seconds"8.0A defender seen at the hall pauses hold accrual for this long afterward.
"War-Cooldown-Hours"24.0Real-world hours the defender sect is immune from further sieges after a war, win or lose.
"War-Requires-Defender-Online"trueOffline protection - a sect with nobody online cannot be besieged.
"Description-Wars"A long string explaining the values above.The full siege loop: declaration, the open window, hold accrual while no defender is present, capture transferring the hall, failure at the window's end, and the cooldown either way. Notes that the defender's own Warding and Trapping formations naturally hinder attackers.

Partner Config

Partnered Cultivation (双修) between married cultivators, found in the path mods/Siren_Cultivation/Society/PartnerConfig.json. Requires the Marriage mod — see Partnered Cultivation.

Variable NameDefault ValueDescription
"ConfigName""Partner Config"The name given to this config file.
"ConfigVersion"1Current Version when you have loaded for the plugin.
"Partnered-Cultivation-Enabled"trueMaster toggle. Inert anyway without the Marriage mod installed.
"Partner-Radius-Blocks"8.0How close two married cultivators must sit for a session to take.
"Partner-Qi-Multiplier"1.25Qi multiplier each partner draws with. Multiplies with the vein tier, weather resonance, formations, the abode and a Gatherer beast, so it compounds rather than replacing them.
"Partner-Unlock-Realm""BODY_REFINEMENT"Realm required to partner at all. The default is no gate in practice.
"Partner-Convergence-Enabled"trueWhether the two partners' Yin-Yang balances pull toward one another.
"Partner-Convergence-Shift-Per-Tick"0.2How hard each partner is pulled toward the other per tick. Matches Dao-Config's own meditation alignment shift.
"Partner-Convergence-Deadzone-Percent"1.0Gap in Yin percent below which neither shifts, so a settled couple does not oscillate.
"Description-Partner"A long string explaining the values above.The whole feature: that it requires the Marriage mod, the four conditions a session needs, what the multiplier compounds with, and how the convergence behaves.

Duel Config

Qi-wagered duels between cultivators, found in the path mods/Siren_Cultivation/Society/DuelConfig.json.

Variable NameDefault ValueDescription
"ConfigName""Duel Config"The name given to this config file.
"ConfigVersion"3Current Version when you have loaded for the plugin.
"Duels-Enabled"trueMaster toggle for /cultivation duel.
"Duel-Challenge-Expiry-Seconds"60.0How long an unanswered challenge stays open.
"Duel-Max-Wager"0The largest banked Qi a player may stake on a single duel. 0 means uncapped.
"Duel-Overrides-World-Pvp"trueWhether an accepted duel may exchange blows on a world with PvP switched off. A duel is mutual, staked consent, so this defaults on - and it only ever lets the two duelists hit each other, only while the duel is live, and never through spawn protection or invulnerability.
"Duel-Max-Duration-Seconds"600.0How long a live duel may run before it is voided with no wager changing hands. A backstop against duels that can never be decided. 0 disables the timeout.
"Description-Duels"A long string explaining the values above.The whole duel flow: challenge and wager, expiry, how a duel is decided and what the loser forfeits, exactly what the PvP override does and does not permit, and that a duel whose participant logs out is voided the same way as one that times out.

Tide Config

New in 0.9.0. Beast Tide (兽潮) events - the lethal toggle, the wave interval, wave count and spacing, the beacon's max health, the boss lord's scale multiplier, integrity costs, and the Qi reward or penalty for a defender's contribution to a win or a loss, found in the path mods/Siren_Cultivation/Society/TideConfig.json. See Beast Tide.

Market Config

New in 0.9.0. The Auction House - off by default, the max listings and max price per player, the cut taken on a sale, and how long an unsold listing sits before it expires, found in the path mods/Siren_Cultivation/Society/MarketConfig.json. See Auction House and Commands.

Bounty Config

New in 0.9.0. The Bounty Board - its size, how often it rotates, the most contracts a cultivator may hold at once, the target-count range rolled for each archetype, the Qi, pill-chance and manual-chance a completed contract rewards, and how long a claimed contract is retained, found in the path mods/Siren_Cultivation/Society/BountyConfig.json. See Bounty Board and Commands.

Oath Config

New in 0.9.0. The Heavenly Oath (天道誓言) - offer expiry and cooldowns, the wager cap, the breach penalty (Qi lost, karma gained), the Dao-Heart Flaw's duration and severity, and the cure-speed bonus for being near the bonded party, found in the path mods/Siren_Cultivation/Cultivation/OathConfig.json - outside the Society/ folder the rest of this page covers, since the oath sits alongside the core progression files rather than under Society/. See Heavenly Oath and Commands.