Eternally incorrect and incomplete. Please refer to the warfork source whenever possible.
Types
Vec3
Constructors
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.
|
Properties
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
|
Methods
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
Constructors
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.
|
Properties
Property |
Description |
R/W
|
bool modified |
?????? |
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
|
Methods
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
|
Enums
Enum Value |
Description
|
CVAR_ARCHIVE |
Saved to config
|
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
Constructors
Not constructable. New instances can be spawned, see@ G_SpawnEntity.
Properties
Property |
Description |
R/W
|
Client@ client |
The associated client (nullable) |
RW
|
Item@ item |
?????? (for bonus items) |
RW
|
Entity@ groundEntity |
?????? |
RW
|
Entity@ owner |
?????? |
RW
|
Entity@ enemy |
?????? |
RW
|
Entity@ activator |
?????? |
RW
|
int type |
Entity type enum (see below) |
RW
|
int modelindex |
?????? |
RW
|
int modelindex2 |
?????? |
RW
|
int frame |
Frame of animation OR ET_SPRITE radius, ... |
RW
|
int ownerNum |
?????? |
RW
|
int counterNum |
?????? |
RW
|
int skinNum |
?????? |
RW
|
int colorRGBA |
?????? |
RW
|
int weapon |
?????? |
RW
|
bool teleported |
?????? |
RW
|
uint effects |
?????? |
RW
|
int sound |
?????? |
RW
|
int team |
?????? |
RW
|
int light |
?????? |
RW
|
bool inuse |
?????? |
R
|
uint svflags |
?????? |
RW
|
int solid |
?????? |
RW
|
int clipMask |
?????? |
RW
|
int spawnFlags |
?????? |
RW
|
int style |
?????? |
RW
|
int moveType |
?????? |
RW
|
uint nextThink |
?????? |
RW
|
float health |
?????? |
RW
|
int maxHealth |
?????? |
RW
|
int viewHeight |
?????? |
RW
|
int takeDamage |
?????? |
RW
|
int damage |
?????? |
RW
|
int projectileMaxDamage |
?????? |
RW
|
int projectileMinDamage |
?????? |
RW
|
int projectileMaxKnockback |
?????? |
RW
|
int projectileMinKnockback |
?????? |
RW
|
float projectileSplashRadius |
?????? |
RW
|
int count |
?????? |
RW
|
float wait |
?????? |
RW
|
float delay |
?????? |
RW
|
float random |
?????? |
RW
|
int waterLevel |
?????? |
RW
|
float attenuation |
?????? |
RW
|
int mass |
?????? |
RW
|
uint timeStamp |
?????? |
RW
|
entThink@ think |
Think callback |
RW
|
entTouch@ touch |
Touch callback |
RW
|
entUse@ use |
Use callback |
RW
|
entPain@ pain |
Pain callback |
RW
|
entDie@ die |
Die callback |
RW
|
entStop@ stop |
Stop callback |
RW
|
Vec3 velocity |
The velocity vector of the entity |
RW
|
Vec3 avelocity |
The angular velocity vector of the entity |
RW
|
Vec3 origin |
Position vector |
RW
|
Vec3 origin2 |
Position vector (but different than origin) |
RW
|
Vec3 angles |
The direction the entity is facing |
RW
|
Vec3 movedir |
Movement vector (separate from current velocity) |
RW
|
int entNum |
?????? |
R
|
int playerNum |
?????? |
R
|
String@ model |
?????? |
R
|
String@ model2 |
?????? |
R
|
String@ classname |
?????? |
RW
|
String@ targetname |
?????? |
RW
|
String@ target |
?????? |
RW
|
String@ map |
?????? |
RW
|
int particlesSpeed |
?????? only used on ET_PARTICLES entities |
RW
|
int particlesShaderIndex |
?????? only used on ET_PARTICLES entities |
RW
|
int particlesSpread |
?????? only used on ET_PARTICLES entities |
RW
|
int particlesSize |
?????? only used on ET_PARTICLES entities |
RW
|
int particlesTime |
?????? only used on ET_PARTICLES entities |
RW
|
int particlesFrequency |
?????? only used on ET_PARTICLES entities |
RW
|
bool particlesSpherical |
?????? only used on ET_PARTICLES entities |
RW
|
bool particlesBounce |
?????? only used on ET_PARTICLES entities |
RW
|
bool particlesGravity |
?????? only used on ET_PARTICLES entities |
RW
|
bool particlesExpandEffect |
?????? only used on ET_PARTICLES entities |
RW
|
bool particlesShrinkEffect |
?????? only used on ET_PARTICLES entities |
RW
|
Methods
Enums
Entity types enum |
Description
|
ET_GENERIC |
Generic entity?
|
ET_PLAYER |
Player entity
|
ET_CORPSE |
Corpse entity
|
ET_BEAM |
Map beams
|
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 projectile
|
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 |
Lasergun projectile?
|
ET_CURVELASERBEAM |
Weak laser beam, unused
|
ET_FLAG_BASE |
??? used for the flag base in CTF
|
ET_MINIMAP_ICON |
HUD Minimap
|
ET_DECAL |
Decal sprites
|
ET_ITEM_TIMER |
??? (for specs only)
|
ET_PARTICLES |
misc_particles
|
ET_SPAWN_INDICATOR |
Shows spawn locations
|
ET_VIDEO_SPEAKER |
misc_video_speaker
|
ET_RADAR |
ET_SPRITE minus the depth test
|
ET_EVENT [96] |
Used for effects, last 1 frame
|
ET_SOUNDEVENT [97] |
Used for effects, last 1 frame
|
Callbacks
Callback signature |
Description
|
void entThink(Entity@ ent) |
Think function. Called every frame(?)
|
void entTouch(Entity@ ent, Entity@ other, Vec3 planeNormal, int surfFlags) |
Called when the entity touches another entity. planeNormal, surfFlags ???
|
void entUse(Entity@ ent, Entity@ other, Entity@ activator) |
??????
|
void entPain(Entity@ ent, Entity@ other, float kick, float damage) |
Called when the entity is damaged by another entity. kick ?????
|
void entDie(Entity@ ent, Entity@ inflicter, Entity@ attacker) |
Called on entity death. inflictor, attacker ??????
|
void entStop(Entity@ ent) |
??????
|
Item
Weapons & weapon, ammo, armor, health, powerup pickups
Constructors
Not constructable.
Properties
Property |
Description |
R/W
|
int tag |
More specific type, see enums |
R
|
uint type |
Category, see relevant enum |
R
|
int flags |
Item flags, see relevant enum |
R
|
int quantity |
Pickup amount |
R
|
int inventoryMax |
Max amount that can be carried |
R
|
int ammoTag |
Ammo type, see relevant enum |
R
|
int weakAmmoTag |
Ammo type |
R
|
String@ classname |
?????? |
R
|
String@ name |
Printed on pickup |
R
|
String@ shortName |
Name used for printing in messages |
R
|
String@ model |
worldmodel |
R
|
String@ model2 |
worldmodel |
R
|
String@ icon |
Icon displayed in HUD? |
R
|
String@ simpleIcon |
Image used in simpleitems mode |
R
|
String@ pickupSound |
Sound played on pickup |
R
|
String@ colorToken |
Color used for printing in messages |
R
|
Methods
Method |
Description
|
bool isPickable() |
Returns the state of the pickable flag
|
bool isUsable() |
Returns the state of the usable flag
|
bool isDropable() |
Returns the state of the dropable flag
|
Enums
Weapon Tag
Name |
Description
|
WEAP_NONE |
No weapon
|
WEAP_GUNBLADE |
The gunblade
|
WEAP_MACHINEGUN |
The machinegun
|
WEAP_RIOTGUN |
The riotgun
|
WEAP_GRENADELAUNCHER |
The grenade launcher
|
WEAP_ROCKETLAUNCHER |
The rocket launcher
|
WEAP_PLASMAGUN |
The plasmagun
|
WEAP_LASERGUN |
The lasergun
|
WEAP_ELECTROBOLT |
The electrobolt
|
WEAP_INSTAGUN |
The instagun
|
Ammo Tag
Name |
Description
|
AMMO_NONE |
No ammo
|
AMMO_GUNBLADE [WEAP_TOTAL] |
Gunblade ammo
|
AMMO_BULLETS |
Machinegun ammo
|
AMMO_SHELLS |
Riotgun ammo
|
AMMO_GRENADES |
Grenade Launcher ammo
|
AMMO_ROCKETS |
Rocket Launcher ammo
|
AMMO_PLASMA |
Plasmagun ammo
|
AMMO_LASER |
Lasergun ammo
|
AMMO_BOLTS |
Electrobolt ammo
|
AMMO_INSTAS |
Instagun ammo
|
AMMO_WEAK_GUNBLADE |
Unused in Warfork.
|
AMMO_WEAK_BULLETS |
Unused in Warfork.
|
AMMO_WEAK_SHELLS |
Unused in Warfork.
|
AMMO_WEAK_GRENADES |
Unused in Warfork.
|
AMMO_WEAK_ROCKETS |
Unused in Warfork.
|
AMMO_WEAK_PLASMA |
Unused in Warfork.
|
AMMO_WEAK_LASER |
Unused in Warfork.
|
AMMO_WEAK_BOLTS |
Unused in Warfork.
|
AMMO_WEAK_INSTAS |
Unused in Warfork.
|
Armor Tag
Name |
Description
|
ARMOR_NONE [0] |
No armor
|
ARMOR_GA [AMMO_TOTAL] |
Green armor, +50 up to 100
|
ARMOR_YA |
Yellow armor, +75 up to 125
|
ARMOR_RA |
Red armor, +100 up to 150
|
ARMOR_SHARD |
Armor shard, +5 up to 200
|
Health Tag
Name |
Description
|
HEALTH_NONE [0] |
No health
|
HEALTH_SMALL [ARMOR_TOTAL] |
Green health, 5HP pickup
|
HEALTH_MEDIUM |
Yellow health, 25HP pickup
|
HEALTH_LARGE |
Orange health, 50HP pickup
|
HEALTH_MEGA |
Purple health, 100HP pickup, overheal
|
HEALTH_ULTRA |
Blue health, 100HP pickup, overheal
|
Powerup Tag
Name |
Description
|
POWERUP_NONE [0] |
No powerup
|
POWERUP_QUAD [HEALTH_TOTAL] |
Quad damage powerup
|
POWERUP_SHELL |
Warshell powerup
|
POWERUP_REGEN |
Regen powerup
|
Otheritems Tag
starts at POWERUP_TOTAL
Name |
Description
|
AMMO_PACK_WEAK |
unused?
|
AMMO_PACK_STRONG |
unused?
|
AMMO_PACK |
Item is an ammo pack
|
Item flags
Bitmaskable
Name |
Description
|
ITFLAG_PICKABLE |
Can be picked up
|
ITFLAG_USABLE |
Can be used
|
ITFLAG_DROPABLE |
Can be dropped
|
ITFLAG_STAY_COOP |
??????
|
Item type
Bitmaskable
Name |
Description
|
IT_WEAPON |
Item is a weapon
|
IT_AMMO |
Item is ammo
|
IT_ARMOR |
Item is armor
|
IT_POWERUP |
Item is a powerup
|
IT_HEALTH [64] |
Item is health
|