spawnpoints.qc File Reference

#include "spawnpoints.qh"
#include <common/constants.qh>
#include <common/gametypes/_mod.qh>
#include <common/mapobjects/subs.qh>
#include <common/mapobjects/target/spawnpoint.qh>
#include <common/mapobjects/triggers.qh>
#include <common/net_linked.qh>
#include <common/stats.qh>
#include <common/teams.qh>
#include <common/util.qh>
#include <common/weapons/_all.qh>
#include <lib/warpzone/common.qh>
#include <lib/warpzone/util_server.qh>
#include <server/command/vote.qh>
#include <server/intermission.qh>
#include <server/mutators/_mod.qh>
#include <server/race.qh>
#include <server/utils.qh>
#include <server/world.qh>

Include dependency graph for spawnpoints.qc:

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

Go to the source code of this file.

Functions
void	link_spawnpoint (entity this)
void	relocate_spawnpoint (entity this)
entity	SelectSpawnPoint (entity this, bool anypoint)
entity	Spawn_FilterOutBadSpots (entity this, entity firstspot, float mindist, float teamcheck, bool targetcheck)
vector	Spawn_Score (entity this, entity spot, float mindist, float teamcheck, bool targetcheck)
void	Spawn_ScoreAll (entity this, entity firstspot, float mindist, float teamcheck, bool targetcheck)
entity	Spawn_WeightedPoint (entity firstspot, float lower, float upper, float exponent)
bool	SpawnEvent_Send (entity this, entity to, int sf)
	spawnfunc (info_player_deathmatch)
	spawnfunc (info_player_start)
	spawnfunc (info_player_survivor)
	spawnfunc (info_player_team1)
	spawnfunc (info_player_team2)
	spawnfunc (info_player_team3)
	spawnfunc (info_player_team4)
bool	spawnpoint_customize (entity this, entity client)
void	spawnpoint_reset (entity this)
bool	SpawnPoint_Send (entity this, entity to, int sf)
void	spawnpoint_setactive (entity this, int act)
void	spawnpoint_think (entity this)
void	spawnpoint_use (entity this, entity actor, entity trigger)

Variables
vector	spawnpoint_prevorigin
bool	testspawn_checked
entity	testspawn_point

Function Documentation

link_spawnpoint()

void link_spawnpoint

(

entity

this

)

Definition at line 106 of file spawnpoints.qc.

{
    bool anypoint = (autocvar_g_spawn_useallspawns || (teamplay && have_team_spawns <= 0)); // TODO: check if available teams is equal to spawnpoints available
 
    // Don't show team spawns in non-team matches,
    // and don't show non-team spawns in team matches.
    // (Unless useallspawns is activated)
    if(anypoint || !((teamplay && !Team_IsValidTeam(this.team)) || (!teamplay && Team_IsValidTeam(this.team))))
        Net_LinkEntity(this, false, 0, SpawnPoint_Send);
}

References autocvar_g_spawn_useallspawns, entity(), have_team_spawns, Net_LinkEntity(), SpawnPoint_Send(), team, Team_IsValidTeam(), and teamplay.

Referenced by relocate_spawnpoint().

relocate_spawnpoint()

void relocate_spawnpoint

(

entity

this

)

Definition at line 117 of file spawnpoints.qc.

{
    // nudge off the floor
    setorigin(this, this.origin + '0 0 1');
 
    tracebox(this.origin, PL_MIN_CONST, PL_MAX_CONST, this.origin, true, this);
    if (trace_startsolid)
    {
        vector o = this.origin;
        this.mins = PL_MIN_CONST;
        this.maxs = PL_MAX_CONST;
        if (!move_out_of_solid(this))
            objerror(this, "could not get out of solid at all!");
        LOG_INFOF(
            "^1NOTE: this map needs FIXING. Spawnpoint at %s needs to be moved out of solid, e.g. by %s",
            vtos(o - '0 0 1'),
            vtos(this.origin - o)
        );
        if (autocvar_g_spawnpoints_auto_move_out_of_solid)
        {
            if (!spawnpoint_nag)
                LOG_INFO("\{1}^1NOTE: this map needs FIXING (it contains spawnpoints in solid, see server log)");
            spawnpoint_nag = 1;
        }
        else
        {
            setorigin(this, o);
            this.mins = this.maxs = '0 0 0';
            objerror(this, "player spawn point in solid, mapper sucks!\n");
            return;
        }
    }
 
    this.active = ACTIVE_ACTIVE;
    this.setactive = spawnpoint_setactive;
    setcefc(this, spawnpoint_customize);
    this.use = spawnpoint_use;
    setthink(this, spawnpoint_think);
    this.nextthink = time + 0.5 + random() * 2; // shouldn't need it for a little second
    this.reset2 = spawnpoint_reset; // restores team, allows re-sending the spawnpoint
    this.team_saved = this.team;
    IL_PUSH(g_saved_team, this);
    if (!this.cnt)
        this.cnt = 1;
 
    if (have_team_spawns != 0)
        if (this.team)
            have_team_spawns = 1;
    have_team_spawns_forteams |= BIT(this.team);
 
    if (autocvar_r_showbboxes)
    {
        // show where spawnpoints point at too
        vector forward, right, up;
        MAKE_VECTORS(this.angles, forward, right, up);
        entity e = new(info_player_foo);
        setorigin(e, this.origin + forward * 24);
        setsize(e, '-8 -8 -8', '8 8 8');
        e.solid = SOLID_TRIGGER;
    }
 
    // network it after all spawnpoints are setup, so that we can check if team spawnpoints are used
    InitializeEntity(this, link_spawnpoint, INITPRIO_FINDTARGET);
}

References active, ACTIVE_ACTIVE, angles, autocvar_g_spawnpoints_auto_move_out_of_solid, autocvar_r_showbboxes, BIT, cnt, entity(), g_saved_team, have_team_spawns, have_team_spawns_forteams, IL_PUSH(), InitializeEntity(), INITPRIO_FINDTARGET, link_spawnpoint(), LOG_INFO, LOG_INFOF, MAKE_VECTORS, maxs, mins, move_out_of_solid, nextthink, objerror, origin, PL_MAX_CONST, PL_MIN_CONST, random(), setcefc, setthink, SOLID_TRIGGER, spawnpoint_customize(), spawnpoint_nag, spawnpoint_reset(), spawnpoint_setactive(), spawnpoint_think(), spawnpoint_use(), team, team_saved, time, trace_startsolid, use, vector, and vtos().

Referenced by spawnfunc().

SelectSpawnPoint()

entity SelectSpawnPoint	(	entity	this,
		bool	anypoint )

Definition at line 358 of file spawnpoints.qc.

{
    float teamcheck;
    entity spot = NULL;
 
    if(!testspawn_checked)
    {
        testspawn_point = find(NULL, classname, "testplayerstart");
        testspawn_checked = true;
    }
 
    if(testspawn_point)
        return testspawn_point;
 
    if(this.spawnpoint_targ)
        return this.spawnpoint_targ;
 
    if(anypoint || autocvar_g_spawn_useallspawns)
        teamcheck = -1;
    else if(have_team_spawns > 0)
    {
        if(!(have_team_spawns_forteams & BIT(this.team)))
        {
            // we request a spawn for a team, and we have team
            // spawns, but that team has no spawns?
            if(have_team_spawns_forteams & BIT(0))
                // try noteam spawns
                teamcheck = 0;
            else
                // if not, any spawn has to do
                teamcheck = -1;
        }
        else
            teamcheck = this.team; // MUST be team
    }
    else if(have_team_spawns == 0 && (have_team_spawns_forteams & BIT(0)))
        teamcheck = 0; // MUST be noteam
    else
        teamcheck = -1;
        // if we get here, we either require team spawns but have none, or we require non-team spawns and have none; use any spawn then
 
 
    // get the entire list of spots
    //entity firstspot = findchain(classname, "info_player_deathmatch");
    entity firstspot = IL_FIRST(g_spawnpoints);
    entity prev = NULL;
    IL_EACH(g_spawnpoints, true,
    {
        if(prev)
            prev.chain = it;
        it.chain = NULL;
        prev = it;
    });
    // filter out the bad ones
    // (note this returns the original list if none survived)
    if(anypoint)
    {
        spot = Spawn_WeightedPoint(firstspot, 1, 1, 1);
    }
    else
    {
        firstspot = Spawn_FilterOutBadSpots(this, firstspot, 100, teamcheck, true);
 
        // emergency fallback! double check without targets
        // fixes some crashes with improperly repacked maps
        if(!firstspot)
        {
            firstspot = IL_FIRST(g_spawnpoints);
            prev = NULL;
            IL_EACH(g_spawnpoints, true,
            {
                if(prev)
                    prev.chain = it;
                it.chain = NULL;
                prev = it;
            });
            firstspot = Spawn_FilterOutBadSpots(this, firstspot, 100, teamcheck, false);
        }
 
        // there is 50/50 chance of choosing a random spot or the furthest spot
        // (this means that roughly every other spawn will be furthest, so you
        // usually won't get fragged at spawn twice in a row)
        if (random() > autocvar_g_spawn_furthest)
            spot = Spawn_WeightedPoint(firstspot, 1, 1, 1);
        else
            spot = Spawn_WeightedPoint(firstspot, 1, 5000, 5); // chooses a far far away spawnpoint
    }
 
    if (!spot)
    {
        if(autocvar_spawn_debug)
            GotoNextMap(0);
        else
        {
            if(some_spawn_has_been_used)
                return NULL; // team can't spawn any more, because of actions of other team
            else
                error("Cannot find a spawn point - please fix the map!");
        }
    }
 
    return spot;
}

References autocvar_g_spawn_furthest, autocvar_g_spawn_useallspawns, autocvar_spawn_debug, BIT, classname, entity(), error, find(), g_spawnpoints, GotoNextMap(), have_team_spawns, have_team_spawns_forteams, IL_EACH, IL_FIRST, NULL, prev, random(), some_spawn_has_been_used, Spawn_FilterOutBadSpots(), Spawn_WeightedPoint(), spawnpoint_targ, team, testspawn_checked, and testspawn_point.

Referenced by buff_Respawn(), ka_RespawnBall(), MUTATOR_HOOKFUNCTION(), MUTATOR_HOOKFUNCTION(), PutObserverInServer(), PutPlayerInServer(), and tka_RespawnBall().

Spawn_FilterOutBadSpots()

entity Spawn_FilterOutBadSpots	(	entity	this,
		entity	firstspot,
		float	mindist,
		float	teamcheck,
		bool	targetcheck )

Definition at line 310 of file spawnpoints.qc.

{
    entity spot, spotlist, spotlistend;
 
    spotlist = NULL;
    spotlistend = NULL;
 
    Spawn_ScoreAll(this, firstspot, mindist, teamcheck, targetcheck);
 
    for(spot = firstspot; spot; spot = spot.chain)
    {
        if(spot.spawnpoint_score.x >= 0) // spawning allowed here
        {
            if(spotlistend)
                spotlistend.chain = spot;
            spotlistend = spot;
            if(!spotlist)
                spotlist = spot;
        }
    }
    if(spotlistend)
        spotlistend.chain = NULL;
 
    return spotlist;
}

References entity(), NULL, and Spawn_ScoreAll().

Referenced by SelectSpawnPoint(), and trigger_race_checkpoint_verify().

Spawn_Score()

vector Spawn_Score	(	entity	this,
		entity	spot,
		float	mindist,
		float	teamcheck,
		bool	targetcheck )

Definition at line 239 of file spawnpoints.qc.

{
    // filter out spots for the wrong team
    if(teamcheck >= 0)
        if(spot.team != teamcheck)
            return '-1 0 0';
 
    if(race_spawns)
        if(!spot.target || spot.target == "")
            return '-1 0 0';
 
    if(spot.active != ACTIVE_ACTIVE && targetcheck)
        return '-1 0 0';
 
    if(IS_REAL_CLIENT(this))
    {
        if(spot.restriction == 1)
            return '-1 0 0';
    }
    else
    {
        if(spot.restriction == 2)
            return '-1 0 0';
    }
 
    float prio = 0;
    float shortest = vlen(world.maxs - world.mins);
    FOREACH_CLIENT(IS_PLAYER(it) && !IS_DEAD(it) && it != this, {
        float thisdist = vlen(it.origin - spot.origin);
        if (thisdist < shortest)
            shortest = thisdist;
    });
    if(shortest > mindist)
        prio += SPAWN_PRIO_GOOD_DISTANCE;
 
    vector spawn_score = prio * '1 0 0' + shortest * '0 1 0';
 
    // filter out spots for assault
    if(spot.target && spot.target != "" && targetcheck)
    {
        int found = 0;
        for(entity targ = findchain(targetname, spot.target); targ; targ = targ.chain)
        {
            ++found;
            if(targ.spawn_evalfunc)
            {
                spawn_score = targ.spawn_evalfunc(targ, this, spot, spawn_score);
                if(spawn_score.x < 0)
                    return spawn_score;
            }
        }
 
        if(!found && !g_cts)
        {
            LOG_TRACE("WARNING: spawnpoint at ", vtos(spot.origin), " could not find its target ", spot.target);
            return '-1 0 0';
        }
    }
 
    MUTATOR_CALLHOOK(Spawn_Score, this, spot, spawn_score);
    spawn_score = M_ARGV(2, vector);
    return spawn_score;
}

References ACTIVE_ACTIVE, entity(), FOREACH_CLIENT, g_cts, IS_DEAD, IS_PLAYER, IS_REAL_CLIENT, LOG_TRACE, M_ARGV, MUTATOR_CALLHOOK, race_spawns, SPAWN_PRIO_GOOD_DISTANCE, Spawn_Score(), targetname, vector, vlen(), vtos(), and world.

Referenced by MUTATOR_HOOKABLE(), MUTATOR_HOOKFUNCTION(), MUTATOR_HOOKFUNCTION(), Spawn_Score(), and Spawn_ScoreAll().

Spawn_ScoreAll()

void Spawn_ScoreAll	(	entity	this,
		entity	firstspot,
		float	mindist,
		float	teamcheck,
		bool	targetcheck )

Definition at line 303 of file spawnpoints.qc.

{
    entity spot;
    for(spot = firstspot; spot; spot = spot.chain)
        spot.spawnpoint_score = Spawn_Score(this, spot, mindist, teamcheck, targetcheck);
}

References entity(), and Spawn_Score().

Referenced by Spawn_FilterOutBadSpots().

Spawn_WeightedPoint()

entity Spawn_WeightedPoint	(	entity	firstspot,
		float	lower,
		float	upper,
		float	exponent )

Definition at line 336 of file spawnpoints.qc.

{
    // weight of a point: bound(lower, mindisttoplayer, upper)^exponent
    // multiplied by spot.cnt (useful if you distribute many spawnpoints in a small area)
    entity spot;
 
    RandomSelection_Init();
    for(spot = firstspot; spot; spot = spot.chain)
        RandomSelection_AddEnt(spot, (bound(lower, spot.spawnpoint_score.y, upper) ** exponent) * spot.cnt, (spot.spawnpoint_score.y >= lower) * 0.5 + spot.spawnpoint_score.x);
 
    return RandomSelection_chosen_ent;
}

References bound(), entity(), RandomSelection_AddEnt, RandomSelection_chosen_ent, and RandomSelection_Init().

Referenced by SelectSpawnPoint().

SpawnEvent_Send()

bool SpawnEvent_Send	(	entity	this,
		entity	to,
		int	sf )

Definition at line 32 of file spawnpoints.qc.

{
    float send;
 
    WriteHeader(MSG_ENTITY, ENT_CLIENT_SPAWNEVENT);
 
    if(autocvar_g_spawn_alloweffects)
    {
        WriteByte(MSG_ENTITY, etof(this.owner));
        WriteVector(MSG_ENTITY, this.owner.origin);
        WriteByte(MSG_ENTITY, this.owner.team);
        WriteByte(MSG_ENTITY, autocvar_g_spawn_alloweffects);
        send = true;
    }
    else if((to == this.owner) || (IS_SPEC(to) && (to.enemy == this.owner)) )
    {
        WriteByte(MSG_ENTITY, 0);
        send = true;
    }
    else { send = false; }
 
    return send;
}

References autocvar_g_spawn_alloweffects, entity(), etof, IS_SPEC, MSG_ENTITY, owner, WriteByte(), and WriteHeader.

Referenced by PutPlayerInServer().

spawnfunc() [1/7]

spawnfunc

(

info_player_deathmatch

)

Definition at line 192 of file spawnpoints.qc.

{
    IL_PUSH(g_spawnpoints, this);
    relocate_spawnpoint(this);
}

References g_spawnpoints, IL_PUSH(), and relocate_spawnpoint().

spawnfunc() [2/7]

spawnfunc

(

info_player_start

)

Definition at line 187 of file spawnpoints.qc.

{
    spawnfunc_info_player_deathmatch(this);
}

spawnfunc() [3/7]

spawnfunc

(

info_player_survivor

)

Definition at line 182 of file spawnpoints.qc.

{
    spawnfunc_info_player_deathmatch(this);
}

spawnfunc() [4/7]

spawnfunc

(

info_player_team1

)

Definition at line 201 of file spawnpoints.qc.

{
    this.team = NUM_TEAM_1; // red
    spawnfunc_info_player_deathmatch(this);
}

References NUM_TEAM_1, and team.

spawnfunc() [5/7]

spawnfunc

(

info_player_team2

)

Definition at line 211 of file spawnpoints.qc.

{
    this.team = NUM_TEAM_2; // blue
    spawnfunc_info_player_deathmatch(this);
}

References NUM_TEAM_2, and team.

spawnfunc() [6/7]

spawnfunc

(

info_player_team3

)

Definition at line 220 of file spawnpoints.qc.

{
    this.team = NUM_TEAM_3; // yellow
    spawnfunc_info_player_deathmatch(this);
}

References NUM_TEAM_3, and team.

spawnfunc() [7/7]

spawnfunc

(

info_player_team4

)

Definition at line 230 of file spawnpoints.qc.

{
    this.team = NUM_TEAM_4; // purple
    spawnfunc_info_player_deathmatch(this);
}

References NUM_TEAM_4, and team.

spawnpoint_customize()

bool spawnpoint_customize	(	entity	this,
		entity	client )

Definition at line 79 of file spawnpoints.qc.

{
    return (this.active == ACTIVE_ACTIVE);
}

References active, ACTIVE_ACTIVE, and entity().

Referenced by relocate_spawnpoint().

spawnpoint_reset()

void spawnpoint_reset

(

entity

this

)

Definition at line 100 of file spawnpoints.qc.

{
    this.active = ACTIVE_ACTIVE;
    this.SendFlags |= 1; // update team since it was restored during reset
}

References active, ACTIVE_ACTIVE, entity(), and SendFlags.

Referenced by relocate_spawnpoint().

SpawnPoint_Send()

bool SpawnPoint_Send	(	entity	this,
		entity	to,
		int	sf )

Definition at line 22 of file spawnpoints.qc.

{
    WriteHeader(MSG_ENTITY, ENT_CLIENT_SPAWNPOINT);
 
    WriteByte(MSG_ENTITY, this.team);
    WriteVector(MSG_ENTITY, this.origin);
 
    return true;
}

References entity(), MSG_ENTITY, origin, team, WriteByte(), and WriteHeader.

Referenced by link_spawnpoint().

spawnpoint_setactive()

void spawnpoint_setactive	(	entity	this,
		int	act )

Definition at line 84 of file spawnpoints.qc.

{
    int old_status = this.active;
    if(act == ACTIVE_TOGGLE)
        this.active = (this.active == ACTIVE_ACTIVE) ? ACTIVE_NOT : ACTIVE_ACTIVE;
    else
        this.active = act;
 
    if(this.active != old_status)
    {
        // mappers may attempt to let players disable enemy spawns
        if(teamplay && have_team_spawns > 0)
            some_spawn_has_been_used = true;
        this.SendFlags |= 1;
    }
}

References active, ACTIVE_ACTIVE, ACTIVE_NOT, ACTIVE_TOGGLE, entity(), have_team_spawns, SendFlags, some_spawn_has_been_used, and teamplay.

Referenced by relocate_spawnpoint().

spawnpoint_think()

void spawnpoint_think

(

entity

this

)

Definition at line 57 of file spawnpoints.qc.

{
    this.nextthink = time + 0.1;
    if(this.origin != this.spawnpoint_prevorigin)
    {
        this.spawnpoint_prevorigin = this.origin;
        this.SendFlags |= 1;
    }
}

References entity(), nextthink, origin, SendFlags, spawnpoint_prevorigin, and time.

Referenced by relocate_spawnpoint().

spawnpoint_use()

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

Definition at line 67 of file spawnpoints.qc.

{
    if(teamplay)
    if(have_team_spawns > 0)
    {
        this.team = actor.team;
        some_spawn_has_been_used = true;
        this.SendFlags |= 1; // update team on the client side
    }
    //LOG_INFO("spawnpoint was used!\n");
}

References entity(), have_team_spawns, SendFlags, some_spawn_has_been_used, team, and teamplay.

Referenced by relocate_spawnpoint().

Variable Documentation

spawnpoint_prevorigin

vector spawnpoint_prevorigin

Definition at line 56 of file spawnpoints.qc.

Referenced by spawnpoint_think().

testspawn_checked

bool testspawn_checked

Definition at line 356 of file spawnpoints.qc.

Referenced by SelectSpawnPoint().

testspawn_point

entity testspawn_point

Definition at line 357 of file spawnpoints.qc.

Referenced by SelectSpawnPoint().