Gametype Scripting

Page in progress.

Types

Vec3

Constructor	Description
Vec3()	Initializes x,y,z to zero.
Vec3(float v)	Initializes x,y,z to v.
Vec3(float x, float y, float z)	Initializes x,y,z with the given values for each.
Vec3(Vec3 &in)	Copy constructor. Initializes x,y,z to the values on the supplied Vec3.

Property	Description	R/W
float x	The x component of the vector.	RW
float y	The y component of the vector.	RW
float z	The z component of the vector.	RW

Method	Description
void set(float x, float y, float z)	Sets the x,y,z components on the vector to the supplied values.
float length()	Returns the magnitude of the vector.
float normalize()	Normalizes the vector and returns the magnitude pre-normalization.
float distance(Vec3 &other)	Returns the distance between the tips of this vector and the supplied vector.
void angleVectors(Vec3 &f, Vec3 &r, Vec3 &u)	Sets the provided vectors as rotations about the forward, right, and up axes (?)
Vec3 toAngles()	Returns a vector representing the current vector as a rotation.
Vec3 perpendicular()	Returns the vector perpendicular to this vector.
void makeNormalVectors(Vec3 &r, Vec3 &u)	Returns the normal and binormal vector of the current vector (assumed to be the tangent/forward).

The mathematical operators are overloaded for vectors and perform the equivalent vector operation.

Cvar

Constructor	Description
Cvar(String &name, String &value, uint flags)	Creates the cvar "name" if it does not exist, with the given value and flags. If the cvar exists, the value is unused, and the supplied flags are set if they are not already set on the cvar.
Cvar(Cvar &other)	Copy constructor.

Property	Description	R/W
bool modified	Example	RW
bool boolean	The value of the cvar as a bool	R
int integer	The value of the cvar as an int	R
float value	The value of the cvar as a float	R
String@ name	The name of cvar	R
String@ string	The value of the cvar as a string	R
String@ defaultString	The default value of the cvar	R
String@ latchedString	If the cvar has CVAR_LATCH or a variant, the value after a map/video restart	R

Method	Description
void reset()	Resets the value of the cvar to its default value.
void set(String &value)	Sets the value of the cvar to the supplied string.
void set(float value)	Sets the value of the cvar to the supplied float.
void set(int value)	Sets the value of the cvar to the supplied integer. Note: cast to float internally
void set(double value)	Sets the value of the cvar to the supplied double. Note: cast to float internally

Enum Value	Description
CVAR_ARCHIVE	Save to vars.rc
CVAR_USERINFO	Added to userinfo when changed
CVAR_SERVERINFO	Added to serverinfo when changed
CVAR_NOSET	Only settable from command line
CVAR_LATCH	Save changes until a map restart
CVAR_LATCH_VIDEO	Save changes until a video restart
CVAR_LATCH_AUDIO	Save changes until a sound restart
CVAR_CHEAT	Reset to default unless cheats are enabled
CVAR_READONLY	not user-changeable
[Not present in angelscript] CVAR_DEVELOPER	only visible/changeable in dev builds

Entity

Not constructable. New instances can be spawned, see @G_SpawnEntity.

Entity types enum	Description
ET_GENERIC	Generic entity?
ET_PLAYER	Player entity
ET_CORPSE	Corpse entity
ET_BEAM	Beam entity??? Likely deprecated
ET_PORTALSURFACE	Portal surface, used for misc_portal_surface
ET_PUSH_TRIGGER	Push trigger entity, another weird map thing
ET_GIB	Gib entity that leaves a trail
ET_BLASTER	Gunblade projectile?
ET_ELECTRO_WEAK	EB weak mode? currently unclear
ET_ROCKET	Rocket projectile
ET_GRENADE	Grenade projectile
ET_PLASMA	Plasma gun projectile
ET_SPRITE	2d Sprite entity
ET_ITEM	Item entity, like those created by SpawnItem
ET_LASERBEAM	Continuous laser beam(???)
ET_CURVELASERBEAM	Curved laser beam(???)
ET_FLAG_BASE	??? used for the flag base in CTF
ET_MINIMAP_ICON	???
ET_DECAL	???
ET_ITEM_TIMER	??? (for specs only)
ET_PARTICLES	???
ET_SPAWN_INDICATOR	Shows spawn locations
ET_VIDEO_SPEAKER	???
ET_RADAR	ET_SPRITE minus the depth test
ET_EVENT [96]	???
ET_SOUNDEVENT [97]	???