PerkShop

PerkShop is a server-side V Rising mod that adds a configurable perk shop through VampireCommandFramework commands.

Players can buy persistent buffs and stat perks. Admins can grant, revoke, whitelist, inspect, validate, reload, and sync player perks. Stats acquired via PerkShop may not all appear in the player's UI, but they still have gameplay effects.

Current packaged source version: 0.3.0

Highlights in this release:

• per-entry currency overrides for buffs and stats
• relic tower buffs included in the default config
• relic category standardized to relic
• expanded command/config/key documentation

Command prefix:

.perk

Credits

PerkShop was inspired by and built with reference to the V Rising modding community's work:

• Bloodcraft by zfolmt — inspiration/reference for the buff and stat systems.
• PrisonerBlood by GGs — inspiration/reference for the command-based shop flow.

Transparency

The original working code for the mod is human made, but it has been greatly tinkered with AI for debugging and optimization.

Features

• Configurable buff shop.
• Configurable permanent stat shop.
• Renewable timed buffs for potions, elixirs, blood buffs, and relics.
• Blood-buff category defaults to five slots.
• Relic category defaults to four slots.
• Purchased ownership persists across relogs/restarts, with manual session sync available.
• Admin-given buffs and flat stats.
• Buff/stat whitelist support.
• .perk validate, .perk diag, .perk reload, and .perk syncall for live-server administration.
• Debounced JSON persistence and throttled periodic reapply.
• Bloodcraft-safe default stat carrier.
• Optional per-entry currency override while keeping a global default currency.

Dependencies

Install these before PerkShop:

• BepInExPack for V Rising
• VampireCommandFramework

This repository does not include game, BepInEx, VCF, or interop DLLs.

Installation

Copy the compiled DLL to the server:

BepInEx/plugins/PerkShop/PerkShop.dll

Start the server once to generate:

BepInEx/config/PerkShop/perkconfig.json
BepInEx/config/PerkShop/ownedbuffs.json
BepInEx/config/PerkShop/playercache.json

Then edit the config and reload in game:

.perk reload
.perk validate
.perk diag

Command Reference

Player commands

Admin commands

Whitelist commands

Configuration Reference

Config file:

BepInEx/config/PerkShop/perkconfig.json

Reload after editing:

.perk reload
.perk validate

Important top-level options

Stat carrier

Default:

"StatCarrierBuffPrefab": -809648681

This is intended to avoid Bloodcraft's known carrier. Keep it configurable for compatibility with other servers/mod stacks.

Buff categories

Blood buffs default to five slots:

"BuffCategories": {
  "blood_buff": {
    "MaxOwnedSlots": 5
  }
}

Relic buffs default to four slots:

"BuffCategories": {
  "relic": {
    "MaxOwnedSlots": 4
  }
}

Set MaxOwnedSlots to -1 for unlimited slots.

Renewable timed buffs

Potions, elixirs, blood buffs, and relic buffs are intended to keep a normal countdown and renew when missing or expired.

This is preferred over force-removing LifeTime, which can leave stale client UI state for some vanilla buff prefabs.

Configuration Guide

Workflow

1. Start the server once to generate config.
2. Stop the server.
3. Edit BepInEx/config/PerkShop/perkconfig.json.
4. Start the server.
5. Run:

.perk reload
.perk validate
.perk diag

Recommended live defaults

{
  "Enabled": true,
  "EnableBuffShop": true,
  "EnableStatShop": true,
  "EnableClientUnsupportedStats": true,
  "EnableExperimentalBloodBuffs": true,
  "RenewableTimedBuffDurationSeconds": 7200,
  "ReapplyCheckIntervalSeconds": 60,
  "ReapplyMaxUsersPerCycle": 5,
  "OwnershipSaveDebounceSeconds": 2,
  "PlayerCacheSaveDebounceSeconds": 30,
  "EnableDebugLogging": false
}

Buff entries

Each buff entry defines a buyable persistent perk.

Buff entries can optionally override the global currency with CurrencyPrefab and CurrencyName.

Stat entries

Each stat entry defines a buyable stat rank.

Stat entries can also optionally override the global currency with CurrencyPrefab and CurrencyName.

UI limitations

PerkShop applies stats server-side through V Rising stat modifiers. Some stats may affect gameplay but not appear in the vanilla TAB/Eclipse attributes UI.

Key Reference

Stat keys

Blood buff keys

Relic buff keys

These use the standardized relic category.