zeeCameLsnake-VeinControl icon

VeinControl

The bite you can take back: stop a feed early with your interrupt key, and your high-blood target survives. Biting gets its own key, so Interact grabs the loot next to wounded enemies instead of their throat.

Last updated a day ago
Total downloads 10
Total rating 0 
Categories Client Server Mods Oakveil Update
Dependency string zeeCameLsnake-VeinControl-1.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

Mythic-ServerLaunchFix-0.2.0 icon
Mythic-ServerLaunchFix

Enable mods for single player and host & play

Preferred version: 0.2.0
BepInEx-BepInExPack_V_Rising-1.733.2 icon
BepInEx-BepInExPack_V_Rising

BepInEx pack for V Rising. Preconfigured and includes Unity Base DLLs.

Preferred version: 1.733.2

README

VeinControl

"Finally control your cravings!"
A misplaced bite has cost V Rising players countless precious would-be prisoners, and the only "solutions" were desperate tricks like Unstuck, which may kill your character or drop your inventory. VeinControl is the fix players have wished for since launch: you decide when you bite. The Interact key no longer feeds on wounded enemies, a separate feed key does. And if a bite still goes wrong, it is no longer final: stop it with your own 'Interrupt Ability Cast' key, and your target survives, ready to be dominated.

VeinControl

I had finally found my Alchemist, blood quality 98, and fought off his friends while carefully keeping him alive. Then one of them dropped a Blood Orb. I pressed Interact to grab it, and found myself at the Alchemist's throat, with no way to stop.

Click here if you'd like to read the whole tale!

I was new to the area when I came upon the picturesque settlement of Venom Mixing Outpost. I only meant to admire the pretty flowers, but then I saw HIM: the Alchemist! So marvelous, so learned, so splendid to behold, and so gloriously full of corruption! The impressive 98 above his head told me that he had to be held in the highest regard among his kind.

I knew I had to have him!

Naturally, he would not come along of his own free will, so I would have to convince him, with well-tempered cruelty, that it was best for everyone involved. He and his friends, however, did not quite share my view on the matter. In the scuffle that followed, I took some rather serious wounds, ever careful not to snuff out the Alchemist's light of life while I rid myself of his companions.

How great was my relief when one of them, with his last breath, let a Blood Orb slip from his pocket. Swiftly pick it up, and on with the party: that was my plan.

But alas! Instead of sinking my fangs into that sweet orb of blood, I found myself at the throat of my coveted Alchemist, knowing that this meant his certain death, for I had no way to stop it. And in that very moment, I cried out in pain and agony: "STUNLOCK STUDIOS! WHAT HAVE YOU DONE?"

A separate feed key: any key except Interact Key modifiers possible
A separate feed key Key modifiers possible
Cancel key spares, primary attack kills Optional: primary attack spares as well
Cancel key spares, primary attack kills Optional: primary attack spares as well
Default: drink V Blood with Interact, as in vanilla Optional: V Blood requires the feed key
Default: drink V Blood with Interact Optional: V Blood requires the feed key

Features

  • A separate feed key: The Interact key (vanilla: F) no longer bites wounded enemies. Biting is done with FeedKey: F2 by default, but you can choose any key, with Shift, Ctrl or Alt if you like, and add a second key, for example a side mouse button. The floating prompt above a wounded enemy shows your primary feed key, e.g. Feed [F2] (or the second one, if no primary key is set). If you prefer the vanilla behavior (Interact bites), switch SeparateFeedKey off in the config. You can still spare your target then (see below).
  • Interact keeps working next to wounded enemies: Interact uses the next object in reach instead of the enemy in front of you: blood orbs, loot, doors, chests, mounts, portals. Holding Interact while you walk over loot, or pressing it before a portal is in reach, works as in vanilla.
  • Spare your target with the key you already know: By default, the key you have bound to 'Interrupt Ability Cast' in the game's settings (Controls → General) stops a bite early, and the target survives at its current health. Nothing to set up and nothing to relearn: the key already means "cancel" for your spells, and now it cancels a bite too. This double use is intended and safe, because in vanilla the key does nothing at all while you drink.
    • Your own blood type and quality stay unchanged. The target can be subdued with Dominate Human right away, or bitten again after the normal feed cooldown.
    • Pressing your feed key again during a bite spares the target as well, and you can add an extra CancelFeedKey. Use whichever you like.
  • The quick finisher stays: [LMB] Abort still kills the target without taking its blood, as in vanilla. If you prefer, LMB can spare as well (AllowPrimaryAttackCancel).
  • The feed bar tells you your keys: Instead of "Press Left Mouse to abort", it shows your own 'Interrupt Ability Cast' key, e.g. "Press Mouse Button 5 to spare, Left Mouse to kill" if that key is on your fifth mouse button. If it is not bound, the bar shows your CancelFeedKey or your feed key instead.
  • V Blood bosses and mount revives stay vanilla: Interact still feeds on downed V Blood bosses (optional: RequireFeedKeyForVBlood), and V Blood bites can never be spared. Reviving a mount with Interact works as before.
  • Everything in one config, applied live: Changes made in a mod manager or text editor take effect while the game runs, without a restart.

Good to Know

  • Interact never bites wounded enemies. If no other object is in reach, Interact simply does nothing.
  • The Feed [F2] prompt disappears for a moment while you hold Interact next to a wounded enemy. That is how VeinControl looks past the enemy to find the next object. It comes back when you let go.
  • A short grace window after every spare: However you spare a target, your own hits on it, and those of your minions, do no damage for a short moment (SpareGraceSeconds, 1.5 seconds by default), so they may look like misses. This matters most with AllowPrimaryAttackCancel: your character still swings right after an LMB spare, however short the press, and the grace window makes that swing harmless. Hits from other players and from enemies still count, and your attacks count again after that moment.
  • The feed bar text is English only.
  • Safety net: In the rare case that a bite starts with Interact anyway (for example with lag), a server with VeinControl ends it at once without killing the target. You may see the bite start for a moment.
  • Choose free keys. If a feed key or cancel key also has an in-game binding outside menus (for example Q, a weapon skill by default), both the game and VeinControl react to it. The same goes for modifiers: in the default keybindings, Shift, Ctrl and Alt all do something while you roam (for example, Ctrl opens the action wheel and Alt the emote wheel), so a combination with one of them triggers that as well, unless you have rebound it. Free keys by default: F1–F11, PageUp, PageDown, Home, End, Insert, Delete.
  • Key names in the config: letter keys follow the key positions of a US keyboard, so on a German keyboard Y is the key labelled Z. The side mouse buttons are Mouse3 (the game's Mouse Button 5) and Mouse4 (the game's Mouse Button 4). The floating prompt and the feed bar always show the key as the game names it, so a quick look tells you which key it is.

How It Works: Client and Server

VeinControl is one DLL for both the game client and the server.

Part What it does
Client The separate feed key, Interact that passes wounded enemies, and the feed key in the floating prompt. Works on every server, also on servers without VeinControl.
Server Sparing the target when a bite is stopped early, and the safety net. Only with VeinControl on the server do the cancel keys spare and the feed bar show them; without it, stopping a bite with LMB kills the target, as in vanilla.

Single player and hosting: The game starts its own built-in server, which does not load mods by itself. ServerLaunchFix, a required library, loads VeinControl there.

Dedicated servers: Install VeinControl on the server as well. The server greets every player with "[VeinControl] Feed control is active on this server."; players with the client part do not see it. On a server without VeinControl, the separate feed key still works, but bites cannot be spared.

Players without the client part on a server with VeinControl can spare their target with their in-game 'Interrupt Ability Cast' key, because that key reaches the server anyway. Everything else stays vanilla for them.

Servers without VeinControl: The separate feed key works there too, but there is no safety net and a bite cannot be spared: stopping it with LMB kills the target, as in vanilla. A bite with Interact can only slip through in rare cases, for example with lag. If you want to rule that out completely, switch on StrictInteractWithoutServerMod: Interact then does nothing while a wounded enemy is targeted, so you cannot pick up items next to wounded enemies with it on those servers. Leave it off if you would rather keep picking up blood orbs and loot there. It is a trade-off, not a must.

For server owners: The server has its own file, com.zeeCameLsnake.VeinControl.Server.cfg, in the server's config folder:

  • on a dedicated server: BepInEx\config
  • in single player and when you host a game from your game client (where ServerLaunchFix runs the built-in server): BepInEx_Server\config, next to the BepInEx folder of your game or mod manager profile

The file is read when the server starts.

  • EnableNonLethalCancel (default: true): Allows sparing on your server. Off: every early end of a bite is lethal, as in vanilla (e.g. for PvP servers).
  • FeedKeySafetyNet (default: true): For players with the client part, a bite started with Interact is ended at once without killing.
  • MaxSpareGraceSeconds (default: 5, 0 = off for everyone): Upper limit for the grace window after a spare, which each player sets in their own config (SpareGraceSeconds). Players without the client part get 1.5 seconds. The window only holds back the player who spared the target and their minions; damage from other players and from enemies still counts.
  • LogDiagnostics (default: false): Diagnostic lines in the server log.

Configuration

The settings are in BepInEx/config/com.zeeCameLsnake.VeinControl.cfg, which is created on your first game start. Mod managers like Gale show them with descriptions. With LiveReload on (default), changes take effect about half a second after saving.

General

  • Enabled (default: true): Master switch. Off: vanilla Feed and Interact.
  • LiveReload (default: true): Applies changes to this file while the game runs.

Separate Feed Key

  • SeparateFeedKey (default: true): Interact no longer bites wounded enemies; the feed keys do.
  • FeedKey (default: F2) with FeedKeyModifier (default: None): The key that bites.
  • FeedKeyAlt (default: None) with FeedKeyAltModifier: A second bite key, like the second keybind column in the game's settings. Example: Mouse4 for a side mouse button.
  • RequireFeedKeyForVBlood (default: false): On: downed V Blood bosses also need the feed key.
  • AllowInteractFallThrough (default: true): Interact uses the next object in reach next to wounded enemies. Off: Interact does nothing while a wounded enemy is targeted.
  • StrictInteractWithoutServerMod (default: false): Only for servers without VeinControl, see above.

Non-Lethal Feed Cancel

  • EnableNonLethalCancel (default: true): Stopping a bite early spares the target. Needs VeinControl on the server (included in single player).
  • UseInterruptAbilityCastKey (default: true): Your in-game 'Interrupt Ability Cast' key spares the target.
  • CancelFeedKey (default: None) with CancelFeedKeyModifier: An extra key that spares the target.
  • AllowFeedKeyToggleCancel (default: true): Pressing a feed key during a bite spares the target, whichever key started the bite.
  • AllowPrimaryAttackCancel (default: false): On: [LMB] Abort spares the target instead of killing it. See Good to Know about the swing that follows.
  • SpareGraceSeconds (default: 1.5, 0 = off): After every spare, your own hits on the spared target (and those of your minions) do no damage for this many seconds. Needs VeinControl on the server, which may set a lower limit.

Debug

  • LogDiagnostics (default: false): Feed key decisions and spare requests in the client log.

Installation

Playing single player, or hosting a game from your game client? VeinControl needs ServerLaunchFix to spare your targets: it loads VeinControl 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 VeinControl 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. 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).
  • ServerLaunchFix (tested with 0.2.0): Loads VeinControl 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. It should work with other 1.1 versions.
  • Multiplayer and dedicated servers: 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 mods: Works together with ConVicted (tested). VeinControl has not been tested together with other mods that change the Interact key or feeding.
  • Made and tested with keyboard and mouse on Windows. Controllers have not been tested.

Safe to Uninstall

Yes. VeinControl changes nothing in your world or character: it only changes which key bites and whether an early bite end kills, while it is installed. Spared enemies are ordinary units.

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!

Buy Me a Coffee at ko-fi.com