CastleLink

A server-side V Rising mod that lets a player use the resources stored across all of the castles they own — not just the one they're standing in.

Because V Rising computes crafting/building affordability on the client, a server mod cannot make a distant castle's resources appear "available" out of thin air. CastleLink solves this by physically pulling the resources you need from your other castles, on demand:

• Crafting — right-click a recipe at a crafting station and CastleLink pulls the recipe's missing materials from your other castles into your inventory, so the craft can proceed.
• Chat commands — gather resources between your castles, top up stacks, and deposit items neatly back into their dedicated storage boxes.

This mod is server-side only. Players do not need to install anything.

Features

• Pull crafting materials from your other castles automatically (right-click a recipe).
• Gather resources from your other castles straight into the current castle's storage boxes, or into your inventory.
• Category-based bulk pull (armor, weapons, herbs, materials, and many more).
• Smart deposit that only stores items which have a dedicated storage box (materials, herbs, alchemy, etc.) and leaves gear in your inventory.
• Only affects castles owned by the same player. Raided castles are skipped.

Commands

All commands use the VampireCommandFramework prefix (default .).

Command	Alias	Description
.clhelp	.clh	List all CastleLink commands and categories.
.wolt	.all	Top up this castle's storage boxes to one full stack of each storable item, pulled from your other castles.
.pull		Top up items you already carry to one full stack (storable items only).
.pull <guid> <amount>		Pull a specific item by PrefabGUID hash.
.pullcat <category>	.pc <category>	Pull all items of a category into your inventory (other castles first, then the current one).
.deposit	.dep	Deposit your inventory's items into this castle's dedicated storage boxes (leaves armor/weapons).

Categories

armor, weapons, gear, herbs, materials, jewels, consumables, fish, coins, gems, blood, soulshards, relics, bags, saddles, stables, magic, lumber, stone, minerals, alchemy, tailoring, flowers, everything.

Crafting

Just right-click a recipe at a crafting station. If your inventory + the station don't have enough, CastleLink pulls the shortfall from your other castles.

Requirements

• A dedicated V Rising server (this mod does not run on the client).
• BepInEx (IL2CPP pack for V Rising).
• VampireCommandFramework.
• The player must own more than one castle for sharing to do anything.

Installation

1. Install the BepInEx pack for V Rising and VampireCommandFramework on your server.
2. Drop CastleLink.dll into BepInEx/plugins/.
3. Start the server.

(Or install via a V Rising mod manager from Thunderstore.)

Building from source

This mod targets the current V Rising build and uses recent game types that are not yet present in the public VRising.Unhollowed.Client NuGet package. You must therefore build against the interop assemblies generated by your own BepInEx install:

1. Run your modded server once so BepInEx generates BepInEx/interop/.
2. Copy the DLLs from <server>/BepInEx/interop/ into ../server-interop/interop/ (relative to this project), or set the InteropDir property:

   dotnet build -c Release -p:InteropDir="C:\path\to\BepInEx\interop"
   

How it works (short version)

• Ownership: a castle heart is mapped to its owner via the territory owner's PlatformId; all hearts with the same owner form the shared pool.
• Crafting: patches StopCraftingSystem to read the recipe's RecipeRequirementBuffer and transfer the shortfall from other castles' chests.
• Storage: enumerates each castle's chests via the heart's SharedCastleInventories, and uses the game's own inventory-restriction rules so items land in their correct storage boxes.

Credits & attribution

This mod is an original implementation by Geckuss, but the techniques it relies on were learned from the excellent open-source V Rising logistics mods:

• KindredLogistics by Odjit & Zfolmt — the on-demand craft-pull pattern.
• Satisvampory by Greeneye — clan/cross-castle resource sharing.
• VampireCommandFramework and the BepInEx V Rising pack by deca.
• The V Rising modding community & wiki.

License

Licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later). See LICENSE.