PerkShop

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

| Command | Description | |---|---| | .perk menu | Shows the main PerkShop command menu. | | .perk status [page] | Shows your owned buffs, purchased stats, admin grants, and slot usage. | | .perk search <text> | Searches configured buff and stat entries by key or name. | | .perk sync | Reapplies your owned buffs and stats for the current session. | | .perk bufflist [page] | Lists available buff purchase keys. | | .perk buffdet <buffKey> | Shows detailed information for a buff entry, including cost, category, and notes. | | .perk buffbuy <buffKey> | Buys a buff entry using its configured currency. | | .perk buffremove <buffKey> | Removes one owned buff entry from your active setup. | | .perk statlist [page] | Lists available stat purchase keys. | | .perk statdet <statKey> | Shows detailed information for a stat entry. | | .perk statbuy <statKey> | Buys one rank of a stat entry. | | .perk statremove <statKey> | Removes all purchased ranks of one stat entry. |

Admin commands

| Command | Description | |---|---| | .perk admin | Shows the admin command menu. | | .perk info <player> | Shows PerkShop ownership and status info for a player. | | .perk reload | Flushes pending saves, reloads config, and rebuilds runtime caches. | | .perk diag | Shows runtime diagnostics for troubleshooting. | | .perk validate | Validates config entries and reports risky or invalid settings. | | .perk syncall | Reapplies PerkShop buffs and stats for cached online users. | | .perk giftbuff <player> <buffKey> | Grants purchased-style buff ownership to a player. | | .perk revokebuff <player> <buffKey> | Removes purchased-style buff ownership from a player. | | .perk addbuff <player> <buffKey> | Grants an admin-only buff entry to a player. | | .perk clearbuff <player> <buffKey> | Removes an admin-only buff grant and clears the active buff. | | .perk giftstat <player> <statKey> <ranks> | Grants purchased-style stat ranks to a player. | | .perk revokestat <player> <statKey> <ranks> | Revokes purchased-style stat ranks from a player. | | .perk addflat <player> <UnitStat|statKey> <amount> | Adds an admin flat stat modifier. | | .perk clearflat <player> <UnitStat|statKey> | Removes an admin flat stat modifier. |

Whitelist commands

| Command | Description | |---|---| | .perk wlstatus | Shows whether buff/stat whitelists are enabled and how many players are listed. | | .perk wlcheckbuff | Checks whether you can use the buff shop. | | .perk wlcheckstat | Checks whether you can use the stat shop. | | .perk wlcheckall | Checks both whitelist types for your current character. | | .perk wlplayer <player> | Checks whitelist status for a target player. | | .perk wladdbuff <player> | Adds a player to the buff whitelist. | | .perk wlremovebuff <player> | Removes a player from the buff whitelist. | | .perk wladdstat <player> | Adds a player to the stat whitelist. | | .perk wlremovestat <player> | Removes a player from the stat whitelist. |

Configuration Reference

Config file:

BepInEx/config/PerkShop/perkconfig.json

Reload after editing:

.perk reload
.perk validate

Important top-level options