BloodCraftHub
Unified client-side V Rising UI mod that turns the chat commands of its companion server mods into buttons, forms, and on-screen overlays — first-class support for Bloodcraft, KindredCommands, and KindredLogistics, plus the sibling Beelzebub (ability capture / transforms) and Uriel (shared storage / public prisons / stair restyling / object spawning) mods. Each mod's tab group appears only when that mod is detected on your server, so it works whether your server runs one, several, or none.
📢 Coming soon: this mod is being renamed to Raphael, Lord of Wisdom
BloodCraftHub is being rebranded. It started as a companion UI for the Bloodcraft server mod, but it has grown well beyond that — it now also provides UI for Beelzebub and Uriel, a full standalone chat interface, and it will support more server-side mods over time. To reflect that broader scope — and to end the frequent mix-up between BloodCraftHub (this client UI mod) and Bloodcraft (the separate server-side mod people keep opening the wrong support tickets for) — this project will soon become Raphael, Lord of Wisdom (joining the named family alongside Uriel and Beelzebub).
Nothing changes for you right now — same mod, same features, same install. The switch-over (new name, new icon, and the move on Thunderstore) is coming in a near-future update. Watch this page and the The Shadow Realm Discord for the announcement so your mod manager points at the new package when it lands. When in doubt about whether a problem is with this mod or with the Bloodcraft server mod, the new name should make it clear which is which.
⚠ Pre-1.0 public beta — please read
BloodCraftHub is pre-1.0 and still in active testing. It's daily-driven on a live server, but it's a client-side UI mod that hooks the game and runs alongside other mods — so you may run into mod incompatibilities or other issues, especially right after a version update or when combining it with other client-side mods.
If you hit anything — a crash, a conflict, weird UI/input behavior — please tell us. The fastest way is the The Shadow Realm Discord; written-up GitHub issues also work. A crash log (from BepInEx/LogOutput.log) or a clear repro helps enormously and usually gets a fix into the next release quickly.
Rolling back if a version update causes problems
You can always drop back to an earlier version:
- In your mod manager (Thunderstore Mod Manager / r2modman): select BloodCraftHub in your profile, open its version dropdown, pick the previous version, and let it download + swap automatically. Fully quit V Rising first.
- Manually: download an older build from the Thunderstore page or GitHub releases, then in your profile's
BepInEx/plugins folder delete the BloodCraftHub folder and replace it with the older one (game closed).
- If the client crashes on load after any version change: close the game and delete the
BepInEx/interop and BepInEx/cache folders in your profile — they rebuild automatically on the next launch and clear any stale/corrupted interop state.
⚠ Heads-up before you install
1 — Running alongside Eclipse? BloodCraftHub auto-switches to "command-console mode."
Historically, BloodCraftHub + Eclipse crashed the client on load. The fault is inside Eclipse's own HUD code (Eclipse.Services.CanvasService reads a Unity BufferLookup<ModifyUnitStatBuff_DOTS> from a background coroutine — an access violation that BCH's normal startup activity tips over; BCH isn't in the crash stack and can't fix it directly). So as of 0.17.1, when BCH detects Eclipse it stands down from its own passive Bloodcraft layer: it doesn't register for or read the Bloodcraft data stream, which avoids the crash. In that mode Eclipse provides the live HUD (XP / legacy / expertise / familiar / professions / quests), and BloodCraftHub still gives you its command buttons (Bloodcraft + KindredCommands + KindredLogistics) and the tabbed chat window — the affected tabs show an in-app notice explaining this. If you'd rather have BloodCraftHub's own live overlays, disable Eclipse (BCH covers the same readouts on its own). The proper fix for true side-by-side passive overlays is on Eclipse's end (guarding that coroutine lookup).
2 — Pre-1.0 testing.
v0.x is still public-beta. The major feature set is in place and the mod is daily-driven on a live PvE server, but APIs and UI may still shift before 1.0. If you spot a bug, please reach out on the The Shadow Realm Discord — that's the fastest way to get a fix in the next release. GitHub issues also work for written-up reports.
3 — Controller / gamepad input (under investigation).
There are known interaction edge cases when V Rising's controller input pipeline intersects with the BCH UI — for example, after using a teleport waypoint the controller's A button can re-open the BCH main panel because Unity's UI navigation system retains focus on the floating BCH button. v0.15.0 ships a first-pass fix that excludes the floating BCH / OV buttons from gamepad UI navigation, but more thorough controller testing is in progress. If you play with a controller and hit something unexpected — UI opening / closing on the wrong button, focus getting stuck, hotkeys not firing under controller input, etc. — please report it on the Discord with as much repro detail as you can. We're actively working on coverage here.
4 — Server-side Bloodcraft compatibility (read this if BCH looks empty).
The live HUD overlays + tab readouts in BCH are driven by Bloodcraft's signed broadcast protocol, which the Bloodcraft server-side mod only emits when at least one of these systems is enabled on the server:
LevelingSystem — XP / levels / classLegacySystem — blood legacyExpertiseSystem — weapon expertiseClassSystem — Bloodcraft classesFamiliarSystem — familiars
A server that runs only QuestSystem or ProfessionSystem (with all five above disabled) will not engage the protocol at all, and BCH will mark the BLOODCRAFT tab group as unavailable. In that situation, click the BLOODCRAFT header in the left rail — BCH shows an in-panel diagnostic with a one-click "Force-enable tabs" button. After force-enabling, the chat-regex pipeline still works (.fam boxes, .quest p, .bl get, .wep get, etc.) and replies surface in the Last server response panel, but live HUD overlays will remain empty because the server isn't broadcasting.
If you want full BCH functionality on a Quests-only / Professions-only server, ask the admin to enable at least one of the five systems above. The Eclipsed Bloodcraft config value is a separate broadcast-frequency knob (true = 0.1 s updates, false = 2.5 s updates) — both values work, but Eclipsed=true gives the smoothest experience on modern Bloodcraft. On older Bloodcraft builds, Eclipsed=false may suppress broadcasts entirely; if your server is stuck on an older release, set it to true.
Repo: https://github.com/KDavidP1987/BloodCraftHub
Status: v0.29.10 — pre-1.0 public beta, actively developed (APIs and UI may still shift before 1.0).
Beelzebub integration target: v0.131.0 (ApiVersion 28).
Uriel integration target: ApiVersion 1 (object-spawn collection).
At a glance: a "Game UI" group (works on any server, no server mods needed) + BLOODCRAFT / KINDRED / BEELZEBUB / URIEL / SETTINGS-AND-HELP tab groups · a standalone tabbed chat window · secondary info overlays + a Beelzebub ability action-bar + a Uriel nearby-public-storage overlay · every chat command from the backing server mods surfaced as forms + buttons. Each tab group only appears when the matching server mod is detected.
New in v0.28–v0.29 — overlay controls, a Uriel object-spawner overlay, server-switch fixes & a whisper UX overhaul:
- Whisper overhaul (tabbed chat → Whispers tab) — whisper anyone connected to the server (the old "must be nearby / have spoken" limit is gone), including a note to yourself; a whisper you send now shows who you sent it to (toggle: in the channel column "[→Name]" or the name column "→Name"); self-whispers read as "Note to self" (toggle). The Whispers tab was restructured — the conversation sub-tabs sit on top, and a single bottom line composes everything: a recipient quick-switch (reply to anyone while staying on the All-Whispers view) + a "+ Whisper…" picker to start a new conversation + the message box. Privacy fix: a whisper with no resolvable recipient can no longer fall through into Local chat.
- Uriel object-spawner overlay — a draggable spawn palette (category cycler + page selector + name/ID search, per-row Spawn / Despawn / Rotate), plus building hotkeys moved to the top of the Object Spawning tab and a "Despawn Nearest" control.
- Overlay visibility controls (0.28) — the OV button / hide-all hotkey can auto-reappear on a timer, optionally hide the BCH/OV launcher buttons too, and keep native chat hidden while overlays are hidden.
- Overlays-behind-menus now also drops BCH overlays behind the Social / Spellbook / Map (and other fullscreen) menus, not just inventory/crafting — while the coffin spawn screen still keeps them on top.
- Server-switch fixes — switching between servers running different mods now correctly re-detects them: the BLOODCRAFT / BEELZEBUB / URIEL tab groups (and the Beelzebub tab content) light up properly instead of staying greyed/"connecting."
- Fixes — closing the main panel no longer leaves your character stuck auto-attacking; combined-overlay stat-name abbreviation; the Shift overlay's recast/charge cooldown.
New in v0.26.0 — Uriel integration (sibling server mod: storage sharing / public prisons / stair restyling / object spawning):
- URIEL tab group, handshake-gated like Beelzebub, with Quick Start + Help guides, a Settings tab, admin tabs (Sharing / Objects / Config), a Connection → Re-detect Uriel card, and an inline "not detected" diagnostic.
- Storage Sharing — quick-share the nearest chest or build a custom share (permission + withdrawal limits + cost), pay-chest, and my-shares management.
- Nearby Public Storage — BCH detects Uriel-shared containers/cells around you client-side (no server query) and lists them in the Storage tab + a new draggable overlay.
- Object Spawning — spawn your unlocked prefabs, collection progress, category filter, and an optional full-catalog browse cached per Uriel version.
- Prisons & Stairs — share cells + Take-prisoner relay; live stair restyling across six styles.
- 0.26.1–0.27.1 follow-ups — temporary build-mode hotkeys (move / rotate / remove the nearest spawned object); a dedicated Object Catalog tab with aligned Name · Category · ID columns and pagination (50/page) for the full ~2,000-item list; spawn durability (Indestructible / Breakable / Smashable) + Respawn options; fully built-out Uriel admin tabs (player/prefab-targeted grant/revoke/block/share/plot tools with two-click confirms); and fixes for spawn placement, empty-list diagnostics, and the main-panel close no longer leaving your character stuck auto-attacking.
New in v0.24.x — chat, loadout & admin polish + Beelzebub v0.120→v0.131 catch-up:
- Secondary view-only chat window — a second draggable, display-only overlay that mirrors only the channels you pick, so you can watch two chat streams at once (enable + choose channels in Game UI → chat settings).
- First-run welcome + opens to the active mod — a one-time Quick Start on first launch, and the left rail now opens to whichever mod your server runs (Bloodcraft wins when both are present) instead of always Bloodcraft.
- Loadout fixes — the new Mounted form (slots 3/6/7) updates its slot buttons instantly on set-switch; slot buttons default to key labels (LM/Q/Sp/Sh/E/R/C/T); and an Unstick bar button recovers a bar stuck on a transformation's abilities.
- Admin recovery toolkit (Beelzebub → Admin: Players → Recovery) — Rebuild bar, Purge bar (last-resort engine-leak fix), and Cleanse stuck buffs (invisible/phased player states), plus the existing Respawn / Rebuild slots, with an in-panel escalation-ladder guide.
- Admin: Abilities — saved config changes now apply (
admin reload) and refresh in the table reliably; new Power window + Leap height tuning fields; editable form/weapon allow/!-block lists.
- Tidier forms — dropdowns and numeric fields across the panel no longer stretch edge-to-edge; the Bestiary and Loadout tabs were de-cluttered.
- Dual-mod (Bloodcraft) coexistence — the Admin: Config tab spells out which spell slots can contest and how to resolve them (
Interop_SlotInjectionPriority, or Bloodcraft's ShiftSlot/UnarmedSlots).
New in v0.20.0 — Beelzebub v0.100 catch-up (ApiVersion 22):
- Admin: Abilities table now lists every ability (enabled + disabled) via Beelzebub's new admin catalog scope; uncaptured abilities show their unit + numeric ID. The Bestiary keeps the player-collectible set.
- Custom transform loadouts — a new Transforms-tab editor: pick a form + phase to see each slot's current bind (with per-slot Clear), bind from that form's kit, or reset to defaults.
- New Transforms overlay — a draggable on-screen list of your forms; double-click to transform, with Phase 1 / Phase 2 / Revert buttons.
- More transforms — Werewolf, Golem, Gargoyle (+ a basic werewolf) join Dracula & Morgana, each multi-phase; per-transformation duration/cooldown tuning + a Transform_Enabled master switch and Transform_CooldownScope in the config tab.
- Rebuilt announcement editor — manage the broadcast message pools one message at a time (add/edit/remove via
broadcast-msg, list read from the server); a Reset loadouts admin button; and single primary/ultimate slot clears.
- "Show overlays" footer reflowed — label on its own line, and the 10+ overlay toggles now wrap onto as many rows as the window width allows (no more squish / border overlap when narrow).
New in v0.19.1 — testing & polish over 0.19.0:
- Summon management moved to the Hotkeys tab, plus a new draggable Summons overlay with a one-click Stash ⟷ Restore toggle (+ Recall / Clear).
- Admin tabs gate to admins — non-admins see the controls grayed-out (not hidden) with a Re-check admin button. The Admin: Abilities table is slimmer with aligned ID / Unit / Enabled columns, a Cancel/revert, per-field tooltips, and export-to-clipboard.
- Input fields show the text caret reliably (even when pre-filled) and no longer error on selection; overlay transparency is a live slider that now reaches fully-invisible; overlays stay properly behind game menus.
New in v0.19.0 — Beelzebub catch-up (now current with Beelzebub v0.94.0 / ApiVersion 20):
- Per-form ability sets. Build a distinct loadout per shapeshift form (Wolf, Bear, Rat, Spider, Toad, Werewolf, Gargoyle) alongside the universal + per-weapon sets — pick the form in the Loadout "Editing" dropdown.
- Primary + ultimate slots. Bind abilities to the left-click (primary) and T-key (ultimate) slots in addition to the six spell slots.
- Correct tooltips + catalog. Reassembles Beelzebub's now-chunked ability/catalog replies, so tooltips and the Bestiary are complete again; active-bar abilities resolve full tooltips by GUID (no more "No name").
- Clear-bar fixed to the per-bucket
.beelz clearbar; leaderboard / drop-odds / mute-duplicate-devour buttons; a 100%-collection hook.
- Admin: a per-ability shaping editor (cooldown, range, charges, AoE, projectile speed, duration, healing, summon caps, cast modifiers, …), per-unit transform tuning, capture-filter management, and server-announcement controls.
- Server loadout presets (save/load/list/delete) + a Transforms panel showing each form's mode / duration / live cooldown.
Earlier — v0.18.x — Beelzebub integration + a big stability pass:
- 0.18.0 — Beelzebub support. A full client UI for Beelzebub ("Lord of Gluttony", the ability-capture / transform mod): a new BEELZEBUB tab group — Bestiary collection tracker, Loadout (per-weapon ability sets), Hotkeys, Transforms, plus admin Config/Players — and a Beelz action-bar overlay with on-screen ability buttons, client-side cooldown rings, and optional per-ability keyboard shortcuts. Auto-detects whether the server runs Beelzebub.
- 0.18.1–0.18.3 — stability + detection. Fixed a logout-to-desktop crash; overlays no longer linger over the main menu after leaving a game; reliable mod re-detection when you switch servers without fully quitting; other mods' chat messages no longer get swallowed; overlays auto-hide on a server that doesn't run the matching mod.
- 0.18.4 — server-switch stability + polish. Fixed crashes when opening BCH after a server switch and when renaming a chest with the chat window open; the Shift overlay is now a compact, resizable ability-button tile; the Beelz action-bar shows real ability icons; new button color and launcher button size options. Full list in the changelog.
Earlier — v0.17.x (a big client-side release):
- 0.17.3 — chat overhaul + new-player hints. Whisper anyone on the server: right-click → Whisper on the social page (P) now opens in BCH's chat, double-click a name in chat to whisper, and the "+ Whisper…" picker /
\whisper <name> read the full online roster (not just people you've seen talk). Cleaner tabbed chat: optional separate channel/name columns with auto-fit so the message column grows first when you widen the window, an All-tab channel filter, and Alt + 1–6 tab hotkeys. Inline \g / \local / \whisper chat commands. New "you're leaving power on the table" hints on the Class / Weapon Expertise / Blood Legacy pages + overlays (toggleable, and only for systems your server has enabled). Fixes: "Putrid Rat" V-Blood capture, a stuck basic-attack when clicking chat tabs/input, and Eclipse command-console chat spam. Known issue: Stash All must be clicked with your inventory/menu closed (with "Overlays behind game menus" on, BCH overlays sit behind the menu) — fix planned.
- 0.17.2 — fixed the load / V-Blood-tracking / waypoint-teleport crash. Some 0.16.x players crashed on login, on starting to track a V-Blood/boss, or on a waypoint teleport (and then on every load after). The cause was BCH's "don't open menus while typing" feature detouring three of the game's menu-input systems, which tipped a BepInEx IL2CPP interop bug during HUD rebuilds. Those three patches are removed — menu suppression while typing now uses a safe approach instead — while the "don't move / cast while typing" suppression stays. Overlays also now build on a quiet frame a few seconds after login. Minor known gap: menu keys can still open a menu while typing into a main-panel form (press Escape); a safe fix is planned. (A form-typing experiment was reverted for stability — see the changelog.)
- Standalone "Game UI" group + tabbed chat window — a movable, persistent, per-channel chat window (All / Global / Local / Clan / System / Whispers) with sender names, whisper conversations, an optional native-chat takeover, an All-tab "send to" dropdown + Tab-to-cycle, per-channel colored tabs, configurable colors, chat-only text size, word-wrap input, and its own transparency + theme. Works on any server.
- Runs alongside Eclipse (command-console mode) — install both and BCH auto-detects Eclipse, stands down from its own live readouts (Eclipse shows those), and keeps its command buttons, chat window, Familiar Browser, and V-Bloods scanning working. No more load crash.
- Folds in the 0.16.1 stability hardening (custom recipes default-off + deferred; gated SHIFT-icon read).
Full per-version history lives in CHANGELOG.md.
Screenshots
All captures below are from v0.13.0 — every UI piece shown still applies in v0.17.3. Newer work (v0.16's input-suppression + Quick Actions overlay, and v0.17's Game UI group + tabbed chat window + Eclipse command-console mode) is largely invisible until triggered; the screenshots below still represent the day-to-day look of the panel.
Class tab — Active Class card now includes the live class-details block (Death Mage shown here, with archetype + tagline + weapon/blood synergies + on-hit debuff). The Last server response strip at the bottom shows the same data the Bloodcraft .class lst reply carries, with stat synergies color-coded by Weapon / Blood. Settings → Display → Combined overlay carries the same data into the combined HUD overlay's Weapon and Blood sections.
Weapon Expertise — Current Weapon Expertise card (level + chosen bonus-stat names + live numeric values), the v0.13 Class synergies card explaining which weapon stats your current class amplifies with a 1.5× cap, and the Set bonus stat for a weapon form. The collapsible reference below lists every baseline stat cap (Physical Power +20, Spell Power +10, etc.).
Blood Legacy — mirror treatment for the blood side. Current legacy state, class synergies card (which blood stats your class amplifies), action row, and the .bl cst set-bonus-stat form. Bottom collapsible has the full baseline-cap reference for every blood stat.
Prestige — current prestige rows for each system (XP / Blood Legacy / Weapon Expertise / Familiar), the Prestige info display with current-tier breakdown, plus the "What each prestige tier gives you" reference card so you can see what every additional tier of leveling / weapon / blood / Exo prestige actually grants.
Settings & Help → Settings — the v0.12 two-zone panel color theme (outer chrome + interior scroll surfaces, with seven dark + seven bright presets for the interior), per-overlay transparency sliders, panel-background color, and HUD extras toggles. v0.13.0's gold-band section markers make long Settings / Mod Help pages scannable.
Main panel open in-world to the V-Bloods collection tab, with the bound-familiar indicator at the right of the screen and the floating BCH button strip at the top-right. The footer overlay-toggle row (visible at the bottom of the main panel) is where the v0.14 Combined toggle lives, sitting alongside XP / Familiar / Familiar Browser / Daily Quest / Professions / Shift Spell.
In-castle shot showing BCH's overlays running unobtrusively alongside the V Rising HUD, with the player's familiar and servants in view. The right-side stack shows the XP / weapon / blood / familiar progress readouts streaming live data via Bloodcraft's signed broadcast protocol; the per-overlay transparency settings keep them legible without competing for visual attention.
What it does
- Floating BCH + OV button strip top-right of the screen → BCH opens the main panel; OV is a master overlay show/hide that respects each overlay's individual setting. Overlay Visibility options (v0.28, Settings → Display) let OV/its hotkey act as a timed hide that auto-reappears after a countdown, optionally hide the launcher buttons too for a fully clean screen (safety-gated so you always have a way back), and keep the game's native chat hidden during a hide instead of letting it pop back.
- Tabbed primary UI with collapsible groups in the left rail (each appears only when its server mod is detected):
- BLOODCRAFT (12 tabs): Familiars, Boxes, V-Bloods, All Familiars, Class, Weapon Expertise, Blood Legacy, Unarmed + Shift, Prestige, Levels, Daily Quests, Admin
- KINDRED (6 tabs): Logistics, Logistics: Admin, Commands, Admin: Players, Admin: Server, Admin: World
- BEELZEBUB (v0.19): Bestiary collection tracker, Loadout (universal + per-weapon + per-form ability sets, incl. primary/ultimate slots), Hotkeys, Transforms, Settings, + admin Config / Players (with a per-ability shaping editor)
- SETTINGS AND HELP: Quick Start, Mod Help, Beelzebub Quick Start + Help, Game Guide, Settings, Vanilla Admin, About
- Eight secondary overlays (toggle from footer): XP tracker (with EXO prestige), Familiar quick-glance, Familiar Browser, Daily Quest tracker, Professions (all eight Bloodcraft profession levels), Shift Spell cooldown (now showing the slotted spell's icon, v0.16), the v0.14 Combined info overlay (one panel with XP + Familiar + Weapon + Blood + Professions + Quests in configurable sections), and the v0.16 Quick Actions overlay (one-click command buttons, shipping with Stash All). Each is independently draggable + resizable, with its own background transparency setting. Visibility persists across sessions; the OV button hides/shows all currently-enabled overlays at once. Combined mode is mutually exclusive with the four standalone info overlays it replaces (XP / Familiar / Daily Quest / Professions).
- Freeze character actions while the UI is open (v0.16, opt-in) — with the main panel open, optionally stop your character from moving, attacking, and casting, and block game-menu hotkeys (build, map, inventory, etc.) so nothing happens in the background while you click around the UI. Especially handy for admins who keep commands or abilities on hotkeys. Toggle in Settings → Display; off by default. Only the gameplay-input systems are suppressed — the panel, cursor, and form typing stay fully responsive.
- In-rail Bloodcraft diagnostic + Force-enable (v0.15.0) — when the Bloodcraft handshake fails (server doesn't run Bloodcraft, runs only Quests/Professions, or has the older hard-Eclipsed config), the BLOODCRAFT group expands to a diagnostic explaining the cause + a one-click button to force-enable tabs so the chat-regex pipeline (
.fam boxes, .quest p, .bl get, etc.) remains usable.
- Opt-in keyboard hotkeys (v0.15.0) — bind one key to "open main panel" and another to "toggle all overlays" via Settings → Display → Hotkeys. Unbound by default; mouse clicks on the floating button strip work unchanged.
- Three-state diagnostic mode (v0.15.0) — Off / Session / Always. Session-only logging never persists across game restarts, so a one-off bug repro can't leave verbose logging on forever.
- Dual text-size toggle (Small / Standard / Large / X-Large, separate for the UI and for the overlays) on the Settings tab.
- "Last server response" docked panel at the bottom of the main panel — replies to read-data chat commands (
.wep get, .class l, .misc userstats, .clan list, etc.) appear in-UI as well as in chat, so you don't have to chase the chat box for the answer.
- Forms-driven commands — every chat command with arguments has a real form (player picker + enum dropdowns + numeric inputs + Submit). No more typing
.lvl set <Player> <Level> in chat.
- Live data via Bloodcraft's structured MAC-signed protocol (the same channel Eclipse uses). Falls back to regex parsing for
.fam boxes / .fam l / .bl get / .wep get and other read-data replies that the structured protocol doesn't cover.
- Bloodcraft custom recipes (v0.16) — when the server has Bloodcraft's extra recipes enabled, BCH surfaces them in the vanilla crafting/refinement stations (vampiric dust, copper wires, charged battery, soul-shard extraction, primal jewel, blood crystal, primal stygian, plus new salvage outputs) — the same surface Eclipse provided. Client-side display only (the server still validates every craft); only appears when the server enables them; automatically skipped when the Eclipse mod is installed. Toggle via the
EnableCustomRecipes config option.
- Two-zone panel color theme (v0.12.x) — outer chrome and interior scroll surfaces are independently themed, with seven dark + seven bright presets for the interior and a free-form hex picker for either zone.
- Hover tooltips for every control, surfaced in a single footer line at the bottom of the panel.
- Scrollable tabs + scrollable left rail — long admin tabs scroll within the viewport instead of clipping; the tab strip itself scrolls when all groups are expanded so the BLOODCRAFT Admin button is always reachable.
- Auto-resizing panel that grows/shrinks to fit the active tab content (capped at 90% of screen height; toggleable).
- V-Blood collection scanner — walks every familiar box to catalog which V-Bloods you've captured, with summon-from-anywhere via the V-Bloods tab or the Familiar Browser overlay's V-Blood mode.
- Passive player-name autocomplete cache that fills as the server prints names into chat.
Installation
BloodCraftHub is a client-side mod. It does nothing on the server; install only on the V Rising client of the player who wants the UI.
Via Thunderstore Mod Manager (recommended)
- Open Thunderstore Mod Manager.
- Select V Rising → your existing profile (or create a new one).
- Search for BloodCraftHub under the Mods tab → Install.
- Make sure BepInExPack_V_Rising (the dependency) is installed in the same profile.
- Launch V Rising via the mod manager (not Steam directly).
Via r2modman
Same flow — open r2modman, V Rising profile, search BloodCraftHub, install, launch.
Manual install
- Install BepInEx for V Rising (
BepInExPack_V_Rising 1.733.2 or compatible).
- Drop
BloodCraftHub.dll into <V Rising>/BepInEx/plugins/.
- Launch V Rising.
First launch
When you connect to a server running Bloodcraft, a small floating BCH button appears top-right. Click to open the panel. Hover any control to see what it does — the description prints in the panel's bottom footer.
You don't need to be an admin to use BloodCraftHub — non-admin commands work for everyone. Admin tabs return permission errors gracefully if you're not authorized.
Compatibility
BloodCraftHub talks to the server through chat commands and Bloodcraft's signed Eclipse-protocol channel. It was tested against these versions:
| Mod |
Tested version |
Role |
| BepInEx for V Rising |
BepInExPack_V_Rising 1.733.2 |
Loader (hard dependency) |
| Bloodcraft (server) |
v1.13.21 |
Primary integration target |
| KindredCommands (server) |
v2.5.8 |
Admin/player commands surfaced under KINDRED |
| KindredLogistics (server) |
v1.6.0 |
Personal/admin toggles surfaced under KINDRED |
| Beelzebub (server, optional) |
v0.100.0 (ApiVersion 22) |
Ability capture / transforms surfaced under BEELZEBUB (v0.20) |
| Eclipse (client) |
v1.3.13 |
Source mod for the signed-protocol design. ⚠ Compatibility needs re-testing — was incompatible (client crash); Eclipse has since updated and we haven't re-verified. Disable Eclipse while running BloodCraftHub to be safe. See the Eclipse heads-up at the top of this README. |
| BloodCraftUI / OnlyFams (client, optional) |
v1.1.0 |
Source mod for the panel framework; coexists, doesn't conflict |
If the server is running a newer Bloodcraft, most things should still work — the chat-command grammar is fairly stable. If a tab silently does nothing on click, the server probably renamed a command and MessageService_Processing.cs's BCCOM_* constants need a bump.
Known issues
- Eclipse mod compatibility needs re-testing — see the top-of-README heads-up. Previously, Eclipse + BCH installed together hard-crashed the V Rising client. Eclipse has since updated and we haven't re-verified; likely still incompatible. Disable Eclipse while running BloodCraftHub to be safe. Re-test + coexistence work is on the roadmap.
- Controller / gamepad edge cases under investigation — see the controller heads-up at the top of this README. v0.15.0 ships a first-pass fix; more thorough testing is in progress. If you play with a controller and notice the UI opening, closing, or focusing on the wrong button after an in-game action, please report via Discord with repro steps.
- Per-feature server detection is conservative — when a Bloodcraft server has the structured protocol enabled but individual systems (Familiars / Quests / Professions / etc.) disabled, BCH currently still shows the corresponding tabs and overlays. A future release will add per-system chat-regex probes so the UI can hide / dim per-system surfaces that the server has turned off.
- Tooltips occasionally don't render on some control rows — diagnostic logging is in. If you see "TooltipHover wired" in BepInEx's
LogOutput.log but the footer never updates while hovering, please open a GitHub issue (or toggle Settings → Display → Hotkeys & diagnostics → Diagnostic mode to This session and share the relevant LogOutput.log snippet).
- No autocomplete dropdown yet — the player-name cache fills passively from chat, but the form fields don't render a dropdown of known names. You still have to type the name. Planned for a follow-up release.
- Pagination only on
.clan list — the other paginated commands (.castle plotsowned, .search item, etc.) accept a page int but don't have prev/next widgets yet. Type the command in chat for now.
- Quitting V Rising is required before redeploy if you're a developer iterating — the running game file-locks
BloodCraftHub.dll and the post-build copy step errors.
For the full open-issue list, see the project's GitHub issues.
Roadmap
Where BloodCraftHub is headed next. This is direction, not a dated promise —
priorities shift with player feedback, and the fastest way to influence them is
the The Shadow Realm Discord.
- Eclipse coexistence — re-test against the latest Eclipse and resolve the
remaining client crash so BloodCraftHub and Eclipse can run side by side,
instead of asking you to disable one.
- Per-system server awareness — automatically hide or dim the tabs and
overlays for Bloodcraft systems your server has turned off, so the UI shows
only what's actually live (today it still shows them, just empty).
- Name & item autocomplete in forms — dropdown suggestions in the command
forms instead of typing player / item names by hand.
- More Quick Actions — additional one-click command buttons in the new
Quick Actions overlay.
- Controller / gamepad polish — continued hardening of the UI under
controller input.
- Broader server-mod support — surface more server-side mods (additional
Kindred mods and others) with auto-detection so only the relevant tabs show.
- Buffs dashboard — an at-a-glance view of active buffs from leveling,
professions, and potions.
- Pagination controls — prev/next widgets for the remaining paginated
commands (
.castle plotsowned, .search item, etc.).
Acknowledgements
BloodCraftHub is a client UI for server-side mods built by other developers. The
features it surfaces would not exist without their work. If you use BCH, please
also show the upstream mods some love:
Bloodcraft — by zfolmt
Leveling, expertise, legacies, professions, familiars, classes, quests! The
bulk of what BloodCraftHub surfaces (every BLOODCRAFT-group tab) is wrapping
zfolmt's chat-command surface.
KindredCommands & KindredLogistics — by odjit
Server administration utilities and personal/admin logistics toggles. The KINDRED
admin tabs (Players / Server / World) and the Logistics section all call into
odjit's mods.
About the UI
BCH was built on the V Rising server The Shadow Realm (Brutal PvE), maintained
by Chaos. If you want to support BCH development directly:
Special thanks — testing & feedback
BloodCraftHub has been shaped almost entirely by hands-on playtesting and
detailed reports from these friends, who have helped on and off across many
releases. Every false-positive, every "this looks wrong" screenshot, and every
controller / partial-server / disabled-system scenario in the release notes
traces back to their patience and careful repro work:
- Moonie
- Bradley
- Xavarie
- Exotic Mystique
- Shiyrva
- Imperivm Draconis
Thank you all. The mod is meaningfully better because of you.
BloodCraftHub is open source (MIT). Bug reports, feature ideas, and pull
requests welcome at https://github.com/KDavidP1987/BloodCraftHub.
For developers
Dev docs
First-time setup
cd BloodCraftHub
.\tools\install-hooks.ps1 # wires up the pre-commit + commit-msg hooks
Build
cd BloodCraftHub
dotnet restore BloodCraftHub.sln
dotnet build BloodCraftHub.sln -c Release
Optional: deploy the built DLL directly to your client's BepInEx plugins folder:
# Default target is r2modman / Thunderstore Mod Manager "Default" profile.
dotnet build BloodCraftHub\BloodCraftHub.csproj -c Release -p:DeployToClient=true
# Override the r2modman profile name:
dotnet build BloodCraftHub\BloodCraftHub.csproj -c Release -p:DeployToClient=true -p:R2ModmanProfile=MyProfile
# Or target a non-r2modman install (vanilla Steam path):
dotnet build BloodCraftHub\BloodCraftHub.csproj -c Release `
-p:DeployToClient=true `
"-p:ClientPluginDirectory=C:\Program Files (x86)\Steam\steamapps\common\VRising\BepInEx\plugins"
Heads up: fully quit V Rising before redeploying. A running game file-locks the DLL and MSBuild's Copy step errors with MSB3021. The compile itself still succeeds — just the copy fails.
Layout
BloodCraftHub/
├── BloodCraftHub.sln
├── docs/ ← read CHANGELOG + ARCHITECTURE first
├── tools/ ← preflight.ps1, bump-version.ps1, install-hooks.ps1
├── .githooks/ ← pre-commit + commit-msg
└── BloodCraftHub/ ← plugin project
├── BloodCraftHub.csproj
├── Manifest.props ← generates Thunderstore manifest.json
├── thunderstore.toml ← package metadata for tcli
├── Plugin.cs ← BepInEx entry
├── Core.cs ← runtime singleton
├── icon.png ← 256×256 BCH icon
├── Behaviors/
│ CoreUpdateBehavior.cs ← IL2CPP-registered MonoBehaviour, per-frame loop
├── Config/
│ Settings.cs ← BepInEx-bound, static accessors
├── Patches/ ← Harmony patches
│ ClientChatPatch ← inbound: Eclipse protocol + regex fallback + name harvest
│ InitializationPatch ← UI bring-up + LocalCharacter/User capture
│ GameManagerPatch / EscapeMenuPatch / UICanvasSystemPatch / VersionStringPatch
├── Services/
│ MessageService ← outbound chat injection (immediate send)
│ MessageService_Processing ← BCCOM_* command constants + regex pipeline
│ EclipseProtocolService ← MAC-signed protocol decode + registration
│ PlayerStateService ← single source of truth for parsed state
│ PlayerNameCacheService ← passive name harvest + autocomplete cache
│ RecipeService ← client-side Bloodcraft custom-recipe injection (v0.16)
├── UI/
│ BCHubUIManager ← root, owns floating button + lazy panels
│ TooltipHover ← hover-tooltip polling service
│ Framework/ ← UniverseLib + CustomLib + ModernLib (folded in)
│ Forms/
│ FormBuilder ← builds form panels from FormField specs
│ FormField ← TextField/IntField/EnumField<T>/BoolField/PlayerNameField
│ CollapsibleSection ← accordion wrapper, fires Toggled event
│ ModContent/
│ FloatingButtonPanel ← 40×40 BCH button (top-right)
│ MainPanel ← tabbed primary UI (Bloodcraft tabs + Quick Start)
│ MainPanel.KindredAdmin ← partial-class file: 3 KindredCommands admin sub-tabs
│ ExperienceOverlayPanel / FamiliarOverlayPanel
│ ModContent/Data/PanelType ← enum of every tab and overlay identity
├── Utils/ ← LogUtils + Extensions (Entity.Read/Write/Has, color helpers)
└── Resources/
├── PrefabGUIDs.cs ← static prefab GUID lookup (stub)
├── PrefabNameResolver.cs ← runtime PrefabCollectionSystem name lookup
├── SecretManager.cs ← HMAC shared-key loader (regex-parses secrets.json)
├── secrets.json ← embedded HMAC key (same default Bloodcraft+Eclipse ship)
└── Localization/English.json
License
MIT — see LICENSE.txt for the full text plus third-party attribution for ported code from BloodCraftUI (panthernet), Eclipse (zfolmt), and the runtime peers we integrate with: Bloodcraft (zfolmt), KindredCommands (odjit), and KindredLogistics (odjit).
