How to Configure Key Mapping
Key Mapping lets you assign keyboard, mouse, or gamepad inputs to touch actions on the phone screen. You first create mapping profiles in the global editor, then assign a profile to each phone individually.
Ready-to-use key mapping profiles
The LaiCai Community shares profiles for popular games. Download one and use it right away, then adjust the key positions to match your in-game layout.
Browse and download community profiles →Game-specific Key Mapping Tutorials
Prerequisites
- A phone is already connected and screen mirroring is active
- If you want to map gamepad inputs, make sure your gamepad is connected first
- For best results, start the game before configuring mappings so coordinates are accurate
Part 1: Create Mapping Profiles
All mapping profiles are managed in a global editor. Open it once and configure everything there.
Step 1: Open the Mapping Editor
- Click the Tools menu in the top menu bar
- Select Input Mapping from the dropdown
- The Input Mapping Settings window will open
Step 2: Create a Profile
Mappings are organized in profiles — create one profile per game.
- In the editor, the Mapping Profile selector is shown at the top of the window — use it to switch between profiles
- Click New and enter a name (e.g. the game name) to create a new profile
- Click Copy to duplicate an existing profile
- Switch between profiles anytime from the dropdown
Step 3: Add Mappings
Select an input source, choose a behavior, then click Add New Mapping.
- Choose the input source: Keyboard, Mouse, or Gamepad
- Choose the mapping behavior (see table below)
- Click Add New Mapping — press the desired key/button — set the screen coordinate — save
Mapping Behavior Reference
Part 2: Assign a Profile to a Phone
Profiles created in the editor are not automatically active. You need to assign one to each phone individually.
Step 4: Assign a Profile to a Phone
- Find the KM button at the top of the phone panel in the screen mirror view
- Click KM — the Select KeyMapping Profile dialog will open
- The dialog lists all available profiles
- Click the profile name you want to apply to this phone
- The dialog closes and the mapping activates immediately
- The KM button turns yellow to indicate an active profile
Tips
- Name profiles after the game — makes switching fast when you play different games
- The overlay on the screen mirror shows all active mapping points visually
- Use layers when a game needs different key configs for different modes — switch with Switch Layer mapping
- On the screen mirror, the overlay shows all mapping touch points — click any point to jump directly to its edit dialog
- In the KM profile picker, toggle Show Feedback to see real-time visual feedback when inputs are triggered (flash on touch, trail on swipe, joystick HUD for stick)
Mapping Behavior Reference
Learn the behavior of each mapping type in detail.