A_FireCustomMissile

From ZDoom Wiki
Jump to navigation Jump to search

A_FireCustomMissile (string missiletype [, angle angle [, bool useammo [, float spawnofs_horz [, int spawnheight [, int flags [, angle pitch]]]]]])


Nuvolabomb.png Warning: The feature described on this page has been deprecated, and will no longer be supported or updated by the GZDoom developers. While some functionality may be retained for the purposes of backwards-compatibility, authors are strongly discouraged from utilizing this feature in future projects and to instead use A_FireProjectile. Compatibility with future GZDoom versions is not guaranteed.

Usage

Fires a projectile from a Weapon or a CustomInventory. Optionally you can specify an angle and a spawn offset.

If used in a weapon, useammo specifies whether this attack uses ammo or not. This parameter is irrelevant if used in a custom inventory.

The following flags can optionally be used. Multiple flags can be combined by separating them with the pipe character '|'.

  • FPF_AIMATANGLE — Alternate autoaim behavior, relevant when playing with autoaim. Autoaiming is based off of the projectile's trajectory instead of the player's aim. If this flag is set, the engine looks at the horizontal line of fire projected for the projectile, independent of the player's aim. If the horizontal line of fire cuts close enough to a valid target (again ignoring vertical aim), that projectile will fire directly towards that target. If this flag is not set, the engine looks at the player's horizontal aim. If the horizontal line of fire cuts close enough to a valid target (ignoring vertical aim), the resulting projectile will fire with the vertical angle adjusted to aim directly at the target.
  • FPF_TRANSFERTRANSLATION — Transfer Translation. The projectile fired uses the same translation as the actor that fired it. In most cases, this will be the player.
  • FPF_NOAUTOAIM — Disables autoaim for this attack.

pitch becomes relevant with autoaim off. It adjusts the player's vertical aim by the given angle value, like the angle parameter affects the horizontal aim. A positive value makes it fire the missile higher than the player's aim, a negative value makes it fire lower.

Examples

  Fire:
     TRIF A 5 Bright A_FireCustomMissile("RifleBullet",0,1,8,8,0)
     TRIF B 5 Bright
     TRIG A 10
     TRIG B 0 A_Refire
     Goto Ready