scripting.qc File Reference

#include "scripting.qh"
#include <common/gametypes/gametype/ctf/sv_ctf.qh>
#include <common/physics/player.qh>
#include <common/state.qh>
#include <common/stats.qh>
#include <common/weapons/_all.qh>
#include <common/wepent.qh>
#include <server/bot/default/bot.qh>
#include <server/bot/default/cvars.qh>
#include <server/weapons/selection.qh>
#include <server/weapons/weaponsystem.qh>

Include dependency graph for scripting.qc:

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

Go to the source code of this file.

Functions
void	bot_clearqueue (entity bot)
float	bot_cmd_aim (entity this)
float	bot_cmd_aimtarget (entity this)
float	bot_cmd_barrier (entity this)
float	bot_cmd_cc (entity this)
float	bot_cmd_continue (entity this)
float	bot_cmd_debug_assert_canfire (entity this)
float	bot_cmd_else (entity this)
float	bot_cmd_eval (entity this, string expr)
float	bot_cmd_fi (entity this)
float	bot_cmd_if (entity this)
float	bot_cmd_impulse (entity this)
float	bot_cmd_keypress_handler (entity this, string key, float enabled)
float	bot_cmd_moveto (entity this)
float	bot_cmd_movetotarget (entity this)
float	bot_cmd_pause (entity this)
float	bot_cmd_presskey (entity this)
float	bot_cmd_releasekey (entity this)
float	bot_cmd_resetaim (entity this)
float	bot_cmd_resetgoal (entity this)
float	bot_cmd_select_weapon (entity this)
float	bot_cmd_sound (entity this)
float	bot_cmd_turn (entity this)
float	bot_cmd_wait (entity this)
float	bot_cmd_wait_until (entity this)
void	bot_cmdhelp (string scmd)
void	bot_command_executed (entity this, bool rm)
void	bot_commands_init ()
float	bot_decodecommand (string cmdstring)
void	bot_dequeuecommand (entity bot, float idx)
int	bot_execute_commands (entity this)
float	bot_execute_commands_once (entity this)
entity	bot_getplace (entity this, string placename)
bool	bot_havecommand (entity this, int idx)
bool	bot_ispaused (entity this)
void	bot_list_commands ()
bool	bot_presskeys (entity this)
void	bot_queuecommand (entity bot, string cmdstring)
string	bot_readcommand (entity bot, float idx)
void	bot_resetqueues ()
void	bot_setcurrentcommand (entity this)
entity	find_bot_by_name (string name)
entity	find_bot_by_number (float number)

Variables
vector	bot_cmd_aim_begin
float	bot_cmd_aim_begintime
vector	bot_cmd_aim_end
float	bot_cmd_aim_endtime
int	bot_cmd_condition_status
const int	BOT_CMD_KEY_ATTACK1 = BIT(5)
const int	BOT_CMD_KEY_ATTACK2 = BIT(6)
const int	BOT_CMD_KEY_BACKWARD = BIT(1)
const int	BOT_CMD_KEY_CHAT = BIT(10)
const int	BOT_CMD_KEY_CROUCH = BIT(9)
const int	BOT_CMD_KEY_FORWARD = BIT(0)
const int	BOT_CMD_KEY_HOOK = BIT(8)
const int	BOT_CMD_KEY_JUMP = BIT(4)
const int	BOT_CMD_KEY_LEFT = BIT(3)
const int	BOT_CMD_KEY_NONE = 0
const int	BOT_CMD_KEY_RIGHT = BIT(2)
const int	BOT_CMD_KEY_USE = BIT(7)
int	bot_cmd_keys
float	bot_cmd_wait_time
float	bot_cmdqueuebuf
float	bot_cmdqueuebuf_allocated
float	bot_cmdqueuebuf_end
float	bot_cmdqueuebuf_start
int	bot_exec_status
string	bot_placenames [MAX_BOT_PLACES]
entity	bot_places [MAX_BOT_PLACES]
float	bot_places_count
const int	CMD_CONDITION_false = 2
const int	CMD_CONDITION_false_BLOCK = 8
const int	CMD_CONDITION_NONE = 0
const int	CMD_CONDITION_true = 1
const int	CMD_CONDITION_true_BLOCK = 4
const int	MAX_BOT_PLACES = 4
int	state
entity	tuba_note

Function Documentation

bot_clearqueue()

void bot_clearqueue

(

entity

bot

)

Definition at line 21 of file scripting.qc.

{
    if(!bot.bot_cmdqueuebuf_allocated)
        return;
    buf_del(bot.bot_cmdqueuebuf);
    bot.bot_cmdqueuebuf_allocated = false;
    LOG_TRACE("bot ", bot.netname, " queue cleared");
}

References entity(), and LOG_TRACE.

Referenced by bot_clientdisconnect(), bot_cmd_if(), bot_dequeuecommand(), and MUTATOR_HOOKFUNCTION().

bot_cmd_aim()

float bot_cmd_aim

(

entity

this

)

Definition at line 730 of file scripting.qc.

{
    // Current direction
    if(this.bot_cmd_aim_endtime)
    {
        float progress;
 
        progress = min(1 - (this.bot_cmd_aim_endtime - time) / (this.bot_cmd_aim_endtime - this.bot_cmd_aim_begintime),1);
        this.v_angle = this.bot_cmd_aim_begin + ((this.bot_cmd_aim_end - this.bot_cmd_aim_begin) * progress);
 
        if(time>=this.bot_cmd_aim_endtime)
        {
            this.bot_cmd_aim_endtime = 0;
            return CMD_STATUS_FINISHED;
        }
        else
            return CMD_STATUS_EXECUTING;
    }
 
    // New aiming direction
    string parms;
    float tokens, step;
 
    parms = bot_cmd.bot_cmd_parm_string;
 
    tokens = tokenizebyseparator(parms, " ");
 
    if(tokens<2||tokens>3)
        return CMD_STATUS_ERROR;
 
    step = (tokens == 3) ? stof(argv(2)) : 0;
 
    if(step == 0)
    {
        this.v_angle_x -= stof(argv(1));
        this.v_angle_y += stof(argv(0));
        return CMD_STATUS_FINISHED;
    }
 
    this.bot_cmd_aim_begin = this.v_angle;
 
    this.bot_cmd_aim_end_x = this.v_angle.x - stof(argv(1));
    this.bot_cmd_aim_end_y = this.v_angle.y + stof(argv(0));
    this.bot_cmd_aim_end_z = 0;
 
    this.bot_cmd_aim_begintime = time;
    this.bot_cmd_aim_endtime = time + step;
 
    return CMD_STATUS_EXECUTING;
}

References argv(), bot_cmd, bot_cmd_aim_begin, bot_cmd_aim_begintime, bot_cmd_aim_end, bot_cmd_aim_endtime, CMD_STATUS_ERROR, CMD_STATUS_EXECUTING, CMD_STATUS_FINISHED, entity(), min(), stof(), time, tokenizebyseparator, and v_angle.

Referenced by bot_cmd_aimtarget(), and bot_execute_commands_once().

bot_cmd_aimtarget()

float bot_cmd_aimtarget

(

entity

this

)

Definition at line 781 of file scripting.qc.

{
    if(this.bot_cmd_aim_endtime)
    {
        return bot_cmd_aim(this);
    }
 
    entity e;
    string parms;
    vector v;
    float tokens, step;
 
    parms = bot_cmd.bot_cmd_parm_string;
 
    tokens = tokenizebyseparator(parms, " ");
 
    e = bot_getplace(this, argv(0));
    if(!e)
        return CMD_STATUS_ERROR;
 
    v = e.origin + (e.mins + e.maxs) * 0.5;
 
    if(tokens==1)
    {
        this.v_angle = vectoangles(v - (this.origin + this.view_ofs));
        this.v_angle_x = -this.v_angle.x;
        return CMD_STATUS_FINISHED;
    }
 
    if(tokens<1||tokens>2)
        return CMD_STATUS_ERROR;
 
    step = stof(argv(1));
 
    this.bot_cmd_aim_begin = this.v_angle;
    this.bot_cmd_aim_end = vectoangles(v - (this.origin + this.view_ofs));
    this.bot_cmd_aim_end_x = -this.bot_cmd_aim_end.x;
 
    this.bot_cmd_aim_begintime = time;
    this.bot_cmd_aim_endtime = time + step;
 
    return CMD_STATUS_EXECUTING;
}

References argv(), bot_cmd, bot_cmd_aim(), bot_cmd_aim_begin, bot_cmd_aim_begintime, bot_cmd_aim_end, bot_cmd_aim_endtime, bot_getplace(), CMD_STATUS_ERROR, CMD_STATUS_EXECUTING, CMD_STATUS_FINISHED, entity(), origin, stof(), time, tokenizebyseparator, v_angle, vectoangles(), vector, and view_ofs.

Referenced by bot_execute_commands_once().

bot_cmd_barrier()

float bot_cmd_barrier

(

entity

this

)

Definition at line 531 of file scripting.qc.

{
    // 0 = no barrier, 1 = waiting, 2 = waiting finished
 
    if(this.bot_barrier == 0) // initialization
    {
        this.bot_barrier = 1;
 
        //this.colormod = '4 4 0';
    }
 
    if(this.bot_barrier == 1) // find other bots
    {
        FOREACH_CLIENT(it.isbot, {
            if(it.bot_cmdqueuebuf_allocated)
            if(it.bot_barrier != 1)
                return CMD_STATUS_EXECUTING; // not all are at the barrier yet
        });
 
        // all bots hit the barrier!
 
        // acknowledge barrier
        FOREACH_CLIENT(it.isbot, { it.bot_barrier = 2; });
 
        bot_barriertime = time;
    }
 
    // if we get here, the barrier is finished
    // so end it...
    this.bot_barrier = 0;
    //this.colormod = '0 0 0';
 
    return CMD_STATUS_FINISHED;
}

References bot_barrier, bot_barriertime, CMD_STATUS_FINISHED, entity(), FOREACH_CLIENT, and time.

Referenced by bot_execute_commands_once().

bot_cmd_cc()

float bot_cmd_cc

(

entity

this

)

Definition at line 482 of file scripting.qc.

{
    SV_ParseClientCommand(this, bot_cmd.bot_cmd_parm_string);
    return CMD_STATUS_FINISHED;
}

References bot_cmd, CMD_STATUS_FINISHED, entity(), and SV_ParseClientCommand.

Referenced by bot_execute_commands_once().

bot_cmd_continue()

float bot_cmd_continue

(

entity

this

)

Definition at line 494 of file scripting.qc.

{
    this.bot_exec_status &= ~BOT_EXEC_STATUS_PAUSED;
    bot_relinkplayerlist();
    return CMD_STATUS_FINISHED;
}

References bot_exec_status, BOT_EXEC_STATUS_PAUSED, bot_relinkplayerlist(), CMD_STATUS_FINISHED, and entity().

Referenced by bot_execute_commands_once().

bot_cmd_debug_assert_canfire()

float bot_cmd_debug_assert_canfire

(

entity

this

)

Definition at line 1075 of file scripting.qc.

{
    float f = bot_cmd.bot_cmd_parm_float;
 
    int slot = 0; // TODO: unhardcode?
    .entity weaponentity = weaponentities[slot];
    if(this.(weaponentity).state != WS_READY)
    {
        if(f)
        {
            this.colormod = '0 8 8';
            LOG_INFO("Bot ", this.netname, " using ", this.(weaponentity).weaponname, " wants to fire, inhibited by weaponentity state");
        }
    }
    else if(ATTACK_FINISHED(this, weaponentity) > time)
    {
        if(f)
        {
            this.colormod = '8 0 8';
            LOG_INFO("Bot ", this.netname, " using ", this.(weaponentity).weaponname, " wants to fire, inhibited by ATTACK_FINISHED (", ftos(ATTACK_FINISHED(this, weaponentity) - time), " seconds left)");
        }
    }
    else if(this.(weaponentity).tuba_note)
    {
        if(f)
        {
            this.colormod = '8 0 0';
            LOG_INFO("Bot ", this.netname, " using ", this.(weaponentity).weaponname, " wants to fire, bot still has an active tuba note");
        }
    }
    else
    {
        if(!f)
        {
            this.colormod = '8 8 0';
            LOG_INFO("Bot ", this.netname, " using ", this.(weaponentity).weaponname, " thinks it has fired, but apparently did not; ATTACK_FINISHED says ", ftos(ATTACK_FINISHED(this, weaponentity) - time), " seconds left");
        }
    }
 
    return CMD_STATUS_FINISHED;
}

References ATTACK_FINISHED, bot_cmd, CMD_STATUS_FINISHED, colormod, entity(), ftos(), LOG_INFO, netname, state, time, tuba_note, weaponentities, weaponname, and WS_READY.

Referenced by bot_execute_commands_once().

bot_cmd_else()

float bot_cmd_else

(

entity

this

)

Definition at line 706 of file scripting.qc.

{
    this.bot_cmd_condition_status &= ~CMD_CONDITION_true_BLOCK;
    this.bot_cmd_condition_status |= CMD_CONDITION_false_BLOCK;
    return CMD_STATUS_FINISHED;
}

References bot_cmd_condition_status, CMD_CONDITION_false_BLOCK, CMD_CONDITION_true_BLOCK, CMD_STATUS_FINISHED, and entity().

Referenced by bot_execute_commands_once().

bot_cmd_eval()

float bot_cmd_eval	(	entity	this,
		string	expr )

Definition at line 609 of file scripting.qc.

{
    // Search for numbers
    if(IS_DIGIT(substring(expr, 0, 1)))
        return stof(expr);
 
    // Search for cvars
    if(substring(expr, 0, 5)=="cvar.")
        return cvar(substring(expr, 5, strlen(expr)));
 
    // Search for fields
    // TODO: expand with support for more fields (key carrier, ball carrier, armor etc)
    switch(expr)
    {
        case "health":
            return GetResource(this, RES_HEALTH);
        case "speed":
            return vlen(this.velocity);
        case "flagcarrier":
            return ((this.flagcarried!=NULL));
    }
 
    LOG_INFO("ERROR: Unable to convert the expression '", expr, "' into a numeric value");
    return 0;
}

References cvar(), entity(), flagcarried, GetResource(), IS_DIGIT, LOG_INFO, NULL, stof(), strlen, substring(), velocity, and vlen().

Referenced by bot_cmd_if().

bot_cmd_fi()

float bot_cmd_fi

(

entity

this

)

Definition at line 713 of file scripting.qc.

{
    this.bot_cmd_condition_status = CMD_CONDITION_NONE;
    return CMD_STATUS_FINISHED;
}

References bot_cmd_condition_status, CMD_CONDITION_NONE, CMD_STATUS_FINISHED, and entity().

Referenced by bot_execute_commands_once().

bot_cmd_if()

float bot_cmd_if

(

entity

this

)

Definition at line 635 of file scripting.qc.

{
    string expr, val_a, val_b;
    float cmpofs;
 
    if(this.bot_cmd_condition_status != CMD_CONDITION_NONE)
    {
        // Only one "if" block is allowed at time
        LOG_INFO("ERROR: Only one conditional block can be processed at time");
        bot_clearqueue(this);
        return CMD_STATUS_ERROR;
    }
 
    this.bot_cmd_condition_status |= CMD_CONDITION_true_BLOCK;
 
    // search for operators
    expr = bot_cmd.bot_cmd_parm_string;
 
    cmpofs = strstrofs(expr,"=",0);
 
    if(cmpofs>0)
    {
        val_a = substring(expr,0,cmpofs);
        val_b = substring(expr,cmpofs+1,strlen(expr));
 
        if(bot_cmd_eval(this, val_a)==bot_cmd_eval(this, val_b))
            this.bot_cmd_condition_status |= CMD_CONDITION_true;
        else
            this.bot_cmd_condition_status |= CMD_CONDITION_false;
 
        return CMD_STATUS_FINISHED;
    }
 
    cmpofs = strstrofs(expr,">",0);
 
    if(cmpofs>0)
    {
        val_a = substring(expr,0,cmpofs);
        val_b = substring(expr,cmpofs+1,strlen(expr));
 
        if(bot_cmd_eval(this, val_a)>bot_cmd_eval(this, val_b))
            this.bot_cmd_condition_status |= CMD_CONDITION_true;
        else
            this.bot_cmd_condition_status |= CMD_CONDITION_false;
 
        return CMD_STATUS_FINISHED;
    }
 
    cmpofs = strstrofs(expr,"<",0);
 
    if(cmpofs>0)
    {
        val_a = substring(expr,0,cmpofs);
        val_b = substring(expr,cmpofs+1,strlen(expr));
 
        if(bot_cmd_eval(this, val_a)<bot_cmd_eval(this, val_b))
            this.bot_cmd_condition_status |= CMD_CONDITION_true;
        else
            this.bot_cmd_condition_status |= CMD_CONDITION_false;
 
        return CMD_STATUS_FINISHED;
    }
 
    if(bot_cmd_eval(this, expr))
        this.bot_cmd_condition_status |= CMD_CONDITION_true;
    else
        this.bot_cmd_condition_status |= CMD_CONDITION_false;
 
    return CMD_STATUS_FINISHED;
}

References bot_clearqueue(), bot_cmd, bot_cmd_condition_status, bot_cmd_eval(), CMD_CONDITION_false, CMD_CONDITION_NONE, CMD_CONDITION_true, CMD_CONDITION_true_BLOCK, CMD_STATUS_ERROR, CMD_STATUS_FINISHED, entity(), LOG_INFO, strlen, strstrofs, and substring().

Referenced by bot_execute_commands_once().

bot_cmd_impulse()

float bot_cmd_impulse

(

entity

this

)

Definition at line 488 of file scripting.qc.

{
    CS(this).impulse = bot_cmd.bot_cmd_parm_float;
    return CMD_STATUS_FINISHED;
}

References bot_cmd, CMD_STATUS_FINISHED, CS(), and entity().

Referenced by bot_execute_commands_once().

bot_cmd_keypress_handler()

float bot_cmd_keypress_handler	(	entity	this,
		string	key,
		float	enabled )

Definition at line 889 of file scripting.qc.

{
    switch(key)
    {
        case "all":
            if(enabled)
                this.bot_cmd_keys = (2 ** 20) - 1; // >:)
            else
                this.bot_cmd_keys = BOT_CMD_KEY_NONE;
        case "forward":
            if(enabled)
            {
                this.bot_cmd_keys |= BOT_CMD_KEY_FORWARD;
                this.bot_cmd_keys &= ~BOT_CMD_KEY_BACKWARD;
            }
            else
                this.bot_cmd_keys &= ~BOT_CMD_KEY_FORWARD;
            break;
        case "backward":
            if(enabled)
            {
                this.bot_cmd_keys |= BOT_CMD_KEY_BACKWARD;
                this.bot_cmd_keys &= ~BOT_CMD_KEY_FORWARD;
            }
            else
                this.bot_cmd_keys &= ~BOT_CMD_KEY_BACKWARD;
            break;
        case "left":
            if(enabled)
            {
                this.bot_cmd_keys |= BOT_CMD_KEY_LEFT;
                this.bot_cmd_keys &= ~BOT_CMD_KEY_RIGHT;
            }
            else
                this.bot_cmd_keys &= ~BOT_CMD_KEY_LEFT;
            break;
        case "right":
            if(enabled)
            {
                this.bot_cmd_keys |= BOT_CMD_KEY_RIGHT;
                this.bot_cmd_keys &= ~BOT_CMD_KEY_LEFT;
            }
            else
                this.bot_cmd_keys &= ~BOT_CMD_KEY_RIGHT;
            break;
        case "jump":
            if(enabled)
                this.bot_cmd_keys |= BOT_CMD_KEY_JUMP;
            else
                this.bot_cmd_keys &= ~BOT_CMD_KEY_JUMP;
            break;
        case "crouch":
            if(enabled)
                this.bot_cmd_keys |= BOT_CMD_KEY_CROUCH;
            else
                this.bot_cmd_keys &= ~BOT_CMD_KEY_CROUCH;
            break;
        case "attack1":
            if(enabled)
                this.bot_cmd_keys |= BOT_CMD_KEY_ATTACK1;
            else
                this.bot_cmd_keys &= ~BOT_CMD_KEY_ATTACK1;
            break;
        case "attack2":
            if(enabled)
                this.bot_cmd_keys |= BOT_CMD_KEY_ATTACK2;
            else
                this.bot_cmd_keys &= ~BOT_CMD_KEY_ATTACK2;
            break;
        case "use":
            if(enabled)
                this.bot_cmd_keys |= BOT_CMD_KEY_USE;
            else
                this.bot_cmd_keys &= ~BOT_CMD_KEY_USE;
            break;
        case "hook":
            if(enabled)
                this.bot_cmd_keys |= BOT_CMD_KEY_HOOK;
            else
                this.bot_cmd_keys &= ~BOT_CMD_KEY_HOOK;
            break;
        case "chat":
            if(enabled)
                this.bot_cmd_keys |= BOT_CMD_KEY_CHAT;
            else
                this.bot_cmd_keys &= ~BOT_CMD_KEY_CHAT;
            break;
        default:
            break;
    }
 
    return CMD_STATUS_FINISHED;
}

References BOT_CMD_KEY_ATTACK1, BOT_CMD_KEY_ATTACK2, BOT_CMD_KEY_BACKWARD, BOT_CMD_KEY_CHAT, BOT_CMD_KEY_CROUCH, BOT_CMD_KEY_FORWARD, BOT_CMD_KEY_HOOK, BOT_CMD_KEY_JUMP, BOT_CMD_KEY_LEFT, BOT_CMD_KEY_NONE, BOT_CMD_KEY_RIGHT, BOT_CMD_KEY_USE, bot_cmd_keys, CMD_STATUS_FINISHED, and entity().

Referenced by bot_cmd_presskey(), and bot_cmd_releasekey().

bot_cmd_moveto()

float bot_cmd_moveto

(

entity

this

)

Definition at line 1027 of file scripting.qc.

{
    return this.cmd_moveto(this, bot_cmd.bot_cmd_parm_vector);
}

References bot_cmd, and entity().

Referenced by bot_execute_commands_once().

bot_cmd_movetotarget()

float bot_cmd_movetotarget

(

entity

this

)

Definition at line 1032 of file scripting.qc.

{
    entity e;
    e = bot_getplace(this, bot_cmd.bot_cmd_parm_string);
    if(!e)
        return CMD_STATUS_ERROR;
    return this.cmd_moveto(this, e.origin + (e.mins + e.maxs) * 0.5);
}

References bot_cmd, bot_getplace(), CMD_STATUS_ERROR, and entity().

Referenced by bot_execute_commands_once().

bot_cmd_pause()

float bot_cmd_pause

(

entity

this

)

Definition at line 1008 of file scripting.qc.

{
    PHYS_INPUT_BUTTON_DRAG(this) = false;
    PHYS_INPUT_BUTTON_USE(this) = false;
    PHYS_INPUT_BUTTON_ATCK(this) = false;
    PHYS_INPUT_BUTTON_JUMP(this) = false;
    PHYS_INPUT_BUTTON_HOOK(this) = false;
    PHYS_INPUT_BUTTON_CHAT(this) = false;
    PHYS_INPUT_BUTTON_ATCK2(this) = false;
    PHYS_INPUT_BUTTON_CROUCH(this) = false;
 
    CS(this).movement = '0 0 0';
    this.bot_cmd_keys = BOT_CMD_KEY_NONE;
 
    this.bot_exec_status |= BOT_EXEC_STATUS_PAUSED;
    bot_relinkplayerlist();
    return CMD_STATUS_FINISHED;
}

References BOT_CMD_KEY_NONE, bot_cmd_keys, bot_exec_status, BOT_EXEC_STATUS_PAUSED, bot_relinkplayerlist(), CMD_STATUS_FINISHED, CS(), entity(), PHYS_INPUT_BUTTON_ATCK, PHYS_INPUT_BUTTON_ATCK2, PHYS_INPUT_BUTTON_CHAT, PHYS_INPUT_BUTTON_CROUCH, PHYS_INPUT_BUTTON_DRAG, PHYS_INPUT_BUTTON_HOOK, PHYS_INPUT_BUTTON_JUMP, and PHYS_INPUT_BUTTON_USE.

Referenced by bot_execute_commands_once().

bot_cmd_presskey()

float bot_cmd_presskey

(

entity

this

)

Definition at line 983 of file scripting.qc.

{
    string key;
 
    key = bot_cmd.bot_cmd_parm_string;
 
    bot_cmd_keypress_handler(this, key,true);
 
    return CMD_STATUS_FINISHED;
}

References bot_cmd, bot_cmd_keypress_handler(), CMD_STATUS_FINISHED, and entity().

Referenced by bot_execute_commands_once().

bot_cmd_releasekey()

float bot_cmd_releasekey

(

entity

this

)

Definition at line 994 of file scripting.qc.

{
    string key;
 
    key = bot_cmd.bot_cmd_parm_string;
 
    return bot_cmd_keypress_handler(this, key,false);
}

References bot_cmd, bot_cmd_keypress_handler(), and entity().

Referenced by bot_execute_commands_once().

bot_cmd_resetaim()

float bot_cmd_resetaim

(

entity

this

)

Definition at line 719 of file scripting.qc.

{
    this.v_angle = '0 0 0';
    return CMD_STATUS_FINISHED;
}

References CMD_STATUS_FINISHED, entity(), and v_angle.

Referenced by bot_execute_commands_once().

bot_cmd_resetgoal()

float bot_cmd_resetgoal

(

entity

this

)

Definition at line 1041 of file scripting.qc.

{
    return this.cmd_resetgoal(this);
}

References entity().

Referenced by bot_execute_commands_once().

bot_cmd_select_weapon()

float bot_cmd_select_weapon

(

entity

this

)

Definition at line 573 of file scripting.qc.

{
    float id = bot_cmd.bot_cmd_parm_float;
 
    if(id < WEP_FIRST || id > WEP_LAST)
        return CMD_STATUS_ERROR;
 
    bool success = false;
 
    for(int slot = 0; slot < MAX_WEAPONSLOTS; ++slot)
    {
        .entity weaponentity = weaponentities[slot];
        if(this.(weaponentity).m_weapon == WEP_Null && slot != 0)
            continue;
 
        if(client_hasweapon(this, REGISTRY_GET(Weapons, id), weaponentity, true, false))
        {
            success = true;
            this.(weaponentity).m_switchweapon = REGISTRY_GET(Weapons, id);
        }
    }
 
    if(!success)
        return CMD_STATUS_ERROR;
 
    return CMD_STATUS_FINISHED;
}

References bot_cmd, client_hasweapon(), CMD_STATUS_ERROR, CMD_STATUS_FINISHED, entity(), m_switchweapon, m_weapon, MAX_WEAPONSLOTS, REGISTRY_GET, weaponentities, Weapons, and WEP_LAST.

Referenced by bot_execute_commands_once().

bot_cmd_sound()

float bot_cmd_sound

(

entity

this

)

Definition at line 1047 of file scripting.qc.

{
    string f;
    f = bot_cmd.bot_cmd_parm_string;
 
    float n = tokenizebyseparator(f, " ");
 
    string sample = f;
    float chan = CH_WEAPON_B;
    float vol = VOL_BASE;
    float atten = ATTEN_MIN;
 
    if(n >= 1)
        sample = argv(n - 1);
    if(n >= 2)
        chan = stof(argv(0));
    if(n >= 3)
        vol = stof(argv(1));
    if(n >= 4)
        atten = stof(argv(2));
 
    precache_sound(f);
    _sound(this, chan, sample, vol, atten);
 
    return CMD_STATUS_FINISHED;
}

References _sound, argv(), atten, ATTEN_MIN, bot_cmd, CH_WEAPON_B, CMD_STATUS_FINISHED, entity(), precache_sound(), stof(), tokenizebyseparator, and VOL_BASE.

Referenced by bot_execute_commands_once().

bot_cmd_turn()

float bot_cmd_turn

(

entity

this

)

Definition at line 566 of file scripting.qc.

{
    this.v_angle_y = this.v_angle.y + bot_cmd.bot_cmd_parm_float;
    this.v_angle_y = this.v_angle.y - floor(this.v_angle.y / 360) * 360;
    return CMD_STATUS_FINISHED;
}

References bot_cmd, CMD_STATUS_FINISHED, entity(), floor(), and v_angle.

Referenced by bot_execute_commands_once().

bot_cmd_wait()

float bot_cmd_wait

(

entity

this

)

Definition at line 502 of file scripting.qc.

{
    if(this.bot_exec_status & BOT_EXEC_STATUS_WAITING)
    {
        if(time>=this.bot_cmd_wait_time)
        {
            this.bot_exec_status &= ~BOT_EXEC_STATUS_WAITING;
            return CMD_STATUS_FINISHED;
        }
        else
            return CMD_STATUS_EXECUTING;
    }
 
    this.bot_cmd_wait_time = time + bot_cmd.bot_cmd_parm_float;
    this.bot_exec_status |= BOT_EXEC_STATUS_WAITING;
    return CMD_STATUS_EXECUTING;
}

References bot_cmd, bot_cmd_wait_time, bot_exec_status, BOT_EXEC_STATUS_WAITING, CMD_STATUS_EXECUTING, CMD_STATUS_FINISHED, entity(), and time.

Referenced by bot_execute_commands_once().

bot_cmd_wait_until()

float bot_cmd_wait_until

(

entity

this

)

Definition at line 520 of file scripting.qc.

{
    if(time < bot_cmd.bot_cmd_parm_float + bot_barriertime)
    {
        this.bot_exec_status |= BOT_EXEC_STATUS_WAITING;
        return CMD_STATUS_EXECUTING;
    }
    this.bot_exec_status &= ~BOT_EXEC_STATUS_WAITING;
    return CMD_STATUS_FINISHED;
}

References bot_barriertime, bot_cmd, bot_exec_status, BOT_EXEC_STATUS_WAITING, CMD_STATUS_EXECUTING, CMD_STATUS_FINISHED, entity(), and time.

Referenced by bot_execute_commands_once().

bot_cmdhelp()

void bot_cmdhelp

(

string

scmd

)

Definition at line 331 of file scripting.qc.

{
    int i, ntype;
    string stype;
 
    if(!bot_cmds_initialized)
        bot_commands_init();
 
    for(i=1;i<BOT_CMD_COUNTER;++i)
    {
        if(bot_cmd_string[i]!=scmd)
            continue;
 
        ntype = bot_cmd_parm_type[i];
 
        switch(ntype)
        {
            case BOT_CMD_PARAMETER_FLOAT:
                stype = "float";
                break;
            case BOT_CMD_PARAMETER_STRING:
                stype = "string";
                break;
            case BOT_CMD_PARAMETER_VECTOR:
                stype = "vector";
                break;
            default:
                stype = "none";
                break;
        }
 
        string desc = "";
        switch(i)
        {
            case BOT_CMD_PAUSE:
                desc = "Stops the bot completely. Any command other than 'continue' will be ignored.";
                break;
            case BOT_CMD_CONTINUE:
                desc = "Disable paused status";
                break;
            case BOT_CMD_WAIT:
                desc = "Pause command parsing and bot ai for N seconds. Pressed key will remain pressed";
                break;
            case BOT_CMD_WAIT_UNTIL:
                desc = "Pause command parsing and bot ai until time is N from the last barrier. Pressed key will remain pressed";
                break;
            case BOT_CMD_BARRIER:
                desc = "Waits till all bots that have a command queue reach this command. Pressed key will remain pressed";
                break;
            case BOT_CMD_TURN:
                desc = "Look to the right or left N degrees. For turning to the left use positive numbers.";
                break;
            case BOT_CMD_MOVETO:
                desc = "Walk to an specific coordinate on the map. Usage: moveto \'x y z\'";
                break;
            case BOT_CMD_MOVETOTARGET:
                desc = "Walk to the specific target on the map";
                break;
            case BOT_CMD_RESETGOAL:
                desc = "Resets the goal stack";
                break;
            case BOT_CMD_CC:
                desc = "Execute client command. Examples: cc say something; cc god; cc name newnickname; cc kill;";
                break;
            case BOT_CMD_IF:
                desc = "Perform simple conditional execution.\n"
                    "Syntax: \n"
                    "        sv_cmd .. if \"condition\"\n"
                    "        sv_cmd ..  <instruction if true>\n"
                    "        sv_cmd ..  <instruction if true>\n"
                    "        sv_cmd .. else\n"
                    "        sv_cmd ..  <instruction if false>\n"
                    "        sv_cmd ..  <instruction if false>\n"
                    "        sv_cmd .. fi\n"
                    "Conditions: a=b, a>b, a<b, a\t\t(spaces not allowed)\n"
                    "            Values in conditions can be numbers, cvars in the form cvar.cvar_string or special fields\n"
                    "Fields: health, speed, flagcarrier\n"
                    "Examples: if health>50; if health>cvar.g_balance_laser_primary_damage; if flagcarrier;";
                break;
            case BOT_CMD_RESETAIM:
                desc = "Points the aim to the coordinates x,y 0,0";
                break;
            case BOT_CMD_AIM:
                desc = "Move the aim x/y (horizontal/vertical) degrees relatives to the bot\n"
                    "There is a 3rd optional parameter telling in how many seconds the aim has to reach the new position\n"
                    "Examples: aim \"90 0\" // Turn 90 degrees inmediately (positive numbers move to the left/up)\n"
                    "          aim \"0 90 2\"   // Will gradually look to the sky in the next two seconds";
                break;
            case BOT_CMD_AIMTARGET:
                desc = "Points the aim to given target";
                break;
            case BOT_CMD_PRESSKEY:
                desc = "Press one of the following keys: forward, backward, left, right, jump, crouch, attack1, attack2, use"
                    "Multiple keys can be pressed at time (with many presskey calls) and it will remain pressed until the command \"releasekey\" is called"
                    "Note: The script will not return the control to the bot ai until all keys are released";
                break;
            case BOT_CMD_RELEASEKEY:
                desc = "Release previoulsy used keys. Use the parameter \"all\" to release all keys";
                break;
            case BOT_CMD_SOUND:
                desc = "play sound file at bot location";
                break;
            case BOT_CMD_DEBUG_ASSERT_CANFIRE:
                desc = "verify the state of the weapon entity";
                break;
            default:
                desc = "This command has no description yet.";
                break;
        }
        LOG_HELP("Command: ", bot_cmd_string[i], "\nParameter: <", stype, ">", "\nDescription: ", desc);
    }
}

References BOT_CMD_AIM, BOT_CMD_AIMTARGET, BOT_CMD_BARRIER, BOT_CMD_CC, BOT_CMD_CONTINUE, BOT_CMD_COUNTER, BOT_CMD_DEBUG_ASSERT_CANFIRE, BOT_CMD_IF, BOT_CMD_MOVETO, BOT_CMD_MOVETOTARGET, BOT_CMD_PARAMETER_FLOAT, BOT_CMD_PARAMETER_STRING, BOT_CMD_PARAMETER_VECTOR, bot_cmd_parm_type, BOT_CMD_PAUSE, BOT_CMD_PRESSKEY, BOT_CMD_RELEASEKEY, BOT_CMD_RESETAIM, BOT_CMD_RESETGOAL, BOT_CMD_SOUND, bot_cmd_string, BOT_CMD_TURN, BOT_CMD_WAIT, BOT_CMD_WAIT_UNTIL, bot_cmds_initialized, bot_commands_init(), and LOG_HELP.

Referenced by GameCommand_bot_cmd().

bot_command_executed()

void bot_command_executed	(	entity	this,
		bool	rm )

Definition at line 1119 of file scripting.qc.

{
    entity cmd;
 
    cmd = bot_cmd;
 
    if(rm)
        bot_dequeuecommand(this, this.bot_cmd_execution_index);
 
    this.bot_cmd_execution_index++;
}

References bot_cmd, bot_cmd_execution_index, bot_dequeuecommand(), cmd(), and entity().

Referenced by bot_execute_commands_once().

bot_commands_init()

void bot_commands_init

(

)

Definition at line 157 of file scripting.qc.

{
    bot_cmd_string[BOT_CMD_NULL] = "";
    bot_cmd_parm_type[BOT_CMD_NULL] = BOT_CMD_PARAMETER_NONE;
 
    bot_cmd_string[BOT_CMD_PAUSE] = "pause";
    bot_cmd_parm_type[BOT_CMD_PAUSE] = BOT_CMD_PARAMETER_NONE;
 
    bot_cmd_string[BOT_CMD_CONTINUE] = "continue";
    bot_cmd_parm_type[BOT_CMD_CONTINUE] = BOT_CMD_PARAMETER_NONE;
 
    bot_cmd_string[BOT_CMD_WAIT] = "wait";
    bot_cmd_parm_type[BOT_CMD_WAIT] = BOT_CMD_PARAMETER_FLOAT;
 
    bot_cmd_string[BOT_CMD_TURN] = "turn";
    bot_cmd_parm_type[BOT_CMD_TURN] = BOT_CMD_PARAMETER_FLOAT;
 
    bot_cmd_string[BOT_CMD_MOVETO] = "moveto";
    bot_cmd_parm_type[BOT_CMD_MOVETO] = BOT_CMD_PARAMETER_VECTOR;
 
    bot_cmd_string[BOT_CMD_MOVETOTARGET] = "movetotarget";
    bot_cmd_parm_type[BOT_CMD_MOVETOTARGET] = BOT_CMD_PARAMETER_STRING;
 
    bot_cmd_string[BOT_CMD_RESETGOAL] = "resetgoal";
    bot_cmd_parm_type[BOT_CMD_RESETGOAL] = BOT_CMD_PARAMETER_NONE;
 
    bot_cmd_string[BOT_CMD_CC] = "cc";
    bot_cmd_parm_type[BOT_CMD_CC] = BOT_CMD_PARAMETER_STRING;
 
    bot_cmd_string[BOT_CMD_IF] = "if";
    bot_cmd_parm_type[BOT_CMD_IF] = BOT_CMD_PARAMETER_STRING;
 
    bot_cmd_string[BOT_CMD_ELSE] = "else";
    bot_cmd_parm_type[BOT_CMD_ELSE] = BOT_CMD_PARAMETER_NONE;
 
    bot_cmd_string[BOT_CMD_FI] = "fi";
    bot_cmd_parm_type[BOT_CMD_FI] = BOT_CMD_PARAMETER_NONE;
 
    bot_cmd_string[BOT_CMD_RESETAIM] = "resetaim";
    bot_cmd_parm_type[BOT_CMD_RESETAIM] = BOT_CMD_PARAMETER_NONE;
 
    bot_cmd_string[BOT_CMD_AIM] = "aim";
    bot_cmd_parm_type[BOT_CMD_AIM] = BOT_CMD_PARAMETER_STRING;
 
    bot_cmd_string[BOT_CMD_AIMTARGET] = "aimtarget";
    bot_cmd_parm_type[BOT_CMD_AIMTARGET] = BOT_CMD_PARAMETER_STRING;
 
    bot_cmd_string[BOT_CMD_PRESSKEY] = "presskey";
    bot_cmd_parm_type[BOT_CMD_PRESSKEY] = BOT_CMD_PARAMETER_STRING;
 
    bot_cmd_string[BOT_CMD_RELEASEKEY] = "releasekey";
    bot_cmd_parm_type[BOT_CMD_RELEASEKEY] = BOT_CMD_PARAMETER_STRING;
 
    bot_cmd_string[BOT_CMD_SELECTWEAPON] = "selectweapon";
    bot_cmd_parm_type[BOT_CMD_SELECTWEAPON] = BOT_CMD_PARAMETER_FLOAT;
 
    bot_cmd_string[BOT_CMD_IMPULSE] = "impulse";
    bot_cmd_parm_type[BOT_CMD_IMPULSE] = BOT_CMD_PARAMETER_FLOAT;
 
    bot_cmd_string[BOT_CMD_WAIT_UNTIL] = "wait_until";
    bot_cmd_parm_type[BOT_CMD_WAIT_UNTIL] = BOT_CMD_PARAMETER_FLOAT;
 
    bot_cmd_string[BOT_CMD_BARRIER] = "barrier";
    bot_cmd_parm_type[BOT_CMD_BARRIER] = BOT_CMD_PARAMETER_NONE;
 
    bot_cmd_string[BOT_CMD_CONSOLE] = "console";
    bot_cmd_parm_type[BOT_CMD_CONSOLE] = BOT_CMD_PARAMETER_STRING;
 
    bot_cmd_string[BOT_CMD_SOUND] = "sound";
    bot_cmd_parm_type[BOT_CMD_SOUND] = BOT_CMD_PARAMETER_STRING;
 
    bot_cmd_string[BOT_CMD_DEBUG_ASSERT_CANFIRE] = "debug_assert_canfire";
    bot_cmd_parm_type[BOT_CMD_DEBUG_ASSERT_CANFIRE] = BOT_CMD_PARAMETER_FLOAT;
 
    bot_cmds_initialized = true;
}

References BOT_CMD_AIM, BOT_CMD_AIMTARGET, BOT_CMD_BARRIER, BOT_CMD_CC, BOT_CMD_CONSOLE, BOT_CMD_CONTINUE, BOT_CMD_DEBUG_ASSERT_CANFIRE, BOT_CMD_ELSE, BOT_CMD_FI, BOT_CMD_IF, BOT_CMD_IMPULSE, BOT_CMD_MOVETO, BOT_CMD_MOVETOTARGET, BOT_CMD_NULL, BOT_CMD_PARAMETER_FLOAT, BOT_CMD_PARAMETER_NONE, BOT_CMD_PARAMETER_STRING, BOT_CMD_PARAMETER_VECTOR, bot_cmd_parm_type, BOT_CMD_PAUSE, BOT_CMD_PRESSKEY, BOT_CMD_RELEASEKEY, BOT_CMD_RESETAIM, BOT_CMD_RESETGOAL, BOT_CMD_SELECTWEAPON, BOT_CMD_SOUND, bot_cmd_string, BOT_CMD_TURN, BOT_CMD_WAIT, BOT_CMD_WAIT_UNTIL, and bot_cmds_initialized.

Referenced by bot_cmdhelp(), bot_decodecommand(), and bot_list_commands().

bot_decodecommand()

float bot_decodecommand

(

string

cmdstring

)

Definition at line 268 of file scripting.qc.

{
    float cmd_parm_type;
    float sp;
    string parm;
 
    sp = strstrofs(cmdstring, " ", 0);
    if(sp < 0)
    {
        parm = "";
    }
    else
    {
        parm = substring(cmdstring, sp + 1, -1);
        cmdstring = substring(cmdstring, 0, sp);
    }
 
    if(!bot_cmds_initialized)
        bot_commands_init();
 
    int i;
    for(i=1;i<BOT_CMD_COUNTER;++i)
    {
        if(bot_cmd_string[i]!=cmdstring)
            continue;
 
        cmd_parm_type = bot_cmd_parm_type[i];
 
        if(cmd_parm_type!=BOT_CMD_PARAMETER_NONE&&parm=="")
        {
            LOG_INFO("ERROR: A parameter is required for this command");
            return 0;
        }
 
        // Load command into queue
        bot_cmd.bot_cmd_type = i;
 
        // Attach parameter
        switch(cmd_parm_type)
        {
            case BOT_CMD_PARAMETER_FLOAT:
                bot_cmd.bot_cmd_parm_float = stof(parm);
                break;
            case BOT_CMD_PARAMETER_STRING:
                strcpy(bot_cmd.bot_cmd_parm_string, parm);
                break;
            case BOT_CMD_PARAMETER_VECTOR:
                if(substring(parm, 0, 1) != "\'")
                {
                    LOG_INFOF("ERROR: expected vector type \'x y z\', got %s", parm);
                    return 0;
                }
                bot_cmd.bot_cmd_parm_vector = stov(parm);
                break;
            default:
                break;
        }
        return 1;
    }
    LOG_INFO("ERROR: No such command '", cmdstring, "'");
    return 0;
}

References bot_cmd, BOT_CMD_COUNTER, BOT_CMD_PARAMETER_FLOAT, BOT_CMD_PARAMETER_NONE, BOT_CMD_PARAMETER_STRING, BOT_CMD_PARAMETER_VECTOR, bot_cmd_parm_type, bot_cmd_string, bot_cmds_initialized, bot_commands_init(), LOG_INFO, LOG_INFOF, stof(), stov(), strcpy, strstrofs, and substring().

Referenced by bot_setcurrentcommand().

bot_dequeuecommand()

void bot_dequeuecommand	(	entity	bot,
		float	idx )

Definition at line 72 of file scripting.qc.

{
    if(!bot.bot_cmdqueuebuf_allocated)
        error("dequeuecommand but no queue allocated");
    if(idx < bot.bot_cmdqueuebuf_start)
        error("dequeueing a command in the past");
    if(idx >= bot.bot_cmdqueuebuf_end)
        error("dequeueing a command in the future");
    bufstr_set(bot.bot_cmdqueuebuf, idx, "");
    if(idx == bot.bot_cmdqueuebuf_start)
        bot.bot_cmdqueuebuf_start += 1;
    if(bot.bot_cmdqueuebuf_start >= bot.bot_cmdqueuebuf_end)
        bot_clearqueue(bot);
}

References bot_clearqueue(), entity(), and error.

Referenced by bot_command_executed(), and bot_setcurrentcommand().

bot_execute_commands()

int bot_execute_commands

(

entity

this

)

Definition at line 1350 of file scripting.qc.

{
    int f;
    do
    {
        f = bot_execute_commands_once(this);
    }
    while(f < 0);
    return f;
}

References bot_execute_commands_once(), and entity().

Referenced by havocbot_ai().

bot_execute_commands_once()

float bot_execute_commands_once

(

entity

this

)

Definition at line 1184 of file scripting.qc.

{
    float status, ispressingkey;
 
    // Find command
    bot_setcurrentcommand(this);
 
    // Ignore all commands except continue when the bot is paused
    if(!(this.bot_exec_status & BOT_EXEC_STATUS_PAUSED))
    {
        // if we have no bot command, better return
        // old logic kept pressing previously pressed keys, but that has problems
        // (namely, it means you cannot make a bot "normal" ever again)
        // to keep a bot walking for a while, use the "wait" bot command
        if(bot_cmd == world)
            return 0;
    }
    else if(bot_cmd.bot_cmd_type != BOT_CMD_CONTINUE)
    {
        if(bot_cmd.bot_cmd_type!=BOT_CMD_NULL)
        {
            bot_command_executed(this, true);
            LOG_INFO("WARNING: Commands are ignored while the bot is paused. Use the command 'continue' instead.");
        }
        return 1;
    }
 
    // Keep pressing keys raised by the "presskey" command
    ispressingkey = boolean(bot_presskeys(this));
 
    // Handle conditions
    if (!(bot_cmd.bot_cmd_type == BOT_CMD_FI || bot_cmd.bot_cmd_type == BOT_CMD_ELSE))
    if((this.bot_cmd_condition_status & CMD_CONDITION_true) && (this.bot_cmd_condition_status & CMD_CONDITION_false_BLOCK))
    {
        bot_command_executed(this, true);
        return -1;
    }
    else if((this.bot_cmd_condition_status & CMD_CONDITION_false) && (this.bot_cmd_condition_status & CMD_CONDITION_true_BLOCK))
    {
        bot_command_executed(this, true);
        return -1;
    }
 
    // Map commands to functions
    switch(bot_cmd.bot_cmd_type)
    {
        case BOT_CMD_NULL:
            return ispressingkey;
            //break;
        case BOT_CMD_PAUSE:
            status = bot_cmd_pause(this);
            break;
        case BOT_CMD_CONTINUE:
            status = bot_cmd_continue(this);
            break;
        case BOT_CMD_WAIT:
            status = bot_cmd_wait(this);
            break;
        case BOT_CMD_WAIT_UNTIL:
            status = bot_cmd_wait_until(this);
            break;
        case BOT_CMD_TURN:
            status = bot_cmd_turn(this);
            break;
        case BOT_CMD_MOVETO:
            status = bot_cmd_moveto(this);
            break;
        case BOT_CMD_MOVETOTARGET:
            status = bot_cmd_movetotarget(this);
            break;
        case BOT_CMD_RESETGOAL:
            status = bot_cmd_resetgoal(this);
            break;
        case BOT_CMD_CC:
            status = bot_cmd_cc(this);
            break;
        case BOT_CMD_IF:
            status = bot_cmd_if(this);
            break;
        case BOT_CMD_ELSE:
            status = bot_cmd_else(this);
            break;
        case BOT_CMD_FI:
            status = bot_cmd_fi(this);
            break;
        case BOT_CMD_RESETAIM:
            status = bot_cmd_resetaim(this);
            break;
        case BOT_CMD_AIM:
            status = bot_cmd_aim(this);
            break;
        case BOT_CMD_AIMTARGET:
            status = bot_cmd_aimtarget(this);
            break;
        case BOT_CMD_PRESSKEY:
            status = bot_cmd_presskey(this);
            break;
        case BOT_CMD_RELEASEKEY:
            status = bot_cmd_releasekey(this);
            break;
        case BOT_CMD_SELECTWEAPON:
            status = bot_cmd_select_weapon(this);
            break;
        case BOT_CMD_IMPULSE:
            status = bot_cmd_impulse(this);
            break;
        case BOT_CMD_BARRIER:
            status = bot_cmd_barrier(this);
            break;
        case BOT_CMD_CONSOLE:
            localcmd(strcat(bot_cmd.bot_cmd_parm_string, "\n"));
            status = CMD_STATUS_FINISHED;
            break;
        case BOT_CMD_SOUND:
            status = bot_cmd_sound(this);
            break;
        case BOT_CMD_DEBUG_ASSERT_CANFIRE:
            status = bot_cmd_debug_assert_canfire(this);
            break;
        default:
            LOG_INFOF("ERROR: Invalid command on queue with id '%s'", ftos(bot_cmd.bot_cmd_type));
            return 0;
    }
 
    if (status==CMD_STATUS_ERROR)
        LOG_INFOF("ERROR: The command '%s' returned an error status", bot_cmd_string[bot_cmd.bot_cmd_type]);
 
    // Move execution pointer
    if(status==CMD_STATUS_EXECUTING)
    {
        return 1;
    }
    else
    {
        if(autocvar_g_debug_bot_commands)
        {
            string parms;
 
            switch(bot_cmd_parm_type[bot_cmd.bot_cmd_type])
            {
                case BOT_CMD_PARAMETER_FLOAT:
                    parms = ftos(bot_cmd.bot_cmd_parm_float);
                    break;
                case BOT_CMD_PARAMETER_STRING:
                    parms = bot_cmd.bot_cmd_parm_string;
                    break;
                case BOT_CMD_PARAMETER_VECTOR:
                    parms = vtos(bot_cmd.bot_cmd_parm_vector);
                    break;
                default:
                    parms = "";
                    break;
            }
            clientcommand(this,strcat("say ^7", bot_cmd_string[bot_cmd.bot_cmd_type]," ",parms,"\n"));
        }
 
        bot_command_executed(this, true);
    }
 
    if(status == CMD_STATUS_FINISHED)
        return -1;
 
    return CMD_STATUS_ERROR;
}

References autocvar_g_debug_bot_commands, boolean, bot_cmd, BOT_CMD_AIM, bot_cmd_aim(), BOT_CMD_AIMTARGET, bot_cmd_aimtarget(), BOT_CMD_BARRIER, bot_cmd_barrier(), BOT_CMD_CC, bot_cmd_cc(), bot_cmd_condition_status, BOT_CMD_CONSOLE, BOT_CMD_CONTINUE, bot_cmd_continue(), BOT_CMD_DEBUG_ASSERT_CANFIRE, bot_cmd_debug_assert_canfire(), BOT_CMD_ELSE, bot_cmd_else(), BOT_CMD_FI, bot_cmd_fi(), BOT_CMD_IF, bot_cmd_if(), BOT_CMD_IMPULSE, bot_cmd_impulse(), BOT_CMD_MOVETO, bot_cmd_moveto(), BOT_CMD_MOVETOTARGET, bot_cmd_movetotarget(), BOT_CMD_NULL, BOT_CMD_PARAMETER_FLOAT, BOT_CMD_PARAMETER_STRING, BOT_CMD_PARAMETER_VECTOR, bot_cmd_parm_type, BOT_CMD_PAUSE, bot_cmd_pause(), BOT_CMD_PRESSKEY, bot_cmd_presskey(), BOT_CMD_RELEASEKEY, bot_cmd_releasekey(), BOT_CMD_RESETAIM, bot_cmd_resetaim(), BOT_CMD_RESETGOAL, bot_cmd_resetgoal(), bot_cmd_select_weapon(), BOT_CMD_SELECTWEAPON, BOT_CMD_SOUND, bot_cmd_sound(), bot_cmd_string, BOT_CMD_TURN, bot_cmd_turn(), BOT_CMD_WAIT, bot_cmd_wait(), BOT_CMD_WAIT_UNTIL, bot_cmd_wait_until(), bot_command_executed(), bot_exec_status, BOT_EXEC_STATUS_PAUSED, bot_presskeys(), bot_setcurrentcommand(), clientcommand(), CMD_CONDITION_false, CMD_CONDITION_false_BLOCK, CMD_CONDITION_true, CMD_CONDITION_true_BLOCK, CMD_STATUS_ERROR, CMD_STATUS_EXECUTING, CMD_STATUS_FINISHED, entity(), ftos(), localcmd(), LOG_INFO, LOG_INFOF, strcat(), vtos(), and world.

Referenced by bot_execute_commands().

bot_getplace()

entity bot_getplace	(	entity	this,
		string	placename )

Definition at line 113 of file scripting.qc.

{
    entity e;
    if(substring(placename, 0, 1) == "@")
    {
        int i, p;
        placename = substring(placename, 1, -1);
        string s, s2;
        for(i = 0; i < this.bot_places_count; ++i)
            if(this.(bot_placenames[i]) == placename)
                return this.(bot_places[i]);
        // now: i == this.bot_places_count
        s = s2 = cvar_string(placename);
        p = strstrofs(s2, " ", 0);
        if(p >= 0)
        {
            s = substring(s2, 0, p);
            //print("places: ", placename, " -> ", cvar_string(placename), "\n");
            cvar_set(placename, strcat(substring(s2, p+1, -1), " ", s));
            //print("places: ", placename, " := ", cvar_string(placename), "\n");
        }
        e = find(NULL, targetname, s);
        if(!e)
            LOG_INFO("invalid place ", s);
        if(i < MAX_BOT_PLACES)
        {
            this.(bot_placenames[i]) = strzone(placename);
            this.(bot_places[i]) = e;
            this.bot_places_count += 1;
        }
        return e;
    }
    else
    {
        e = find(NULL, targetname, placename);
        if(!e)
            LOG_INFO("invalid place ", placename);
        return e;
    }
}

References bot_placenames, bot_places, bot_places_count, cvar_set(), cvar_string(), entity(), find(), LOG_INFO, MAX_BOT_PLACES, NULL, s2, strcat(), strstrofs, strzone(), substring(), and targetname.

Referenced by bot_cmd_aimtarget(), and bot_cmd_movetotarget().

bot_havecommand()

bool bot_havecommand	(	entity	this,
		int	idx )

Definition at line 98 of file scripting.qc.

{
    if(!this.bot_cmdqueuebuf_allocated)
        return false;
    if(idx < this.bot_cmdqueuebuf_start)
        return false;
    if(idx >= this.bot_cmdqueuebuf_end)
        return false;
    return true;
}

References bot_cmdqueuebuf_allocated, bot_cmdqueuebuf_end, bot_cmdqueuebuf_start, and entity().

Referenced by bot_setcurrentcommand().

bot_ispaused()

bool bot_ispaused

(

entity

this

)

Definition at line 1003 of file scripting.qc.

{
    return(this.bot_exec_status & BOT_EXEC_STATUS_PAUSED);
}

References bot_exec_status, BOT_EXEC_STATUS_PAUSED, and entity().

Referenced by bot_relinkplayerlist(), and havocbot_ai().

bot_list_commands()

void bot_list_commands

(

)

Definition at line 444 of file scripting.qc.

{
    int i;
    string ptype;
 
    if(!bot_cmds_initialized)
        bot_commands_init();
 
    LOG_HELP("Bot commands:");
 
    for(i=1;i<BOT_CMD_COUNTER;++i)
    {
        switch(bot_cmd_parm_type[i])
        {
            case BOT_CMD_PARAMETER_FLOAT:
                ptype = "float";
                break;
            case BOT_CMD_PARAMETER_STRING:
                ptype = "string";
                break;
            case BOT_CMD_PARAMETER_VECTOR:
                ptype = "vector";
                break;
            default:
                ptype = "none";
                break;
        }
        if (ptype != "none")
            LOG_HELP("  ^2", bot_cmd_string[i]," ^7<", ptype, ">");
        else
            LOG_HELP("  ^2", bot_cmd_string[i]);
    }
    LOG_HELP("For help about a specific command, type bot_cmd help <command>");
}

References BOT_CMD_COUNTER, BOT_CMD_PARAMETER_FLOAT, BOT_CMD_PARAMETER_STRING, BOT_CMD_PARAMETER_VECTOR, bot_cmd_parm_type, bot_cmd_string, bot_cmds_initialized, bot_commands_init(), and LOG_HELP.

Referenced by GameCommand_bot_cmd().

bot_presskeys()

bool bot_presskeys

(

entity

this

)

Definition at line 840 of file scripting.qc.

{
    CS(this).movement = '0 0 0';
    PHYS_INPUT_BUTTON_JUMP(this) = false;
    PHYS_INPUT_BUTTON_CROUCH(this) = false;
    PHYS_INPUT_BUTTON_ATCK(this) = false;
    PHYS_INPUT_BUTTON_ATCK2(this) = false;
    PHYS_INPUT_BUTTON_USE(this) = false;
    PHYS_INPUT_BUTTON_HOOK(this) = false;
    PHYS_INPUT_BUTTON_CHAT(this) = false;
 
    if(this.bot_cmd_keys == BOT_CMD_KEY_NONE)
        return false;
 
    if(this.bot_cmd_keys & BOT_CMD_KEY_FORWARD)
        CS(this).movement_x = autocvar_sv_maxspeed;
    else if(this.bot_cmd_keys & BOT_CMD_KEY_BACKWARD)
        CS(this).movement_x = -autocvar_sv_maxspeed;
 
    if(this.bot_cmd_keys & BOT_CMD_KEY_RIGHT)
        CS(this).movement_y = autocvar_sv_maxspeed;
    else if(this.bot_cmd_keys & BOT_CMD_KEY_LEFT)
        CS(this).movement_y = -autocvar_sv_maxspeed;
 
    if(this.bot_cmd_keys & BOT_CMD_KEY_JUMP)
        PHYS_INPUT_BUTTON_JUMP(this) = true;
 
    if(this.bot_cmd_keys & BOT_CMD_KEY_CROUCH)
        PHYS_INPUT_BUTTON_CROUCH(this) = true;
 
    if(this.bot_cmd_keys & BOT_CMD_KEY_ATTACK1)
        PHYS_INPUT_BUTTON_ATCK(this) = true;
 
    if(this.bot_cmd_keys & BOT_CMD_KEY_ATTACK2)
        PHYS_INPUT_BUTTON_ATCK2(this) = true;
 
    if(this.bot_cmd_keys & BOT_CMD_KEY_USE)
        PHYS_INPUT_BUTTON_USE(this) = true;
 
    if(this.bot_cmd_keys & BOT_CMD_KEY_HOOK)
        PHYS_INPUT_BUTTON_HOOK(this) = true;
 
    if(this.bot_cmd_keys & BOT_CMD_KEY_CHAT)
        PHYS_INPUT_BUTTON_CHAT(this) = true;
 
    return true;
}

References autocvar_sv_maxspeed, BOT_CMD_KEY_ATTACK1, BOT_CMD_KEY_ATTACK2, BOT_CMD_KEY_BACKWARD, BOT_CMD_KEY_CHAT, BOT_CMD_KEY_CROUCH, BOT_CMD_KEY_FORWARD, BOT_CMD_KEY_HOOK, BOT_CMD_KEY_JUMP, BOT_CMD_KEY_LEFT, BOT_CMD_KEY_NONE, BOT_CMD_KEY_RIGHT, BOT_CMD_KEY_USE, bot_cmd_keys, CS(), entity(), PHYS_INPUT_BUTTON_ATCK, PHYS_INPUT_BUTTON_ATCK2, PHYS_INPUT_BUTTON_CHAT, PHYS_INPUT_BUTTON_CROUCH, PHYS_INPUT_BUTTON_HOOK, PHYS_INPUT_BUTTON_JUMP, and PHYS_INPUT_BUTTON_USE.

Referenced by bot_execute_commands_once().

bot_queuecommand()

void bot_queuecommand	(	entity	bot,
		string	cmdstring )

Definition at line 30 of file scripting.qc.

{
    if(!bot.bot_cmdqueuebuf_allocated)
    {
        bot.bot_cmdqueuebuf = buf_create();
        bot.bot_cmdqueuebuf_allocated = true;
        bot.bot_cmdqueuebuf_start = 0;
        bot.bot_cmdqueuebuf_end = 0;
    }
 
    bufstr_set(bot.bot_cmdqueuebuf, bot.bot_cmdqueuebuf_end, cmdstring);
 
    // if the command was a "sound" command, precache the sound NOW
    // this prevents lagging!
    {
        float sp;
        string parm;
        string cmdstr;
 
        sp = strstrofs(cmdstring, " ", 0);
        if(sp >= 0)
        {
            parm = substring(cmdstring, sp + 1, -1);
            cmdstr = substring(cmdstring, 0, sp);
            if(cmdstr == "sound")
            {
                // find the LAST word
                for (;;)
                {
                    sp = strstrofs(parm, " ", 0);
                    if(sp < 0)
                        break;
                    parm = substring(parm, sp + 1, -1);
                }
                precache_sound(parm);
            }
        }
    }
 
    bot.bot_cmdqueuebuf_end += 1;
}

References buf_create, entity(), precache_sound(), strstrofs, and substring().

Referenced by GameCommand_bot_cmd().

bot_readcommand()

string bot_readcommand	(	entity	bot,
		float	idx )

Definition at line 87 of file scripting.qc.

{
    if(!bot.bot_cmdqueuebuf_allocated)
        error("readcommand but no queue allocated");
    if(idx < bot.bot_cmdqueuebuf_start)
        error("reading a command in the past");
    if(idx >= bot.bot_cmdqueuebuf_end)
        error("reading a command in the future");
    return bufstr_get(bot.bot_cmdqueuebuf, idx);
}

References entity(), and error.

Referenced by bot_setcurrentcommand().

bot_resetqueues()

void bot_resetqueues

(

)

Definition at line 1165 of file scripting.qc.

{
    FOREACH_CLIENT(it.isbot, {
        it.bot_cmd_execution_index = 0;
        bot_clearqueue(it);
        // also, cancel all barriers
        it.bot_barrier = 0;
        for(int i = 0; i < it.bot_places_count; ++i)
        {
            strfree(it.(bot_placenames[i]));
        }
        it.bot_places_count = 0;
    });
 
    bot_barriertime = time;
}

References FOREACH_CLIENT.

Referenced by GameCommand_bot_cmd().

bot_setcurrentcommand()

void bot_setcurrentcommand

(

entity

this

)

Definition at line 1131 of file scripting.qc.

{
    bot_cmd = NULL;
 
    if(!this.bot_cmd_current)
    {
        this.bot_cmd_current = new_pure(bot_cmd);
    }
 
    bot_cmd = this.bot_cmd_current;
    if(bot_cmd.bot_cmd_index != this.bot_cmd_execution_index || this.bot_cmd_execution_index == 0)
    {
        if(bot_havecommand(this, this.bot_cmd_execution_index))
        {
            string cmdstring;
            cmdstring = bot_readcommand(this, this.bot_cmd_execution_index);
            if(bot_decodecommand(cmdstring))
            {
                bot_cmd.owner = this;
                bot_cmd.bot_cmd_index = this.bot_cmd_execution_index;
            }
            else
            {
                // Invalid command, remove from queue
                bot_cmd = NULL;
                bot_dequeuecommand(this, this.bot_cmd_execution_index);
                this.bot_cmd_execution_index++;
            }
        }
        else
            bot_cmd = NULL;
    }
}

References bot_cmd, bot_cmd_current, bot_cmd_execution_index, bot_decodecommand(), bot_dequeuecommand(), bot_havecommand(), bot_readcommand(), entity(), new_pure, and NULL.

Referenced by bot_execute_commands_once().

find_bot_by_name()

entity find_bot_by_name

(

string

name

)

Definition at line 235 of file scripting.qc.

{
    FOREACH_CLIENT(IS_BOT_CLIENT(it) && it.netname == name,
    {
        return it;
    });
 
    return NULL;
}

References entity(), FOREACH_CLIENT, IS_BOT_CLIENT, name, and NULL.

Referenced by GameCommand_bot_cmd().

find_bot_by_number()

entity find_bot_by_number

(

float

number

)

Definition at line 246 of file scripting.qc.

{
    entity bot;
    float c = 0;
 
    if(!number)
        return NULL;
 
    bot = findchainflags(flags, FL_CLIENT); // TODO: doesn't findchainflags loop backwards through entities?
    while (bot)
    {
        if(IS_BOT_CLIENT(bot))
        {
            if(++c==number)
                return bot;
        }
        bot = bot.chain;
    }
 
    return NULL;
}

References entity(), findchainflags(), FL_CLIENT, flags, IS_BOT_CLIENT, NULL, and number.

Referenced by GameCommand_bot_cmd().

Variable Documentation

bot_cmd_aim_begin

vector bot_cmd_aim_begin

Definition at line 727 of file scripting.qc.

Referenced by bot_cmd_aim(), and bot_cmd_aimtarget().

bot_cmd_aim_begintime

float bot_cmd_aim_begintime

Definition at line 725 of file scripting.qc.

Referenced by bot_cmd_aim(), and bot_cmd_aimtarget().

bot_cmd_aim_end

vector bot_cmd_aim_end

Definition at line 728 of file scripting.qc.

Referenced by bot_cmd_aim(), and bot_cmd_aimtarget().

bot_cmd_aim_endtime

float bot_cmd_aim_endtime

Definition at line 726 of file scripting.qc.

Referenced by bot_cmd_aim(), and bot_cmd_aimtarget().

bot_cmd_condition_status

int bot_cmd_condition_status

Definition at line 601 of file scripting.qc.

Referenced by bot_cmd_else(), bot_cmd_fi(), bot_cmd_if(), and bot_execute_commands_once().

BOT_CMD_KEY_ATTACK1

const int BOT_CMD_KEY_ATTACK1 = BIT(5)

Definition at line 833 of file scripting.qc.

Referenced by bot_cmd_keypress_handler(), and bot_presskeys().

BOT_CMD_KEY_ATTACK2

const int BOT_CMD_KEY_ATTACK2 = BIT(6)

Definition at line 834 of file scripting.qc.

Referenced by bot_cmd_keypress_handler(), and bot_presskeys().

BOT_CMD_KEY_BACKWARD

const int BOT_CMD_KEY_BACKWARD = BIT(1)

Definition at line 829 of file scripting.qc.

Referenced by bot_cmd_keypress_handler(), and bot_presskeys().

BOT_CMD_KEY_CHAT

const int BOT_CMD_KEY_CHAT = BIT(10)

Definition at line 838 of file scripting.qc.

Referenced by bot_cmd_keypress_handler(), and bot_presskeys().

BOT_CMD_KEY_CROUCH

const int BOT_CMD_KEY_CROUCH = BIT(9)

Definition at line 837 of file scripting.qc.

Referenced by bot_cmd_keypress_handler(), and bot_presskeys().

BOT_CMD_KEY_FORWARD

const int BOT_CMD_KEY_FORWARD = BIT(0)

Definition at line 828 of file scripting.qc.

Referenced by bot_cmd_keypress_handler(), and bot_presskeys().

BOT_CMD_KEY_HOOK

const int BOT_CMD_KEY_HOOK = BIT(8)

Definition at line 836 of file scripting.qc.

Referenced by bot_cmd_keypress_handler(), and bot_presskeys().

BOT_CMD_KEY_JUMP

const int BOT_CMD_KEY_JUMP = BIT(4)

Definition at line 832 of file scripting.qc.

Referenced by bot_cmd_keypress_handler(), and bot_presskeys().

BOT_CMD_KEY_LEFT

const int BOT_CMD_KEY_LEFT = BIT(3)

Definition at line 831 of file scripting.qc.

Referenced by bot_cmd_keypress_handler(), and bot_presskeys().

BOT_CMD_KEY_NONE

const int BOT_CMD_KEY_NONE = 0

Definition at line 827 of file scripting.qc.

Referenced by bot_cmd_keypress_handler(), bot_cmd_pause(), and bot_presskeys().

BOT_CMD_KEY_RIGHT

const int BOT_CMD_KEY_RIGHT = BIT(2)

Definition at line 830 of file scripting.qc.

Referenced by bot_cmd_keypress_handler(), and bot_presskeys().

BOT_CMD_KEY_USE

const int BOT_CMD_KEY_USE = BIT(7)

Definition at line 835 of file scripting.qc.

Referenced by bot_cmd_keypress_handler(), and bot_presskeys().

bot_cmd_keys

int bot_cmd_keys

Definition at line 825 of file scripting.qc.

Referenced by bot_cmd_keypress_handler(), bot_cmd_pause(), and bot_presskeys().

bot_cmd_wait_time

float bot_cmd_wait_time

Definition at line 501 of file scripting.qc.

Referenced by bot_cmd_wait().

bot_cmdqueuebuf

float bot_cmdqueuebuf

Definition at line 17 of file scripting.qc.

bot_cmdqueuebuf_allocated

float bot_cmdqueuebuf_allocated

Definition at line 16 of file scripting.qc.

Referenced by bot_havecommand().

bot_cmdqueuebuf_end

float bot_cmdqueuebuf_end

Definition at line 19 of file scripting.qc.

Referenced by bot_havecommand().

bot_cmdqueuebuf_start

float bot_cmdqueuebuf_start

Definition at line 18 of file scripting.qc.

Referenced by bot_havecommand().

bot_exec_status

int bot_exec_status

Definition at line 480 of file scripting.qc.

Referenced by bot_cmd_continue(), bot_cmd_pause(), bot_cmd_wait(), bot_cmd_wait_until(), bot_execute_commands_once(), and bot_ispaused().

bot_placenames

string bot_placenames[MAX_BOT_PLACES]

Definition at line 112 of file scripting.qc.

Referenced by bot_getplace().

bot_places

entity bot_places[MAX_BOT_PLACES]

Definition at line 111 of file scripting.qc.

Referenced by bot_getplace().

bot_places_count

float bot_places_count

Definition at line 110 of file scripting.qc.

Referenced by bot_getplace().

CMD_CONDITION_false

const int CMD_CONDITION_false = 2

Definition at line 605 of file scripting.qc.

Referenced by bot_cmd_if(), and bot_execute_commands_once().

CMD_CONDITION_false_BLOCK

const int CMD_CONDITION_false_BLOCK = 8

Definition at line 607 of file scripting.qc.

Referenced by bot_cmd_else(), and bot_execute_commands_once().

CMD_CONDITION_NONE

const int CMD_CONDITION_NONE = 0

Definition at line 603 of file scripting.qc.

Referenced by bot_cmd_fi(), and bot_cmd_if().

CMD_CONDITION_true

const int CMD_CONDITION_true = 1

Definition at line 604 of file scripting.qc.

Referenced by bot_cmd_if(), and bot_execute_commands_once().

CMD_CONDITION_true_BLOCK

const int CMD_CONDITION_true_BLOCK = 4

Definition at line 606 of file scripting.qc.

Referenced by bot_cmd_else(), bot_cmd_if(), and bot_execute_commands_once().

MAX_BOT_PLACES

const int MAX_BOT_PLACES = 4

Definition at line 109 of file scripting.qc.

Referenced by bot_getplace().

state

int state

Definition at line 14 of file scripting.qc.

tuba_note

entity tuba_note

Definition at line 1074 of file scripting.qc.