banning.qc File Reference

#include "banning.qh"
#include <common/command/_mod.qh>
#include <common/minigames/sv_minigames.qh>
#include <common/state.qh>
#include <common/stats.qh>
#include <common/util.qh>
#include <common/weapons/_all.qh>
#include <server/command/common.qh>
#include <server/ipban.qh>
#include <server/player.qh>

Include dependency graph for banning.qc:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	BAN_COMMAND(name, function, description)
#define	BAN_COMMAND(name, function, description)
#define	BAN_COMMAND(name, function, description)
#define	BAN_COMMAND(name, function, description)
#define	BAN_COMMANDS(request, arguments, command)

Functions
float	BanCommand (string command)
void	BanCommand_ban (int request, int argc, string command)
void	BanCommand_banlist (int request)
void	BanCommand_kickban (int request, int argc, string command)
float	BanCommand_macro_command (int argc, string command)
void	BanCommand_macro_help ()
float	BanCommand_macro_usage (int argc)
void	BanCommand_macro_write_aliases (float fh)
void	BanCommand_mute (int request, int argc, string command)
void	BanCommand_playban (int request, int argc, string command)
void	BanCommand_unban (int request, int argc)
void	BanCommand_unmute (int request, int argc)
void	BanCommand_unplayban (int request, int argc)
void	BanCommand_unvoteban (int request, int argc)
void	BanCommand_voteban (int request, int argc, string command)

Macro Definition Documentation

BAN_COMMAND [1/4]

#define BAN_COMMAND	(		name,
			function,
			description )

Value:

        { if (strtolower(description) != "") { LOG_INFO("  ^2", name, "^7: ", description); } }

BAN_COMMAND [2/4]

#define BAN_COMMAND	(		name,
			function,
			description )

Value:

        { if (name == strtolower(argv(0))) { function; return true; } }

BAN_COMMAND [3/4]

#define BAN_COMMAND	(		name,
			function,
			description )

Value:

        { if (name == strtolower(argv(1))) { function; return true; } }

BAN_COMMAND [4/4]

#define BAN_COMMAND	(		name,
			function,
			description )

Value:

        { if (strtolower(description) != "") { CMD_Write_Alias("qc_cmd_sv", name, description); } }

BAN_COMMANDS

#define BAN_COMMANDS	(		request,
			arguments,
			command )

Value:

    BAN_COMMAND("ban",          BanCommand_ban(request, arguments, command),        "Ban an IP address or a range of addresses (like 1.2.3)") \
    BAN_COMMAND("banlist",      BanCommand_banlist(request),                        "List all existing bans") \
    BAN_COMMAND("kickban",      BanCommand_kickban(request, arguments, command),    "Disconnect a client and ban it at the same time") \
    BAN_COMMAND("mute",         BanCommand_mute(request, arguments, command),       "Disallow a client from talking by muting them") \
    BAN_COMMAND("playban",      BanCommand_playban(request, arguments, command),    "Force to spectate a client permanently") \
    BAN_COMMAND("unban",        BanCommand_unban(request, arguments),               "Remove an existing ban") \
    BAN_COMMAND("unmute",       BanCommand_unmute(request, arguments),              "Unmute a client") \
    BAN_COMMAND("unvoteban",    BanCommand_unvoteban(request, arguments),           "Remove an existing voting ban") \
    BAN_COMMAND("unplayban",    BanCommand_unplayban(request, arguments),           "Remove an existing forced to spectate ban") \
    BAN_COMMAND("voteban",      BanCommand_voteban(request, arguments, command),    "Disallow a client from voting") \
    /* nothing */

Definition at line 467 of file banning.qc.

#define BAN_COMMANDS(request, arguments, command) \
    BAN_COMMAND("ban",          BanCommand_ban(request, arguments, command),        "Ban an IP address or a range of addresses (like 1.2.3)") \
    BAN_COMMAND("banlist",      BanCommand_banlist(request),                        "List all existing bans") \
    BAN_COMMAND("kickban",      BanCommand_kickban(request, arguments, command),    "Disconnect a client and ban it at the same time") \
    BAN_COMMAND("mute",         BanCommand_mute(request, arguments, command),       "Disallow a client from talking by muting them") \
    BAN_COMMAND("playban",      BanCommand_playban(request, arguments, command),    "Force to spectate a client permanently") \
    BAN_COMMAND("unban",        BanCommand_unban(request, arguments),               "Remove an existing ban") \
    BAN_COMMAND("unmute",       BanCommand_unmute(request, arguments),              "Unmute a client") \
    BAN_COMMAND("unvoteban",    BanCommand_unvoteban(request, arguments),           "Remove an existing voting ban") \
    BAN_COMMAND("unplayban",    BanCommand_unplayban(request, arguments),           "Remove an existing forced to spectate ban") \
    BAN_COMMAND("voteban",      BanCommand_voteban(request, arguments, command),    "Disallow a client from voting") \
    /* nothing */

Referenced by BanCommand_macro_command(), BanCommand_macro_help(), BanCommand_macro_usage(), and BanCommand_macro_write_aliases().

Function Documentation

BanCommand()

float BanCommand

(

string

command

)

Definition at line 520 of file banning.qc.

{
    int argc = tokenize_console(command);
 
    // Guide for working with argc arguments by example:
    // argc:   1    - 2      - 3     - 4
    // argv:   0    - 1      - 2     - 3
    // cmd     vote - master - login - password
 
    if (BanCommand_macro_command(argc, command)) // continue as usual and scan for normal commands
        return true;                             // handled by one of the above GenericCommand_* functions
 
    return false;
}

References BanCommand_macro_command(), and tokenize_console.

Referenced by GameCommand().

BanCommand_ban()

void BanCommand_ban	(	int	request,
		int	argc,
		string	command )

Definition at line 19 of file banning.qc.

{
    switch (request)
    {
        case CMD_REQUEST_COMMAND:
        {
            if (argc >= 2)
            {
                string ip = argv(1);
                float reason_arg, bantime;
                string reason;
 
                reason_arg = 2;
 
                GET_BAN_ARG(bantime, autocvar_g_ban_default_bantime);
                GET_BAN_REASON(reason, "No reason provided");
 
                Ban_Insert(ip, bantime, reason, 1);
                return;
            }
        }
 
        default:
            LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
        case CMD_REQUEST_USAGE:
        {
            LOG_HELP("Usage:^3 sv_cmd ban <address> [<bantime>] [<reason>]");
            LOG_HELP("  <address> is the IP address or range of the player to ban,");
            LOG_HELP("  <bantime> is the amount of time that the ban is active (default if not provided),");
            LOG_HELP("  and <reason> is the string to label the ban with as reason for banning.");
            LOG_HELP("See also: ^2banlist, kickban, unban^7");
            return;
        }
    }
}

References argv(), autocvar_g_ban_default_bantime, Ban_Insert(), CMD_REQUEST_COMMAND, CMD_REQUEST_USAGE, GET_BAN_ARG, GET_BAN_REASON, LOG_HELP, and LOG_INFOF.

BanCommand_banlist()

void BanCommand_banlist

(

int

request

)

Definition at line 55 of file banning.qc.

{
    switch (request)
    {
        case CMD_REQUEST_COMMAND:
        {
            Ban_View();
            return;
        }
 
        default:
        case CMD_REQUEST_USAGE:
        {
            LOG_HELP("Usage:^3 sv_cmd banlist");
            LOG_HELP("  No arguments required.");
            LOG_HELP("See also: ^2ban, kickban, unban^7");
            return;
        }
    }
}

References Ban_View(), CMD_REQUEST_COMMAND, CMD_REQUEST_USAGE, and LOG_HELP.

BanCommand_kickban()

void BanCommand_kickban	(	int	request,
		int	argc,
		string	command )

Definition at line 76 of file banning.qc.

{
    switch (request)
    {
        case CMD_REQUEST_COMMAND:
        {
            if (argc >= 2)
            {
                entity client = GetIndexedEntity(argc, 1);
                float accepted = VerifyKickableEntity(client);
                float reason_arg, bantime, masksize;
                string reason;
 
                if (accepted > 0)
                {
                    reason_arg = next_token;
 
                    GET_BAN_ARG(bantime, autocvar_g_ban_default_bantime);
                    GET_BAN_ARG(masksize, autocvar_g_ban_default_masksize);
                    GET_BAN_REASON(reason, "No reason provided");
 
                    Ban_KickBanClient(client, bantime, masksize, reason);
 
                    return;
                }
                else
                {
                    LOG_INFO("kickban: ", GetClientErrorString(accepted, argv(1)), ".");
                }
            }
        }
 
        default:
            LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
        case CMD_REQUEST_USAGE:
        {
            LOG_HELP("Usage:^3 sv_cmd kickban <client> [<bantime>] [<masksize>] [<reason>]");
            LOG_HELP("  <client> is the entity number or name of the player to ban,");
            LOG_HELP("  <bantime> is the amount of time that the ban is active (default if not provided),");
            LOG_HELP("  <masksize> is the range of the IP address (1-thru-4, default if not provided),");
            LOG_HELP("  and <reason> is the string to label the ban with as reason for banning.");
            LOG_HELP("See also: ^2ban, banlist, unban^7");
            return;
        }
    }
}

References argv(), autocvar_g_ban_default_bantime, autocvar_g_ban_default_masksize, Ban_KickBanClient(), CMD_REQUEST_COMMAND, CMD_REQUEST_USAGE, entity(), GET_BAN_ARG, GET_BAN_REASON, GetClientErrorString, GetIndexedEntity(), LOG_HELP, LOG_INFO, LOG_INFOF, next_token, and VerifyKickableEntity().

BanCommand_macro_command()

float BanCommand_macro_command	(	int	argc,
		string	command )

Definition at line 489 of file banning.qc.

{
    #define BAN_COMMAND(name, function, description) \
        { if (name == strtolower(argv(0))) { function; return true; } }
 
    BAN_COMMANDS(CMD_REQUEST_COMMAND, argc, command);
#undef BAN_COMMAND
 
    return false;
}

References BAN_COMMANDS, and CMD_REQUEST_COMMAND.

Referenced by BanCommand().

BanCommand_macro_help()

void BanCommand_macro_help

(

)

Definition at line 480 of file banning.qc.

{
    #define BAN_COMMAND(name, function, description) \
        { if (strtolower(description) != "") { LOG_INFO("  ^2", name, "^7: ", description); } }
 
    BAN_COMMANDS(0, 0, "");
#undef BAN_COMMAND
}

References BAN_COMMANDS.

Referenced by GameCommand().

BanCommand_macro_usage()

float BanCommand_macro_usage

(

int

argc

)

Definition at line 500 of file banning.qc.

{
    #define BAN_COMMAND(name, function, description) \
        { if (name == strtolower(argv(1))) { function; return true; } }
 
    BAN_COMMANDS(CMD_REQUEST_USAGE, argc, "");
#undef BAN_COMMAND
 
    return false;
}

References BAN_COMMANDS, and CMD_REQUEST_USAGE.

Referenced by GameCommand().

BanCommand_macro_write_aliases()

void BanCommand_macro_write_aliases

(

float

fh

)

Definition at line 511 of file banning.qc.

{
    #define BAN_COMMAND(name, function, description) \
        { if (strtolower(description) != "") { CMD_Write_Alias("qc_cmd_sv", name, description); } }
 
    BAN_COMMANDS(0, 0, "");
#undef BAN_COMMAND
}

References BAN_COMMANDS.

Referenced by GENERIC_COMMAND().

BanCommand_mute()

void BanCommand_mute	(	int	request,
		int	argc,
		string	command )

Definition at line 123 of file banning.qc.

{
    switch (request)
    {
        case CMD_REQUEST_COMMAND:
        {
            if (argc >= 2)
            {
                entity client = GetIndexedEntity(argc, 1);
                float accepted = VerifyClientEntity(client, true, false);
 
                if (accepted > 0)
                {
                    string theid = "";
                    if(!PlayerInIPList(client, autocvar_g_chatban_list))
                        theid = cons(theid, client.netaddress);
                    if(!PlayerInIDList(client, autocvar_g_chatban_list))
                        theid = cons(theid, client.crypto_idfp);
                    CS(client).muted = true;
                    LOG_INFO(strcat("Mute-banning player ", GetCallerName(client), " (", argv(1), ")."));
                    cvar_set("g_chatban_list", cons(autocvar_g_chatban_list, theid));
 
                    return;
                }
                else
                {
                    LOG_INFO("mute: ", GetClientErrorString(accepted, argv(1)), ".");
                }
            }
        }
 
        default:
            LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
        case CMD_REQUEST_USAGE:
        {
            LOG_HELP("Usage:^3 sv_cmd mute <client>");
            LOG_HELP("  <client> is the entity number or name of the player to mute.");
            LOG_HELP("See also: ^2unmute, g_chatban_list^7");
            return;
        }
    }
}

References argv(), autocvar_g_chatban_list, CMD_REQUEST_COMMAND, CMD_REQUEST_USAGE, cons(), CS(), cvar_set(), entity(), GetCallerName(), GetClientErrorString, GetIndexedEntity(), LOG_HELP, LOG_INFO, LOG_INFOF, PlayerInIDList(), PlayerInIPList(), strcat(), and VerifyClientEntity().

BanCommand_playban()

void BanCommand_playban	(	int	request,
		int	argc,
		string	command )

Definition at line 166 of file banning.qc.

{
    switch (request)
    {
        case CMD_REQUEST_COMMAND:
        {
            if (argc >= 2)
            {
                entity client = GetIndexedEntity(argc, 1);
                float accepted = VerifyClientEntity(client, true, false);
 
                if (accepted > 0)
                {
                    string theid = "";
                    if(!PlayerInIPList(client, autocvar_g_playban_list))
                        theid = cons(theid, client.netaddress);
                    if(!PlayerInIDList(client, autocvar_g_playban_list))
                        theid = cons(theid, client.crypto_idfp);
 
                    LOG_INFO(strcat("Play-banning player ", GetCallerName(client), " (", argv(1), ")."));
                    PutObserverInServer(client, true, true);
                    if (autocvar_g_playban_minigames) 
                        part_minigame(client);
                    cvar_set("g_playban_list", cons(autocvar_g_playban_list, theid));
 
                    return;
                }
                else
                {
                    LOG_INFO("playban: ", GetClientErrorString(accepted, argv(1)), ".");
                }
            }
        }
 
        default:
            LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
        case CMD_REQUEST_USAGE:
        {
            LOG_HELP("Usage:^3 sv_cmd playban <client>");
            LOG_HELP("  <client> is the entity number or name of the player to ban being forced to spectate permanently,");
            LOG_HELP("See also: ^2g_playban_list, unplayban^7");
            return;
        }
    }
}

References argv(), autocvar_g_playban_list, autocvar_g_playban_minigames, CMD_REQUEST_COMMAND, CMD_REQUEST_USAGE, cons(), cvar_set(), entity(), GetCallerName(), GetClientErrorString, GetIndexedEntity(), LOG_HELP, LOG_INFO, LOG_INFOF, part_minigame(), PlayerInIDList(), PlayerInIPList(), PutObserverInServer(), strcat(), and VerifyClientEntity().

BanCommand_unban()

void BanCommand_unban	(	int	request,
		int	argc )

Definition at line 212 of file banning.qc.

{
    switch (request)
    {
        case CMD_REQUEST_COMMAND:
        {
            if (argv(1))
            {
                float tmp_number = -1;
                string tmp_string;
 
                if (substring(argv(1), 0, 1) == "#")
                {
                    tmp_string = substring(argv(1), 1, -1);
 
                    if (tmp_string != "") // is it all one token? like #1
                        tmp_number = stof(tmp_string);
                    else if (argc > 2)    // no, it's two tokens? # 1
                        tmp_number = stof(argv(2));
                    else tmp_number = -1;
                }
                else  // maybe it's ONLY a number?
                {
                    tmp_number = stof(argv(1));
 
                    if ((tmp_number == 0) && (argv(1) != "0")) tmp_number = -1; }
 
                if (tmp_number >= 0)
                {
                    Ban_Delete(tmp_number);
                    return;
                }
            }
        }
 
        default:
        case CMD_REQUEST_USAGE:
        {
            LOG_HELP("Usage:^3 sv_cmd unban <banid>");
            LOG_HELP("  Where <banid> is the ID of the ban of which to remove.");
            LOG_HELP("See also: ^2ban, banlist, kickban^7");
            return;
        }
    }
}

References argv(), Ban_Delete(), CMD_REQUEST_COMMAND, CMD_REQUEST_USAGE, LOG_HELP, stof(), and substring().

BanCommand_unmute()

void BanCommand_unmute	(	int	request,
		int	argc )

Definition at line 258 of file banning.qc.

{
    switch (request)
    {
        case CMD_REQUEST_COMMAND:
        {
            if (argc >= 2)
            {
                entity client = GetIndexedEntity(argc, 1);
                float accepted = VerifyClientEntity(client, true, false);
                string original_arg = argv(1);
 
                if (accepted > 0)
                {
                    string tmp_string = "";
                    FOREACH_WORD(autocvar_g_chatban_list, it != client.netaddress,
                    {
                        if(client.crypto_idfp && it == substring(client.crypto_idfp, 0, strlen(it)))
                            continue;
                        tmp_string = cons(tmp_string, it);
                    });
 
                    cvar_set("g_chatban_list", tmp_string);
                    LOG_INFO(strcat("Unmuting player ", GetCallerName(client), " (", original_arg, ")."));
                    CS(client).muted = false;
 
                    return;
                }
                else
                {
                    LOG_INFO("unmute: ", GetClientErrorString(accepted, argv(1)), ".");
                }
            }
        }
 
        default:
            LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
        case CMD_REQUEST_USAGE:
        {
            LOG_HELP("Usage:^3 sv_cmd unmute <client>");
            LOG_HELP("  <client> is the entity number or name of the player to unmute.");
            LOG_HELP("See also: ^2mute, g_chatban_list^7");
            return;
        }
    }
}

References argv(), autocvar_g_chatban_list, CMD_REQUEST_COMMAND, CMD_REQUEST_USAGE, CS(), cvar_set(), entity(), FOREACH_WORD, GetCallerName(), GetClientErrorString, GetIndexedEntity(), LOG_HELP, LOG_INFO, LOG_INFOF, strcat(), and VerifyClientEntity().

BanCommand_unplayban()

void BanCommand_unplayban	(	int	request,
		int	argc )

Definition at line 305 of file banning.qc.

{
    switch (request)
    {
        case CMD_REQUEST_COMMAND:
        {
            if (argv(1))
            {
                entity client = GetIndexedEntity(argc, 1);
                float accepted = VerifyClientEntity(client, true, false);
                string original_arg = argv(1);
 
                if (accepted > 0)
                {
                    string tmp_string = "";
                    FOREACH_WORD(autocvar_g_playban_list, it != client.netaddress,
                    {
                        if(client.crypto_idfp && it == substring(client.crypto_idfp, 0, strlen(it)))
                            continue;
                        tmp_string = cons(tmp_string, it);
                    });
 
                    cvar_set("g_playban_list", tmp_string);
                    LOG_INFO(strcat("Releasing forced to spectate player ", GetCallerName(client), " (", original_arg, ")."));
 
                    return;
                }
                else
                {
                    LOG_INFO("unplayban: ", GetClientErrorString(accepted, argv(1)), ".");
                }
            }
        }
 
        default:
        case CMD_REQUEST_USAGE:
        {
            LOG_HELP("Usage:^3 sv_cmd unplayban <banid>");
            LOG_HELP("  Where <banid> is the ID of the forced to spectate ban of which to remove.");
            LOG_HELP("See also: ^2playban, g_playban_list^7");
            return;
        }
    }
}

References argv(), autocvar_g_playban_list, CMD_REQUEST_COMMAND, CMD_REQUEST_USAGE, cvar_set(), entity(), FOREACH_WORD, GetCallerName(), GetClientErrorString, GetIndexedEntity(), LOG_HELP, LOG_INFO, strcat(), and VerifyClientEntity().

BanCommand_unvoteban()

void BanCommand_unvoteban	(	int	request,
		int	argc )

Definition at line 350 of file banning.qc.

{
    switch (request)
    {
        case CMD_REQUEST_COMMAND:
        {
            if (argv(1))
            {
                entity client = GetIndexedEntity(argc, 1);
                float accepted = VerifyClientEntity(client, true, false);
                string original_arg = argv(1);
 
                if (accepted > 0)
                {
                    string tmp_string = "";
                    FOREACH_WORD(autocvar_g_voteban_list, it != client.netaddress,
                    {
                        if(client.crypto_idfp && it == substring(client.crypto_idfp, 0, strlen(it)))
                            continue;
                        tmp_string = cons(tmp_string, it);
                    });
 
                    cvar_set("g_voteban_list", tmp_string);
                    LOG_INFO(strcat("Unvote-banning player ", GetCallerName(client), " (", original_arg, ")."));
 
                    return;
                }
                else
                {
                    LOG_INFO("unvoteban: ", GetClientErrorString(accepted, argv(1)), ".");
                }
            }
        }
 
        default:
        case CMD_REQUEST_USAGE:
        {
            LOG_HELP("Usage:^3 sv_cmd unvoteban <banid>");
            LOG_HELP("  Where <banid> is the ID of the ban from voting of which to remove.");
            LOG_HELP("See also: ^2voteban, g_voteban_list^7");
            return;
        }
    }
}

References argv(), autocvar_g_voteban_list, CMD_REQUEST_COMMAND, CMD_REQUEST_USAGE, cvar_set(), entity(), FOREACH_WORD, GetCallerName(), GetClientErrorString, GetIndexedEntity(), LOG_HELP, LOG_INFO, strcat(), and VerifyClientEntity().

BanCommand_voteban()

void BanCommand_voteban	(	int	request,
		int	argc,
		string	command )

Definition at line 395 of file banning.qc.

{
    switch (request)
    {
        case CMD_REQUEST_COMMAND:
        {
            if (argc >= 2)
            {
                entity client = GetIndexedEntity(argc, 1);
                float accepted = VerifyClientEntity(client, true, false);
 
                if (accepted > 0)
                {
                    string theid = "";
                    if(!PlayerInIPList(client, autocvar_g_voteban_list))
                        theid = cons(theid, client.netaddress);
                    if(!PlayerInIDList(client, autocvar_g_voteban_list))
                        theid = cons(theid, client.crypto_idfp);
 
                    LOG_INFO(strcat("Vote-banning player ", GetCallerName(client), " (", argv(1), ")."));
                    cvar_set("g_voteban_list", cons(autocvar_g_voteban_list, theid));
 
                    return;
                }
                else
                {
                    LOG_INFO("voteban: ", GetClientErrorString(accepted, argv(1)), ".");
                }
            }
        }
 
        default:
            LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
        case CMD_REQUEST_USAGE:
        {
            LOG_HELP("Usage:^3 sv_cmd voteban <client>");
            LOG_HELP("  <client> is the entity number or name of the player to ban from voting,");
            LOG_HELP("See also: ^2g_voteban_list, unvoteban^7");
            return;
        }
    }
}

References argv(), autocvar_g_voteban_list, CMD_REQUEST_COMMAND, CMD_REQUEST_USAGE, cons(), cvar_set(), entity(), GetCallerName(), GetClientErrorString, GetIndexedEntity(), LOG_HELP, LOG_INFO, LOG_INFOF, PlayerInIDList(), PlayerInIPList(), strcat(), and VerifyClientEntity().