Satisvampory

Current version 1.0.81. Server-only V Rising 1.1 BepInEx plugin for dedicated servers.

Satisvampory is a server-side quality-of-life addon. It was built so playing the game stops feeling like a chore: less running between chests, less babysitting castle hearts and servants, and more actually playing. Nothing to install on the client.

Main features

Item pickup (scoop) - Pick up items around you with a configurable radius (1-50). Choose between grabbing everything you walk past or only items that drop near you. Per-item caps and an exclude list so your bags don't fill with cotton.
Clan Share - Treat every clan plot as one island. If the clan has the mats, you can build and craft with them from any castle (craft-pull honors reserves). Includes .pull commands to grab items straight into your bags (still a little buggy).
Heart top-off - Keeps castle hearts fed with Blood Essence automatically.
Improved conveyor belts - Name chests s# (sender) and r# (receiver) and items flow between them. Like Kindred's belts, but with production caps, chest reserves, and box-to-box support.
Item groups - Predefined groups (ore, mushrooms, and more), fully customizable per castle. .s group ore lists every member's stock and where it is.
Quick deposit (RR) - Double-tap R or .stash to dump your inventory into the right chests. Works on the local castle, across all clan castles with Clan Share on, or from anywhere with .s rrglobal.
Priority containers - Deposits go to the best chest in order: conveyors, exact name match, similar group or type name, then everything else. Chests can be excluded with NS or a trailing '' in the name.
Servant deposits - Servants returning from hunts stash their loot automatically using the same chest rules as you.
Auto rerun hunts - Servants go straight back out on the same hunt when they get home. Toggle per castle.
Find item / find chest - .fi "Blood Essence" and .fc salvage tell you which plot and chest, with (here) marking where you stand.
.s need - Shows the top 10 things your stations are hungriest for, so you know what to hunt or farm next.
Item aliases - Out of the box: BE (Blood Essence), GBE (Greater), PBE (Primal), ABE (Ancestral), GSS (Greater Stygian Shard), SGS (Siege Golem Stone), DSI (Dark Silver Ingot), OT (Onyx Tear). Admins can add their own with .sg alias add.
Detailed hunt results - Loot and losses from each servant hunt reported in chat to the owner.

Getting started

Type .s help in game. Player commands use the .s prefix, admin toggles use .sg. The full command table with scopes and examples is in COMMANDS.md inside the zip and on GitHub.

Diagnostics

.s conv <item> - Why a conveyor is not moving that item (station, line, reason).
.s need - Station demand, total stock, and reserve for the top 10 inputs.
.s diag - Drops a marker in the server's rolling log for dupes, missing items, or lag. Tell your admin the time.
.s settings - Your toggles plus the reserve on the castle you're standing on.
.s vq - Work-queue depth (admin).

Install

Stop the dedicated server.
Remove any other logistics or scoop plugin DLLs from BepInEx\plugins. Satisvampory should be the only one.
Copy everything from the zip's plugins folder (Satisvampory.dll, HookDOTS.API.dll, VampireCommandFramework.dll) into BepInEx\plugins.
Start the server.

Quickest way to get help

Point ChatGPT, Claude, or any LLM at the GitHub repo and ask it your question. The specs folder and COMMANDS.md describe every behavior, so it will usually give you a better answer than I can at 2am.

Source (AGPL-3.0): github.com/Greeneye0/Satisvampory

Specs

Product contract (dest ranking, tidy, covering, ClanShare, belts, scoop, servants): specs/. Behavior changes update the matching spec in the same commit.

Commands

Full list, scopes (you / plot / castle / clan / server), and examples: COMMANDS.md.

In game: .s help. Prefix .s. Admin .sg. Chest floors are .s reserve (there is no leftover command). .s cap is castle production; .s bagcap is personal scoop.

New castle (ClanShare)

With .s cs on, a brand-new plot is already on the clan island. .stash and RR (double-tap R / .s ss) work as soon as the heart is placed — they dump to clan chests, not only this plot.

Stand on the plot while you build. Covering only runs while a clan member is standing there (castle guests do not trigger clan covering or pull from other clan plots). If clan reserves are still met at the other castles, the kit stays when you leave.

Place the heart.
Lay foundations.
Place one chest. After a few seconds it fills with starter mats (planks, stone bricks, gem dust, copper, iron, stone) plus enough to enclose a small castle: walls and treasury floor.
Build that small enclosed room on treasury floor.
Place about three large chests on the treasury floor so the clan covering buffer can land (enough to place about 3 of whichever unlocked piece is hungriest per material, capped at 200 of each mat so a 1200-stone wall does not drain the warehouse). One clan member standing: leftover-bypass so a new castle can start (kit, covering 1x, heart upgrade, heart fuel seed). Two or more occupied clan plots: those pulls honor reserve. Covering 3x always honors reserve. Unnamed chests (blank nameplate) are generic dumps even if the prefab is "Jewel Storage". Chests named Empty, General, or Everything Else are also generic dumps.

Unnamed chests are fine. Named s# / r# belts can wait until the room exists.

To dismantle a filled chest: empty it. Kit/covering will not restuff that chest for 5 minutes (or leave the plot). A new chest is a new fill.

To keep this castle out of ClanShare: stand on it as the heart owner and run .s cse. Standing there is then this plot only. Run .s cse again to include it.

Build from source

Build from this repo (needs a V Rising dedicated-server interop tree; Satisvampory.csproj points at C:\VRisingServer\BepInEx\ by default):

dotnet build Satisvampory.csproj -c Release

Stage the output as BepInEx/plugins/Satisvampory.dll.next while the server is running, then bounce to swap.

License

AGPL-3.0. See LICENSE.