CastleLink

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.), leaves gear in your inventory, and moves blood potions as whole item entities so their blood type/quality survives.

• 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 one stack of each item in a category into your inventory (topping up to a full stack; other castles first, then the current one). | | .deposit | .dep | Deposit your inventory's items into this castle's dedicated storage boxes (skips your hotbar; leaves armor/weapons; blood potions keep their blood type/quality). |

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.