Jump to content

Controls (OpenApoc): Difference between revisions

From UFOpaedia
Makus (talk | contribs)
No edit summary
Deldonut1 (talk | contribs)
Major rewrite: complete controls reference for v0.0.49+; added Cityscape and Battlescape hotkey tables
Line 1: Line 1:
List of hotkeys implemented for OpenApoc version 0.0.49
OpenApoc aims to implement all controls from the original game while introducing new hotkeys to improve interface usability. A key addition is the '''improved city control scheme''' — a completely new, consistent control system using modifier keys. This can be disabled via the "Improved city control scheme" option in the More Options menu to restore vanilla behavior.


Note:
For debug and cheat hotkeys, see [[Hidden Features (OpenApoc)]].


OpenApoc eventually aims to implement all the controls from the original, as well as improve interface usability by introducing new hotkeys that make sense (things like mouse scroll for lists etc.). So, eventually you can expect all hotkeys from original manual to work, in addition to new ones. For now, however, refer to this file to find out what hotkeys do what, as well as to learn about debug keys (cheats).
== General UI Hotkeys ==


General UI Hotkeys:
{| class="wikitable"
* [Mousewheel] Scroll Lists
! Key !! Action
* [Esc] Go back, close form, "Cancel" option
|-
  For example, "OK" button in screens, "Cancel" or "No" option in dialogues
| Mousewheel || Scroll lists
* [Enter] Go forward, "Confirm" option, first option
|-
  For example, "OK" option in screens, "Confirm" or "Yes" option in dialogues, real time in breifing
| Esc || Go back, close form, "Cancel" option
* [Space] Skip, second (non-cancel) option
|-
  For example, "No" in "Yes/No/Cancel" dialogue, equip button in squad assignment, checkbox to pause when event happens again, turn based in briefing
| Enter || Go forward, "Confirm" option, first option (e.g., real-time in briefing)
 
|-
General Hotkeys:
| Space || Skip, second non-cancel option (e.g., turn-based in briefing, equip button in squad assignment)
* [Middle Click] Move camera to location
|}
* [Arrows] Move camera around
* [TAB] Toggle map
* [Space] Pause/Resume time (including TB)
* [Escape] Options menu
* [C] Toggle Follow Mode
* [M] Show Log
* [Home] Zoom to last event


Cityscape Vanilla Controls Note
== General Hotkeys ==
* Vanilla city controls were not very consistent and quite limited. For starters, right-clicking mouse in city moved map, while in battle, it didn't. There were no ways to quickly open frequently used screens (namely equipment, location, base screens) without clicking their buttons, and when using Alt/Shift hotkeys, they acted as if you clicked a corresponding button, meaning that if you missed your selection mode changed.
* Instead, OpenApoc introduces a new, consistent control scheme, which is explained in the next two sections
* For those who prefer to still use the vanilla control scheme, there is a feature to disable in the options menu called "Improved city control scheme". When disabled, vanilla control scheme will apply:
* Right click will move screen to cursor
* Alt+LMB will order vehicle attack
* Shift+LMB will order moving to building
* Left-clicking on building will always open building screen
* No mouse controls introduced by OpenApoc will function


Cityscape Mouse:
{| class="wikitable"
* [Ctrl]
! Key !! Action
  - when giving move orders to Agents, forces Agents to move on foot (never call a taxi), and allows use of personal teleporter
|-
  - when giving move orders to Vehicles, allows manual use of teleporter
| Middle Click || Move camera to location
  - when giving attack orders forces Vehicles to attack their target (instead of recovering UFOs or escorting owned vehicles)
|-
  - note that in vanilla, attacking owned vehicles was impossible, as such, a feature toggle is required for it to work (on by default)
| Arrow Keys || Move camera around
* [Alt] Opens ufopaedia
|-
* [Alt/Shift] + [Click] orders vehicles directly, Alt+Shift targets buildings and Shift targets vehicles or locations, while left click is aggressive and right is non-aggressive
| Tab || Toggle map
* [Alt] + [Left Click] Opens ufopaedia screen for the object (vehicle type, building function or even who fired the projectile!)
|-
* [Alt] + [Right Click] Opens ufopaedia screen for object's owner (be that vehicle or building)
| Space || Pause / Resume time (including turn-based)
* [Alt] + [Shift] + [Left Click] Order Attack Building
|-
* [Alt] + [Shift] + [Right Click] Order Goto Building
| Esc || Options menu
* [Shift] + [Left Click] Order Attack Vehicle
|-
* [Shift] + [Right Click] Order Follow Vehicle / Goto Location
| C || Toggle follow mode
* [Left Click]
|-
  - Issues orders
| M || Show message log
  - Base screen for building that contains a base
|-
  - Building screen for buildings
| Home || Zoom to last event
* [Right Click]
|}
  - Building screen for buildings


Cityscape Mouse Clicks on Vehicle / Agent icons:
== Cityscape Controls ==
* [Shift] + [Right Click] Open Location Screen
* [Ctrl] + [Shift] + [Right Click] Open Equipment Screen
* [Alt] + [Shift] + [Right Click] Open Equipment Screen


Cityscape Mouse Unit Selection:
=== Vanilla Controls Note ===
* [Ctrl] makes selection additive
* [Left Click]
  - Select Agent/Vehicle (as the only object selected)
* [Ctrl] + [Left Click]
  - Add Agent/Vehicle to selection and make it first in the list
* [Right Click]
  - Remove Agent/Vehicle from selection
 
Cityscape Keyboard:
* [0],[1]...[5] control time
* [N] Manual control (if using vanilla scheme then [M] is the manual control key and there is no way to open message log, as per vanilla)


Cityscape Debug:
The original game's city controls were inconsistent and limited:
* [F1] Debug hotkeys are toggled on/off
* Right-clicking moved the map in city but not in battle
* [Ctrl] + [Alt] + [Shift] + [Left Click] destroys scenery
* No quick access to frequently used screens (equipment, location, base)
* [Ctrl] + [Alt] + [Shift] + [Right Click] collapses building
* Alt/Shift hotkeys acted as if clicking a corresponding button — missing a target changed your selection mode
* [A] gives every vehicle weapon and ammo to current base
* [W] warp to alien dimension and back
* [R] repairs all scenery
* [B] spawn UFO on base assault mission
* [U] spawns three crashed UFOs
* [X] crashes every vehcile on map
* [PgUp] / [PgDown] displays only one layer of map, with other layers being transparent
* [F2] show road pathfinding map
* [F3] highlight walkmode, collapsing tiles, basement tiles
* [F4] show aliens in buildings on strategy map
* [F5] show vehicle paths (blue flying, yellow ground)
* [F6] dump voxelmap for line of sight to tileviewvoxels.png
* [F7] dump voxelmap for line of sight to tileviewvoxels.png (fast way, calculate 1/4 of points)
* [F8] dump voxelmap for line of fire to tileviewvoxels.png
* [F9] dump voxelmap for line of fire to tileviewvoxels.png (fast way, calculate 1/4 of points)
* [F10] highlight tube in city
* [F11] highlight roads in city
* [F12] highlight hills in city
* [Numpad 1379] show only roads/tubes that have an outgoing connection in this direction
* [Numpad 28] show only tubes that have an outgoing connection down [2] or up [8]
* [Numpad 0] show all roads/tubes again
* [Numpad 5]
  - For tubes, switch between showing only tiles with defined tube passability, or to also include tiles belonging to buildings
  - For roads, switch between showing only tiles marked as "road", or to also include tiles marked with road direction
  - For hills, switch between showing only tiles marked as "road", or to also include tiles marked with hill direction


Base screens Debug:
OpenApoc introduces a new, consistent control scheme explained below. To restore vanilla controls, disable "Improved city control scheme" in the More Options menu. With vanilla controls:
* [F10]
* Right click moves screen to cursor
  - On base view: finish all facilities
* Alt + Left Click orders vehicle attack
  - On research screen: mark project as requiring just 100 more points(basically complete project at next update if you have at least 2 people assigned)
* Shift + Left Click orders moving to building
* Left-clicking on building always opens building screen
* No OpenApoc mouse controls will function


 
=== Cityscape Mouse (Improved Scheme) ===
Vehicle Equipment:
* [Shift] makes item auto-equip into first available slot, or auto-remove to base stores
Agent Equipment:
* Usual selection controls apply, with option to de-select with right click as well
* [Shift] makes item auto-equip into first available slot, or auto-remove to base stores / ground
* [Ctrl] makes you remove clip when clicking on weapon
* [1]...[0] applies equipment template to every selected agent
* [Ctrl] + [1]...[0] remembers current agent's equipment set as a template


Battlescape Mouse:
{| class="wikitable"
* [Alt] When giving moving orders, makes unit keep facing to the target (making unit strafe or move backwards)
! Input !! Action
When firing at a tile, makes the shot aim at the ground of the tile, rather than at unit's level
|-
* [Shift] Turns cursor into attack mode
| Left Click on building || Open building screen (base screen if it contains a base)
* [Left Click]
|-
  - Order unit to execute action at cursor (move / throw / psi attack / teleport etc.)
| Right Click on building || Open building screen
  - Open probed unit's screen
|-
  - Use item (weapon / teleport / prime grenade etc.)
| Shift + Left Click || Order attack vehicle
* [Shift] + [Left Click]
|-
  - Order unit to fire at target tile, shot moving parallel to ground
| Shift + Right Click || Order follow vehicle / go to location
* [Shift] + [Alt] + [Left Click]
|-
  - Order unit to fire at target tile, shot aimed at tile's ground
| Alt + Shift + Left Click || Order attack building
* [Right Click]
|-
  - Turn towards cursor
| Alt + Shift + Right Click || Order go to building
  - Focus at enemy in RT
|-
  - Use item's "auto" function (like prime grenade for impact)
| Alt + Left Click || Open UFOpaedia for object (vehicle type, building function, or projectile source)
|-
| Alt + Right Click || Open UFOpaedia for object's owner (vehicle or building)
|}


Battlescape Mouse Unit Selection:
==== Modifier Keys ====
* [Ctrl] makes selection additive
* [Left Click]
  - Select Unit (as the only unit selected)
* [Ctrl] + [Left Click]
  - Add Unit to selection and make it first in the list
* [Right Click]
  - Remove Unit from selection


Battlescape Keyboard:
{| class="wikitable"
* [PgUp]/[PgDown] Change map levels
! Modifier !! Effect
* [V] Toggle layering
|-
* [F2] Prone Mode
| Ctrl (agent move orders) || Force agents to move on foot (never call taxi); allows use of personal teleporter
* [F3] Walk Mode
|-
* [F4] Run Mode
| Ctrl (vehicle move orders) || Allow manual use of city teleporter buildings
* [F5] Cease Fire Mode
|-
* [F6] Aimed Mode
| Ctrl (attack orders) || Force vehicles to attack target (instead of recovering UFOs or escorting owned vehicles)
* [F7] Snap Mode
|}
* [F8] Auto Mode
* [F9] Evasive Mode
* [F10] Normal Mode
* [F11] Aggressive Mode
* [Backspace] Kneel Mode
* [1..6] Select squad
* [Shift] + [1..6] Select Unit in current squad (as the only unit selected)
* [Shift] + [Ctrl] + [1..6] Add Unit to selection and make it first in the list
* [Alt] + [1..6] Go through spotted enemies of unit
* [Enter] Open Inventory
* [[] Throw right hand item
* []] Throw left hand item
* ['] Drop right hand item
* [\] Drop left hand item
* [Y] Confirm priming
* [N] Cancel priming
* [E] End your turn
* [S] Open Save menu
* [L] Open Load menu
* [J] Make unit jump (down from a cliff)


Battlescape Debug:
'''Note:''' In vanilla, attacking owned vehicles was impossible. OpenApoc enables this via the "Allow attacking owned vehicles" toggle (on by default).
* [F1] Debug hotkeys are toggled on/off, when they are on some of the normal hotkeys are off
 
* [Middle Click] Activate teleportation mode for unit regardless of wether it holds a charged teleporter
=== Cityscape Mouse on Vehicle / Agent Icons ===
* [E] Force end current turn in TB mode
 
* [R] Reveal whole map and show debug lines for which unit sees which unit
{| class="wikitable"
* [S] Stun units
! Input !! Action
  - with [Ctrl] held will affect small area around cursor, without will affect only unit under cursor
|-
  - with [Shift] held will affect everything except cursor
| Shift + Right Click || Open location screen
  - with [Shift] and Ctrl held will affect everything except what's in small area around cursor
|-
* [K] Same as [S] but removes units from map (units count as reterated)
| Ctrl + Shift + Right Click || Open equipment screen
* [P] Lower morale of every unit to the point where they will eventually suffer a low morale event
|-
* [Shift] + [P] gives every unit 0 psi defense and 100 psi energy/attack
| Alt + Shift + Right Click || Open equipment screen
* [H] Restore stats of every unit, heals stun damage and fatal wounds
|}
* [T] Restore TU of every player unit
 
* [F] Re-link support lines for battlescape map parts
=== Cityscape Unit Selection ===
* [Numpad 0] Spawn vortex mine explosion at cursor
 
* [Numpad 1-9] Spawn a shot with over 9000 at cursor in specified direction (5 being "down")
{| class="wikitable"
* [F6] dump voxelmap for line of sight to tileviewvoxels.png
! Input !! Action
* [F7] dump voxelmap for line of sight to tileviewvoxels.png (fast way, calculate 1/4 of points)
|-
* [F8] dump voxelmap for line of fire to tileviewvoxels.png
| Left Click || Select agent/vehicle (as the only object selected)
|-
| Ctrl + Left Click || Add agent/vehicle to selection and make it first in the list
|-
| Right Click || Remove agent/vehicle from selection
|}
 
=== Cityscape Keyboard ===
 
{| class="wikitable"
! Key !! Action
|-
| 0, 1, 2, 3, 4, 5 || Control game speed
|-
| N || Manual control (with vanilla scheme: M is manual control and there is no way to open message log)
|}
 
== Vehicle Equipment ==
 
{| class="wikitable"
! Input !! Action
|-
| Shift + Click || Auto-equip item into first available slot, or auto-remove to base stores
|}
 
== Agent Equipment ==
 
Standard selection controls apply, with the option to de-select with right click.
 
{| class="wikitable"
! Input !! Action
|-
| Shift + Click || Auto-equip item into first available slot, or auto-remove to base stores / ground
|-
| Ctrl + Click on weapon || Remove clip from weapon
|-
| 1 through 0 || Apply saved equipment template to every selected agent
|-
| Ctrl + 1 through 0 || Remember current agent's equipment set as a template
|}
 
== Battlescape Mouse ==
 
{| class="wikitable"
! Input !! Action
|-
| Left Click || Order unit to execute action (move / throw / psi attack / teleport), open probed unit's screen, use item
|-
| Right Click || Turn towards cursor, focus enemy (real-time), use item's "auto" function (e.g., prime grenade for impact)
|-
| Shift + Left Click || Force-fire at target tile, shot moving parallel to ground
|-
| Shift + Alt + Left Click || Force-fire at target tile, shot aimed at tile's ground
|}
 
==== Modifier Keys ====
 
{| class="wikitable"
! Modifier !! Effect
|-
| Alt (movement) || Unit keeps facing the target while moving (strafing or moving backwards)
|-
| Alt (firing at tile) || Shot aims at the ground of the tile rather than at the unit's level
|-
| Shift || Turns cursor into attack mode
|}
 
=== Battlescape Unit Selection ===
 
{| class="wikitable"
! Input !! Action
|-
| Left Click || Select unit (as the only unit selected)
|-
| Ctrl + Left Click || Add unit to selection and make it first in the list
|-
| Right Click || Remove unit from selection
|}
 
== Battlescape Keyboard ==
 
=== Movement and Fire Modes ===
 
{| class="wikitable"
! Key !! Action
|-
| PgUp / PgDown || Change map levels
|-
| V || Toggle layering
|-
| F2 || Prone mode
|-
| F3 || Walk mode
|-
| F4 || Run mode
|-
| F5 || Cease fire mode
|-
| F6 || Aimed mode
|-
| F7 || Snap mode
|-
| F8 || Auto mode
|-
| F9 || Evasive mode
|-
| F10 || Normal mode
|-
| F11 || Aggressive mode
|-
| Backspace || Kneel mode
|}
 
=== Squad and Unit Selection ===
 
{| class="wikitable"
! Key !! Action
|-
| 1 through 6 || Select squad
|-
| Shift + 1 through 6 || Select unit in current squad (as the only unit selected)
|-
| Shift + Ctrl + 1 through 6 || Add unit to selection and make it first in the list
|-
| Alt + 1 through 6 || Cycle through spotted enemies of the selected unit
|}
 
=== Actions ===
 
{| class="wikitable"
! Key !! Action
|-
| Enter || Open inventory
|-
| [ || Throw right hand item
|-
| ] || Throw left hand item
|-
| ' || Drop right hand item
|-
| \ || Drop left hand item
|-
| Y || Confirm priming
|-
| N || Cancel priming
|-
| E || End your turn (turn-based mode)
|-
| S || Open save menu
|-
| L || Open load menu
|-
| J || Make unit jump (down from a cliff)
|}
 
== See Also ==
 
* [[Hidden Features (OpenApoc)]] — debug hotkeys and cheat system
* [[Improvements (OpenApoc)]] — toggle-able gameplay improvements
* [https://github.com/ayrtondenner/OpenApoc-wiki/blob/master/openapoc/controls.md OpenApoc Wiki: Controls] — Extended controls documentation
* [[OpenApoc]] — main OpenApoc page
 
[[Category:OpenApoc]]

Revision as of 21:26, 1 March 2026

OpenApoc aims to implement all controls from the original game while introducing new hotkeys to improve interface usability. A key addition is the improved city control scheme — a completely new, consistent control system using modifier keys. This can be disabled via the "Improved city control scheme" option in the More Options menu to restore vanilla behavior.

For debug and cheat hotkeys, see Hidden Features (OpenApoc).

General UI Hotkeys

Key Action
Mousewheel Scroll lists
Esc Go back, close form, "Cancel" option
Enter Go forward, "Confirm" option, first option (e.g., real-time in briefing)
Space Skip, second non-cancel option (e.g., turn-based in briefing, equip button in squad assignment)

General Hotkeys

Key Action
Middle Click Move camera to location
Arrow Keys Move camera around
Tab Toggle map
Space Pause / Resume time (including turn-based)
Esc Options menu
C Toggle follow mode
M Show message log
Home Zoom to last event

Cityscape Controls

Vanilla Controls Note

The original game's city controls were inconsistent and limited:

  • Right-clicking moved the map in city but not in battle
  • No quick access to frequently used screens (equipment, location, base)
  • Alt/Shift hotkeys acted as if clicking a corresponding button — missing a target changed your selection mode

OpenApoc introduces a new, consistent control scheme explained below. To restore vanilla controls, disable "Improved city control scheme" in the More Options menu. With vanilla controls:

  • Right click moves screen to cursor
  • Alt + Left Click orders vehicle attack
  • Shift + Left Click orders moving to building
  • Left-clicking on building always opens building screen
  • No OpenApoc mouse controls will function

Cityscape Mouse (Improved Scheme)

Input Action
Left Click on building Open building screen (base screen if it contains a base)
Right Click on building Open building screen
Shift + Left Click Order attack vehicle
Shift + Right Click Order follow vehicle / go to location
Alt + Shift + Left Click Order attack building
Alt + Shift + Right Click Order go to building
Alt + Left Click Open UFOpaedia for object (vehicle type, building function, or projectile source)
Alt + Right Click Open UFOpaedia for object's owner (vehicle or building)

Modifier Keys

Modifier Effect
Ctrl (agent move orders) Force agents to move on foot (never call taxi); allows use of personal teleporter
Ctrl (vehicle move orders) Allow manual use of city teleporter buildings
Ctrl (attack orders) Force vehicles to attack target (instead of recovering UFOs or escorting owned vehicles)

Note: In vanilla, attacking owned vehicles was impossible. OpenApoc enables this via the "Allow attacking owned vehicles" toggle (on by default).

Cityscape Mouse on Vehicle / Agent Icons

Input Action
Shift + Right Click Open location screen
Ctrl + Shift + Right Click Open equipment screen
Alt + Shift + Right Click Open equipment screen

Cityscape Unit Selection

Input Action
Left Click Select agent/vehicle (as the only object selected)
Ctrl + Left Click Add agent/vehicle to selection and make it first in the list
Right Click Remove agent/vehicle from selection

Cityscape Keyboard

Key Action
0, 1, 2, 3, 4, 5 Control game speed
N Manual control (with vanilla scheme: M is manual control and there is no way to open message log)

Vehicle Equipment

Input Action
Shift + Click Auto-equip item into first available slot, or auto-remove to base stores

Agent Equipment

Standard selection controls apply, with the option to de-select with right click.

Input Action
Shift + Click Auto-equip item into first available slot, or auto-remove to base stores / ground
Ctrl + Click on weapon Remove clip from weapon
1 through 0 Apply saved equipment template to every selected agent
Ctrl + 1 through 0 Remember current agent's equipment set as a template

Battlescape Mouse

Input Action
Left Click Order unit to execute action (move / throw / psi attack / teleport), open probed unit's screen, use item
Right Click Turn towards cursor, focus enemy (real-time), use item's "auto" function (e.g., prime grenade for impact)
Shift + Left Click Force-fire at target tile, shot moving parallel to ground
Shift + Alt + Left Click Force-fire at target tile, shot aimed at tile's ground

Modifier Keys

Modifier Effect
Alt (movement) Unit keeps facing the target while moving (strafing or moving backwards)
Alt (firing at tile) Shot aims at the ground of the tile rather than at the unit's level
Shift Turns cursor into attack mode

Battlescape Unit Selection

Input Action
Left Click Select unit (as the only unit selected)
Ctrl + Left Click Add unit to selection and make it first in the list
Right Click Remove unit from selection

Battlescape Keyboard

Movement and Fire Modes

Key Action
PgUp / PgDown Change map levels
V Toggle layering
F2 Prone mode
F3 Walk mode
F4 Run mode
F5 Cease fire mode
F6 Aimed mode
F7 Snap mode
F8 Auto mode
F9 Evasive mode
F10 Normal mode
F11 Aggressive mode
Backspace Kneel mode

Squad and Unit Selection

Key Action
1 through 6 Select squad
Shift + 1 through 6 Select unit in current squad (as the only unit selected)
Shift + Ctrl + 1 through 6 Add unit to selection and make it first in the list
Alt + 1 through 6 Cycle through spotted enemies of the selected unit

Actions

Key Action
Enter Open inventory
[ Throw right hand item
] Throw left hand item
' Drop right hand item
\ Drop left hand item
Y Confirm priming
N Cancel priming
E End your turn (turn-based mode)
S Open save menu
L Open load menu
J Make unit jump (down from a cliff)

See Also