multi.qc File Reference

#include "multi.qh"

Include dependency graph for multi.qc:

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

Go to the source code of this file.

Functions
void	multi_eventdamage (entity this, entity inflictor, entity attacker, float damage, int deathtype,.entity weaponentity, vector hitloc, vector force)
void	multi_reset (entity this)
void	multi_touch (entity this, entity toucher)
void	multi_trigger (entity this, bool exacttrigger)
void	multi_use (entity this, entity actor, entity trigger)
void	multi_wait (entity this)
	spawnfunc (trigger_multiple)
	spawnfunc (trigger_once)

Variables
int	triggertimes

Function Documentation

multi_eventdamage()

void multi_eventdamage	(	entity	this,
		entity	inflictor,
		entity	attacker,
		float	damage,
		int	deathtype,
		.entity	weaponentity,
		vector	hitloc,
		vector	force )

Definition at line 148 of file multi.qc.

{
    if(!this.takedamage)
        return;
    if(this.spawnflags & NOSPLASH)
        if(!(DEATH_ISSPECIAL(deathtype)) && (deathtype & HITTYPE_SPLASH))
            return;
    if(this.team)
        if(((this.spawnflags & INVERT_TEAMS) == 0) == (this.team != attacker.team))
            return;
    TakeResource(this, RES_HEALTH, damage);
    if (GetResource(this, RES_HEALTH) <= 0)
    {
        this.enemy = attacker;
        this.goalentity = inflictor;
        multi_trigger(this, false);
    }
}

References DEATH_ISSPECIAL, enemy, entity(), GetResource(), goalentity, HITTYPE_SPLASH, INVERT_TEAMS, multi_trigger(), NOSPLASH, spawnflags, takedamage, TakeResource(), team, and vector.

Referenced by spawnfunc().

multi_reset()

void multi_reset

(

entity

this

)

Definition at line 167 of file multi.qc.

{
    if (q3compat || !(this.spawnflags & SPAWNFLAG_NOTOUCH))
        settouch(this, multi_touch);
    if (this.max_health)
    {
        SetResourceExplicit(this, RES_HEALTH, this.max_health);
        this.takedamage = DAMAGE_YES;
        this.solid = SOLID_BBOX;
    }
    setthink(this, func_null);
    this.nextthink = 0;
    this.team = this.team_saved;
    this.use = multi_use;
}

References DAMAGE_YES, entity(), func_null(), max_health, multi_touch(), multi_use(), nextthink, q3compat, SetResourceExplicit(), setthink, settouch, solid, SOLID_BBOX, SPAWNFLAG_NOTOUCH, spawnflags, takedamage, team, team_saved, and use.

Referenced by spawnfunc().

multi_touch()

void multi_touch	(	entity	this,
		entity	toucher )

Definition at line 103 of file multi.qc.

{
    if(!q3compat && !(this.spawnflags & ALL_ENTITIES) && !toucher.iscreature)
    {
        return;
    }
 
    if (q3compat && AVAILABLE_TEAMS == 2)
    {
        // This feature isn't mentioned in entities.def but it's in the source.
        // Xonotic has given these spawnflags other meanings.
        if(((this.spawnflags & 1) && toucher.team != NUM_TEAM_1) // not on red
        || ((this.spawnflags & 2) && toucher.team != NUM_TEAM_2)) // not on blue
            return;
    }
    else if (this.team)
    {
        if(((this.spawnflags & INVERT_TEAMS) == 0) == (this.team != toucher.team))
        {
            return;
        }
    }
 
    // if the trigger has an angles field, check player's facing direction
    if (this.movedir != '0 0 0')
    {
        makevectors (toucher.angles);
        if (v_forward * this.movedir < 0)
            return;     // not facing the right way
    }
 
    // if the trigger has pressed keys, check that the player is pressing those keys
    if(this.pressedkeys && IS_PLAYER(toucher)) // only for players
    {
        if(!(CS(toucher).pressedkeys & this.pressedkeys))
        {
            return;
        }
    }
 
    this.enemy = toucher;
    this.goalentity = toucher;
    multi_trigger(this, true);
}

References ALL_ENTITIES, AVAILABLE_TEAMS, CS(), enemy, entity(), goalentity, INVERT_TEAMS, IS_PLAYER, makevectors, movedir, multi_trigger(), NUM_TEAM_1, NUM_TEAM_2, pressedkeys, q3compat, spawnflags, team, toucher, and v_forward.

Referenced by multi_reset(), and spawnfunc().

multi_trigger()

void multi_trigger	(	entity	this,
		bool	exacttrigger )

Definition at line 22 of file multi.qc.

{
    if((this.spawnflags & ONLY_PLAYERS) && !IS_PLAYER(this.enemy))
    {
        return; // only players
    }
 
    // In Q3 .wait <= 0 is forever,
    // in Xonotic .wait == -1 means forever and == -2 means don't wait at all.
    if (IS_GAMETYPE(CTS) && IS_CLIENT(this.enemy))
    {
        // check the client-specific trigger time
        int cnum = etof(this.enemy);
        if (buf_getsize(this.triggertimes) >= cnum) // buffer slot exists
        {
            float triggertime = stof(bufstr_get(this.triggertimes, cnum - 1));
            if (this.enemy.spawn_time <= triggertime) // havn't respawned since triggering
            {
                if ((this.wait <= 0 && (q3compat || this.wait >= -1)) // wait forever (until respawn in CTS)
                || triggertime + this.wait > time) // too soon
                    return;
            }
        }
    }
    else if (this.nextthink > time)
        return;     // allready been triggered
 
    if (exacttrigger)
        EXACTTRIGGER_TOUCH(this, this.enemy);
 
    if (this.noise && this.noise != "")
    {
        _sound (this.enemy, CH_TRIGGER, this.noise, VOL_BASE, ATTEN_NORM);
    }
 
    // don't trigger again until reset
    this.takedamage = DAMAGE_NO;
 
    SUB_UseTargets(this, this.enemy, this.goalentity);
 
    if (IS_GAMETYPE(CTS) && IS_CLIENT(this.enemy))
    {
        // store the client-specific trigger time
        string triggertime = sprintf("%15.14g", time); // 16b, perfect precision until timelimit_max @ <= 512hz (32768 sec)
        int cnum = etof(this.enemy);
        int bsize = buf_getsize(this.triggertimes);
        if (bsize >= cnum) // already got a slot
            bufstr_set(this.triggertimes, cnum - 1, triggertime);
        else while (bsize < cnum) // create any lower numbered slots too
            bufstr_add(this.triggertimes, (++bsize == cnum ? triggertime : "0"), true);
    }
    else if (this.wait > 0)
    {
        setthink(this, multi_wait);
        this.nextthink = time + this.wait;
    }
    else if (this.wait < -1 && !q3compat) // xon maps only: no waiting
    {
        multi_wait(this); // waiting finished
    }
    else
    {
        if (IS_GAMETYPE(CTS)) // client-specific .wait timers
            this.nextthink = stof("inf"); // clients can trigger again after respawning, disabled for other touchers
        else
        {
            // we can't just delete(this) here, because this is a touch function
            // called while C code is looping through area links...
            settouch(this, func_null);
            this.use = func_null;
        }
    }
}

References _sound, ATTEN_NORM, CH_TRIGGER, DAMAGE_NO, enemy, entity(), etof, EXACTTRIGGER_TOUCH, func_null(), goalentity, IS_CLIENT, IS_PLAYER, multi_wait(), nextthink, noise, ONLY_PLAYERS, q3compat, setthink, settouch, spawnflags, stof(), SUB_UseTargets(), takedamage, time, triggertimes, use, VOL_BASE, and wait.

Referenced by multi_eventdamage(), multi_touch(), and multi_use().

multi_use()

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

Definition at line 96 of file multi.qc.

{
    this.goalentity = trigger;
    this.enemy = actor;
    multi_trigger(this, false);
}

References enemy, entity(), goalentity, and multi_trigger().

Referenced by multi_reset(), and spawnfunc().

multi_wait()

void multi_wait

(

entity

this

)

Definition at line 8 of file multi.qc.

{
    if (this.max_health)
    {
        SetResourceExplicit(this, RES_HEALTH, this.max_health);
        this.takedamage = DAMAGE_YES;
        this.solid = SOLID_BBOX;
    }
}

References DAMAGE_YES, entity(), max_health, SetResourceExplicit(), solid, SOLID_BBOX, and takedamage.

Referenced by multi_trigger().

spawnfunc() [1/2]

spawnfunc

(

trigger_multiple

)

Definition at line 196 of file multi.qc.

{
    this.reset = multi_reset;
    if (this.sounds == 1)
        this.noise = "misc/secret.wav";
    else if (this.sounds == 2)
        this.noise = strzone(SND(TALK));
    else if (this.sounds == 3)
        this.noise = "misc/trigger1.wav";
 
    if(this.noise && this.noise != "")
        precache_sound(this.noise);
 
    if (q3compat)
    {
        if (!this.wait)
        {
            string s = GetField_fullspawndata(this, "wait", false);
            if (!s || s == "") // it's really not set ("0" or "foo" waits forever)
                this.wait = 0.5;
        }
    }
    else if (!this.wait)
        this.wait = 0.2;
 
    this.use = multi_use;
 
    EXACTTRIGGER_INIT;
 
    // TEAMNUMBERS_THAT_ARENT_STUPID TODO: need to convert this.team to index, maybe add .teamindex
    this.team_saved = this.team;
    IL_PUSH(g_saved_team, this);
 
    // health/damage mode isn't supported in Q3 or with CTS client-specific .wait timers
    if (GetResource(this, RES_HEALTH) && !q3compat && !IS_GAMETYPE(CTS))
    {
        if (this.spawnflags & SPAWNFLAG_NOTOUCH)
            objerror (this, "health and notouch don't make sense\n");
        this.canteamdamage = true;
        this.max_health = GetResource(this, RES_HEALTH);
        this.event_damage = multi_eventdamage;
        this.takedamage = DAMAGE_YES;
        this.solid = SOLID_BBOX;
        setorigin(this, this.origin); // make sure it links into the world
    }
    else
    {
        if (q3compat || !(this.spawnflags & SPAWNFLAG_NOTOUCH))
            settouch(this, multi_touch);
 
        if (IS_GAMETYPE(CTS)) // client-specific .wait timers
            if ((this.triggertimes = buf_create()) < 0)
                LOG_FATAL("trigger_multiple: wait timer buffer creation failed somehow!\n");
    }
}

References buf_create, canteamdamage, DAMAGE_YES, EXACTTRIGGER_INIT, g_saved_team, GetField_fullspawndata(), GetResource(), IL_PUSH(), LOG_FATAL, max_health, multi_eventdamage(), multi_reset(), multi_touch(), multi_use(), noise, objerror, origin, precache_sound(), q3compat, settouch, SND, solid, SOLID_BBOX, sounds, SPAWNFLAG_NOTOUCH, spawnflags, strzone(), takedamage, team, team_saved, triggertimes, use, and wait.

spawnfunc() [2/2]

spawnfunc

(

trigger_once

)

Definition at line 266 of file multi.qc.

{
    this.wait = -1;
    spawnfunc_trigger_multiple(this);
}

References wait.

Variable Documentation

triggertimes

int triggertimes

Definition at line 5 of file multi.qc.

Referenced by multi_trigger(), and spawnfunc().