quake3.qc File Reference

#include "quake3.qh"
#include <common/gametypes/_mod.qh>
#include <common/gametypes/gametype/ctf/sv_ctf.qh>
#include <common/mapobjects/trigger/counter.qh>
#include <common/mapobjects/triggers.qh>
#include <common/mutators/mutator/buffs/_mod.qh>
#include <common/mutators/mutator/powerups/_mod.qh>
#include <common/mutators/mutator/status_effects/_mod.qh>
#include <common/notifications/all.qh>
#include <common/resources/sv_resources.qh>
#include <common/stats.qh>
#include <common/weapons/_all.qh>
#include <server/client.qh>
#include <server/items/items.qh>
#include <server/items/spawning.qh>
#include <server/world.qh>

Include dependency graph for quake3.qc:

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

Go to the source code of this file.

Macros
#define	FRAGSFILTER_REMOVER   BIT(0)
#define	FRAGSFILTER_RESET   BIT(3)
#define	FRAGSFILTER_RUNONCE   BIT(1)
#define	FRAGSFILTER_SILENT   BIT(2)
#define	PRINT_BLUETEAM   BIT(1)
#define	PRINT_BROADCAST   BIT(3)
#define	PRINT_PRIVATE   BIT(2)
#define	PRINT_REDTEAM   BIT(0)

Functions
bool	DoesQ3ARemoveThisEntity (entity this)
void	fragsfilter_use (entity this, entity actor, entity trigger)
void	score_use (entity this, entity actor, entity trigger)
	spawnfunc (target_fragsFilter)
	spawnfunc (target_give)
	spawnfunc (target_init)
	spawnfunc (target_print)
	spawnfunc (target_score)
	spawnfunc (target_smallprint)
	SPAWNFUNC_Q3 (weapon_shotgun, ammo_shells, q3compat==Q3COMPAT_ARENA ? WEP_MACHINEGUN :WEP_SHOTGUN, q3compat==Q3COMPAT_ARENA ? 8 :1) SPAWNFUNC_Q3(weapon_machinegun
void	target_give_init (entity this)
void	target_init_use (entity this, entity actor, entity trigger)
void	target_init_verify (entity this)
void	target_print_message (entity this, entity actor)
void	target_print_use (entity this, entity actor, entity trigger)

Variables
	ammo_bullets
float	delay
string	gametype
string	not_gametype
	q3compat == Q3COMPAT_ARENA ? WEP_SHOTGUN : WEP_MACHINEGUN

Macro Definition Documentation

FRAGSFILTER_REMOVER

#define FRAGSFILTER_REMOVER   BIT(0)

Definition at line 266 of file quake3.qc.

Referenced by fragsfilter_use().

FRAGSFILTER_RESET

#define FRAGSFILTER_RESET   BIT(3)

Definition at line 269 of file quake3.qc.

Referenced by fragsfilter_use().

FRAGSFILTER_RUNONCE

#define FRAGSFILTER_RUNONCE   BIT(1)

Definition at line 267 of file quake3.qc.

FRAGSFILTER_SILENT

#define FRAGSFILTER_SILENT   BIT(2)

Definition at line 268 of file quake3.qc.

Referenced by fragsfilter_use().

PRINT_BLUETEAM

#define PRINT_BLUETEAM   BIT(1)

Definition at line 300 of file quake3.qc.

Referenced by target_print_use().

PRINT_BROADCAST

#define PRINT_BROADCAST   BIT(3)

Definition at line 302 of file quake3.qc.

Referenced by target_print_use().

PRINT_PRIVATE

#define PRINT_PRIVATE   BIT(2)

Definition at line 301 of file quake3.qc.

Referenced by target_print_use().

PRINT_REDTEAM

#define PRINT_REDTEAM   BIT(0)

Definition at line 299 of file quake3.qc.

Referenced by target_print_use().

Function Documentation

DoesQ3ARemoveThisEntity()

bool DoesQ3ARemoveThisEntity

(

entity

this

)

Definition at line 360 of file quake3.qc.

{
    // Q3 style filters (DO NOT USE, THIS IS COMPAT ONLY)
 
    if (!this.classname)
        return true;
 
    // DeFRaG mappers use "notcpm" or "notvq3" to disable an entity in CPM or VQ3 physics
    // Xonotic is usually played with a CPM-based physics so we default to CPM mode
    if(cvar_string("g_mod_physics") == "Q3")
    {
        if(stof(GetField_fullspawndata(this, "notvq3", false)))
            return true;
    }
    else if(stof(GetField_fullspawndata(this, "notcpm", false)))
        return true;
 
    // Q3 mappers use "notq3a" or "notta" to disable an entity in Q3A or Q3TA
    // Xonotic has ~equivalent features to Team Arena
    if(stof(GetField_fullspawndata(this, "notta", false)))
        return true;
 
    // FIXME: singleplayer does not use maxclients 1 as that would prevent bots,
    // this is the case in Q3 also, it uses another method to block clients.
    // Only accessible in VQ3, via the `spmap` command.
    if(stof(GetField_fullspawndata(this, "notsingle", false)))
        if(maxclients == 1 && IS_GAMETYPE(DEATHMATCH))
            return true;
 
    if(stof(GetField_fullspawndata(this, "notteam", false)))
        if(teamplay)
            return true;
 
    if(stof(GetField_fullspawndata(this, "notfree", false)))
        if(!teamplay)
            return true;
 
    if(this.gametype || this.not_gametype)
    {
        // Q3 checks these with strstr(): case-sensitive, no gametype can be a substring of another,
        // any separator is allowed (conventions are: spaces, commas, or commas with spaces).
        // QL's entities.def says they're space delineated.
 
        // Q3 gametype entity fields: ffa tournament single team ctf oneflag obelisk  harvester    (game/g_spawn.c)
        // Q3 arena file 'type' key:  ffa tourney                ctf oneflag overload harvester    (ui/ui_gameinfo.c)
 
        // QL gametype entity fields: ffa duel tdm ca ft rr ctf ad dom har 1f      race ob
        // QL arena file 'type' key:  ffa duel tdm ca ft rr ctf ad dom har oneflag race
 
        string gametypename_q3, gametypename_ql;
 
        // One of these will apply if our gametype has no Q3/QL equivalent
        if(teamplay)
        {
            gametypename_q3 = "team";
            gametypename_ql = "tdm";
        }
        else
            gametypename_q3 = gametypename_ql = "ffa";
 
        if(g_ctf)
        {
            if (cvar("g_ctf_oneflag"))
            {
                gametypename_q3 = "oneflag";
                gametypename_ql = "1f";
            }
            else
                gametypename_q3 = gametypename_ql = "ctf";
        }
        else if(g_duel)
        {
            gametypename_q3 = "tournament";
            gametypename_ql = "duel";
        }
        else if(IS_GAMETYPE(DEATHMATCH) && maxclients == 1)
            gametypename_q3 = "single";
        else if(g_ca)
            gametypename_ql = "ql";
        else if(IS_GAMETYPE(FREEZETAG))
            gametypename_ql = "ft";
        else if(IS_GAMETYPE(DOMINATION))
            gametypename_ql = "dom";
        else if(g_race || g_cts)
            gametypename_ql = "race";
 
        if(this.gametype)
        if(strstrofs(this.gametype, gametypename_q3, 0) < 0
        && strstrofs(this.gametype, gametypename_ql, 0) < 0)
            return true;
 
        // Only supported by QL
        if(strstrofs(this.not_gametype, gametypename_ql, 0) >= 0)
            return true;
    }
 
    return false;
}

References classname, cvar(), cvar_string(), entity(), g_ca, g_ctf, g_cts, g_duel, g_race, gametype, GetField_fullspawndata(), maxclients, not_gametype, stof(), strstrofs, and teamplay.

Referenced by SV_OnEntityPreSpawnFunction().

fragsfilter_use()

void fragsfilter_use	(	entity	this,
		entity	actor,
		entity	trigger )

Definition at line 271 of file quake3.qc.

{
    if(!IS_PLAYER(actor))
        return;
    if(actor.fragsfilter_cnt >= this.frags)
    {
        if(this.spawnflags & FRAGSFILTER_RESET)
            actor.fragsfilter_cnt = 0;
        else if(this.spawnflags & FRAGSFILTER_REMOVER)
            actor.fragsfilter_cnt -= this.frags;
        SUB_UseTargets(this, actor, trigger);
    }
    else if(!(this.spawnflags & FRAGSFILTER_SILENT))
    {
        int req_frags = this.frags - actor.fragsfilter_cnt;
        centerprint(actor, sprintf("%d more frag%s needed", req_frags, req_frags > 1 ? "s" : ""));
        play2(actor, SND(TALK));
    }
}

References centerprint(), entity(), frags, FRAGSFILTER_REMOVER, FRAGSFILTER_RESET, FRAGSFILTER_SILENT, IS_PLAYER, play2(), SND, spawnflags, and SUB_UseTargets().

Referenced by spawnfunc().

score_use()

void score_use	(	entity	this,
		entity	actor,
		entity	trigger )

Definition at line 251 of file quake3.qc.

{
    if(!IS_PLAYER(actor))
        return;
    actor.fragsfilter_cnt += this.count;
}

References count, entity(), and IS_PLAYER.

Referenced by spawnfunc().

spawnfunc() [1/6]

spawnfunc

(

target_fragsFilter

)

Definition at line 290 of file quake3.qc.

{
    if(!g_cts) { delete(this); return; }
 
    if(!this.frags)
        this.frags = 1;
    this.use = fragsfilter_use;
}

References frags, fragsfilter_use(), g_cts, and use.

spawnfunc() [2/6]

spawnfunc

(

target_give

)

Definition at line 246 of file quake3.qc.

{
    InitializeEntity(this, target_give_init, INITPRIO_FINDTARGET);
}

References InitializeEntity(), INITPRIO_FINDTARGET, and target_give_init().

spawnfunc() [3/6]

spawnfunc

(

target_init

)

Definition at line 204 of file quake3.qc.

{
    this.use = target_init_use;
    InitializeEntity(this, target_init_verify, INITPRIO_FINDTARGET);
}

References InitializeEntity(), INITPRIO_FINDTARGET, target_init_use(), target_init_verify(), and use.

spawnfunc() [4/6]

spawnfunc

(

target_print

)

Definition at line 347 of file quake3.qc.

{
    this.use = target_print_use;
}

References target_print_use(), and use.

spawnfunc() [5/6]

spawnfunc

(

target_score

)

Definition at line 257 of file quake3.qc.

{
    if(!g_cts) { delete(this); return; }
 
    if(!this.count)
        this.count = 1;
    this.use = score_use;
}

References count, g_cts, score_use(), and use.

spawnfunc() [6/6]

spawnfunc

(

target_smallprint

)

Definition at line 353 of file quake3.qc.

{
    spawnfunc_target_print(this);
}

SPAWNFUNC_Q3()

SPAWNFUNC_Q3	(	weapon_shotgun	,
		ammo_shells	,
		q3compat	= = Q3COMPAT_ARENA ? WEP_MACHINEGUN : WEP_SHOTGUN,
		q3compat	= = Q3COMPAT_ARENA ? 8 : 1 )

References ammo_shells, q3compat, and Q3COMPAT_ARENA.

target_give_init()

void target_give_init

(

entity

this

)

Definition at line 211 of file quake3.qc.

{
    IL_EACH(g_items, it.targetname == this.target,
    {
        if (it.classname == "item_buff")
        {
            this.netname = cons(this.netname, it.buffdef.netname);
            this.buffs_finished += it.buffs_finished;
        }
        else
        {
            this.ammo_rockets          += it.ammo_rockets;
            this.ammo_cells            += it.ammo_cells;
            this.ammo_shells           += it.ammo_shells;
            this.ammo_nails            += it.ammo_nails;
            this.invincible_finished   += it.invincible_finished;
            this.strength_finished     += it.strength_finished;
            this.speed_finished        += it.speed_finished;
            this.invisibility_finished += it.invisibility_finished;
            this.health                += it.health;
            this.armorvalue            += it.armorvalue;
 
            this.netname = cons(this.netname, (it.itemdef.m_weapon) ? it.itemdef.m_weapon.netname : it.itemdef.netname);
        }
 
        //remove(it); // removing ents in init functions causes havoc, workaround:
        setthink(it, SUB_Remove);
        it.nextthink = time;
    });
    this.spawnflags = 2;
    this.spawnfunc_checked = true;
    spawnfunc_target_items(this);
    InitializeEntity(this, target_init_verify, INITPRIO_FINDTARGET);
}

References entity(), g_items, IL_EACH, setthink, SUB_Remove(), and time.

Referenced by spawnfunc().

target_init_use()

void target_init_use	(	entity	this,
		entity	actor,
		entity	trigger )

Definition at line 139 of file quake3.qc.

{
    if (!(this.spawnflags & 1))
    {
        SetResource(actor, RES_ARMOR, start_armorvalue);
        actor.pauserotarmor_finished = time + autocvar_g_balance_pause_armor_rot;
    }
 
    if (!(this.spawnflags & 2))
    {
        SetResource(actor, RES_HEALTH, start_health);
        actor.pauserothealth_finished = time + autocvar_g_balance_pause_health_rot;
        actor.pauseregen_finished = time + autocvar_g_balance_pause_health_regen;
    }
 
    if (!(this.spawnflags & 4))
    {
        if(this.spawnflags & 32) // spawn with only melee
        {
            SetResource(actor, RES_SHELLS, 0);
            SetResource(actor, RES_BULLETS, 0);
            SetResource(actor, RES_ROCKETS, 0);
            SetResource(actor, RES_CELLS, 0);
            SetResource(actor, RES_FUEL, 0);
 
            STAT(WEAPONS, actor) = WEPSET(SHOTGUN);
        }
        else
        {
            SetResource(actor, RES_SHELLS, start_ammo_shells);
            SetResource(actor, RES_BULLETS, start_ammo_nails);
            SetResource(actor, RES_ROCKETS, start_ammo_rockets);
            SetResource(actor, RES_CELLS, start_ammo_cells);
            SetResource(actor, RES_FUEL, start_ammo_fuel);
 
            STAT(WEAPONS, actor) = start_weapons;
        }
    }
 
    if (!(this.spawnflags & 8))
    {
        FOREACH(StatusEffects, it.instanceOfPowerupStatusEffect,
        {
            it.m_remove(it, actor, STATUSEFFECT_REMOVE_NORMAL);
        });
        entity heldbuff = buff_FirstFromFlags(actor);
        if(heldbuff) // TODO: make a dropbuffs function to handle this
        {
            int buffid = heldbuff.m_id;
            Send_Notification(NOTIF_ONE, actor, MSG_MULTI, ITEM_BUFF_DROP, buffid);
            sound(actor, CH_TRIGGER, SND_BUFF_LOST, VOL_BASE, ATTN_NORM);
            if(!IS_INDEPENDENT_PLAYER(actor))
                Send_Notification(NOTIF_ALL_EXCEPT, actor, MSG_INFO, INFO_ITEM_BUFF_LOST, actor.netname, buffid);
            buff_RemoveAll(actor, STATUSEFFECT_REMOVE_NORMAL);
        }
    }
 
    if (!(this.spawnflags & 16))
    {
        // We don't have holdables.
    }
 
    SUB_UseTargets(this, actor, trigger);
}

References ATTN_NORM, autocvar_g_balance_pause_armor_rot, autocvar_g_balance_pause_health_regen, autocvar_g_balance_pause_health_rot, buff_FirstFromFlags(), buff_RemoveAll(), CH_TRIGGER, entity(), FOREACH, IS_INDEPENDENT_PLAYER, RES_ARMOR, Send_Notification(), SetResource(), sound, spawnflags, start_ammo_cells, start_ammo_fuel, start_ammo_nails, start_ammo_rockets, start_ammo_shells, start_armorvalue, start_health, start_weapons, STAT, STATUSEFFECT_REMOVE_NORMAL, SUB_UseTargets(), time, VOL_BASE, and WEPSET.

Referenced by spawnfunc().

target_init_verify()

void target_init_verify

(

entity

this

)

Definition at line 121 of file quake3.qc.

{
    entity trigger, targ;
    for(trigger = NULL; (trigger = find(trigger, classname, "trigger_multiple")); )
        for(targ = NULL; (targ = find(targ, targetname, trigger.target)); )
            if (targ.classname == "target_init" || targ.classname == "target_give" || targ.classname == "target_items")
            {
                trigger.wait = 0;
                trigger.delay = 0;
                targ.wait = 0;
                targ.delay = 0;
 
                //setsize(targ, trigger.mins, trigger.maxs);
                //setorigin(targ, trigger.origin);
                //remove(trigger);
            }
}

References classname, entity(), find(), NULL, target_init_verify(), targetname, and this.

Referenced by spawnfunc(), and target_init_verify().

target_print_message()

void target_print_message	(	entity	this,
		entity	actor )

Definition at line 304 of file quake3.qc.

{
    centerprint(actor, this.message);
    play2(actor, SND(TALK));
}

References centerprint(), entity(), message, play2(), and SND.

Referenced by target_print_use().

target_print_use()

void target_print_use	(	entity	this,
		entity	actor,
		entity	trigger )

Definition at line 310 of file quake3.qc.

{
    if(!IS_PLAYER(actor))
        return;
 
    if(this.message == "")
        return;
 
    bool priv, red, blue;
    if(!(q3compat & Q3COMPAT_DEFI)) // Q3 spawnflags
    {
        priv = boolean(this.spawnflags & PRINT_PRIVATE);
        red = boolean(this.spawnflags & PRINT_REDTEAM);
        blue = boolean(this.spawnflags & PRINT_BLUETEAM);
    }
    else // Q3DF spawnflags
    {
        priv = !boolean(this.spawnflags & PRINT_BROADCAST);
        red = blue = false;
    }
 
    if(priv)
    {
        target_print_message(this, actor);
    }
    else
    {
        FOREACH_CLIENT(IS_PLAYER(it) && IS_REAL_CLIENT(it) && ((!red && !blue) || (red && it.team == NUM_TEAM_1) || (blue && it.team == NUM_TEAM_2)), target_print_message(this, it));
    }
}

References boolean, entity(), FOREACH_CLIENT, IS_PLAYER, IS_REAL_CLIENT, message, NUM_TEAM_1, NUM_TEAM_2, PRINT_BLUETEAM, PRINT_BROADCAST, PRINT_PRIVATE, PRINT_REDTEAM, q3compat, Q3COMPAT_DEFI, spawnflags, and target_print_message().

Referenced by spawnfunc().

Variable Documentation

ammo_bullets

ammo_bullets

Definition at line 58 of file quake3.qc.

delay

float delay

Definition at line 118 of file quake3.qc.

gametype

string gametype

Definition at line 358 of file quake3.qc.

not_gametype

string not_gametype

Definition at line 359 of file quake3.qc.

Referenced by DoesQ3ARemoveThisEntity().

q3compat

q3compat == Q3COMPAT_ARENA ? WEP_SHOTGUN : WEP_MACHINEGUN

Definition at line 59 of file quake3.qc.

Referenced by door_init_shared(), item_healthbig_init(), item_healthmedium_init(), item_healthmega_init(), item_healthsmall_init(), Physics_UpdateStats(), PutPlayerInServer(), spawnfunc(), spawnfunc(), spawnfunc(), spawnfunc(), spawnfunc(), spawnfunc(), SPAWNFUNC_Q3(), StartItem(), SV_OnEntityPreSpawnFunction(), target_print_use(), and trigger_hurt_touch().