In this tutorial we’ll set up a control map using gamepad buttons.
Control maps are used to bind actions to input keys.
We’ll set up a control map using gamepad buttons to use the actions assigned to shortcut slots 1 to 9.
We’ll set up
- shortcut assignments
- control map
- update combatants to use control map
This tutorial is based on the ORK 4 Unity Quickstart 3D tutorials using gamepad controls, but can be used in any project.
You can download the finished control map and input keys here:
Download Control Map for Gamepad
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.
Open the ORK editor, 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 #
Next, we’ll set up a control map to use actions via input keys.
We’ll use button west for attacks. For abilities and items we’re going to use the control map’s hold key feature to use gamepad buttons (north, east, south, west) while holding left trigger (items) or right trigger (abilities) for different shortcuts.
Navigate to Controls > Control Map and add a new control map.
Base Settings #
- Name
Set to: Gamepad Map
Useable In #
We’ll allow using the control map in the field and in battle.
- Field
Enable - All Battle Systems
Enable
Target Settings #
We’ll use the group targets we’ve set up, if an action can’t be used on the group target, it’ll bring up the target selection.
- Use Group Target
Enable - Need Targets
Enable
This’ll prevent an action from being fired (or target selection opening) when no target is available
Control Key 0 #
It’s time to add control keys.
We’ll start with the shortcut slots, i.e. using left or right trigger as hold key combined with a gamepad button to use the shortcut. We’ll set up the attack (only using button) last.
This is due to how control maps work. They’re checking the control keys in the order they’re added, using the first that’s possible to use. A shortcut being mapped to left/right trigger + button west will never be used if we put the attack (button west) first.
Abilities will be mapped to the right trigger (slots 2-5), items to the left trigger (slots 6-9). Control key 0 will start with abilities.
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: Button South - Use Hold Input Key
Enable - Hold Input Key
Select: Right Trigger (Hold)
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: 2
We’ll start with 2 because that’s the first slot assigned with an ability.
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: Button West
Action Settings #
- Shortcut Slot Index
Set to: 3
Control Key 2 #
I’ll shorten the description here, you know where the settings are by now.
Copy Control Key 1.
- Input Key
Select: Button North - Shortcut Slot Index
Set to: 4
Control Key 3 #
Copy Control Key 2.
- Input Key
Select: Button East - Shortcut Slot Index
Set to: 5
Control Key 4 #
We’ll now switch to the left trigger for items.
Copy Control Key 3.
- Input Key
Select: Button South - Hold Input Key
Select: Left Trigger (Hold) - Shortcut Slot Index
Set to: 6
Control Key 5 #
Copy Control Key 4.
- Input Key
Select: Button West - Shortcut Slot Index
Set to: 7
Control Key 6 #
Copy Control Key 5.
- Input Key
Select: Button North - Shortcut Slot Index
Set to: 8
Control Key 7 #
Copy Control Key 6.
- Input Key
Select: Button East - Shortcut Slot Index
Set to: 9
Control Key 8 #
The final key maps attack (slot index 1) to button west without a hold key.
Copy Control Key 7.
- Input Key
Select: Button East - Use Hold Input Key
Disable - Shortcut Slot Index
Set to: 1
And that’s it for the control map, now we need to add it to our combatants.
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 #
If you’ve already followed the control map for shortcut slots tutorial, you can simply add the new control map after the old one. Both use separate input keys to use the same shortcut slots and can be used together.
Click on Add Control Map.
- Control Map
Select: Gamepad Map
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 (hold left trigger + buttons), while in battle you’ll also have abilities (hold right trigger + buttons) and the base attack (button west) 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.

