Vein-Tapping Arrays

A Vein-Tapping Array (引脉阵) is a flag planted on a rich or dragon spirit vein that makes the vein pay rent. Once it takes hold it gathers Spirit Stones and Qi on its own, whether you are on the server or not, until its store is full. You stand on the vein to collect. The array is never a block and never an entity, just a record in the world's data, and it does not drain the vein: meditation and breakthroughs on the same ground are untouched. Its yield is arithmetic on the wall clock, the same trick the Cave Abode's Spirit Spring uses.

The cost of owning one is that a rival can raid it. An outsider can stand on your vein, channel a siphon for a minute while your keepers are warned, and walk away with half of what you stored, so an array is something you keep an eye on, defend and sometimes abandon.

The array is on by default (Vein-Tap-Enabled). It has no Reveal gate: the flag is a craftable item, and its Codex article, Vein-Tapping Arrays, shows for every cultivator.

Making the flag

Craft the Vein-Tapping Array Flag at a Workbench, on its Tinkering tab. It is Epic quality and needs no recipe to be learned first.

You need a rich or dragon vein to plant it on. A Vein-Seeking Sinan or Heaven-Seeking Luopan will find one, and a vein another cultivator already taps is named as such in the compass's line.

Planting it

Stand on the vein and right-click with the flag. If everything holds, the flag sinks into the ground with a burst and a crystal sound, the flag is used up, and a line tells you the vein's tier, how much it will gather a day and how many hours of yield the store holds. Standing on a vein you already keep and right-clicking another flag shows its status and draws from it, and the second flag is not spent.

The array belongs to you, or, if you are in a sect, to your sect. There is no choice: a sect member's array is the sect's, and any Patriarch, Elder or member the sect's rules allow draws from it (below).

The gates

In the order the game checks them:

A cultivator in a sect counts against the sect's limit, never their own.

What it gathers

An array gathers at a steady rate set by its vein, and keeps up to Vein-Tap-Storage-Hours of it.

The rates are calibrated against the Spirit Spring: an abode's spring gives 60 Qi an hour on an ordinary vein and a Spirit Stone pays about a day of abode upkeep, so a rich array is roughly two springs and a dragon array four, in Qi.

The store holds 24 hours of yield (Vein-Tap-Storage-Hours, 1 to 168). A full array stops gathering; its keepers are told once when it fills. The array keeps counting while the server is off, so a restart does not cost anything: the stored figure is worked out from the clock when you come back. A clock that moves backwards simply restarts the count.

Collecting

Stand on the vein. After Vein-Tap-Collect-Seconds (3) the array pays out:

• the Spirit Stones go into your bag, and what does not fit stays in the array (Your bag is full - N Spirit Stones stay in the array);
• the Qi goes through the normal Qi pipeline, so your multipliers apply. If you can bank no more Qi, the array keeps it for you.

A keeper who stays on the vein is paid again after 10 minutes, and whoever uses a second flag on the vein draws at once. /cultivation tap lists what is in each array. Collecting needs a living cultivator: it is refused while you are dead, fleeing as a soul or on a test profile (a test profile's draw is held, not lost).

The daily cap. Vein-Tap-Daily-Stone-Cap (24) limits the Spirit Stones one account may draw from arrays per UTC day, across every array and profile. 0 is no cap. The rest waits in the array.

Who collects. The planter of a personal array, or a member of the controlling sect, with one exception: Vein-Tap-Sect-Elders-Only (on by default) restricts a sect's arrays to its Patriarch and Elders, and a member of lower rank is told so. It is on because a sect does not record when a member joined, so a fresh account cannot be told apart from an old one by how long it has belonged: the rank gate is the only guard a sect's store has. Turn it off only if you trust every member of every sect. A server whose config was written by an earlier 0.11.1 build keeps the old stored false until edited.

Allies. A member of a sect in an alliance with the keeper's sect is keeper-side: they see the array's pin and the raid alerts, and standing on the vein stalls a raid. They do not draw its yield.

On the map

A keeper-side viewer sees the array as a pin on the world map and the HUD compass bar: Your Rich Vein Tap, or Sect Name Vein Tap (Rich). Others do not see it. A pin under raid pulses red, labeled Vein Tap under raid! Stepping on a vein tapped by someone else prints who taps it, and, if you could raid it, how.

Raids

Anyone not of the keeper's side may raid an array they stand on. A raid is a channel: the raider holds the vein for Vein-Tap-Raid-Seconds (60) while the keepers are warned, and if it holds the raider takes a share and the array falls dormant.

Who may raid

Raids can be switched off entirely with Vein-Tap-Raid-Enabled: arrays are then safe wherever they stand.

Running a raid

Stand on the vein and run /cultivation tap raid. The raider sees You begin to siphon the array. Hold this vein for 60s, a warning toast and a burst of particles on the array. If a Warding formation holds the ground against the raider, the channel is Vein-Tap-Raid-Warded-Multiplier (1.5) times as long, and the raider is told so.

All keepers online get a toast, a chat line naming the raider and the array's coordinates (or, if it is far from them, how far and which way), and a sound, and the pin pulses red.

While the channel runs:

• Defending stalls it. While any keeper-side player (allies included) stands on the vein, the siphon stalls, and resumes when the vein is clear.
• Leaving breaks it. If the raider steps off the vein for more than Vein-Tap-Raid-Leave-Grace-Seconds (5), after a warning, the siphon breaks. So does the raider dying, going to a different world, disconnecting or the array being released or removed. Nothing is taken, and the keepers are told the raid was broken.
• A halfway line tells the raider the siphon is half done.

If the channel completes, the raider takes Vein-Tap-Raid-Share-Percent (50) of the Spirit Stones and Qi stored, the rest spills back into the earth, and the array falls dormant for Vein-Tap-Dormant-Hours (4): it gathers nothing, cannot be drawn from and cannot be raided until the hours pass. Keepers who were online are told what was lost; those who were away find a notice when they next log in.

Stones that do not fit the raider's bag are held for them (Your bag is full: N Spirit Stones are held for you) and delivered at the next login, or the next time they draw from an array. Qi that a max-level raider cannot bank is lost.

A restart during a raid ends it without an outcome. An array's most recent raider and the hours since are shown in the owner's /cultivation tap list.

Releasing an array

/cultivation tap release, standing on the vein:

• The keeper releases their own array; for a sect's array, its Patriarch or an Elder does. A keeper draws what the array holds first, even if the bag was too full to take it all: whatever stayed in the array goes with it. No flag is refunded.
• The owner of the ground can uproot a foreign array: a sect's Patriarch or Elder on their own claimed land, or the owner of the Cave Abode the array stands on. The keepers are told who did it.
• An array cannot be released while it is being raided.

An array also goes when its sect is disbanded, when an admin clears it, and, for an admin test array, when its time is up. A sect that is renamed keeps its arrays.

Commands

All three need only the base cultivation permission and are player-only. Planting is the flag's right-click and collecting is standing on the vein, so there is no command for either.

Testing it alone

Staff with cultivation.admin have four aids, all acting on the vein you stand on:

/cultivation admin bypass skips the realm gate and the caps when planting. To test raids properly you need a second keeper-side player, or a second sect: the stall, the alerts, the pins other keepers see and the peace gates cannot be seen alone.

For server owners

Everything is in mods/Siren_Cultivation/Cultivation/VeinTapConfig.json, with the arrays themselves saved in Data/VeinTapsData.json (see Data Files). The file holds 28 settings and three Description-* notes, and the in-game editor (Config tab of /cultivation admin, section Vein-Tapping Arrays) lists all 28, clamping a number you type at once. Its ConfigVersion is 1.

Data. Data/VeinTapsData.json holds the arrays, each keeper's drawn-today ledger, raid cooldowns, stones owed to raiders, and the notices queued for keepers who were away. Deleting it deletes every array. Test arrays are dropped at server start. The raid-start cooldown is not saved, so a restart resets it.

In the game. The Codex article Vein-Tapping Arrays sits in The World section and is built from the server's own settings: the rates, the store, the caps, the raid length and the share, and a line that says so if raiding or the elders-only rule is configured differently.

For add-on developers

plugin.siren.API.VeinTapEvents carries seven events. Players are identified by UUID; every listener runs on the thread that caused the event (the planting player's world thread, the raider's, or a command thread), with no Vein-Tap lock held, so keep it cheap.

See Events for the table in the full reference.