HHow-to

How to Create and Edit a GameLoop Key Mapping (2026 Full Guide)

Learn GameLoop's built-in keymap editor from scratch — adding keys, assigning analog sticks, tuning sensitivity, and sharing your layout with friends.

GameLoop's key mapping system converts every on-screen touch into keyboard keys or mouse movements. That's how you get real mouse-aim and keyboard controls on a game originally built for mobile. The editor looks busy at first, but learning it in the right order saves hours of trial and error.

Opening the editor

While a game is running in GameLoop, look for the thin toolbar on the left side of the screen. Click the grid icon at the bottom. Alternatively, Ctrl+9 opens the keymap editor directly.

The editor works in two layers:

  • Top layer: a transparent overlay showing your keyboard and mouse controls
  • Bottom layer: the game's normal interface

The game keeps running while the editor is open. You can test every key you add in real time without leaving the editor.

Core control types

Single Tap

Pressing a key taps a specific point on screen. Ability buttons, fire, reload, jump — all of these are single taps.

To add one:

  1. Click + in the top-right of the editor
  2. Choose Tap
  3. Click the point on the game screen where the button lives
  4. Assign a keyboard key in the box that appears

Tip: In CODM, the fire buttons are in the bottom-left and bottom-right corners. Add two separate taps — one bound to left mouse, one to right mouse.

Joystick (Analog Stick)

Used for movement. Once a joystick is added, WASD or arrow keys move the virtual joystick in-game.

To add one:

  1. + → Joystick
  2. Click the center of the joystick in the game
  3. Leave the key assignments at W=up, S=down, A=left, D=right

You can resize the joystick circle on screen. The circle shows the joystick's active area — making it smaller or larger affects how much physical movement maps to full deflection.

Free Look / Aiming

In shooters like CODM, mouse movement rotates the camera. This is called "free look" or "mouse look."

To add one:

  1. + → Scope/Free Look
  2. Draw the active area on screen (usually the right half of the screen)
  3. Adjust sensitivity

Sensitivity (DPI multiplier): Lower values (0.1–0.3) give slower, more controlled aiming. Higher values (0.8–1.5) give fast camera turns. For CODM, starting at 0.3–0.5 is recommended.

Aiming while firing

In CODM, to shoulder-aim with right-click while adjusting your aim with the mouse, you need two separate settings:

  • Right mouse button → Single Tap → ADS (aim down sights) button
  • Free Look active area set to the right half of the game screen

Together these give you: right-click to aim, mouse to adjust target, left-click to fire — close to the feel of a PC shooter.

Sensitivity and speed settings

The editor has two global settings at the top:

Touch Delay: How many milliseconds after a keypress the touch signal fires. 0 is fastest, but some games miss signals that arrive too quickly. For CODM, 0–20ms is fine.

Mouse DPI Multiplier: Global sensitivity multiplier applied to all mouse movements. It's independent of the in-game sensitivity setting but they multiply together — leave the in-game sensitivity at 50 and start here at 1.0, then calibrate by adjusting one at a time.

Saving your layout

Click Save in the editor or press Ctrl+S. GameLoop automatically links the layout to that specific game title — the next time you open the game the layout loads automatically.

If you want multiple layouts (one for multiplayer, one for battle royale), that's not directly supported — GameLoop stores one layout per game. Workaround: switch the layout, save, test, then edit it back manually if needed.

Exporting and importing layouts

To export:

  1. Click the three-dot menu in the top-right of the editor
  2. Choose Export
  3. A .json file is saved — you pick the name and location

To import:

  1. Three-dot menu → Import
  2. Select and open the file

This is how you share layouts with friends. Post a .json file on Discord or a forum; anyone who downloads it can import it and instantly use the same layout.

Resetting to defaults

Clicking Defaults in the editor loads GameLoop's built-in suggested layout for that game. If you've broken your own layout and don't know where to start, this is the fastest exit.

For CODM, GameLoop's default layout is functional — it covers aim, fire, reload, and movement — but the sensitivity values aren't tuned. Load the defaults, adjust sensitivity values to match your feel, then save.

Common issues

Keymap doesn't work in-game Make sure the editor is closed. While the editor is open, key inputs go to the editor, not the game. Toggle with Ctrl+9.

Mouse aim is being ignored The Free Look area might be mapped to the wrong spot. Delete it in the editor and redraw it to precisely cover the game's camera control zone.

Joystick works but character moves slowly The inner circle of the joystick is too small. Enlarge it in the editor. Alternatively, raise the joystick sensitivity in the game's own settings — that setting also interacts with GameLoop's joystick.

Fire key behaves unexpectedly Verify the Single Tap position exactly matches the fire button's position in the game UI. Select the fire tap in the editor and compare coordinates. If you change the game's resolution, button positions can shift — lock the resolution and re-tune the map.

Community layout sources

CODM and PUBG Mobile layouts shared by the GameLoop community can be found on Discord and Reddit. Before using any file, check: is it a .json file? Any other extension is likely modified or in the wrong format.

The downside of using someone else's layout: their sensitivity values were calibrated for their mouse and monitor setup. Download the layout, adjust the delay and sensitivity values to match your setup, then save.