Editing Unit commands

Commands are the orders or directions that players issue to their units throughout a game of Zero-K. Most of the actions and decisions that players make throughout a game are implemented via issuing various types of commands. This page lists and categorizes all the commands with links for details on specific commands.

== Command Types ==
There are three main types of command: targeted commands, instant commands and state toggles. 
* '''Targeted commands''' are issued with a target. Targets can include units and map features (rocks, trees, wrecks) as well as positions, areas and lines drawn that you draw on the map when the command is issued. Targeting lines, areas or multiple units or features is commonly achieved by clicking an dragging.
* '''Instant commands''' activate unit abilities that require no target.
* '''State toggles''' are standing orders that modify behaviour or toggle certain abilities.

== Giving Commands ==
Instant commands and state toggles can be issued by clicking their button in the command panel or pressing their hotkey. Right clicking a state toggle cycles the toggle backwards or reset it to a deactivated state, depending on the command. Hotkeys to set a state toggle to a particular state can be bound in the hotkeys menu.

Targeted commands can be issued with either the left or right mouse buttons.
* Click the '''right mouse button''' to issue a context sensitive command. The command that will be issued is indicated by the mouse cursor and depends on both your unit selection and the target of the command. Common examples are [[Force Fire Command|force fire]] when the target is an enemy unit and [[Move Command|move]] when the the target is empty ground.
* Click the '''left mouse button''' to issue a command selected. To select a command click on its button in the command panel or press its hotkey. The selected command is indicated by the mouse cursor and a highlighted command button. Issue the command (without holding Shift) or right click to deselect the command.

Targeted commands can be modified in many ways.
* '''Click and drag''' to draw a circle or a line. Most commands support either line or circle drawing and some support both depending on other modifers.
* Many commands are modified by holding '''Alt''' or '''Ctrl''' while clicking to issue the command.
* Some commands change depending on whether they are targeted on a unit or the ground.

== Queuing and Inserting Commands ==
Units maintain a list of commands, known as their command queue, that are executed in order as each command is completed. Most targeted and instant commands can be added to the end of the queue or inserted or inserted into the queue. State toggles cannot be added to the queue and always take effect instantly.
* Hold '''SHIFT''' while issuing a targeted or instant command to add it to the end of the command queue.
* Hold '''SPACE''' while issuing a targeted command to add it to the start of the command queue, pushing the current command to the second spot in the queue.
* Hold '''SHIFT+SPACE''' while issuing a targeted command to insert it at the point in the command queue that would result in the least extra travel time.

A targeted command that is issued without holding Shift or Space cancels the entire command queue, replacing it with the newly issued command. An instant command that is issued without holding Shift or Space immediately executes the command without affecting the rest of the queue. Nobody knows what happens if an instant command is issued with Space held.


== Modifiers ==

Commands can have their behaviour modified using ALT and CTRL, and can be combined with SHIFT and SPACE to queue commands. Some commands also change their behaviour when targeted on a unit or the ground. See [Modifier Reference|the reference page] for a quick list of common modifier behaviour. See each commands page for details.

{|
!style="width: 10%"|Command
!style="width: 10%"|Click+drag behaviour
!style="width: 20%"|Drag behaviour
!style="width: 20%"|+CTRL
!style="width: 20%"|+ALT
!style="width: 20%"|+CTRL+ALT
|-
|Move(M)<br/><img src=""/>
|Move units to a point.
|Move units into a line.
|Move, maintaining current formation.
|When dragging, move along a line.
|When dragging, move along a line in formation.
|-
|Attack move(A)<br/><img src=""/>
|Move to a point, using unit AI while moving.
|Same as move, using AI.
|Same as move, using AI.
|Same as move, using AI.
|Same as move, using AI.
|-
|Patrol(P)<br/><img src=""/>
|Move back and forth between current position and a point, using unit AI while moving.
|Same as move, using AI. 
|Same as move, using AI.
|Same as move, using AI.
|Same as move, using AI.
|-
|Fire(F)<br/><img src=""/>
|Fire at a point
|Fire at all targets in an area, in a queue.
|When dragging, fire at all targets in an area, splitting fire.
|When dragging, fire along a line.
|
|-
|Set Target(T)<br/><img src=""/>
|Target a unit or point, without moving. Fire at target if in range.  Fire normally if out of range.
|Target the nearest enemy in the circle.
|Target all enemies in the circle, splitting targets.
|Target the ground along a line, firing if in range.
|
|-
|Guard(G)<br/><img src=""/>
|Protect, repair, and assist a unit.
|On unit: guard in circle formation.
On ground: guard all units in the circle.
|For circle formation: guard in a specific direction.
|For circle formation: guard in a direction relative to unit facing.
|For circle formation: do not match guarding unit speeds/positions.
|-
|Repair(R)<br/><img src="https://raw.githubusercontent.com/ZeroK-RTS/Zero-K/master/Anims/cursorrepair_0.png"/>
|Repair a live unit; Assist construction.
|Area command. Applies the click command to valid targets in the area, as long as there are any.
|Only repair live units, do not assist construction.
|For area only. Persist the area even when no valid targets inside (continue if any new show up).
|
|-
|Mex(W)<br/><img src="https://raw.githubusercontent.com/ZeroK-RTS/Zero-K/master/LuaUI/Images/commands/Bold/mex.png" width="32" height="32"/>
|Build a mex at given spot||Queue mexes across the area.
|Surround each mex in the area with 4 solars. Works on already-built mexes.
|
|
|
|-
|Reclaim(E)<br/><img src="https://raw.githubusercontent.com/ZeroK-RTS/Zero-K/master/Anims/cursorreclamate_0.png"/>
|Reclaim target (unit or feature).
|Reclaim features across the area.
|Area only. If centered on a live unit, reclaim all units of this type in the area. Else, ignore metal-less features, such as trees. There is a menu option to do this by default, in which case trees can be reclaimed either with CTRL or by centering the area on a tree.
|Area only. Persist the command even when no features are in the area.
|
|-
|Resurrect<br/><img src="https://raw.githubusercontent.com/ZeroK-RTS/Zero-K/master/Anims/cursorrevive_0.png"/>
|Resurrect target wreck||Area version. Resurrect wrecks in given area as long as there are any; ignore ones that are partially reclaimed.
|Area only. Resurrect even partially reclaimed wrecks (but still not those actively being reclaimed - this requires single target command).
|Area only. Persist the command even when no resurrectables are in the area.
|
|-
|}

== Factory Production Commands ==

Factories can make use of unit commands to make produced units take specific actions when leaving the factory.  For example, units can be set to move to a point or patrol as soon as they are produced.

Unit commands given to factories can also be queued and modified, as above.

== Full List of Commands ==
=== Common targeted commands ===
* [[Move Command|Move]]
* [[Attack Move Command|Attack Move]]
* [[Jump Command|Jump]]
* [[Force Fire Command|Force Fire]]
* [[Set Target Command|Set Target]]
* [[Fire Special Weapon Command|Fire Special Weapon]]
* [[Area Attack Command|Area Attack]]
* [[Guard Command|Guard]]
* [[Patrol Command|Patrol]]

=== Common economic commands ===
* [[Repair Command|Repair]]
* [[Reclaim Command|Reclaim]]
* [[Resurrect Command|Resurrect]]
* [[Area Mex Command|Area Mex]]
* [[Structure Placement|Structure placement commands]]
* [[Factory Production|Unit construction commands]]
* [[Terraform|Terraforming commands]]

=== Instant commands ===
* [[Stop Command|Stop]]
* [[Wait Command|Wait]]
* [[Detonate Command|Detonate]]
* [[Self Destruct Command|Self Destruct]]
* [[Cancel Target Command|Cancel Target]]
* [[Return to Airbase Command|Return to Airbase]]
* [[Recall Drones Command|Recall Drones]]
* [[Clear Production Queue Command|Clear Production Queue]]
* [[Stockpile Command|Stockpile]]

=== Transport commands ===
* [[Load Command|Load]]
* [[Unload Command|Unload]]
* [[Load Command#Load Selected Units|Load Selected Units]]
* [[Eject Cargo Command|Eject Cargo]]
* [[Transport AI#Embark and Disembark|Embark]]
* [[Transport AI#Embark and Disembark|Disembark]]

=== Unusual commands ===
* [[Newton Firezones|Newton firezone commands]]
* [[Morph Command|Morph]]
* [[Commander|Upgrade Commander]]
* [[Commander|Stop Commander Upgrade]]
* [[Unique Commands#Drop Bombs|Drop Bombs]]
* [[Unique Commands#Unleash Lightning|Unleash Lightning]]
* [[Unique Commands#Teleport Beacon|Teleport Beacon]]
* [[Unique Commands#Drop Depthcharge|Drop Depthcharge]]
* [[Unique Commands#Speed Boost|Speed Boost]]
* [[Evacuate Command|Evacuate]]

=== Global commands ===
* [[Ferry Command|Ferry]]
* [[Retreat|Retreat]]
* [[Resources Reserve|Reserve]]

=== State commands ===
* [[Unit states#Fire State|Fire State]]
* [[Unit states#Move State|Move State]]
* [[Unit states#Repeat|Repeat]]
* [[Unit states#Overkill Prevention|Overkill Prevention]]
* [[Unit states#Retreat|Retreat]]
* [[Unit states#Build Priority|Build Priority]]
* [[Unit states#Misc Priority|Build Misc]]
* [[Unit states#Factory Assist|Factory Assist]]
* [[Unit states#Cloak|Cloak]]
* [[Unit states#Unit AI|Unit AI]]
* [[Unit states#On/Off|On/Off]]
* [[Unit states#Idle State|Idle State]]
* [[Unit states#Float State|Float State]]
* [[Unit states#Trajectory|Trajectory]]
* [[Unit states#Fire at Radar|Fire at Radar]]
* [[Unit states#Dive State|Dive State]]
* [[Unit states#Area Cloak|Area Cloak]]
* [[Unit states#Gunship Strafe|Gunship Strafe]]
* [[Unit states#Kill Captured|Kill Captured]]
* [[Unit states#Drone Construction|Drone Construction]]
* [[Unit states#Impulse Mode|Impulse Mode]]

{{Navbox manual}}