CrimsonAlliance

Server side only for V Rising 1.1 (Invaders of Oakveil).

CrimsonAlliance lets clan leaders form alliances through chat commands. Allied clans share an alliance chat channel, and server owners can cap alliance size and lock membership changes around castle raid windows.

Friendly fire between allied clans follows the game's damage rules with CrimsonAlliance alone. The optional CrimsonRaidGuard integration provides separate friendly-fire toggles for raids and the open world.

Installation

Install BepInExPack V Rising 1.733.2, VampireCommandFramework, and VAMP on the dedicated server.
Extract CrimsonAlliance.dll into the server's BepInEx/plugins directory.
Start the server once to generate BepInEx/config/CrimsonAlliance.cfg. Stop the server, edit the file, then restart to apply your changes.

Commands

Run commands in chat with .alliance or its alias .ally. Quote clan or character names that contain spaces. These commands use clan roles and invite ownership where indicated. They require no server admin privileges.

Command	Who can use it and what it does
`.ally invite "Clan Name" ["Leader Name"]`	A clan leader invites another clan. The recipient clan leader must be online with invites enabled. The optional leader argument is for existing clans that share a name.
`.ally accept` / `.ally decline`	The recipient accepts or declines their pending invite.
`.ally invites [on\|off]`	Any player can toggle their own incoming invites. Omitting the argument turns invites off. The on aliases are `true`, `yes`, and `active`. The off aliases are `false`, `no`, and `inactive`.
`.ally status` / `.ally me`	A clan member can view their own alliance.
`.ally members`	View your clan's alliance. Use `.ally members clan "Clan Name"` or `.ally members player "Character Name"` to look up another alliance. The target aliases are `c` and `p`.
`.ally kick "Clan Name"`	The leader of the alliance's founding clan removes a clan.
`.ally leave`	A clan leader withdraws their clan. If the founding clan leaves, the alliance disbands.
`.ally disband`	The leader of the founding clan disbands the alliance.

The duplicate-name invite lookup currently checks only the first matching clan's leader. Use distinct clan names for reliable invites.

To message all allied clans, send .a Meet at the bridge in Clan (Team) chat.

When raid locking is enabled, the server blocks invite, accept, kick, leave, and disband during the raid window and its configured buffers. The window uses the server's local time and castle damage settings.

Config

The generated BepInEx/config/CrimsonAlliance.cfg uses these defaults.

[General]
ToggleMod = true

[Alliance]
FriendlyFire = true
MaxAllianceSize = 2
InviteExpiration = 5
ChatColor = #e8515e
LockDuringRaidWindow = true

[Buffers]
PreRaidBufferMins = 30
PostRaidBufferMins = 0

MaxAllianceSize includes the founding clan. InviteExpiration is in minutes with a minimum of one minute.
ChatColor sets the alliance chat message color.
The standalone FriendlyFire setting currently has no effect on damage. Use the CrimsonRaidGuard settings below to control friendly fire between allied clans.

Saved data

CrimsonAlliance manages both files in VAMP's _WipeData directory. It writes the invite preferences periodically and saves alliance membership when alliances change.

BepInEx/config/_WipeData/calliances_alliancelist.json maps founding clan GUIDs to arrays of member clan GUIDs, including the founder.

{
  "11111111-1111-1111-1111-111111111111": [
    "11111111-1111-1111-1111-111111111111",
    "22222222-2222-2222-2222-222222222222"
  ]
}

BepInEx/config/_WipeData/calliancees_disabled_invites.json stores the numeric platform IDs of players who have turned off invites.

[76561198000000000]

Integrations

With CrimsonRaidGuard installed and active, its [Alliance] section controls damage between allied clans. Set FriendlyFireRaid to false to block it when either player is in a raid, or set FriendlyFireWorld to false to block it outside raids. Both default to true.

CrimsonLog is an optional plugin. CrimsonAlliance detects it at startup.

Other server mods can use VAMP's ModTalk to query alliances by the founding clan's GUID string. CrimsonAlliance.InAlliance returns a boolean indicating whether that alliance has multiple clans. CrimsonAlliance.GetClans returns a string array of resolved clan names with the founding clan first.