In this tutorial we’ll set up a control map to use actions assigned to shortcut slots.
Control maps are used to bind actions to input keys.
We’ll set up using keyboard keys 1 to 9 to use the actions assigned to shortcut slots 1 to 9.
We’ll set up
- new input keys
- control map
- update combatants to use control map
This tutorial is based on the ORK 4 Unity Quickstart 3D tutorials using the shortcut HUD, but can be used in any project.
You can download the finished control map and input keys here:
Download Control Map for Keyboard
Input Keys #
First, we’ll need to set up the input keys for the control map. As said above, we’ll use keys 1 to 9.
Open the ORK editor and navigate to Controls > Input Keys. We’ll add multiple new inputs.
Digit 1 #
Add a new input key.
- Name
Set to: Digit 1
Input ID Settings 0 #
- Input Origin
Select: Keyboard Key (Input System) - Positive Key
Select: Digit 1
Digit 2 #
Copy Digit 1.
- Name
Set to: Digit 2
Input ID Settings 0 #
- Positive Key
Select: Digit 2
Digit 3, 4, …, 9 #
You should be able to do this on your own – copy the latest input, change the name and key.
Do this up to digit 9 (being the last key we need).
Shortcut Assignments #
Before we set up the control map, we’ll set up the shortcut assignments it’ll use. Let’s set up automatic shortcut assignments, i.e. the shortcut slots will automatically be filled with content.
We’ll set slot 1 to use the base attack of the combatant, slot 2-5 will get active abilities and slot 6-9 useable items.
You can skip this if you’ve already followed the shortcut HUD tutorial.
Navigate to Gameplay > Shortcut Settings and change the following settings.
Default Shortcut Assignment #
We’ll start with adding the base attack. This is done as a fixed assignment because the base attack isn’t something the combatant learns or gets at some point, it’s always available.
Click on Add Shortcut.
- Shortcut List Index
Set to: 0
The list index defines which shortcut slot list to use, we’ll put all our slots on list index 0. - Shortcut Slot Index
Set to: 1
The slot index defines the slot in the list that’ll be used – as said before, we’ll start at index 1. - Shortcut Type
Select: Attack
Default Auto Add Slots #
Abilities or items are received by the combatant at some time in the game, at which point we’ll automatically fill a free slot with their content.
Click on Add Auto Add Slots.
- Shortcut List Index
Set to: 0 - Slot Start Index
Set to: 2 - Slot End Index
Set to: 5
We set which content will automatically be added to the slots in the Used Shortcuts settings.
- Active Abilities
Enable
Disable all other shortcut settings.
Optionally you can also limit the used abilities by content type.
Click on Add Auto Add Slots to add another setup, this time for items.
- Shortcut List Index
Set to: 0 - Slot Start Index
Set to: 6 - Slot End Index
Set to: 9
We set which content will automatically be added to the slots in the Used Shortcuts settings.
- Useable Items
Enable
Disable all other shortcut settings.
Let’s limit the items to only use potions.
- Limit Item Type
Enable
Click on Add Item Content Type.
- Item Content Type
Select: Potions
Control Map #
We’ve got the input keys we need, so let’s set up the control map.
Navigate to Controls > Control Maps and add a new control map.
Base Settings #
- Name
Set to: Shortcuts 1-9
Useable In #
We’ll allow using the control map in the field and in battle.
- Field
Enable - All Battle Systems
Enable - While Choosing
Enable
This allows the combatant to use the control map while selecting actions (e.g. in the battle menu).
Target Settings #
The Target Settings allow you to fine-tune which combatant will be targeted or if a target selection will be available. Individual control keys, abilities and items can override these target settings with a custom setup.
The default setup will use group/individual targets (i.e. targets marked for the group or individual combatant) or bring up the target selection menu if no other target is found. We’ll keep the default setup for this tutorial, i.e. it’ll open the target selection since we don’t have any group/individual targets set up.
We’ll enable Need Targets to prevent actions from being fired without available targets.
- Need Targets
Enable
Tip!
If you want to focus on mouse-based target selection, I’d recommend using the Cursor Over Target settings:
- Only Cursor Over Target (Optional)
Enable
This only uses the action if the cursor is over a valid target. - Use Cursor Over Target (Optional)
Enable
This uses the target the cursor is currently over.
With this setup, using the control map key will only be possible if the cursor is over a valid target and automatically uses the action on that target.
Control Key 0 #
It’s time to add control keys.
Click on Add Control Key to add the first key to the control map.
Input Settings #
The input settings define the input that’s used and optional conditions that have to be valid to use it.
- Input Key
Select: Digit 1
Action Settings #
The action settings define the actions that’ll be used – in our case it’ll be a shortcut slot.
- Type
Select: Action
Beside actions, control maps can also start global machines, schematics or toggle the auto attack on/off. - Action
Select: Shortcut - Shortcut List Index
Set to: -1
This’ll use the currently active shortcut list.
Combatants can have multiple lists of shortcuts, but only one is active at a time. - Shortcut Slot Index
Set to: 1
We’ll start our slot indexes at 1 instead of 0 (to match the shortcut HUD tutorial).
Control Key 1 #
The rest of the control keys are pretty simple to set up, we’ll just copy the previous key and change the input key and shortcut index.
Copy Control Key 0.
Input Settings #
- Input Key
Select: Digit 2
Action Settings #
- Shortcut Slot Index
Set to: 2
Control Key 2 #
I’ll shorten the description here, you know where the settings are by now.
Copy Control Key 1.
- Input Key
Select: Digit 3 - Shortcut Slot Index
Set to: 3
Control Key 3 #
Copy Control Key 2.
- Input Key
Select: Digit 4 - Shortcut Slot Index
Set to: 4
Control Key 4 #
Copy Control Key 3.
- Input Key
Select: Digit 5 - Shortcut Slot Index
Set to: 5
Control Key 5 #
Copy Control Key 4.
- Input Key
Select: Digit 6 - Shortcut Slot Index
Set to: 6
Control Key 6 #
Copy Control Key 5.
- Input Key
Select: Digit 7 - Shortcut Slot Index
Set to: 7
Control Key 7 #
Copy Control Key 6.
- Input Key
Select: Digit 8 - Shortcut Slot Index
Set to: 8
Control Key 8 #
Copy Control Key 7.
- Input Key
Select: Digit 9 - Shortcut Slot Index
Set to: 9
Updating Combatants #
To use a control map, it needs to be set up for a combatant – you can either set up control maps in the combatant General Settings for all combatants, or add them to individual combatants.
In any case, only the control maps for the currently active player are used.
We’ll set them up for all combatants, so navigate to Combatants > Combatants and select General Settings.
Base Settings > Control Maps #
Click on Add Control Map.
- Control Map
Select: Shortcuts 1-9
Save Changes #
And that’s it for the control map setup.
Don’t forget to save the changes by clicking on the Save Settings button at the bottom of the editor.
Testing #
Hit play and test your control map.
While in the field you’ll be able to use potions (key 6-9), while in battle you will have all available to you (if it’s the player’s turn).
However, with our current setup only the player combatant can use it’s shortcuts in battle. Let’s change that.
Updating Battle System #
We need to enable using control maps for the currently action selecting combatant in each individual battle system we want to use.
However, Real Time battles don’t have this option and don’t need it. During real time battles you’ll only input actions for the currently controlled player. Selecting actions for a different player group member requires changing the player, which automatically uses the new player’s control maps.
Turn Based #
Turn Based Settings > Other Options #
- Selecting Control Map
Enable
Active Time #
Active Time Settings > Other Options #
- Selecting Control Map
Enable
Phase #
Phase Settings > Other Options #
- Selecting Control Map
Enable
Testing Again #
Hit play and test your control map again.
Now, you’ll be able to use the control map of the player group member that’s currently selecting actions.
Tip!
If you’re using a shortcut HUD, you can change it to show the shortcuts of the currently selecting combatant as well. Simply change it’s HUD type to Latest Turn, e.g. see this HUD tutorial for an example.

