Vietcong server API

Compatible with .NET Framework 4.8

Player methods

ChangeSide(Side side) : void

Changes the player side from US to VC and backwards.
Swap() : void

Swaps the player to the opposite side or team.
Kick(string reason = null) : void

Removes the player from the server with an optional reason.
Ban(int time = 2, string reason = null) : void

Bans the player for a certain time (default 2 units) with an optional reason.
Teleport(Vector3 position) : void

Moves the player to the specified coordinates in the game world.
SendMessageToAllAsPlayer(string content) : void

Sends a chat message to all players appearing as this player.
SendMessage(MessageType type, string content) : void

Sends a message to the player with a specified type (e.g., info, warning).

Player properties

Id : int

Unique identifier of the player.
Name : string

Player's nickname.
Kills : int

Number of kills the player has made.
Deaths : int

Number of times the player has died.
Ping : int

Player's network latency.
ItemInHand : int

ID of the item currently held by the player.
Side : int

Player's current side/faction (e.g., US or VC).
ClassId : int

Player's class ID (determines role or kit).
Ip : string

Player's IP address.
X : float

Player's X coordinate in the world.
Y : float

Player's Y coordinate in the world.
Z : float

Player's Z coordinate in the world.
HasBayonet : bool

Whether the player currently has a bayonet equipped.
SkinPath : string

Path to the player's skin/appearance file.
Location : Vector3 (computed)

Computed property returning the player's position as a Vector3 object.
Spawned : bool (computed)

Indicates if the player is spawned in the game (ClassId > 0 and Name is set).
IsValid : bool (computed)

Checks if the player data is valid (Ip and Name are not null).

VcdedAPI Public API

Events

OnChatMessage
Event triggered when a player sends a chat message.
What you get:
- Player player – the player who sent the message (null for system messages)
- string content – the message text
OnPlayerConnection
Event triggered when a player joins the server.
What you get:
- Player player – the player who connected
OnPlayerRecover
Event triggered when a player respawns or recovers in the game.
What you get:
- Player player – the player who respawned or recovered
OnClientConnection
Event triggered when a client connects to the server.
What you get:
- string ipAddress – IP address of the client
- int id – player ID if known
- int clientId – client ID if known
OnPlayerWeaponChange
Event triggered when a player changes their weapon.
What you get:
- Player player – the player who changed weapon
- int oldWeapon – previous weapon ID
- int newWeapon – new weapon ID
OnPlayerMove
Event triggered when a player moves in the game world.
What you get:
- Player player – the player who moved
- Vector3 newPosition – new position coordinates
OnWeaponBayonet
Event triggered when a player equips or unequips a bayonet.
What you get:
- Player player – the player who changed bayonet state
- bool hasBayonet – true if equipped, false if removed

Methods

VcdedAPI(string host, int port, bool allowOverInternet)

Constructor. Initializes the API and starts monitoring threads for chat, players, and connections.
GetPlayers() : List<Player>

Returns a list of online players (Ping > 0).
GetEnemies() : List<Player>

Returns a list of enemy players (Ping == 0).
GetEntities() : List<Player>

Returns a list of all player entities.
GetPlayersCount() : int

Returns the count of currently online players.
GetMaplist() : List<MapEntry>

Retrieves the full map list from the server.
GetCurrentMap() : MapEntry

Returns the currently active map.
SwitchMap(MapEntry map = null)

Switches to the specified map; if null, goes to the next map in the list.
SwitchMap(int index)

Switches to a map by index; -1 moves to the next map.
EnableFriendlyFire(bool enabled)

Enables or disables friendly fire on the server.
EnableVietnamMode(bool enabled)

Hides HUD, ammo, and magazines for a "Vietnam mode".
EnableVietnamModeChat(bool enabled)

Enables or disables Vietnam mode style chat.
EnableBlackDeathScreen(bool enabled)

Enables a black screen effect when the player dies.
SetServerPassword(string password = null)

Sets the server password; null disables it.
SetAdminPassword(string password = null)

Sets the admin password; null disables it.
SetSpectators(int count, int delay)

Sets the number of spectators and the view delay.
Say(string message)

Sends a message as administrator to all players (Host on DC).
AdminSay(string message)

Sends a message as administrator visible only to other admins.
CreateExplosion(Vector3 position, ExplosionType explosionType)

Creates a specified explosion type at the given position.
SpawnItem(Vector3 position, Item item)

Spawns a specified item at a given position.
SpawnItemWithDirection(Vector3 position, Vector3 direction, Item item)

Spawns an item at a position with a direction vector.
IgnoreMessagesStartsWith(char symbol)

Ignores chat messages starting with a specified symbol.
static ExecRaw(string command, bool recursive = false)

Executes a raw server command.
CrashServer() : bool

Attempts to crash the server (used for testing). Returns true if successful.
SendMessage(MessageType messageType, int id, string content)

Sends a message to a player or server with a specific message type.

Installation & Use

Unzip vcded.exe and vcded.dll file to the Vietcong server directory and replace them.
Run the server as normal using the new vcded.exe
Now open Visual Studio or whatever IDE you use and create a new C# project.
Link the DLL vcdedconnector.dll to the C# project and you can use the API.
Use directivity using vcdedconnector;

Here you have some example code you can use:

string hostAddress = "127.0.0.1";
int port = 2000;

VcdedAPI api = new VcdedAPI(hostAddress, port, false);

api.OnChatMessage += (sender, e) =>
{
    if (e.Message.Equals("/swap"))
    {
        e.Player?.Swap();
    }
    else if (e.Message.Equals("/ping"))
    {
        e.Player?.SendMessage(MessageType.HostOnDC, "PONG! Aprox: " + e.Player.Ping);
    }
    else if (e.Message.Equals("/ip"))
    {
        e.Player?.SendMessage(MessageType.HostOnDC, "Your IP: " + e.Player.Ip);
    }
};

api.OnPlayerConnection += (sender, e) =>
{
    // waits until player choose side and the gun
    e?.BlockThreadUntilSpawned();

    e.Player?.SendMessage(MessageType.HostOnDC, "Welcome on the server " + e.Player.Name + "!");
};

api.OnClientConnection += (sender, e) =>
{
    // waits until client (player) fully establish connection and receives the full handshake
    e?.WaitUntilClientEstablishFullConnection();

    api.SendMessage(MessageType.Console, e.Id, "You are joining to our server! Welcome!");
};