Skip to content
OpenTS Manual

TaskForce

The TaskForce whose composition a team of this type recruits and builds toward.

Specification
Applies to
TeamType
File
ai.ini or map file
Section
[<ObjectType ID>]
Value
class
When omitted
none

The named TaskForce is the team’s roster. Each of its member lines names an object type and a quantity. A team recruits toward those quantities, and a computer house builds the members still missing. The team is at full strength when it holds the sum of the quantities. The Reinforcement (team) and Reinforcement (team) at waypoint actions create exactly those members instead of recruiting them. A TaskForce of a single DSHP line is the exception, because it can deliver a dropship loadout instead.

When the TeamType leaves its own Group unset, the team recruits with the TaskForce’s Group.

ai.ini or map file
[MyRaidTeam] ; example TeamType
Name=Raid team
House=Nod
TaskForce=MyRaidForce ; defined under [TaskForces]
Script=MyRaidScript   ; defined under [ScriptTypes]

The value is matched against the IDs registered under [TaskForces]. A name that is not registered there is not an error: the game creates a new, empty TaskForce under that name. What happens next depends on how the team is created:

  • Either reinforcement action creates nothing.
  • Any other team wants no members, so it never reaches full strength and never starts its Script. Outside a campaign it is deleted once DissolveUnfilledTeamDelay frames have passed since it was created. In a campaign it stays for the rest of the mission.

In a Debug build, a team with an empty TaskForce stops the game on a failed assertion the first time its logic runs.

See also — Script, House, Group, Max, ai-team-production