Void Rift

A Void Rift (虚空裂隙) is a tear in the world that opens on its own, somewhere out in the wild, every hour or two. Creatures of the Void pour out of it in five waves, and when the last wave has landed a boss called the Warden steps through. Bring the Warden down before the rift collapses and everyone who fought is paid in Spirit Stones, Void Crystals and Qi.

Unlike a Beast Tide, a rift is not aimed at anyone's home. It opens in neutral ground, anyone may walk up and join the fight at any point, and what you earn depends on how much you contributed rather than on whose side you were on. It is also on by default (Rift-Enabled), so on a server with two or more players online it happens without anyone setting anything up.

When one opens

The server rolls a random wait between 60 and 120 minutes (Rift-Interval-Min-Minutes and -Max-Minutes) each time it starts. When the wait is up, it tries to open a rift. Whether it succeeds or one of the checks below says no, a fresh 60 to 120 minute wait begins afterward.

A rift opens only if all of these hold:

The "other big event" check waits for any running Celestial Event, any Beast Tide assault, and any live Calamity Beast. A rift never takes the shared celestial slot itself, so it does not change the sky and does not stop those events from starting while it is open.

Where

The server picks a random player who is online in an ordinary world (not the Heavenly Realm, not a Sea of Consciousness, not an instance such as a dungeon) and drops the rift somewhere between 90 and 220 blocks from them (Rift-Spawn-Min-Radius-Blocks and -Max-Radius-Blocks), on ground that is already loaded. A roll is thrown out if it lands near anyone's holdings: the rift keeps clear of sect ground, Cave Abodes, Secret Realm sites and land claims by Rift-Guard-Radius-Blocks (40) plus the 35-block reach of the biggest wave spawner. If every try fails, there is no rift this cycle.

How you find out

• Everyone in that world gets a chat line: A Void Rift tears open nearby! Push back its waves, then bring down the Warden before it seals. It goes to the whole world, not just to people close by.
• A violet Void Rift pin appears on the world map for the rift's whole life, from the moment it opens until it resolves, and shows no matter how short your render distance is.
• v0.11.1 For the first 30 seconds, that pin also pulses on the compass. See below.
• Rift-Announce-Server-Wide (off) adds a second, location-free line, A Void Rift has torn open somewhere in the world! v0.11.1 It now reaches players in every other world (before, it only ever reached the rift's own world, so turning it on did nothing). Players in the rift's own world still get only the loud local line, never both. The same switch covers the seal line, A Void Rift has been sealed - its Warden has fallen!, and the collapse line, A Void Rift has collapsed, unresolved.

The compass alert

v0.11.1 Hytale 0.7.2 lets a map pin ask the compass to flag it. For the first 30 seconds after a rift opens (Rift-Compass-Alert-Window-Seconds; 0 turns it off, and the game caps one alert at 30), everyone in the rift's world sees the pin carry a compass alert: tinted a brighter violet and pulsing on the compass. If the pin is out of view, the compass shows it at the nearest edge instead of hiding it. The pulse itself lasts up to 10 seconds and starts the first time the pin comes inside the compass's field of view, so it can outlast the window; if the pin never comes into view while the window runs, the alert is dropped. After that it is the ordinary pin again. The default window is the same length as the 30-second grace period, so the alert covers the time you have to get ready.

The fight

Waves get harder, both in what they send and in how big those creatures are. v0.11.1 The default roster is the Void faction that arrived with Update 7:

The creatures are the game's own Larva_Void_Surge, Crawler_Void_Surge, Voidtaken_Goblin_Surge, Eye_Void_Surge and Void_Spawn roles. Each wave's spawner caps how many of its creatures can be alive at once: 12 for the first two waves, 6 for the next two and 3 for the last. Creatures left over from an earlier wave are not removed when the next one arrives, so a fight you are losing gets more crowded, not less.

Rift creatures and the Warden can kill you. Rift-Lethal is on by default; turn it off and their blows can no longer finish a player off.

The Warden

The Warden is the corrupted Cave Rex that also leads a Beast Tide as its Tide Lord, wearing a Void Rift Warden boss bar. Its health depends on how many people showed up:

Warden health = 2,200 x 1.6, plus 20% for every qualifying contributor so far, up to +120%

That is 3,520 on its own, 4,224 with one contributor, 5,632 with three, and a ceiling of 7,744 with six or more. (Rift-Warden-Max-Health, Rift-Warden-Scale-Multiplier, Rift-Warden-Health-Per-Contributor-Percent, Rift-Warden-Health-Bonus-Max-Percent. Despite its name, the scale multiplier acts on health rather than on the Warden's size.) A qualifying contributor is anyone who has reached 25 contribution points when the Warden appears, so the waves are where the Warden's health is decided.

When it steps through, players within 64 blocks (Rift-Encounter-Radius-Blocks) see a The Warden Emerges title and get the boss bar and a driving music track (Rift-Title-Enabled, Rift-Encounter-Boss-Bar-Enabled, Rift-Encounter-Music-Id), and everyone in the world is told in chat.

v0.11.1 The Warden also unfolds a Dao Domain of Void at 75 and 40 percent health, and its rift guardians fight stronger inside it. See Boss and NPC domains.

Contribution and rewards

The rift keeps a score for every player. Your contribution is:

• every point of damage you deal to a rift creature or the Warden, after armor and other reductions, plus
• 15 points for each wave creature you land the killing blow on (Rift-Kill-Contribution-Credit). The Warden's kill earns no bonus, because the win itself is the payout.

Only a player's own hits count: damage from a summoned spirit beast, and anything done on a sandbox profile, never adds to the score.

A win

Kill the Warden and the rift seals. The creatures still alive vanish, the pin comes off the map, and the world is told The Void Rift seals shut - the Warden has fallen, and its rewards are yours. Everyone whose contribution reached 25 (Rift-Qualifying-Contribution) is paid three things. The first is Spirit Stones, from the single highest tier they reached:

(Rift-Reward-Contribution-Tiers, written as threshold:reward pairs.) Tiers do not stack; you get the one tier, not all of them.

Every payout is then raised by a participation bonus: +15% for each qualifying contributor beyond the first, up to +90% (Rift-Participation-Bonus-Percent, Rift-Participation-Bonus-Max-Percent). That is deliberate. A fuller fight pays each person more, not a thinner slice of the same pile. Four qualifying fighters who each reached the 120 tier are each paid 45 x 1.45, or 65 Spirit Stones (and 783 Qi, below).

The second is Void Crystals (Ingredient_Crystal_Void, a vanilla Update 7 ingredient that the game itself names Void Crystal Shards). v0.11.1 Every qualifying contributor gets a random whole number from Rift-Reward-Void-Crystal-Min to Rift-Reward-Void-Crystal-Max, 1 to 3 by default, whichever tier they reached. The participation bonus does not touch it. Void Crystals go into the recipes for the Void Dao Seal and its conversion seal. Setting the maximum to 0 turns the crystals off.

The third is Qi. v0.11.1 Alongside each Spirit Stone paid, you receive Rift-Reward-Qi-Per-Currency Qi (12 by default). With no participation bonus that is 180 Qi at the lowest tier (15 stones), 540, 1,320, and 2,880 Qi at the top tier (240 stones); a full +90% participation bonus raises those to 342 and 5,472. It is banked the moment the stones reach you, through the same Qi-gain path as everything else you earn, so your usual Qi multipliers apply, and you are told The rift's lingering power deepens your cultivation with the amount. Someone who is not a cultivator, or who is already at the maximum level, receives the stones and no Qi. Set the key to 0 to pay stones only.

On top of those, the single top contributor also rolls a 15% chance (Rift-Reward-Manual-Chance) at one extra random technique manual.

Rewards are delivered at once to anyone online, hotbar first and then pack, with the lines Your Void Rift reward settles into your bag - N Spirit Stone(s)., Your Void Rift reward includes N Void Crystal(s). and the Qi line above. If your inventory has no room you are told so, and the reward waits until your next login; the Qi waits with its stones. Offline contributors are paid the same way when they next log in. A player on a test profile has their reward held until they return to a real one.

A collapse

If 15 minutes pass with the Warden still alive, the rift collapses: The Void Rift collapses, unresolved - too little was done in time. Unlike a Calamity Beast, which pays nothing when it escapes, a collapsed rift can still pay. If the Warden had appeared, every qualifying contributor still receives 25% of what a win would have paid (Rift-Timeout-Payout-Percent), with the same participation bonus. That covers the Spirit Stones and, because it follows the stones, the Qi. The Void Crystal roll is cut to the same share and rounded, so it often comes to nothing: a roll of 1 becomes 0, while 2 and 3 become 1. If the rift ended before the Warden ever appeared, nothing is paid.

Either way the rift's creatures and anchor are removed, and a new rift cannot open for Rift-Cooldown-Minutes.

Running it

v0.11.1 There are two admin test commands, both needing cultivation.admin and taking no arguments, and nothing that lists rifts. There is no in-game admin menu for rifts, so the file is the only other control.

The file is the rest of the control. Setting Rift-Enabled to false stops new rifts and hides the map pin, and a rift already open plays out. A restart clears a running rift without paying it.

For add-on developers, a rift raises public events when it is about to open (cancellable, so another mod can veto it), when it opens, when each wave is released, when the Warden spawns and when it resolves. See Events.

Configuration

Everything is in mods/Siren_Cultivation/Society/RiftConfig.json; unspent rewards are queued in mods/Siren_Cultivation/Data/RiftData.json, the same ledger Breach & Boss Rewards uses for its Spirit Stones. The full society list is on Society Configs. The keys most owners will touch:

Two more keys, Rift-World-Event-Enabled and Rift-World-Event-Asset-Id, control the world-event asset that posts the seal and collapse lines. Leave them alone unless you are replacing that asset.