Beelzebub, Lord of Gluttony

Devour the bestiary. A server-side V Rising mod where every kill can teach you one of the enemy's abilities, and a rare jackpot teaches you its entire kit at once. Slot what you collect on your action bar, bind the rest to extra hotkeys, and take the forms of the bosses you defeat.

Status: pre-1.0 ALPHA (v0.137.7). Test servers only. Install it only on a test or dev server, a server you reset regularly, or one you don't mind resetting if something goes wrong. Characters, collections or the whole server may need a wipe between builds.

Features are still being added and hundreds of abilities are still being tested; some misbehave when a player casts them, and a broken ability is useful feedback. Running alongside Bloodcraft and KindredCommands is intended but not fully verified; other mods are untested. Road to 1.0 · Report an issue

Source: github.com/KDavidP1987/Beelzebub-Lord-of-Gluttony · License: MIT

How it works

1. Kill anything. Each kill has a chance (default 5%) to capture one of the unit's abilities.
2. Hit the jackpot. A rare Devour roll (default about 0.25%) teaches the unit's whole eligible kit in one kill.
3. Never stay unlucky for long. Bad-luck protection raises your odds on every dry kill and resets on a drop.
4. Use what you collect. Put captures on your spell slots, per weapon or for every weapon, or bind extras to named hotkeys.
5. Become the boss. Some bosses can also unlock their transformation, a separate prize with its own odds.
6. Complete the bestiary. Track what you have per unit and hunt what is missing.

Requirements

• A V Rising dedicated server. Beelzebub runs on the server only; it does not work in a Host & Play game.
• BepInExPack V Rising
• VampireCommandFramework
• Recommended for players: Raphael, a client-side companion (formerly BloodCraftHub) that adds on-screen ability buttons, cooldowns and a collection book. It is still in development. Without it, everything works through chat commands and the six vanilla slots.

Installation

Install with r2modman or the Thunderstore Mod Manager, or copy Beelzebub.dll into <VRisingDedicatedServer>\BepInEx\plugins\. Stop the server before replacing the DLL; it is locked while the server runs.

Features

Collection

• Separate capture and Devour odds for regular enemies, V Bloods and shard bosses, each with bad-luck protection.
• A default filter removes filler (idle, lifecycle and plain melee abilities), so captures stay useful.
• .beelz bestiary shows how many of each unit's abilities you hold and what is left.
• .beelz top ranks the server by collection, .beelz odds shows your current chances, and finishing the catalog is announced to the server.

Your action bar

• Put any capture on one of your six spell slots, for every weapon or for one weapon type. Changes apply at once.
• Mix captures with your own spells. Picking a vanilla spell for a slot in the spellbook hands that slot back to you.
• Go past six: bind captures to named hotkeys and fire them with .beelz cast <name>. Cooldowns still apply.
• Give each shapeshift form (Wolf, Bear, Rat, Spider, Toad, Werewolf, Gargoyle) its own loadout with .beelz form-grant. The form holds while you cast.
• Saddle abilities go on R, C and T while you ride.
• One command resets a stuck bar: .beelz resetbar CONFIRM clears every Beelzebub change and checks the result. Your captures are kept.

Transformations

• Dracula and Morgana turn you into their real in-game forms, with their models, rigs and abilities.
• Test forms: Werewolf (Werewolf Chieftain or the common werewolf), Golem (Terah the Geomancer) and Gargoyle (the Tailor).
• Every form has two or more ability sets you switch with .beelz phase, or automatically by health.
• Bosses have more abilities than you have slots, so you choose: .beelz tform <unit> set <phase> <slot> <index> builds your own kit for each phase.
• Capturing abilities, devouring a kit and unlocking a form are three separate rolls. A form is never a free extra.

Summons

• Captured summon abilities raise allies that fight for you, transformed or not. They scale with your level and have caps, leashing and clean despawns.
• .beelz summon calls a transformed boss's signature adds (the Toad King's frogs, the Werewolf Chieftain's wolves).
• .beelz summons stash/restore/clear/status manages them. A server setting decides whether they wait or follow when you mount up.

Server tools

• Change drop rates, pity, transform rules and more live with .beelz admin set <key> <value>. No restart needed.
• Reshape any ability: cooldown, range, charges, area size, projectile speed, duration, healing, damage, summon limits, and how the cast feels (move while casting, interrupt on hit). .beelz admin ability-inspect shows every number behind an ability, and defaults restores the original.
• Ships with the community testing round's results: about 210 abilities pre-tuned, about 300 non-working ones switched off (an admin can turn any back on) and abilities that crash or break characters blocked.
• Incompatibility locks limit how many abilities of a group one player can hold, for combinations that break balance. None ship; your server decides.
• Optional per-hit damage scaling (Damage_Mode), with a telemetry mode to try it before it changes anything.
• Optional transform power scaling from a player's Bloodcraft progression.
• Recovery without wipes: inspect a player's bar, clear a stuck state, or reset loadouts, online or offline.

Commands

The full list, with every option, is in COMMANDS.md.

Collection

Action bar

Transformations and summons

Settings: .beelz verbosity silent/summary/verbose · .beelz silent on/off · .beelz help

Admin (all start with .beelz admin, see .beelz admin help)

Configuration

• BepInEx\config\kdpen.Beelzebub.cfg: server defaults for drop chances, bad-luck protection, transform durations and cooldowns, summon limits, power scaling, announcements and hotkey limits. Most can be changed live with .beelz admin set.
• ability_rules.json: which abilities can drop and how each one is shaped. Created on first start; reload with .beelz admin reload. Reference: ABILITY_CONFIG.md.
• state.json: per-player data, keyed by Steam ID.

Known limitations

• Only five transformations. The game client decides what your character looks like, and a server-side mod cannot change that; these are the forms the game can already show on a player. Becoming other units would need a client-side mod, and whether that is possible is still under investigation.
• Some multi-stage boss abilities misfire. A cast that spawns a projectile that spawns an area can lose a later stage when a player casts it. Many are fixed or curated out; the audit continues.
• Some abilities look best in form. A few are tied to a boss's skeleton and animate oddly on a vampire body.
• Per-hit damage scaling is new and off by default. Run a session in Telemetry and check .beelz admin damage-stats first.
• A boss form takes a moment to appear. Until it does, .beelz phase and .beelz refresh reply "Still transforming". If a form never finishes, .beelz revert clears it.
• A deleted character's leftovers stay. The startup cleanup only touches slot helpers that belong to a living character. If a deleted character left any, they can keep logging one Couldn't remap old Modification Id error at startup. It is harmless.
• Untested at scale: other mods, other server presets and large populations.

Roadmap: the road to 1.0

These five steps lead to 1.0. Testing comes first, because its results decide what gets re-tuned, re-enabled or kept off.

1. Ability testing

Every ability the mod can hand out is on a test plan, 615 in three groups:

Alongside the plan, general play is especially useful to test: mixing captures with vanilla spells, hotkeys, the bar after weapon swaps, transforms and dismounting, summons in group fights, the Devour rate, and reconnecting while transformed (your form and summons should resume within 90 seconds).

2. Ability reconfiguration

• Re-tune every preset that tests Partial or Fail.
• Apply the soft-disabled verdicts to the shipped defaults.
• Make problem abilities safe instead of blocked where possible: Gaius Twinblade Throw, Spider Baneling Explode, Ziva Jetpack, Toad King Swallow and Spit, and others.
• Fix the summon abilities that do not work yet.
• Finish the multi-stage boss ability audit, so boss kits fire cleanly when a player casts them.
• Fill in missing ability names and descriptions.

3. Stability

• A transformation that expires on its own does not fully clean up yet.
• A performance check on the action bar cleanup.
• Re-check the mounted and beast-form action bars on the current build.

4. Planned features

Which of these make 1.0 is still open.

• Mastery: per-unit mastery levels and set rewards on top of the bestiary.
• Raphael UI: ability buttons, cooldown rings, the collection book, a transform browser and admin panels. The server side of this already ships.
• More transformations (under investigation): becoming other units. A server-side mod cannot do this alone; whether a client-side mod can is still being investigated, so this is not promised.
• Summon AI: allies that engage more reliably, and fight hostile players in PvP.

5. Before 1.0

• Testing at scale, on other server presets and alongside other mods.
• Close out the known limitations above.

Feedback

Open an issue on GitHub with what you were doing and the [Beelz] lines from BepInEx\LogOutput.log. Bug reports, mod conflicts, broken abilities and balance notes are all welcome.

Credits

• Bloodcraft by zfolmt: its familiar system inspired Beelzebub's allied summons, and its approach shaped the kill hook and the real-form transformations. Beelzebub can also scale transform power from a player's Bloodcraft progression.
• KindredCommands by odjit: the command and plugin structure.
• VampireCommandFramework by deca: the chat command framework.
• BepInEx: the modding framework.

These are independent projects; Beelzebub is not affiliated with or endorsed by them. Thanks also to everyone testing on the development server: your reports decide what makes the final cut.

License

MIT

Changelog

Newest first: the ten most recent versions, in short. Fuller notes and older versions are in CHANGELOG_FULL.md.

[0.137.7] - 2026-10-04

• The mod page now states that this is a pre-1.0 alpha: install it only on a test server, or one you are willing to reset.
• New road to 1.0 section on the mod page.
• The client companion BloodCraftHub is now called Raphael. Nothing else changes; it keeps working as before.
• This changelog is shorter.

[0.137.6] - 2026-10-04

• Fixed: the Couldn't remap old Modification Id errors at startup. Changing a spell slot could leave a hidden helper behind in the save; Beelzebub now removes these leftovers on its own, including ones saved by older versions.
• Fixed: those leftovers could also turn off slot 7's shared cooldown and change slot 1's spell modifiers.
• Fixed: Militia Leader's Whirlwind no longer logs a conflict warning at startup (existing servers: .beelz admin reseed merge).
• Admin: new read-only .beelz admin modleak [player|all] lists the hidden slot helpers.

[0.137.5] - 2026-10-04

• One transformation at a time. Transforms, phase changes, travel and login no longer stack a form on top of another one.
• While a boss form is still appearing, .beelz phase and .beelz refresh reply "Still transforming".
• Fixed: .beelz phase refused every phase above 1 for Dracula and Morgana.
• Fixed: leaving combat mid-phase-change could skip the automatic return to phase 1.

[0.137.4] - 2026-10-04

• .beelz clearbar [all|universal|<weapon>|<form>] now fully clears the loadout you name, like resetbar. Before, saddle and transform abilities could stay on the bar. Your other loadouts are kept.
• Clearing while riding dismounts you, and clearing while transformed ends the transform; the reply says so.
• If something stays stuck, the reply names it.

[0.137.3] - 2026-10-04

• Saddle abilities go on slot 5, 6 or 7 (R, C, Ultimate). Slot 3 is refused because the game never shows a key for it; existing slot-3 binds move to slot 5.
• .beelz resetbar while riding now dismounts you and tells you, instead of silently.

[0.137.2] - 2026-10-03

• .beelz unslot in a beast form (Wolf, Bear, ...) puts your weapon skill back on that slot at once.
• Grants and unslots made while in a form, transformed or mounted apply as soon as that ends, with no weapon swap.

[0.137.1] - 2026-10-03

• Granted abilities show up on your bar at once. Before, .beelz grant (and weapon grants, admin grants, presets, refresh) needed a weapon swap before the ability appeared and could be cast.
• .beelz unslot puts your weapon skill or spellbook spell back at once.

[0.137.0] - 2026-09-30

• .beelz resetbar CONFIRM clears a stuck action bar in one go, without a weapon swap, and tells you whether the bar is back to normal. Captures, unlocks, hotkeys and presets are kept. It also repairs bars damaged by older versions.
• Fixed: Space, R, C and the ultimate breaking after a reset (lost dash, spells that would not drop onto a slot).
• Fixed: spellbook spells going blank on their key after a login or reset. Affected spells come back at next login.
• Beast forms keep their own abilities by default (Forms_AutoFillFromCaptures = true restores the old behaviour).
• Admin: reset-loadouts and purge use the same reset and work on offline players; new read-only .beelz admin bar [player] shows what is on each slot and why.

[0.136.0] - 2026-09-23

• New default ability rules from the Discord testing round:
  • About 210 abilities ship with the tester's fix: unrooted casts, added cooldowns, damage adjustments, shorter launches, summon limits.
  • About 300 that could not be fixed are off by default; admins can turn them back on.
  • 10 more that crash the game or break characters or bases are blocked for good.
• Existing servers: .beelz admin reseed replace CONFIRM takes the new defaults (a backup is kept).
• A per-ability cooldown now works on abilities that have no cooldown of their own.

[0.135.0] - 2026-09-23

• Admin locks: limit which abilities can share one bar, e.g. .beelz admin lock add nocombo "Gargoyle WingShield, Rat Vanguard". None ship by default.
• .beelz admin reseed preview | merge | replace CONFIRM brings shipped default fixes to an existing server, keeping your own edits on merge.
• Safety timeouts on stuck-state abilities (still disabled by default).
• Fixed cooldown mix-ups when the same ability is on two slots, and on charge abilities.