Difference between revisions of "Unit commands"

From Zero-K
Jump to navigation Jump to search
(Using local images in the table.)
 
(38 intermediate revisions by 15 users not shown)
Line 1: Line 1:
== Basics ==
+
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.
  
Units are controlled by giving them commands. There are three kinds of commands:
+
== Command Types ==
* targeted commands, such as Move or Attack.
+
There are three main types of command: targeted commands, instant commands and state toggles.
* instant commands, such as Wait or Self-destruct.
+
* '''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.
* [[Unit states|state commands]], such as Fire State or Cloak.
+
* '''Instant commands''' activate unit abilities that require no target.
 +
* '''State toggles''' are standing orders that modify behaviour or toggle certain abilities.
  
Some targeted commands have area versions, where the command is given continuously onto valid targets in the area as long as there are any. Drag when giving the order to do an area command.
+
== 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.
  
Others have line versions. Each unit being given the order gets a different target along the line.
+
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.
  
Most targeted and instant commands can be queued using SHIFT. This puts the order at the end of the queue.
+
Targeted commands can be modified in many ways.
You can also use SPACE to insert at the front of the queue, or SHIFT+SPACE to insert in the middle of the queue (between two closest orders).
+
* '''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.
  
== Modifiers ==
+
== 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.
  
Commands can have their behaviour modified using ALT and CTRL.
+
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.
  
<table>
+
== Factory Production Commands ==
<tr><td>Command</td><td>Click behaviour</td><td>Drag behaviour</td><td>+ALT</td><td>+CTRL</td></tr>
+
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.
<tr><td>Repair <img src="https://raw.githubusercontent.com/ZeroK-RTS/Zero-K/master/Anims/cursorrepair_0.png"/></td><td>Repair a live unit;<br/>Assist construction</td><td>Area command.<br/>Applies the click command to valid targets in the area, as long as there are any</td><td>For area only. Persist the area even when no valid targets inside (continue if any new show up)</td><td>Only repair live units, do not assist construction.</td></tr>
+
 
<tr><td>Mex <img src="https://raw.githubusercontent.com/ZeroK-RTS/Zero-K/master/LuaUI/Images/commands/Bold/mex.png" width="32" height="32"/></td><td>Build a mex at given spot</td><td>Queue mexes across the area</td><td>Surround each mex in the area with 4 solars. Works on already-built mexes.</td><td>None.</td></tr>
+
Unit commands given to factories can also be queued and modified, as above.
<tr><td>Reclaim <img src="https://raw.githubusercontent.com/ZeroK-RTS/Zero-K/master/Anims/cursorreclamate_0.png"/></td><td>Reclaim target (unit or feature)</td><td>Reclaim features across the area.</td><td>Area only. Persist the command even when no features are in the area.</td><td>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.
+
 
</td></tr>
+
== Most Common Commands and Modifiers ==
</table>
+
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 each command's 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 Command|Move]]&nbsp;(M) [[File:Move.png|none|32px|link=Move Command]]
 +
|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 Command|Attack move]]&nbsp;(A) [[File:Fight.png|none|32px|link=Attack Move Command]]
 +
|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 Command|Patrol]]&nbsp;(P) [[File:Patrol.png|none|32px|link=Patrol Command]]
 +
|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.
 +
|-
 +
|[[Force Fire Command|Force Fire]]&nbsp;(F) [[File:Attack.png|none|32px|link=Force Fire Command]]
 +
|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 Command|Set Target]]&nbsp;(T) [[File:Settarget.png|none|32px|link=Set Target Command]]
 +
|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 Command|Guard]]&nbsp;(G) [[File:Guard.png|none|32px|link=Guard Command]]
 +
|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 Command|Repair]]&nbsp;(R) [[File:Repair.png|none|32px|link=Repair Command]]
 +
|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).
 +
|For area only. Persist the area even when no valid targets inside while only repairing live units.
 +
|-
 +
|[[Area Mex Command|Area Mex]]&nbsp;(W) [[File:mex.png|none|32px|link=Area Mex Command]]
 +
|Build a mex at given spot||Queue mexes across the area.
 +
|Surround each mex in the area with 2 solars. Works on already-built mexes. If a mex is underwater, 2 Tidal Generators are built instead. If on land and flat space is limited, a Wind Generator will be substituted where a Solar does not fit.
 +
|As with +CTRL, except with only one generator per mex, chosen as appropriate.
 +
|As with +CTRL, except with four generators per mex, chosen as appropriate, one on each side.
 +
|
 +
|-
 +
|[[Reclaim Command|Reclaim]]&nbsp;(E) [[File:Reclaim.png|none|32px|link=Reclaim Command]]
 +
|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.
 +
|Area only. Persist the command even when no features are in the area while ignoring(or not, depending on setting) metal-less features
 +
|-
 +
|[[Resurrect Command|Resurrect]]&nbsp;(T) [[File:Resurrect.png|none|32px|link=Resurrect Command]]
 +
|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. Ignores partially reclaimed wrecks.
 +
|Area only. Persist the command even when no resurrectables are in the area. Resurrects partially reclaimed wrecks.
 +
|-
 +
|}
 +
 
 +
== 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]]
 +
* [[Economy Guide#Reserving resources|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 commands}}
 +
 
 +
{{Navbox manual}}
 +
 
 +
[[Category:Commands|#]]

Latest revision as of 09:53, 16 October 2024

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 when the target is an enemy unit and 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.

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.

Most Common Commands and 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 each command's page for details.

Command Click+drag behaviour Drag behaviour +CTRL +ALT +CTRL+ALT
Move (M)
Move.png
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)
Fight.png
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)
Patrol.png
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.
Force Fire (F)
Attack.png
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)
Settarget.png
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)
Guard.png
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)
Repair.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). For area only. Persist the area even when no valid targets inside while only repairing live units.
Area Mex (W)
Mex.png
Build a mex at given spot Queue mexes across the area. Surround each mex in the area with 2 solars. Works on already-built mexes. If a mex is underwater, 2 Tidal Generators are built instead. If on land and flat space is limited, a Wind Generator will be substituted where a Solar does not fit. As with +CTRL, except with only one generator per mex, chosen as appropriate. As with +CTRL, except with four generators per mex, chosen as appropriate, one on each side.
Reclaim (E)
Reclaim.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. Area only. Persist the command even when no features are in the area while ignoring(or not, depending on setting) metal-less features
Resurrect (T)
Resurrect.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. Ignores partially reclaimed wrecks. Area only. Persist the command even when no resurrectables are in the area. Resurrects partially reclaimed wrecks.

Full List of Commands

Common targeted commands

Common economic commands

Instant commands

Transport commands

Unusual commands

Global commands

State commands