Admin and Config

Everything a player can see is /sacredbody (alias /body) with no arguments — open to anyone, permission-wise, since it only reports what the caller already has. Everything that changes a constitution sits behind cultivation.admin, the same permission Cultivation's own admin tools use, so a server that already has admins configured needs no new grant. The same goes for everything that changes Heaven's Favored, the seasonal fortune the add-on also carries.

Commands

The admin config page

Every number this add-on uses is registered as a section of Cultivation's own in-game admin config editor — no separate menu, no restart, and no file edit required for a value that already exists. Only the rolling section also appears on Cultivation's Settings page; the rest are admin-page-only, so tuning forty-odd balance numbers doesn't turn the Settings page into a second admin page. A seventh section, Heaven's Favored, is also admin-page-only.

Rolling

The one section shown to owners outside the full admin page too.

Tiers

Tier-Weight-* and Tier-Multiplier-* for each of Legendary, King, Saint, and Immortal — see The Eight Physiques for what the defaults are and how the weighting works.

Shared

The bonuses every sacred body grants regardless of which one it is:

Bodies

Every per-body number from The Sixteen Bodies — Ancient-Damage-Reduction-Percent, Ancient-Yin-Resistance-Percent, Ancient-Balance-Tolerance-Percent, DaoFetus-Qi-Percent, DaoFetus-Ritual-Ease-Percent, DaoFetus-Charge-Time-Reduction-Percent, Firmament-Damage-Percent, Firmament-Unarmed-Damage-Percent, Elemental-Qi-Percent, Elemental-Dao-Affinity-Percent, Yin-Body-Yin-Shift-Percent, Yin-Body-Fragility-Percent, Yang-Body-Yang-Shift-Percent, Yang-Body-Lava-Qi-Percent, and Yang-Body-Immune-Damage-Causes — a free-text, comma-separated list of DamageCause asset ids the Yang Body cannot be hurt by (default Fire, Cultivation_Fire, Lava, Burn). An id that doesn't resolve to a real DamageCause is simply never matched, rather than erroring.

Physiques

Every per-physique number from The Eight Physiques — Tyrant-Damage-Percent, Tyrant-Fragility-Percent, YinYangEyes-Balance-Tolerance-Percent, SpiritSea-Qi-Percent, HundredMeridians-Charge-Time-Reduction-Percent, JadeBone-Damage-Reduction-Percent, WindlessStep-Stamina-Percent, HeavensBlindSpot-Ritual-Ease-Percent, and UndyingMarrow-Health — each expressed before its tier multiplier is applied.

Availability: per-body and per-physique checkboxes

Disabled-Bodies and Disabled-Physiques are comma-separated id lists on disk, but the admin page never asks an owner to type an id by hand — it renders one checkbox per sacred body and per physique instead, built dynamically from the same open registry the roll itself reads. That has a real consequence: because it's built from the live registry rather than a fixed list, a body or physique contributed by a different add-on gets a checkbox here automatically, without this add-on needing to know that add-on exists.

Unchecking one removes it from the roll pool immediately and, per the source's own documentation, "grants nothing to a cultivator who already has it" — but the row itself is not deleted from anyone's save, and it is not silently forgotten: an admin who tries to grant a disabled body or physique with /sacredbody set or /sacredbody physique add is warned that it currently does nothing, rather than being refused outright. That's deliberate — flipping a body off today and back on next month should restore it for everyone who was already holding it, with nothing to re-grant.

Heaven's Favored settings

Heaven's Favored keeps its numbers in a file of its own, HeavensFavoredConfig.json, and shows them as one admin-page section, Sacred Bodies: Heaven's Favored. Its ledger, who holds how much favor, the pinned decree, the pair cooldowns and the closed-season history, lives in Data/HeavensFavoredData.json and is not a setting. Every getter clamps its value into the range that is meaningful, so a typed 900% is shown back as its clamp.

For what the system does, see Heaven's Favored on the overview page.

The pick

What favor is worth

Taking it off somebody

None of this needs its own kill-farming guard: the event it listens on only fires for kills that already passed Cultivation's own Pk-Same-Victim-Cooldown-Seconds gate, and sanctioned duels are excluded outright.

The decree

The Child cannot accept a decree naming themselves, and cannot be credited for one, which closes the route of posting a contract on yourself and having a friend collect. Killing the Child still moves the favor whether or not the killer holds the contract.

What takes effect when

Every number above is read live, at the moment it matters — a modifier channel being asked, a roll being made — so nothing here needs a server restart. The one thing a config change cannot do is revisit a cultivator who has already had their one roll; that's what /sacredbody reroll is for, and it should be used with the same care described on Getting Started.

Compatibility

Sacred Bodies declares Siren:Cultivation: ">=0.11.0" (and ServerVersion: ">=0.7.2 <0.8.0", since 0.4.0 is built for Hytale Update 7; the build that ships beside Cultivation 0.11.1 asks for the 0.7.2 release server, with its version number unchanged) as a hard dependency in its manifest — a server running an older Cultivation is refused at load, before a line of this add-on's code runs. On top of that, it checks in with xianxia.dev to confirm it's a genuine, current build and reads the published compatibility list. If a future Cultivation release turns out to break this build, the add-on stands its modifier source and admin pages down and says exactly why in the console, rather than quietly mispricing combat — but it never touches a saved constitution. Every cultivator keeps the body and physiques they were born with, and everything resumes on the next boot once the versions match. It fails open in every direction: an offline server, or one behind a strict firewall, is never affected by a failed check.