Reference

This page provides a detailed overview of all settings, naming conventions, and logic used in Spearhead.
For a quick start guide, visit the Tutorials page.

Configuration

For the configuration you can reference the configuration as it is below:

                    @@CONFIG_CODE@@
                

Naming Conventions

Spearhead uses specific naming conventions for zones, missions, and CAP configurations. These conventions are critical for the framework to function correctly.

Stage Zones

Format: MISSIONSTAGE_[OrderNumber]_[FreeForm]
Example: MISSIONSTAGE_1_EAST

Stages are logical parts of a mission. They encapsulate multiple missions, airbases, and other objects.
Secondary stages can be defined using the format: MISSIONSTAGE_x[OrderNumber].

Waiting Stages

Format: WAITINGSTAGE_[Order]_[Seconds]
Example: WAITINGSTAGE_2_180

Waiting stages introduce delays between stages. They activate only after the previous stage is completed.

Mission Zones

Format: MISSION_[Type]_[Name]
Example: MISSION_DEAD_BYRON

Missions are completable objectives with specific types, such as DEAD, BAI, STRIKE, or SAM.
Randomized missions can be defined using the format: RANDOMMISSION_[Type]_[Name]_[Index].

CAP Routes

Format: CAPROUTE_[Name]
Example: CAPROUTE_ALPHA

CAP routes define the patrol paths for CAP units. They are tied to specific stages and zones.

FARP Zones

Format: FARP_A|B_[Name]
Example: FARP_A_HOUSTON Example: FARP_B_HOUSTON

FARP zones are spawned and activated based on the "activation parameter".
A: Activates when the parent stage zone activates.
B: Activates when the parent stage is "Blue".

Future: FARP zones will be "buildable" once logistics are implemented.

Mission Types

Each mission type has specific logic and completion criteria. Below are the supported types:

SAM

SAM missions involve surface-to-air missile sites. These missions are activated when a stage is "Pre-Active."
Completion Logic: Destroy all air defenses in the zone.

DEAD

DEAD missions target enemy air defenses. They are activated at the start of a stage.
Completion Logic: Destroy all designated targets in the zone.

BAI

BAI missions involve battlefield air interdiction. These missions target enemy ground forces.

STRIKE

STRIKE missions target strategic objectives, such as supply depots or command centers.
Completion Logic: Destroy all designated targets in the zone.

Mission Briefings

Mission briefings are text boxes (draw layer) inside of the trigger zone of the mission.

Special Fields

Special fields are used to display information in the mission briefings.
They are replaced with the corresponding values at the time a briefing is requested and can therefore show real time data.
Field: {{coords}}
Coords are taken from the location of the trigger zone. Then converted to the aircrafts preferred format.

CAP Configuration

CAP (Combat Air Patrol) units are managed using specific naming conventions and configurations.

CAP Group Naming

Format: CAP_[A|B][Config]_[FreeForm]
Example: CAP_A[1-4]5_SomeName

CAP Group Config

                1 at x:               [<activeStage>]<capStage>
                n and n  at x:        [<activeStage>,<activeStage>]<capStage>
                n till n at x:        [<activeStage>-<activeStage>]<capStage>
                n till n and n at x:  [<activeStage>-<activeStage>,<activeStage>]<capStage>
                n till n at Active:   [<activeStage>-<activeStage>]A

                Divider: |

                Examples:
                CAP_A[1-4,6]7|[5,7]8_SomeName => Will fly CAP at stage 7 when stages 1 through 4 and 6 are active and will fly CAP at 8 when 5 and 7 are active.
                CAP_A[2-5]5|[6]6_SomeName => Will fly CAP at stage 5 when stages 2 through 5 are active and will fly CAP at 6 when 6 is active.
                CAP_A[1-5]A|[6]7_SomeName => Will fly CAP at the ACTIVE stage if stages 1-5 are active. Then when 6 is active, it will fly in 7.
                

Active and Backup CAP

Active Units: Define the maximum number of groups in a zone at a time.
Backup Units: Fill in when active units are unavailable due to RTB, death, or rearming.

Randomization

Missions can be randomized using the RANDOMMISSION prefix.
Spearhead will pick one random mission from zones with the same name.

In stage depencies

If you want to have missions inside of a stage depends on each other you can.
Add a text drawing box inside of the mission trigger zone with the name: dependson_[freeform]
And in the text add the "Name" of the mission zone you want the mission to depend on.
The mission will be "pre-activated" (spawned) but won't have a f10 mission menu until the mission(s) it depends on is completed.

Runway Bombing

Runway bombing can be a very effective OCA tactic. With Spearhead we've tried adding as much logic and detail to it so it will feel as engaging as possible.
Firstly, the runway is split up in 5 sections and only sections 2, 3 and 4 are then actually tracked.
+-----------+-----------+-----------+-----------+-----------+
| Section 1 | Section 2 | Section 3 | Section 4 | Section 5 |
+-----------+-----------+-----------+-----------+-----------+