Admin and Config
This release has no in-world discovery path for flames yet — no loot table, no mining drop, no crafting recipe. Everything on this page is the distribution path right now: an admin's own hand, through the command below or the Players-tab row. See Getting Started for the full context.
The /heavenlyflame command
Aliases: /flame, /hflame.
| Command | Who | What |
|---|---|---|
/heavenlyflame | anyone | Reports the flame you carry — name, tier, description, and element if it has one. |
/heavenlyflame list | anyone | Every registered flame, ranked best to worst, with tier, element, and whether your server has disabled it. |
/heavenlyflame give <flame> | admin | Sets your own flame unconditionally. Aliases: set, grant. |
/heavenlyflame give player <flame> <player> | admin | Sets somebody else's flame unconditionally. |
/heavenlyflame clear | admin | Strips your own flame. Alias: revoke. |
/heavenlyflame clear player <player> | admin | Strips somebody else's flame. |
The bare command and list are open to everyone — they only report what already exists. Every form that changes a cultivator's flame is gated behind the cultivation.admin permission, the same node Cultivation's own admin tools use.
give is unconditional, unlike devouring an item. An admin naming a flame is stating what it should be — it does not check whether the named flame is an "upgrade" over what the target already holds, the way the devour-and-replace rule does.
The <flame> argument
<flame> is its own argument type, not a bare string — it tab-completes every registered flame (including one another add-on has registered) plus none, and rejects an unrecognized name at parse time rather than accepting a typo silently. Resolution is case- and punctuation-insensitive, the same as the flame ranking's own id lookup.
The Players-tab admin row
Cultivation's own admin panel gets a "Set Flame" row under the Players tab, registered the same way the config sections below are — Cultivation renders it generically and has no idea what a Heavenly Flame is.
The dropdown lists None first, then every registered flame best to worst, which doubles as a quick reference to the ranking while you pick. Selecting a flame and applying it runs through the exact same code path as /heavenlyflame give — one implementation behind both surfaces, so they can never drift apart or disagree about what "give" does.
The five admin config sections
Everything below lives in Cultivation's admin config menu, in game, with no restart required to change a number (only the mod's own load-time checks — manifest range, licence — need a restart to re-evaluate).
| Field | Default | What it does |
|---|---|---|
Heavenly-Flames-Enabled | true | Master switch. Off retires every flame: none can be devoured, and one already held grants nothing. |
Disabled-Flames | (empty) | Comma-separated flame ids that cannot be devoured and grant nothing to a cultivator who already holds one — prefer the checkboxes in Availability below for this. |
| Field | Default | What it does |
|---|---|---|
Tier-Multiplier-Mythic | 3.0 | Scales everything the Emperor Flame's perks grant. |
Tier-Multiplier-Legendary | 2.0 | |
Tier-Multiplier-Superior | 1.4 | |
Tier-Multiplier-Greater | 1.0 | |
Tier-Multiplier-Lesser | 0.6 | Scales the sixteen weakest flames — most of the roster. |
Each step down roughly halves the tier above's edge over Lesser rather than being evenly spaced, so the gap between "found a flame at all" and "found the flame" reads the way the source material treats it — while Superior and Greater still feel like a real, frequent difference day to day. Flatten these to make tier mostly cosmetic, or widen them to make the Emperor Flame the thing a whole server chases.
| Field | Default | What it does |
|---|---|---|
Qi-Gain-Base-Percent | 8 | Doubled automatically for QI2 (Emperor Flame only). |
Meditation-Qi-Base-Percent | 15 | |
Damage-Dealt-Base-Percent | 6 | |
Unarmed-Damage-Base-Percent | 10 | Applied on top of Damage-Dealt-Base-Percent, not instead of it. |
Damage-Taken-Reduction-Base-Percent | 6 | |
Fragility-Base-Percent | 6 | Extra damage taken — netted against Damage-Taken-Reduction-Base-Percent before applying. |
Charge-Speed-Base-Percent | 12 | Doubled automatically for CHARGE_BIG (Nine Dragon Lightning Flame only). |
Ritual-Ease-Base-Percent | 12 | Doubled automatically for RITUAL_BIG (Six Paths Reincarnation Flame only). |
Aura-Scale-Base-Percent | 15 | Cosmetic. Doubled automatically for AURA2 (Emperor Flame only). |
YinYang-Tolerance-Base-Percent | 20 | |
Yin-Resistance-Percent | 30 | How much less a shift toward Yin moves a flame with the YINRESIST perk. 100 would make it immovable. |
Dao-Affinity-Base-Percent | 12 | Granted automatically to every elemental flame for its own element — not a perk a flame opts into. |
All twelve rows here are the active base percents behind every channel on Stat Channels, each editable with an in-game tooltip explaining what it feeds.
| Field | Default | What it does |
|---|---|---|
Alchemy-Speed-Base-Percent-RESERVED | 10 | Not yet active. Cultivation has no per-player alchemy-speed hook to plug this into. Changing it does nothing right now. |
Alchemy-Success-Base-Percent-RESERVED | 5 | Not yet active. Same as above — reserved for a future patch, not read anywhere in this mod today. |
Both fields are clearly labeled inert in game as well as here — shipped now so a later Cultivation-side alchemy hook is a config wire-up rather than a fresh release, not because either does anything yet.
One checkbox per registered flame, built lazily off the open flame registry — so a flame another add-on contributes gets a checkbox here automatically, with nothing to configure by hand. Unchecking a flame retires it: it can no longer be devoured, and a cultivator who already holds it stops getting anything from it, without touching their save. This is the recommended way to trim the roster, in preference to hand-editing Disabled-Flames in the General section.
Version safety
Heavenly Flames checks in with xianxia.dev to confirm it is a genuine, current build, and reads the published compatibility list alongside that check — the same mechanism Jade Slip and Sacred Bodies use.
Unlike Jade Slip's purely cosmetic withdrawal, Heavenly Flames grants real gameplay, so a failed check follows Sacred Bodies' shape: it hands back the modifier source, the two Codex entries, all five admin config sections, and the Players-tab admin row, and says exactly why in the console. Nothing is deleted. Every cultivator who has devoured a flame keeps it on their own save — a held flame simply stops granting anything until the build is put right, and everything returns on the next restart once it is.
If a build has not been able to verify itself for 30 days, it withdraws on the assumption that something is wrong — the console starts warning 7 days out so an owner has notice rather than a surprise. An offline server is never stripped of anything on the strength of one failed request: only a positive "this build is not current" or "this pairing is published as incompatible" verdict withdraws anything, never silence.
What it needs
Cultivation v0.9.1 or newer — the manifest range stops an incompatible install before a line of this mod runs. Server-side only: your players install nothing.