HexesAndSanguineSteel

Hexes and Sanguine Steel

Server-side custom weapon and abilities mod for V Rising.

Create named weapons, replace weapon and spells ability slots, customize their cooldowns, add stat bonuses, and apply school on-hit effects.

This mod bases itself on admin commands, but the players can access to the weapon through the upgrade system.

If the weapon type bonuses are enabled, every weapon of that type will recieve the benefit of it. With this admins/server owners can change how some weapons behave regarding stats and balance them out in case a weapon is being overshadowed by the other-

Aside from the weapons, this mod allows to replace weapons/spells to the Q|E|Dash|R|C|T keys and manually set their cooldowns as the user pleases.

Credits

This mod is mainly inspired for its systems and ideas by the following amazing mods and people:

• Bloodcraft by zfolmt — inspiration/reference for the boss style weapons
• CustomAbilities by Fryke — inspiration/reference for custom spells and abilities workflow.

Table of Contents

• Feature Overview
• Install
• Configuration
• Creating Custom Weapons
• Using Commands
• Compatibility Notes
• Development

Feature Overview

Custom Weapons

• Define custom weapons in weapons.json.
• Override Attack, Q, E, Dash, R, C, and Ultimate-style slots.
• Set cooldowns per configured ability.
• Bind weapons to a specific item instance with .csw wepgive or .csw upgrade.
• Upgrade held Shadow Matter weapons into configured custom weapons.

Stats and Weapon Type Bonuses

• Apply weapon stats through runtime stat carriers instead of global prefab mutation.
• Add per-weapon Stats[] entries.
• Add WeaponTypeBuffs for weapon-type-wide stat rules.
• Supports stat aliases such as AttackSpeed → PrimaryAttackSpeed.

School On-Hit Effects

• Add school effects through OnHitEffects[].
• Supported proven school effects include Leech, Static, Chill, Ignite, Weaken, and Condemn.
• Effects can be restricted to players, non-players, or both.

Runtime Safety

• Suppresses custom ability injection during shapeshift forms.
• Suppresses custom ability injection during feed and V Blood extraction states.
• Guards replacement slots against temporary ability bars with fewer slots.
• Normal logging is quiet; detailed logs require DebugLogging: true.

Install

1. Install BepInEx IL2CPP for your V Rising dedicated server.
2. Install VampireCommandFramework.
3. Build or download HexesAndSanguineSteel.dll.
4. Place the DLL in:

BepInEx/plugins/HexesAndSanguineSteel/

1. Start the server once to generate config files.

Configuration

Generated config files live in:

BepInEx/config/HexesAndSanguineSteel/

Main files:

weapons.json           Custom weapons, stats, weapon type buffs, and on-hit effects
player-spells.json     Saved per-player weapon-scoped spell overrides
weapon-instances.json  Saved item-instance custom weapon bindings

A minimal starter config is included at:

Resources/weapons.example.json

Legacy configs from BepInEx/config/CustomWeaponMod/ are copied into the new folder on first run when needed.

Creating Custom Weapons

Custom weapons are configured in weapons.json.

The safest workflow is:

1. Start the server once so the config folder is generated.
2. Open BepInEx/config/HexesAndSanguineSteel/weapons.json.
3. Copy an existing weapon entry in the Weapons array.
4. Change Name, ItemWeapon, abilities, cooldowns, stats, and optional on-hit effects.
5. Save the file.
6. Run .csw reload in-game.
7. Run .csw validate.
8. Give or bind the weapon with .csw wepgive or .csw upgrade.

Minimal weapon entry

{
  "Enabled": true,
  "Name": "Crimson Thorns",
  "ItemWeapon": 1307774440,
  "EquipBuff": 673013659,
  "CarrierBuff": 0,
  "StatCarrierBuff": 0,
  "WeaponLevel": 100,
  "PhysicalPower": 0,
  "SpellPower": 0,
  "Stats": [
    {
      "StatType": "PhysicalPower",
      "ModificationType": "AddToBase",
      "AttributeCapType": "SoftCapped",
      "Value": 35
    },
    {
      "StatType": "SpellPower",
      "ModificationType": "AddToBase",
      "AttributeCapType": "SoftCapped",
      "Value": 10
    }
  ],
  "Attack": -208121356,
  "AttackCooldown": 0,
  "Primary": 1826128809,
  "PrimaryCooldown": 8,
  "Secondary": 1730729556,
  "SecondaryCooldown": 10,
  "Dash": -1940289109,
  "DashCooldown": 6,
  "Ultimate": -1730693034,
  "UltimateCooldown": 60,
  "Spell Slot 1": 841757706,
  "Spell Slot 1 Cooldown": 8,
  "Spell Slot 2": 1295370119,
  "Spell Slot 2 Cooldown": 8,
  "OnHitEffects": []
}

Weapon fields

Field — Purpose

Name — The name used by .csw wepgive, .csw upgrade, and .csw list.

ItemWeapon — The base weapon item prefab GUID. This controls which weapon item is used.

EquipBuff — The weapon equip buff reference. Keep the matching vanilla equip buff for the base weapon.

CarrierBuff — Optional ability carrier override. Use 0 to use DefaultCustomWeaponCarrierBuff.

StatCarrierBuff — Optional stat carrier override. Use 0 to use DefaultCustomWeaponStatCarrierBuff.

WeaponLevel — Weapon level/power display value used by the custom weapon definition.

Stats[] — Runtime stat modifiers. This is the preferred stat system.

| Attack, Primary, Secondary, Dash, Ultimate, Spell Slot 1, Spell Slot 2 | Ability group prefab GUIDs fo