CrimsonUtility

Server admin tools for raids, castles, player activity, teleportation, and crafting restrictions.

By skytech6

Last updated	2 days ago
Total downloads	9
Total rating	0
Categories	Mods Oakveil Update Server
Dependency string	skytech6-CrimsonUtility-0.1.4
Dependants	0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack_V_Rising

BepInEx pack for V Rising. Preconfigured and includes Unity Base DLLs.

Preferred version: 1.733.2

deca-VampireCommandFramework

Command framework for developers to easily create universal commands for their plugins.

Preferred version: 0.11.0

skytech6-VAMP

V Rising API Modding Platform

Preferred version: 2.0.0

README

CrimsonUtility

Server side only · V Rising (Oakveil)

CrimsonUtility gives server admins tools to inspect raids, siege golems, castles, and player activity. It also adds admin teleports and an optional workstation recipe blocklist.

Installation

Install these dependencies on the dedicated server. BepInExPack V Rising 1.733.2 · VAMP 2.0.0 · VampireCommandFramework 0.11.0
Extract CrimsonUtility.dll into the server's BepInEx/plugins directory.
Start the server once to generate BepInEx/config/CrimsonUtility.cfg. Stop the server, set ToggleMod = true in that file, and start it again.

Config

The generated BepInEx/config/CrimsonUtility.cfg has these defaults. Restart the server after editing it.

[General]
ToggleMod = false

[Systems]
CraftBlocker = false

Crafting blocklist

With ToggleMod and CraftBlocker enabled, the server creates an empty BepInEx/config/CrimsonUtility/craft_block.txt if needed. Add one signed integer recipe prefab GUID per line. Use the GUID of the recipe itself. Lines starting with # are comments. Restart the server to load the edited list.

Activity data

While enabled, the mod records playtime by Steam ID and week in BepInEx/config/CrimsonUtility/activity_tracking.json. The server creates and updates this file during periodic saves and prunes old week buckets using a five-week cutoff. A saved entry looks like this.

{
  "2025-W24": [
    {
      "player_id": 76561198000000000,
      "login": "0001-01-01T00:00:00",
      "seconds": 3600
    }
  ]
}

Commands

All commands require server admin permissions. Use .utility or its alias .util in chat. Arguments in <angle brackets> are required, and arguments in [square brackets] are optional. For example, .util ip 5 2 lists up to five of the least active players over two weeks.

Raids and teleports

Command	Alias	Effect
`.utility ListRaids`	`.util lr`	List castle owners whose castles are under siege.
`.utility ListGolems`	`.util lg`	List active, summoning, and summoned siege golems. Summoning and summoned entries include instance IDs.
`.utility TPGolem <instanceId>`	`.util tpg`	Teleport to a golem by its listed instance ID.
`.utility TPRaid`	`.util tpr`	Teleport to a castle under siege. Repeat to cycle through current raids.
`.utility TPCastle <playerName>`	`.util tpc`	Teleport to a player's castle heart by character name.
`.utility TPCastleId <steamId>`	`.util tpcid`	Teleport to a player's castle heart by Steam ID.
`.utility TPNamed <name> [index]`	`.util tpname`	Teleport to an interactable by exact name. A positive index selects a specific match starting at `1`. The default `0` picks the first match at least 20 units away.

Castle tiles

Command	Alias	Effect
`.utility CastleTiles <min> <max>`	`.util ct`	Report the count and percentage of owned castles in the inclusive floor tile range.
`.utility CastleTilesPlayer <playerName>`	`.util ctp`	Report a player's castle floor tile count.
`.utility CastleTilesMax`	`.util ctm`	Report the owner and tile count of the castle with the most floor tiles.

Player activity

The activity commands default to 4 weeks. Commands that accept count default to 10 results.

Command	Alias	Effect
`.utility InactiveCastles [count] [weeks]`	`.util ic`	List the least active castle owners by recorded playtime.
`.utility InactivePlayers [count] [weeks]`	`.util ip`	List the least active players by recorded playtime.
`.utility TopActive [count] [weeks]`	`.util ta`	List the most active players by recorded playtime.
`.utility CheckActivity <playerName> [weeks]`	`.util activity`	Show a player's total recorded playtime.
`.utility ActivityBreakdown <playerName> [weeks]`	`.util ab`	Show a player's recorded playtime for each week and the total.
`.utility ActivityStats [weeks]`	`.util as`	Show server-wide activity counts and playtime totals, averages, and medians.

Developer commands that modify player account bindings

.dev UnbindPlayer <playerName> disconnects the player if online and sets the character's platform ID to 0.
.dev SwapPlayers <player1> <player2> (alias .dev swap) disconnects both players if online and exchanges their platform IDs.