PinVentory

PinVentory lets you pin items to inventory and hotbar slots in V Rising, and makes sure they stay there.

Your weapons always on slots 1 to 3, your healing potions on slot 8, your stone bricks on the first bag slot, your keys in the corner of the bag: pin them once, and Sort, Quick Send, KindredLogistics and picking up your death bag will keep them where they belong. Ghost icons in the inventory show at a glance what belongs where, even when you have run out of it.

Frames, ghost icons and slot numbers: slots 3, 7, 8, 9, 10, 16 and 17 are pinned and hold their item. Slots 20, 38 and 39 are pinned but their item is missing, so they show a brighter frame and a ghost icon of the item.

Pinned items that qualify for Quick Send get double frames: with a container open, the game marks the items it would store there with a green frame (slots 15 and 19). Slot 20 is pinned as well, so it shows both frames, and Quick Send leaves its pinned amount in your inventory.

Features

• Pin with a hotkey: Hover an item in your inventory and press F7 to pin it to that slot. Press it again on a pinned slot to remove the pin. The hotbar slots 1 to 8 can be pinned as well.
• Pin by name: .pin set <slot> <item name> pins an item you do not carry right now. Until you find it, the slot can be used for other items as usual; from then on, the item goes to its pinned slot. If the slot is empty, a ghost icon of the item shows the pin right away, even if your character has never seen the item before.
• Whole stack or a fixed amount: A pin keeps the whole stack by default, which is what you would expect. If you want to store part of a stack, F8 (or .pin add <slot> now) pins the current amount, and .pin add <slot> <amount> keeps a fixed amount. When you store items, the pinned amount stays and only the rest goes into the chest.
• Sort respects your pins: Pinned items stay on their slots, all other items are sorted around them without gaps, in the game's own order. Pinned stacks are topped up from other stacks of the same item.
• Storing respects your pins: Quick Send, KindredLogistics .stash and its double-click sort leave pinned items where they are.
• Pins everywhere: If a pinned item lies on another slot, in the bag or on the hotbar, Sort puts it back on its pinned slot.
• The weapon in your hand stays put: While a weapon is equipped, PinVentory leaves it out of sorting. It is not moved off the hotbar or to another hotbar slot, even if its slot is pinned for another item or the weapon itself is pinned somewhere else. Once you switch to another weapon or unequip it, it can be sorted like any other item again.
• Auto-arrange on pickup: Items you pick up from the ground, take from a chest or your death bag, or craft go to their pinned slots right away, without opening the inventory. Turn it off with .pin auto.
• See your pins: A pinned slot shows a dark grey ghost of its item while it is empty, and a warm frame that turns stronger while the pinned item is missing. Bag slots show their numbers from 9 up, which makes the chat commands easy to use. Each of these can be switched off.
• Several pins per item: Pin the same item to more than one slot, for example potions on the hotbar and a reserve in the bag. To do this, the item has to lie on all of its pinned slots when you add the next pin. If one of these slots holds something else or is empty, that pin moves to the new slot instead.
• Item names in your language: With the client part installed, all messages use the item names of your game language.

How It Works: Client and Server

PinVentory is one DLL for both the game client and the server. Install it on both for the full experience.

The server greets every player with "PinVentory is active on this server. Type .pin for help." This message is how the client part detects the server part, so the server cannot switch it off. Players with the client part can hide it in the client settings: set the option ShowGreeting to false (see Configuration below).

Single player and hosting: The game starts its own built-in server, which does not load mods by itself. ServerLaunchFix, a required library, loads PinVentory there. Without it, the client part runs in the client-only fallback.

Commands and Hotkeys

Hover a slot in your inventory to use a hotkey. Slots 1 to 8 are the hotbar, slots 9 and up are the bag.

• The hotkeys are the defaults; you can change them in the client settings (see Configuration below).
• F7 removes a pin when the slot is empty or holds the pinned item. If the slot holds another item, it pins that item instead.
• An amount of a full stack or more keeps the whole stack.
• In the client-only fallback, F7, .pin list, .pin remove, .pin set and .pin toggle work, and .pin apply moves pinned items to their slots right away.

Pins are stored per player on the server, in BepInEx/config/PinVentory/players/.

Configuration

Client settings are in BepInEx/config/com.zeeCameLsnake.PinVentory.cfg, which is created on your first game start. Mod managers like Gale show them with descriptions.

• Mode (default: Auto): Auto uses the server part when the server runs PinVentory and the client-only fallback otherwise. ClientOnly always uses the fallback. ServerOnly keeps the client part inactive. Changes need a game restart to take effect.
• PinHotkey (default: F7): Pins the whole stack in the hovered slot, or removes its pin.
• PinCurrentAmountHotkey (default: F8): Pins the current amount, or sets the amount of a pin anew. Needs the server part.
  • If you choose other keys, avoid keys and modifiers the game already uses: the game still reacts to its own key while you hold Ctrl, Shift or Alt, so both the game and PinVentory would act. For example, with the default controls, Shift opens the split stack window when you hover a stack in the inventory.
• ShowGreeting (default: true): Shows the server's greeting in your chat.
• ShowGhostIcons, ShowSlotNumbers, ShowPinFrame (default: true): The slot display.
• SortWaitSeconds, MoveTimeoutSeconds: Timing of the client-only fallback.

The server part has no settings.

Installation

Playing single player, or hosting a game from your game client? PinVentory needs ServerLaunchFix for the full set of features: it loads PinVentory on the game's built-in server. Mod managers install it for you. On a dedicated server, it does nothing.

Using a Mod Manager

Install PinVentory with one of these mod managers:

• Gale
• r2modman
• Thunderstore Mod Manager

The mod manager installs the required libraries for you.

Manual Installation

1. Install BepInExPack V Rising and VampireCommandFramework. For single player and hosting, also install ServerLaunchFix; a dedicated server does not need it.
2. Extract the DLL directly into your BepInEx\plugins folder, on the client and on the server.

Compatibility

• Requires: BepInExPack V Rising (tested with 1.733.2) and VampireCommandFramework (tested with 0.11.0).
• ServerLaunchFix (tested with 0.2.0): Loads PinVentory on the game's built-in server in single player and when you host a game from your game client. Mod managers install it on dedicated servers as well, where it does nothing.
• Tested with V Rising 1.1.13 in single player, with the server part running on the built-in server.
• KindredLogistics: Optional, but recommended, it is a really great QoL mod. When you stash with its .stash command or its double-click sort, PinVentory keeps your pinned items in place (tested with KindredLogistics 1.6.1).
• Multiplayer: Not tested, because I had no second player to test with. The client and server part talk through hidden chat messages that the server part removes before the game shares them. In single player, they never showed up in the chat, but I cannot promise that other players never see them. If you try it, please let me know on the NexusMods page!
• Other inventory mods: Do not use PinVentory together with SlotSort or other mods that change sorting; they have not been tested together and will most likely work against each other.
• Hotkeys have only been tested on Windows.

Safe to Uninstall

Yes. PinVentory only moves items within your own inventory and keeps its data in its own config files. Your items stay where they are when you remove it, and nothing is stored in your world.

As with any mod, it is always good practice to make a backup of your world and character saves before installing or removing mods, just to be safe.

Feedback and Bug Reports

Thunderstore has no comment section. For feedback, bug reports, and suggestions, please visit the NexusMods page.

Support

Creating and maintaining mods takes a lot of free time. If this mod has enhanced your playthrough, you can support me on Ko-fi. Every little bit helps keep me caffeinated for the next update!