spawnpoints.qh File Reference

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

Go to the source code of this file.

Typedefs
using	spawn_evalfunc_t = vector(entity this, entity player, entity spot, vector current)

Functions
entity	SelectSpawnPoint (entity this, bool anypoint)
entity	Spawn_FilterOutBadSpots (entity this, entity firstspot, float mindist, float teamcheck, bool targetcheck)
bool	SpawnEvent_Send (entity this, entity to, int sf)
	spawnfunc (info_player_deathmatch)
void	spawnpoint_use (entity this, entity actor, entity trigger)
	STATIC_INIT (g_spawnpoints)

Variables
int	autocvar_g_spawn_alloweffects
float	autocvar_g_spawn_furthest
bool	autocvar_g_spawn_useallspawns
bool	autocvar_g_spawnpoints_auto_move_out_of_solid
float	autocvar_r_showbboxes
IntrusiveList	g_spawnpoints
int	have_team_spawns
int	have_team_spawns_forteams
int	restriction
bool	some_spawn_has_been_used
spawn_evalfunc_t	spawn_evalfunc
const int	SPAWN_PRIO_GOOD_DISTANCE = 10
const int	SPAWN_PRIO_NEAR_TEAMMATE_FOUND = 200
const int	SPAWN_PRIO_NEAR_TEAMMATE_SAMETEAM = 100
const int	SPAWN_PRIO_RACE_PREVIOUS_SPAWN = 50
float	spawnpoint_nag
vector	spawnpoint_score

Typedef Documentation

spawn_evalfunc_t

using spawn_evalfunc_t = vector(entity this, entity player, entity spot, vector current)

Definition at line 27 of file spawnpoints.qh.

Function Documentation

SelectSpawnPoint()

entity SelectSpawnPoint	(	entity	this,
		bool	anypoint )

Definition at line 359 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 311 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().

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()

spawnfunc

(

info_player_deathmatch

)

Definition at line 193 of file spawnpoints.qc.

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

References g_spawnpoints, IL_PUSH(), and 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().

STATIC_INIT()

STATIC_INIT

(

g_spawnpoints

)

Definition at line 33 of file spawnpoints.qh.

{ g_spawnpoints = IL_NEW(); }

References g_spawnpoints, and IL_NEW.

Variable Documentation

autocvar_g_spawn_alloweffects

int autocvar_g_spawn_alloweffects

Definition at line 3 of file spawnpoints.qh.

Referenced by SpawnEvent_Send().

autocvar_g_spawn_furthest

float autocvar_g_spawn_furthest

Definition at line 4 of file spawnpoints.qh.

Referenced by SelectSpawnPoint().

autocvar_g_spawn_useallspawns

bool autocvar_g_spawn_useallspawns

Definition at line 5 of file spawnpoints.qh.

Referenced by link_spawnpoint(), SelectSpawnPoint(), and WinningCondition_RanOutOfSpawns().

autocvar_g_spawnpoints_auto_move_out_of_solid

bool autocvar_g_spawnpoints_auto_move_out_of_solid

Definition at line 6 of file spawnpoints.qh.

Referenced by relocate_spawnpoint().

autocvar_r_showbboxes

float autocvar_r_showbboxes

Definition at line 7 of file spawnpoints.qh.

Referenced by relocate_spawnpoint().

g_spawnpoints

IntrusiveList g_spawnpoints

Definition at line 32 of file spawnpoints.qh.

Referenced by MoveToRandomLocationWithinBounds(), SelectSpawnPoint(), spawnfunc(), spawnfunc(), STATIC_INIT(), waypoint_unreachable(), and WinningCondition_RanOutOfSpawns().

have_team_spawns

int have_team_spawns

Definition at line 16 of file spawnpoints.qh.

Referenced by link_spawnpoint(), relocate_spawnpoint(), SelectSpawnPoint(), spawnpoint_setactive(), spawnpoint_use(), SV_OnEntityPreSpawnFunction(), and WinningCondition_RanOutOfSpawns().

have_team_spawns_forteams

int have_team_spawns_forteams

Definition at line 17 of file spawnpoints.qh.

Referenced by relocate_spawnpoint(), and SelectSpawnPoint().

restriction

int restriction

Definition at line 30 of file spawnpoints.qh.

some_spawn_has_been_used

bool some_spawn_has_been_used

Definition at line 15 of file spawnpoints.qh.

Referenced by SelectSpawnPoint(), spawnpoint_setactive(), spawnpoint_use(), and WinningCondition_RanOutOfSpawns().

spawn_evalfunc

spawn_evalfunc_t spawn_evalfunc

Definition at line 28 of file spawnpoints.qh.

Referenced by spawnfunc(), and spawnfunc().

SPAWN_PRIO_GOOD_DISTANCE

const int SPAWN_PRIO_GOOD_DISTANCE = 10

Definition at line 13 of file spawnpoints.qh.

Referenced by Spawn_Score().

SPAWN_PRIO_NEAR_TEAMMATE_FOUND

const int SPAWN_PRIO_NEAR_TEAMMATE_FOUND = 200

Definition at line 10 of file spawnpoints.qh.

Referenced by MUTATOR_HOOKFUNCTION().

SPAWN_PRIO_NEAR_TEAMMATE_SAMETEAM

const int SPAWN_PRIO_NEAR_TEAMMATE_SAMETEAM = 100

Definition at line 11 of file spawnpoints.qh.

Referenced by MUTATOR_HOOKFUNCTION().

SPAWN_PRIO_RACE_PREVIOUS_SPAWN

const int SPAWN_PRIO_RACE_PREVIOUS_SPAWN = 50

Definition at line 12 of file spawnpoints.qh.

Referenced by trigger_race_checkpoint_spawn_evalfunc().

spawnpoint_nag

float spawnpoint_nag

Definition at line 20 of file spawnpoints.qh.

Referenced by relocate_spawnpoint().

spawnpoint_score

vector spawnpoint_score

Definition at line 19 of file spawnpoints.qh.