Celestial Events

A Celestial Event (天象) is a phenomenon the whole server shares. One runs at a time, chosen at random after a quiet interval, each with a sky of its own and a rule of its own. Nobody triggers them and nobody owns them — the heavens keep their own schedule, and /celestial tells you what is overhead and how long is left.

The roster

Seven events share the one celestial slot. Five are drawn by the scheduler; two are started by their own systems and merely borrow the slot, so the sky and the one-at-a-time rule apply to them too.

The schedule

After each event ends — or after boot, if none is running yet — the scheduler waits a random point in that band, then starts one, chosen at random weighted by each event's own Weight among those currently enabled. Only one event runs at a time. Beast Tide and the Calamity Beast's omen carry a weight of 0, so the draw never picks them; they start from their own timers and hold the slot while they run.

A paid Divination reading, /divine heavens, can name the event the scheduler has already settled on next, and sometimes the boss that rides with it.

Spirit Tide

灵潮 — every Spirit Vein on the server regenerates 2.5× faster for fifteen minutes.

A tide lifts every meditation spot at once rather than a favored few. It does not raise any chunk's tier or its ceiling — a common vein still caps where it always did, it simply refills toward that cap much faster. The practical effect is that a spot you had drained flat becomes worth sitting on again immediately, and a group all cultivating in the same region stops competing for the same vein.

Meteor Shower

流星 — some of the ground turns out to have been hit.

While a shower runs, roughly 3% of the chunks a cultivator meditates in turn out to hold a fallen meteor — that chunk's Spirit Vein is lifted to a rich vein holding 2,000 Qi for as long as the shower lasts, then settles back to whatever it truly was.

At 2,000 Qi a meteor site clears the 750 breakthrough bar with room to spare, which is the real prize: a shower can hand an ordinary patch of ground the one property it never had.

Blood Moon

血月 — the sky favors one road and turns against the other.

This applies in every fight, not only in fights between the two paths — against mobs, in duels, in a sect war, everywhere. A Blood Moon is the twelve minutes in which a demonic cultivator's grievances get settled.

It requires Path-Enabled in DaoConfig.json and reads whichever path the attacker currently walks. An unaligned cultivator — the mortal middle road — is unaffected in either direction. See Karma and the two paths.

Starfall Convergence

星陨汇聚 — a night sky thick with falling stars, read as an omen that favors sudden insight.

While it runs, both enlightenment rolls land twice as often: the roll for Dao Enlightenment and the roll that can teach you an art outright. It touches nothing else — no vein, no damage, no reward — so the practical advice is simply to meditate through it.

The multiplier stacks multiplicatively with the Reclusive Cultivator preset's own, rather than replacing it. The Dao roll is then held under Dao-Enlightenment-Chance-Max-Per-Roll, applied last, so a Starfall night on a Reclusive server still cannot push a single roll past that ceiling.

Heavenly Schism

The Righteous and Devil paths' contest comes with its own celestial window. For ten minutes every scored kill counts double and an opposed-path kill can resolve even on a PvP-off world; win the window and your side's meditation draws a standing Qi bonus. It is drawn by the scheduler like the four above (weight 0.6 by default) but is tuned in the Path War config, not here. Everything about it is on the Path War page.

Beast Tide

兽潮 — the wilds converge on a defended hall.

A Beast Tide is a siege: waves of creatures throw themselves at a sect hall or Cave Abode, capped by a boss "lord," until the site's defended beacon breaks or holds. It is non-lethal by default, and settles on the beacon's integrity — the defenders who hold it earn contribution, and a site that falls sees its Spirit Vein weakened for a time. See Beast Tide for the full mechanics.

Its warning phase is a celestial event in its own right: the sky changes while a tide is inbound. But the celestial scheduler never picks it. The tide chooses its own target and its own moment, and takes the slot only when nothing else is using it.

Calamity Beast

灾劫兽 — the same sky machinery, a different guest. A Calamity Beast is a wandering world boss, and the omen that announces it is registered with the scheduler as beast_omen: an ashen sky for a few minutes before the beast is on the ground. Like the Beast Tide it is never drawn by the scheduler. It rolls its own long wait, holds the slot for the length of its omen, and will not start while any other celestial event is running or due to begin. See Calamity Beast.

Event World Bosses

v0.10.1 Four of the mod's public celestial events now carry a real chance of manifesting their own themed boss the moment they begin — no Storm Omen-style opt-in, the sky itself is the warning:

• Blood Moon's own boss is both more likely to appear and pays out more than the others — the richest of the four, matching how much rarer and harsher that event already reads.
• A cultivator whose realm is not yet deep enough for the fight still lands every blow — their damage simply is not credited toward the reward, with one quiet notice rather than a wall stopping them outright.
• The existing Calamity Beast is completely unaffected by any of this. It still wins any collision with an event boss outright, and every one of its own numbers — health, reward, timing — is untouched.

An open registry

The events above are the shipped set, not the whole set. Celestial Events are an open registry: an add-on can hang another phenomenon off the same scheduler, the same weighted pick, the same sky-override machinery and the same /celestial output, without touching the mod. See Registries.

/celestial list prints every registered event and whether the scheduler may currently pick it — including Beast Tide and the Calamity Beast's omen, which never read as pickable, and anything an add-on contributed.

Tuning

Everything above except Heavenly Schism, Beast Tide and the Calamity Beast lives in CelestialConfig.json. Spirit Tide, Meteor Shower, Blood Moon and Starfall Convergence each have their own -Enabled, their own Weight in the random pick, their own duration, and their own -Weather field naming the Weather asset for its sky (blank uses the shipped one). Celestial-Enabled is the master switch. Heavenly Schism's window is tuned by the Path-War-Window-* keys in the Path War config, the Beast Tide's in TideConfig, and the Calamity Beast's in WorldBossConfig.