s&box ConCmd / ConVar Generator

What are ConCmds and ConVars in s&box?

s&box exposes admin commands, debug toggles, and runtime config through the Source-engine-style console. Anything tagged with [ConCmd] becomes a callable command (e.g. kick <steamId>). Anything tagged with [ConVar] becomes a settable variable (e.g. sv_cheats 1). They're the backbone of every server admin tool — moderation, balance tweaks, performance flags, debug helpers.

Both attributes accept a flag bitmask of ConVarFlagsvalues. The flag list above is pulled directly from the s&box C# API schema, so it's guaranteed to match the engine — no drift.

ConVarFlags Reference

Common Patterns

Server-only admin command with caller info

[ConCmd( "kick", ConVarFlags.Server | ConVarFlags.Admin )]
static void KickCommand( Connection caller, string steamId )
{
    if ( caller is null || !caller.HasPermission( "kick" ) )
    {
        Log.Warning( $"{caller?.DisplayName} tried to kick without permission" );
        return;
    }

    var target = Connection.All.FirstOrDefault( c => c.SteamId.ToString() == steamId );
    if ( target is null )
    {
        Log.Info( $"No player with SteamID {steamId}" );
        return;
    }

    target.Kick( $"Kicked by {caller.DisplayName}" );
}

Replicated server config

[ConVar( "sv_max_players", ConVarFlags.Server | ConVarFlags.Replicated, Help = "Soft cap on connected players", Min = 1f, Max = 64f )]
public static int MaxPlayers { get; set; } = 32;

Saved local preference

[ConVar( "ui_show_fps", ConVarFlags.Saved )]
public static bool ShowFps { get; set; } = false;