George: more info on <OnSystemWeaponFire> please

[sdw195]

what type of object supports <OnSystemWeaponFire> and what are the variables it uses (aWeaponUNID aWeaponObj etc)?

[george moromisato]

First, you need to call:

Code: Select all

(objRegisterForSystemEvents obj distance)

obj is the object that you want to receive OnSystemWeaponFire
distance is the radius (in light-seconds) of the area (centered on obj) that you want to watch for events.

You will then get called at OnSystemWeaponFire whenever a ship or a station fires a weapon (I believe it will also include calls to sysCreateWeaponFire, but only if objSource is not Nil). The parameters to OnSystemWeaponFire are:

aWeaponObj is the object that fired the weapon.
aWeaponUNID is the UNID of the weapon being fired.
aWeaponPos is the position where the shot originated.

You will also get called at OnSystemExplosion if there are any ships that explode. The parameters are:

aExplosionObj is the ship that exploded.
aExplosionUNID is the UNID of the explosion (look in StdExplosions.xml).
aExplosionPos is the position of the explosion.

[sdw195]

cool, ty

*goes to tracker to request some more variables for that event*

would like ahitobj if the weapon fire hits anything and damage amount dealt