The Complete Guide to Submunitions

a threat fulfilled

Back in March of last year, I posted the Complete Guide to Spob-Based Weapons, and said that if I got a positive response, I'd do a guide to submunitions. Well, I didn't get much of a response at all, but an old post I read a few days ago got me started looking at submunitions again. A couple days of testing later, here's the guide. It's a wee bit longer than the last one:

-------------------
---------- INTRODUCTION ----------
-------------------

Weapon submunitions are a powerful feature of Nova that allow you to have a weapon transform into one or more copies of another type of weapon (or the same weapon, which is called "recursive submunitioning") when the first weapon either reaches the end of its life or hits a ship. Uses for this include having a missile split into many sub-missiles when it nears a wing of fighters, or having a weapon shot suddenly change its behaviour after a certain period of time.

This guide is an in-depth explaination of how submunitions behave. Any questions you have about submunitions should be answered here. If they aren't, please let me know, so I can add in the answers.

The guide is divided into four sections:
Weapon Types: The basics of how each weapon type acts when used as a submunition.
Fields: Explains just what each submunition-related field does.
Flags: The behavior of a few submunition-related flags.
Other Notes: A few points about submunitions that don't fit very well in any other section.

-------------------
---------- WEAPON TYPES ----------
-------------------
Behaviors of Weapon Types:
Unguided: Fires as if from a motionless ship positioned at the point where the submunitions are created. That is, if two submunitions appear when a shot dies, one going forward, one going back, they will move at the same speed relative to the system background.

Guided: Acts like Unguided, except:

  • If the firing ship had no target selected when they fired the original weapon, guided submunitions will fly straight and not impact any ships (unless they have the "Any Ship Triggers ProxRadius" flag set).

  • If the firing ship did have a target selected when they fired the original weapon, any guided submunitions will lock onto and follow that target.

  • If one of the stages of the weapon is created with the "fire at nearest target" flag, subsequent guided stages will track that target (see below).

Beam: Acts exactly like Unguided, except that there is no fading effect from the FallOff field. Repeat: Beam-type submunitions create projectiles , not beams.

Turreted Beam: Acts exactly like Beam.

Turreted Unguided: Acts exactly like Unguided.

Freefall Bomb: Acts exactly like Unguided.

Free-flight Rocket: When it is created, it starts out with the velocity of the parent shot, and then accelerates until it is going at its maximum velocity relative to the system background.

Example: The first stage of a submunition chain is an unguided shot with a Speed of 1000, and the second stage is a free-flight rocket with a Speed of 0. When the first stage expires, the second stage will be created traveling at the same speed as the first stage. The second stage will then decelerate until it is completely motionless.

Front-quadrant Turret: Acts exactly like Unguided.

Rear-quadrant Turret: Acts exactly like Unguided.

Point Defense Turret: Acts just like Unguided, except that it can only hit guided weapons, not ships (even if they have the "Vulnerable to PD" flag set). However, if you set the weapon's "Proximity Triggered by Any Ship" flag, and ProxRadius is greater than 0, it will impact ships properly, regardless of whether the ships are "Vulnerable to PD".
Also, it seems that the "Immune to Point Defense" seeker flag only applies when the PD weapon is an initial shot (fired directly from the ship)- PD Turret-type submunitions can hit guided weapons regardless of whether or not they have that flag set.
Finally, once a PD Turret has been used in a chain of submunitions, all subsequent Guided weapons will be unable to track ships, and no subsequent weapon will be able to use the "Fires at Nearest Ship" flag.

Point Defense Beam: Acts exactly like Beam. Cannot hit guided weapons, can hit ships regardless of whether they have the "Vulnerable to PD" flag set.

Carried Ship: Acts exactly like Unguided. Repeat: Creates weapon projectiles, not ships.

----------
---------- FIELDS ----------
----------

SubCount:
Quite simply, this is the number of submunitions created when a shot dies. Any number higher than 0 is valid, although you should keep in mind that there can only be 128 shots in a system at a time.

SubType:
The RID of the weapon to be created as submunitions when a shot dies. Despite what the Bible says, beams and carried fighters do not cause problems as of Nova 1.0.9 (see above for what they actually do).

SubTheta:
SubTheta is the amount of inaccuracy in the direction a submunition is fired. It is applied to submunitions of the weapon for which it is set, and the submunitions' own Inaccuracy field is ignored.

For all submunition types, if SubTheta is positive, each submunition will shoot at a random angle up to SubTheta degrees to each side of straight ahead.* So, if forward-shooting cannon has a SubTheta of 90, its submunitions will fire in any direction in a 180 degree arc forward of the firing ship.

If SubTheta is negative, then the submunitions will be evenly spaced, with absoluteValue(SubTheta) being the angle between each shot. (I.E. if a weapon has a SubCount of 2 and a SubTheta of -90, then the submunitions will appear with one going 45 degrees to the right of straight, and one going 45 degrees to the left of straight. If it has a SubCount of 3 and a SubTheta of -90, one submunition will go straight, one due right, and one due left.)

*Note: SubTheta is added after the direction of the sub is chosen by either the "Fires at Nearest Target" flag or the Guided weapon type (see above).

SubLimit:
The number of times this weapon can submunition into itself (1 will allow first shot + one sub, 2 will allow first shot plus two subs, etc.). Has no effect if the weapon does not submunition into itself, even if it subs into another weapon that then subs into the first.

---------
---------- FLAGS ----------
---------

The "Subs Fail When Shot Expires" flag:
Does exactly what it says it does. The weapon will only produce submunitions if it impacts a ship or asteroid (via ProxRadius- see "Proximity to Target" below) before its Count runs out. No exceptions.

The "One Shot at a Time" flag:
If the first submunition is of a different wëap resource than the initial weapon, the firing ship will be able to fire the initial weapon again as soon as the first submunitions appears.

If the initial weapon uses itself as a recursive submunition, the firing ship will not be able to fire the initial weapon again until the entire chain of recursive submunitions finishes.

NOTE: The "One Shot at a Time" flag prevents reloading during the time that the shot exists. That is, the time until the weapon can fire again is the life of the shot PLUS the reload time of the weapon.
Also, the "One Shot at a Time" flag seems to be ignored if the weapon has a Reload of 0.

Submunitions Fire at Nearest Target flag:
Unguided submunitions: When created, each submunition will fire at a non-escort ship, regardless of whether you have any ship targeted, and regardless of whether the ship is disabled or not. If you do have a ship targeted, that ship will be added to the list of ships that will be fired at, even if it would not normally be fired at.
Unfortunately, I do not have the faintest idea how each submunition decides which ship to target. In a test with several ships scattered throughout a system, some disabled, some not, the shots seemed to randomly switch between the various ships, showing no preference for near over far, for active over disabled, for in-range over out-of-range, or even for enemy over neutral. The only ships that were ignored were my escorts and ships with the wrong planet/non-planet type for the weapon (unless I targeted them). There did seem to be a preference for more distant ships over close ships, but that may have been because the more distant ships had been created earlier.

Guided submunitions: The flag has no effect. If a non-guided submunition had this flag set for its creation, a subsequent guided submunition will track the target that the unguided submunition was fired at, but that will happen whether or not the guided sub was created with this flag.

Finally, there seems to be about a small error rate in whether a particular submunition successfully aims at any "nearest target", or whether it continues straight. This error rate may be affected by the number of submunitions (it seemed to be almost zero with just one submunition, but I measured a 15% error rate with 100 submunitions). It also seems to be much higher when there is a negative SubTheta.

-----------------
---------- OTHER NOTES ----------
-----------------

Range:
When Nova starts up, it calculates the maximum range of each weapon by adding the ranges of every submunition to the range of the primary shot. This causes a crash if you set two weapons to submunition into each other, as Nova will add their ranges forever.
This ability to add range to a weapon by adding a "dud" submunition can be useful for influencing the AI's choice of weapons.

Sounds:
When a submunition is created, it plays the sound associated with its firing, and not the explosion sound for the parent weapon (unless the parent weapon hit a ship).

Proximity to Target:
Submunitions will not appear unless their parent shot detonates at some distance from whatever they hit. Therefore, a weapon with a ProxRadius of 0 will not produce any submunitions on impact. Also, Point Defense weapons impacting Guided weapons cannot produce submunitions, as PD-Guided collisions do not use proximity fuses.
It seems that the parent shot needs to explode at least at the edge of the target ship. I am not certain just how ProxRadius impacts are calculated, but I think I recall a statement that it needs to be around 40 in order to work properly with most ships in Nova. What I have tested is that 10 works about 80% of the time on a squarish ship 40 pixels on a side.

Planet-Type/Non-Planet-Type Submunitions:
Although AI ships will not fire a weapon if the primary shot is of the wrong type to damage a ship, they do not care about the types of the submunitions.
However, if a submunition is created with the "Fires at Nearest Target" flag, it will not aim at any ship of the wrong type, unless that ship is targeted by the firing ship.

Cool Weapon:
Since you've read this far (I hope), here's a nice trick you can do with submunitions: Create a recursively submunitioning free-flight rocket with a SubTheta of 180 and a Count of 20 to 30. What you get is a weapon that curves smoothly through space, much like the EVO SAD/SAE Pods, only randomly.
-----------
---------- THE END ----------
-----------

Well, that's the guide. It's rather long, but it's a complex subject, and I wanted to make myself clear on several of those points. Please make comments, point out things I missed, etc., but please don't quote the whole thing as a single block in your comments.

Edwards

This post has been edited by Edwards : 19 June 2006 - 06:17 PM

So, Subtheta replaces the submunitions inaccuracy level then? As in: if I wanted a submunition weapon to fire with 10 degrees of inaccuracy, I would set the Subtheta to 5, and ignore the inaccuracy feild in the submunition weapon? Would I set the Subtheta to 10? I'm wondering because, if I'm not mistaken, if a weapons inaccuracy is set to say 90 degrees, it will fire randomly in a 90 degree arc from the front of the ship, or 45 degrees to either side of straight ahead. However, it appears that if Subtheta were set to 90 degrees, that the submunition would fire along a 180 degree arc from the center of the original weapon, or 90 degrees to either side of straight ahead. Although this was more specific to my very first question, I would still like to know if the inaccuracy field of the submunition's weapon is completely ignored or added to the Subtheta field.

Inaccuracy is measured as angle off of straight ahead, so a weapon with an Inaccuracy of 90 will fire in a 180-degree arc.

SubTheta is the only inaccuracy applied to a submunition- the submunition's Inaccuracy field is ignored.

Thanks for asking- I've clarified that bit of the guide.

Edwards

@edwards, on Jun 16 2006, 08:59 PM (GMT+2), said in The Complete Guide to Submunitions:

a threat fulfilled

I think I'm going to appease you... to put your threats to execution more often. Nice job (I could never remember the sign to give to SubTheta for inaccuracy vs evenly spaced)!

Very nice 🙂

@edwards, on Jun 17 2006, 06:59 AM, said in The Complete Guide to Submunitions:

  • If the firing ship has no target selected, guided submunitions will fly straight and not impact any ships (unless they have the "Any Ship Triggers ProxRadius" flag set).
  • If the firing ship had a target selected when they fired the original weapon, any guided submunitions will lock onto and follow that target.

This bit nearly confused me. Should the first point also say "If the firing ship has no target selected when they fired the original weapon "? Or is it possible to create a weapon you can control by switching between targets?

@edwards, on Jun 17 2006, 06:59 AM, said in The Complete Guide to Submunitions:

Planet-Type/Non-Planet-Type Submunitions:
Although AI ships will not fire a weapon if the primary shot is of the wrong type to damage a ship, they do not care about the types of the submunitions.
However, if a submunition is created with the "Fires at Nearest Target" flag, it will not aim at any ship of the wrong type, unless that ship is targeted by the firing ship.

Ah, now here's a question I've been wondering about but haven't gotten around to testing myself yet: Do PD turrets also not fire at the "wrong" type (both ways)? I ask because I'm suspicious that they don't (or only one way).

@guy, on Jun 16 2006, 06:16 PM, said in The Complete Guide to Submunitions:

Should the first point also say "If the firing ship has no target selected when they fired the original weapon "? Or is it possible to create a weapon you can control by switching between targets?

Yes, the first point should have that clause. Once a weapon has been fired, it is completely independant from the firing ship.

@guy, on Jun 16 2006, 06:16 PM, said in The Complete Guide to Submunitions:

Do PD turrets also not fire at the "wrong" type (both ways)?

It appears that Point Defense weapons do not care what type an enemy ship is, as long as it can be targeted by point defense.

Also, Point Defense Beams can only (and always) hit non-planet-type ships, regardless of what type the weapon is. I suspect that this is part of a more general bug in which planet-type beams only interact with non-planet-type objects.

@zacha-pedro, on Jun 16 2006, 01:49 PM, said in The Complete Guide to Submunitions:

I think I'm going to appease you... to put your threats to execution more often.

Any suggestions for what I should threaten to do next?

Edwards

Quote

Beam: Acts exactly like Unguided, except that there is no fading effect from the FallOff field. Repeat: Beam-type submunitions create projectiles, not beams.

Note to self: Never attempt Honor Harrington TC.

Lindley: You're referring to the Laser-Head missiles? Those lasers wouldn't last for more than a moment, and on the distance-scales that Weber uses, Lasers wouldn't be instantaneous anyway. Use an unguided shot.

@lindley, on Jun 19 2006, 01:03 AM, said in The Complete Guide to Submunitions:

Note to self: Never attempt Honor Harrington TC.

I've been sort of considering doing one for quite some time... only I've got practically none of the required skills whatsoever. 🙂

Very nice, Edwards. Extremely nice. Awesome job.

You've got a couple ambiguities in there, and in the introduction there's a sentence that implies a submunition has to be "another type of weapon", but overall it's very cool. Highly detailed. Thank you for taking the time to make it.

One quesiton:

@edwards, on Jun 16 2006, 02:59 PM, said in The Complete Guide to Submunitions:

Point Defense Turret: Acts just like Unguided, except that it can only hit guided weapons, not ships (even if they have the "Vulnerable to PD" flag set). However, if you set the weapon's "Proximity Triggered by Any Ship" flag, and ProxRadius is greater than 0, it will impact ships properly, regardless of whether the ships are "Vulnerable to PD".
Also, it seems that the "Immune to Point Defense" seeker flag only applies when the PD weapon is an initial shot (fired directly from the ship)- PD Turret-type submunitions can hit guided weapons regardless of whether or not they have that flag set.

SubLimit:
The number of times this weapon can submunition into itself (1 will allow first shot + one sub, 2 will allow first shot plus two subs, etc.). Has no effect if the weapon does not submunition into itself, even if it subs into another weapon that then subs into the first.

The "Subs Fail When Shot Expires" flag:
Does exactly what it says it does. The weapon will only produce submunitions if it impacts a ship or asteroid (via ProxRadius) before its Count runs out. No exceptions.

You say there are no exceptions to the weapon having to hit a ship or asteroid via proximity trigger for its subs to work if it's flagged to fail on expiration. You also say that a PD turret-shot launched as a submunition can only hit guided weapons. So here's the question:

If a recursively submunitioning PD weapon fires and comes within ProxRadius of a guided missiles and explodes, does it make copies of itself? If those copies come within ProxRadius of a missile, do they make more copies?

Ooh, I've got another question too. A while back I noted that when a PD shot submunitions into a guided shot, the submunition doesn't act guided but instead behaves just like a point-defense shot. Is this still the case in 1.0.9? And if so, what are the facts of the matter. Can the "guided" submunition hit both ships and missiles, or does it act exactly like the PD subs you describe? Furthermore, what other odd behaviors crop up when a PD submunitions into a nonPD (of any type)—and does anything strange happen when a nonPD weapon subs into a PD?

@qaanol, on Jun 19 2006, 10:14 AM, said in The Complete Guide to Submunitions:

If a recursively submunitioning PD weapon fires and comes within ProxRadius of a guided missiles and explodes, does it make copies of itself? If those copies come within ProxRadius of a missile, do they make more copies?

  1. ProxRadius has no effect in PD-Missile collisions.
  2. No, the weapon doesn't make copies of itself.

@qaanol, on Jun 19 2006, 10:14 AM, said in The Complete Guide to Submunitions:

A while back I noted that when a PD shot submunitions into a guided shot, the submunition doesn't act guided but instead behaves just like a point-defense shot. Is this still the case in 1.0.9?

I just tested this, and I can't see any problems with Guided submunitions of PD Turrets, in either 1.0.9 or 1.0.8, except that they don't track whatever the turret was targetting. They pass through ships and shots alike.
However, there do seem to be several other problems with using PD Turrets as first stages, including their not using the "Fires at Nearest Target" flag. I suspect that PD Turrets muck up Nova's targetting mechanism, especially since guided weapons also don't track properly after a Unguided-PDTurret-Guided series (PD Beams gave no problems). In fact, it seems that having a PD Turret anywhere in a chain of submunitions will destroy the ability to target ships of all subsequent wepons in the chain, as in an Unguided - PDTurretFiredAtNearestTarget chain - Unguided - UnguidedFiredAtNearestTarget chain, the second stage fired at a target, but the last stage did not (even when the second stage was modified to not fire at the nearest target).

I can send you my testbed scenario, if you would like to try it on your system.

Edwards

I made this weapon that is a smart nuke...basicalyl it sends out 12 submunitions at the target that was targeted, but the missles just pass right through the enemy ship, it is kewl to c them all reach tehre and then explode but it gets kinda old to c the missles flying in circles around the ship until the explode. The only way i made up for it was the massive damage and the kewl explosions.

@eugene-chin, on Jun 18 2006, 05:48 PM, said in The Complete Guide to Submunitions:

Lindley: You're referring to the Laser-Head missiles? Those lasers wouldn't last for more than a moment, and on the distance-scales that Weber uses, Lasers wouldn't be instantaneous anyway. Use an unguided shot.

I suppose that would be physically correct, but it wouldn't look nearly as cool as I imagined those things looking.

@belthazar, on Jun 19 2006, 02:50 AM, said in The Complete Guide to Submunitions:

I've been sort of considering doing one for quite some time... only I've got practically none of the required skills whatsoever. 🙂

Only skills required for a TC are patience, basic writing skills, and stubborness. Random stuff like graphics and whatnot can be aquired later, once you've gotten enough done that people feel helping you out is worthwhile.

This post has been edited by Lindley : 23 June 2006 - 06:37 PM

I have a couple of questions pertaining to sub-munitions.

  • Is it possible for a (non-guided) weapon to have its (homing) sub-munitions track different targets using any methods nessacary such as:
    free-flight rocket goes a distance, submunitions into 10 unguided projectiles for say 5 frames at a high speed then change to something that targets the nearest ship for 1-2 frames then finaly changes to a homing type weapon? I havent tested any of this but I will shortly.

  • Any suggestions?

  • Advice?

  • Statements saying this will work or saying a method that will result in the desired actions?

As always thanks for everyones help and all that jazz.

WonderBoy

(Edit): I would like for the post first shot's sub-munitions, and theirs aswell, to travel in a smooth path if possible. Meaning that there are no jerky turns. so it doesent appear as if it had a extreemly high turn rate and diden't arc toward the target.

This post has been edited by WonderBoy : 27 June 2006 - 02:42 PM

Yes, that should work perfectly well, although as I said in the guide, I have no idea how the "nearest target" is decided. Try it out and see.

As for making it shift directions smoothly, use entirely free-flight rocket guidance types until the Guided stage. Free-flight rockets transition smoothly from the parent shot's velocity to their own.

Edwards

@lindley, on Jun 24 2006, 09:34 AM, said in The Complete Guide to Submunitions:

Only skills required for a TC are patience, basic writing skills, and stubborness.

Patience, check. Stubborness, check. Basic writing skills... well, two out of three ain't bad. 🙂

GAH! The more I read this Guide, the more confused I become... :sigh: I guess I will just read it again from the top and hope it makes sence again.
And, Edwards, with the "fire towards nearest ship" flag set it will be smooth then an ubrupt change will occur in the flight path of the projectile. I want it to launch the sub-munitions at different targets but have the homing type weapon turn to face it, not start out facing it before it begins to track it.

This post has been edited by WonderBoy : 27 June 2006 - 02:35 PM

@wonderboy, on Jun 27 2006, 12:34 PM, said in The Complete Guide to Submunitions:

And, Edwards, with the "fire towards nearest ship" flag set it will be smooth then an ubrupt change will occur in the flight path of the projectile.

That's because the "fire at nearest target" free-flight rocket isn't getting up to full speed before it changes into a guided weapon. If you set the last free-flight rocket to have a Count somewhere around 30, or give it a speed of (30/Count)*(speed of guided weapon), it should look smooth.

@wonderboy, on Jun 27 2006, 12:34 PM, said in The Complete Guide to Submunitions:

I want it to launch the sub-munitions at different targets but have the homing type weapon turn to face it, not start out facing it before it begins to track it.

I don't think that is possible. When a submunition is launched "at the nearest target", it will automatically face the target when it is created. Sorry.

Edwards

This post has been edited by Edwards : 27 June 2006 - 04:14 PM

Try giving it a negative subtheta. I seem to recall that was the fix for otherwise infinite turn rate.

I don’t know if this is new behavior, but here’s what I’m seeing now in EVN 1.1 regarding submunition target acquisition.

To start things off, a weapon W that is fired by ship S has as its target the ship that was targeted by S at the time W was fired. In particular, if the player has a ship targeted at the time they fire a weapon, then that weapon’s shot has that target, even if the weapon is unguided.

Given a weapon “A” that submunitions into a weapon “B”, there are several cases to consider.

1. First, if there was a PD turret anywhere previous to B in the submunition chain, then B will have no target.
Edit: 1. First, if A was a PD turret, then B will have no target.

2. Otherwise, if B is not guided and A has “subs fire at nearest target”, then B will have a target chosen apparently at random from among the valid targets as described by Edwards above.

If neither of the above two conditions apply then:

3. If weapon A has its Prox Radius triggered by any ship, then the ship that triggered the Prox Radius of weapon A becomes the target for weapon B.

4. Otherwise, if weapon A has its Count expire so that it submunitions “in empty space”, then the ship that was the target for weapon A becomes the target for weapon B.

In any of these last three cases, if A has “subs fire at nearest target”, then B will begin life facing directly toward its target. Otherwise B will begin life facing the same direction as A had been facing.
Edit: If B has a target and A has “subs fire at nearest target”, then B will begin life facing directly toward its target. Otherwise B will begin life facing the same direction as A had been facing.

This post has been edited by Qaanol : 05 December 2011 - 10:22 AM