Build DocFX

Make every boss kill feel like it is worthwhile using RisingV.

“RisingV.BossDrops is a mod for V Rising that allows you to assign custom loot drops to VBlood bosses. The rewards can scale based on your equipment level (all configurable)”

Features

  • Custom loot drops – assign custom loot drops to VBlood bosses.
  • Chance scaling – scale loot drops based on your equipment level.
  • Configurable rewards – configure the rewards for each boss in the configs/RisingV.BossDrops/Bosses.json file.
  • Item Drop Templates – use item drop templates to define the loot item pools.

Note: This may not be the entire list—refer to the API docs for every class, interface, and extension method that RisingV.BossDrops provides.

Installation

  1. Dependency – ensure RisingV.Shared, RisingV.Core are already installed.
  2. Download the latest release from Release
  3. Extract RisingV.BossDrops.<version>.zip to your VRising BepInEx directory.
  4. (Optional) Edit the Bosses.json, ItemDropTemplates.json inside BepInEx/configs/VRising.BossDrops/Databases for your desired loot drops/rates/amounts.
  5. Restart your dedicated server or client.

Quick start

// Added to your plugin class
[BepInDependency("RisingV.BossDrops")]

Configurations

RisingV.BossDrops uses the RisingV.Shared.Config base class for configuration management. This allows you to define your plugin's configuration in a type-safe manner, with support for hot-reloading and easy access to configuration values.

BepInEx/configs
└── RisingV.BossDrops
    ├── Databases
    │   ├── Bosses.json
    │   ├── CustomItems.json
    │   └── ItemDropTemplates.json
    └── RisingV.BossDrops.cfg

VBloodLootSystem.cfg

Configure boss drops inside VBloodLootSystem.cfg:

[General]

## Enable or disable the plugin
# Setting type: Boolean
# Default value: true
Enabled = true

## If true, loot drop rates will not be affected by the global drop rate settings.
# Setting type: Boolean
# Default value: false
IgnoreGlobalDropRate = false

[Scaling]

## If true, loot drop rates will be scaled based on the equipment level of players involved in the boss fight.
# Setting type: Boolean
# Default value: true
ScaleDropsByEquipmentLevel = true

## Exponent to control the loot drop rate scaling based on player and boss levels. <1 → mild squish, >1 → stronger squish
# Setting type: Single
# Default value: 0.8
DropChanceScalingExponent = 0.8

## Exponent to control the stack amount drop rate scaling based on player and boss levels. <1 → mild squish, >1 → stronger squish
# Setting type: Single
# Default value: 1.7
AmountChanceScalingExponent = 1.7

Documentation

For a deeper dive, API reference, and design docs see https://docs.risingv.dev/bossdrops.

Contributing

PRs that add new functionality—or improve existing ones—are warmly welcomed. Please open an issue first if you plan a large refactor. See CONTRIBUTING.md for more information.

Community

Join the V Rising Mod Community Discord for modding support, updates, and discussions!

Discord

License

GNU GPL-3.0. See LICENSE for details.

Edit this page