User Tools

Site Tools


equipment

Equipment

Equipment is a bit of a maze in Freelancer. Equipment definitions have lot of properties and often interconnected with each other.

Common

These are properties common to most equipment definitions.

Lootables

Usually these are stackable projectiles such as missiles, torpedoes, mines and countermeasures.

Property Type Description
loot_appearance string Reference to loot crate that will be used for visual representation.
units_per_container uint When X amount of stackable equipment is dropped the game will generate ceil(x/units_per_container) lootables and assign number of units each hold.

Mountables

Visible equipment that is attached to hardpoints and can take damage and be blown off.

Property Type Description
DA_archetype string 3D model.
LODranges …uint Customized level of detail ranges for equipment archetype.
hit_pts uint32 Hitpoints.
HP_child string Hardpoint in DA_archetype used to connect to attachment hardpoint on target. Typically HpConnect.
explosion_resistance float How much area of effect damage is reduced (0 - none, 1 - completely ignores AoE damage)
debris_type string Debris effect that is fired upon destruction
separation_explosion string Explosion effect that is fired upon destruction (separation from attached part)

Weapons

Armaments

Anything that shoots: guns, turrets, launchers, etc. Armaments inherits from Mountables.

Property Type Desciprtion
damage_per_fire int Damage to hull each shot takes.
power_usage int How much energy each shot takes.
toughness float Adds 'toughness' points. The higher the rating the less likely NPCs will attack you or bail out of fight quicker.
dry_fire_sound string Name of sound effect when there isn't enough energy to make a shot.
use_animation string Play compound mesh animation script on each shot.
refire_delay float Hard cooldown before another shot could be made.
muzzle_velocity float Initial velocity given to projectile.
flash_particle_name string Particle effect used for muzzle flash.
flash_radius float Visibility range for muzzle flash particle effect.
light_anim string Light effect?
projectile_archetype string Name of munition this thing shoots.
turn_rate float Turn rate for armaments attached to revolute hardpoints. Also affects turn rate of the barrel(s).
gun_elevation float Supposedly it limited gun base and barrel angles. Apparently not used in game. Instead same is done by revolute hardpoint min/max angles the gun is attached to, and by revolute barrel joint within turret .cmp.
gun_azimuth
dispersion_angle float Randomizes muzzle angle from 0 to this value if present.
AI_range float Prevents AI pilots from using this equipment after exceeding this distance from target(s).
auto_turret bool Automatic turret?

Munition

Projectiles that are shot by guns: bullets, missiles, mines, countermeasures, etc.

Munition equipment (bullets, missiles, mines, whatever):

Property Type Appearance Description
motor string Munition Add acceleration motor to projectile.
detonation_dist float Munition
Mine
Triggers explosion at a distance from target.
explosion_arch string Munition
Mine
Explosion (triggered by detonation_dist). Reference to [Explosion]\nickname in equipment INIs.
one_shot_sound string Munition
Mine
Countermeasure
Firing shot sound.
const_effect string Munition
Mine
Countermeasure
Effect applied to projectile.
munition_hit_effect string Munition Effect applied to hit point. Effect will attach to object it got hit.
HP_trail_parent string Munition
Mine
const_effect is applied to this hardpoint of projectile if it has a mesh.
lifetime float Munition
Mine
Countermeasure
How long projectile lives before vanishing off.
seeker string Munition Turns projectile into a missile. DUMB is dumb missile. SEEK will attempt to home onto target.
time_to_lock float Munition Delay before homing missile will lock onto target.
seeker_range float Munition Homing missile tracking distance.
seeker_fov_deg float Munition Homing missile field of vision limit.
seek_dist float Mine Maximum distance within which mines will scan for a target.
max_angular_velocity float Munition Homing missile turn speed.
top_speed float Mine Mine maximum speed.
acceleration float Mine Mine acceleration upon following target and until reaching top speed.
owner_safe_time float Mine Mine safety time before before it'll starting homing onto owner as well.
linear_drag float Mine Velocity drag. Used by countermeasures and mines.
range float Countermeasure Capture range. Used by countermeasures.
diversion_pctg float Countermeasure Diversion percentage. Used by countermeasures.
force_gun_ori bool Munition
Mine
Countermeasure
Forces projectile orientation to HpFire hardpoint of the gun.
requires_ammo bool Munition
Mine
Countermeasure
Requires ammo to fire.
cruise_disruptor bool Munition
Mine?
Countermeaure?
Damage disables engine cruise mode.
damage int Munition Appears somewhere?
weapon_type string Munition Damage type applied by projectile.

Motors

Motors provide constant acceleration to projectile on top of the existing initial velocity.

Property Type Description
lifetime float How long motor will work.
accel float Motor will provide acceleartion.
delay float Delay activating motor acceleration.

Explosions

Explosions? EXPLOSIONS! YEAAAAAAAH!!!

Munitions refer to these, so don't get them confused with [explosion] in FX\explosions.ini, although related they are different.

Property Type Description
effect string Reference to FX\effects.ini\[Effect]\nickname.
lifetime float, float Explosion lifetime?
process string Available values: 'none', 'disappear', 'shatter'.
strength float Dunno.
radius float Blast radius. Apparently there's no damage falloff due to distnace?
hull_damage int Damage to hull.
energy_damage int Damage to shield or power capacity if shield is down.
impulse float Force vector applied to all moveable objects caught in radius.
equipment.txt · Last modified: 2018/02/04 18:11 by treewyrm