unit (abstract tag)

Edit

Vehicles and bipeds are both extensions of the Unit abstract tag class, which is not directly creatable itself. Generally, units are controllable objects which can "die" and appear on the motion sensor.

Structure and fields #

This tag inherits fields from object which are not shown here. See the parent's page for more information. The following information is unique to the unit tag.

Field Type Comments

unit flags bitfield(32)

Flag	Mask	Comments
circular aiming	`0x1`
destroyed after dying	`0x2`
half speed interpolation	`0x4`
fires from camera	`0x8`
entrance inside bounding sphere	`0x10`
unused	`0x20`
causes passenger dialogue	`0x40`
resists pings	`0x80`
melee attack is fatal	`0x100`
don't reface during pings	`0x200`
has no aiming	`0x400`
simple creature	`0x800`
impact melee attaches to unit	`0x1000`
impact melee dies on shields	`0x2000`
cannot open doors automatically	`0x4000`
melee attackers cannot attach	`0x8000`
not instantly killed by melee	`0x10000`
shield sapping	`0x20000`
runs around flaming	`0x40000`
inconsequential	`0x80000`
special cinematic unit	`0x100000`
ignored by autoaiming	`0x200000`
shields fry infection forms	`0x400000`
integrated light cntrls weapon	`0x800000`
integrated light lasts forever	`0x1000000`

default team enum

Option	Value	Comments
none	`0x0`
player	`0x1`
human	`0x2`
covenant	`0x3`
flood	`0x4`
sentinel	`0x5`
unused 6	`0x6`
unused 7	`0x7`
unused 8	`0x8`
unused 9	`0x9`

constant sound volume enum

Option	Value	Comments
silent	`0x0`
medium	`0x1`
loud	`0x2`
shout	`0x3`
quiet	`0x4`

rider damage fraction f32

integrated light toggle

Reference^?: effect

unit a in enum

Option	Value	Comments
none	`0x0`
driver seat power	`0x1`
gunner seat power	`0x2`
aiming change	`0x3`
mouth aperture	`0x4`
integrated light power	`0x5`
can blink	`0x6`
shield sapping	`0x7`

unit b in enum

Option	Value	Comments
none	`0x0`
driver seat power	`0x1`
gunner seat power	`0x2`
aiming change	`0x3`
mouth aperture	`0x4`
integrated light power	`0x5`
can blink	`0x6`
shield sapping	`0x7`

unit c in enum

Option	Value	Comments
none	`0x0`
driver seat power	`0x1`
gunner seat power	`0x2`
aiming change	`0x3`
mouth aperture	`0x4`
integrated light power	`0x5`
can blink	`0x6`
shield sapping	`0x7`

unit d in enum

Option	Value	Comments
none	`0x0`
driver seat power	`0x1`
gunner seat power	`0x2`
aiming change	`0x3`
mouth aperture	`0x4`
integrated light power	`0x5`
can blink	`0x6`
shield sapping	`0x7`

camera field of view

Angle: f32

Default value: 1.22173.

camera stiffness f32

camera marker name char[32]

camera submerged marker name char[32]

pitch auto level Angle: f32

pitch range Angle: f32 (min & max)

camera tracks Block^?

Field	Type	Comments
track	`Reference^?`: camera_track
	`pad(12)`

seat acceleration scale

Vector3D

i: f32
j: f32
k: f32

pad(12)

soft ping threshold

f32

Maximum: 1

soft ping interrupt time f32 (seconds)

hard ping threshold

f32

Maximum: 1

hard ping interrupt time f32 (seconds)

hard death threshold

f32

Maximum: 1

feign death threshold

f32

Maximum: 1

feign death time f32 (seconds)

distance of evade anim f32 (world units)

distance of dive anim f32 (world units)

pad(4)

stunned movement threshold

f32

Maximum: 1

feign death chance

f32

Maximum: 1

feign repeat chance

f32

Maximum: 1

spawned actor

Reference^?: actor_variant

spawned actor count u16 (min & max)

spawned velocity f32

aiming velocity maximum Angle: f32 (degrees per second)

aiming acceleration maximum Angle: f32 (degrees per second squared)

casual aiming modifier

Fraction: f32

Maximum: 1

looking velocity maximum Angle: f32 (degrees per second)

looking acceleration maximum Angle: f32 (degrees per second squared)

pad(8)

ai vehicle radius f32

ai danger radius f32

melee damage

Reference^?: damage_effect

motion sensor blip size enum

Option	Value	Comments
medium	`0x0`
small	`0x1`
large	`0x2`

pad(2)

pad(12)

new hud interfaces Block^?

Field	Type	Comments
hud	`Reference^?`: unit_hud_interface
	`pad(32)`

dialogue variants Block^?

Field	Type	Comments
variant number	`i16`
	`pad(2)`
	`pad(4)`
dialogue	`Reference^?`: dialogue

grenade velocity f32 (world units per second)

grenade type enum

Option	Value	Comments
human fragmentation	`0x0`
covenant plasma	`0x1`

grenade count u16

soft ping interrupt ticks

i16 (little endian^?)

Only set when the tag is compiled into a map cache.

hard ping interrupt ticks

i16 (little endian^?)

Only set when the tag is compiled into a map cache.

powered seats Block^?

Field	Type	Comments
	`pad(4)`
driver powerup time	`f32 (seconds)`
driver powerdown time	`f32 (seconds)`
	`pad(56)`

weapons Block^?

Field	Type	Comments
weapon	`Reference^?`: weapon
	`pad(20)`

seats Block^?

Field Type Comments

flags bitfield(32)

Flag	Mask	Comments
invisible	`0x1`
locked	`0x2`
driver	`0x4`
gunner	`0x8`
third person camera	`0x10`
allows weapons	`0x20`
third person on enter	`0x40`
first person camera slaved to gun	`0x80`
allow vehicle communication animations	`0x100`
not valid without driver	`0x200`
allow ai noncombatants	`0x400`
reserved	`0x800`
reserved 1	`0x1000`
reserved 2	`0x2000`
reserved 3	`0x4000`
reserved 4	`0x8000`
reserved 5	`0x10000`
reserved 6	`0x20000`
reserved 7	`0x40000`
reserved 8	`0x80000`
allows melee	`0x100000`

label char[32]

marker name char[32]

pad(32)

acceleration scale

Vector3D

i: f32
j: f32
k: f32

pad(12)

yaw rate f32 (degrees per second)

pitch rate f32 (degrees per second)

camera marker name char[32]

camera submerged marker name char[32]

pitch auto level Angle: f32

pitch range Angle: f32 (min & max)

camera tracks Block^?

Field	Type	Comments
track	`Reference^?`: camera_track
	`pad(12)`

unit hud interface Block^?

Field	Type	Comments
hud	`Reference^?`: unit_hud_interface
	`pad(32)`

pad(4)

hud text message index Index: u16

pad(2)

yaw minimum Angle: f32

yaw maximum Angle: f32

built in gunner

Reference^?: actor_variant

pad(20)

This information was partially generated using Invader tag definitions.

Acknowledgements

Thanks to the following individuals for their research or contributions to this topic:

Kavawuvi (Invader tag definitions)
MosesOfEgypt (Tag structure research)