A_SeekerMissile

From ZDoom Wiki
Jump to: navigation, search

A_SeekerMissile (angle threshold, angle maxturnangle, int flags = 0, int chance = 50, int distance = 10)


Seeker missile handling. threshold and maxturnangle determine how 'aggressive' the missile will home in on its tracer. The larger the values the more precise it is.

  • threshold
Specifies the angle inside which the missile will home in directly on its tracer. If the angle toward the target is larger than threshold it will change its movement angle only partially towards the tracer.
  • maxturnangle
The maximum change of movement direction that will be performed in one move. maxturnangle should be larger than threshold. Both angles are specified in degrees and must be in the range [0, 90].
  • flags
The following flags can be combined by using the | character between the constant names. The default value is 0 for no flags.
  • SMF_LOOK — Look for targets: If this flag is passed, the missile will try to acquire a target if it does not already have one. The SCREENSEEKER flag on the projectile can restrict this search for potential targets that are in the shooter's field of vision.
  • SMF_PRECISE — Precise trajectory: If this flag is passed, the missile will chase its target in true 3D, readjusting its vertical velocity with each call, making it harder to lead it to crash on a ground or ceiling.
  • SMF_CURSPEED — Use current speed: If this flag is passed, the missile will keep its current velocity rather than use a vector calculated from its default Speed value.
  • chance
If the SMF_LOOK flag is used, this is the chance (out of 256) that the missile will try acquiring a target if it doesn't already have one. The default value is 50.
  • distance
If the SMF_LOOK flag is used, this is the maximum distance (in blocks of 64 map units) at which targets are sought. The default value is 10; values much larger should be avoided or the function might become too much resource intensive.


The range at which a player-fired seeker missile will first acquire a tracer can be set using MaxTargetRange actor property. Note that the value to be set is in a 64-map-unit block. For instance, a value of 8 means a range of 512 map units (8 * 64 = 512). The default value is 0, which is interpreted as 1024 map units (this is the same as setting it to 16).

It is also worth mentioning that NOAUTOAIM should be disabled if SMF_LOOK isn't being used, otherwise it will not home when fired from a weapon.

Examples

This is an example for a magic missile that homes in on its tracer. It has a low maxturnangle which gives it a laggy turning effect.

ACTOR MagicMissile
{
  Projectile
  +RANDOMIZE
  +SEEKERMISSILE
  Height 16
  Radius 8
  Speed 10
  Damage (random(13, 17))
  RenderStyle "Add"
  Alpha 0.8
  States
  {
  Spawn:
    MMIS B 2 Bright A_SeekerMissile(0, 2) // MMIS is the sprite used for the missile.
    Loop
  Death:
    MMIS CDE 5 Bright
    Stop
  }
}