Agent skill
uloop-simulate-keyboard
Simulate keyboard key input in PlayMode via Input System. Use when you need to: (1) Press game control keys like WASD, Space, or Shift during PlayMode, (2) Hold keys down for continuous movement or actions, (3) Combine multiple held keys for complex input like Shift+W for sprint.
Stars
249
Forks
21
Install this agent skill to your Project
npx add-skill https://github.com/hatayama/unity-cli-loop/tree/main/Packages/src/Editor/Api/McpTools/SimulateKeyboard/Skill
SKILL.md
Task
Simulate keyboard input on Unity PlayMode: $ARGUMENTS
Workflow
- Ensure Unity is in PlayMode (use
uloop control-play-mode --action Playif not) - Execute the appropriate
uloop simulate-keyboardcommand - Take a screenshot to verify the result:
uloop screenshot --capture-mode rendering - Report what happened
Tool Reference
bash
uloop simulate-keyboard --action <action> --key <key> [options]
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
--action |
enum | Press |
Press, KeyDown, KeyUp |
--key |
string | (required) | Key name matching Input System Key enum (e.g. W, Space, LeftShift, A, Enter). Case-insensitive. |
--duration |
number | 0 |
Hold duration in seconds for Press action (0 = one-shot tap). Ignored by KeyDown/KeyUp. |
Actions
| Action | Behavior | Use Case |
|---|---|---|
Press |
KeyDown → wait → KeyUp | One-shot tap (jump, use item) |
KeyDown |
KeyDown only (held until KeyUp) | Start continuous movement, hold sprint |
KeyUp |
KeyUp only (release held key) | Stop movement, release sprint |
KeyDown/KeyUp Rules
KeyDownfails if the key is already heldKeyUpfails if the key is not currently held- Multiple keys can be held simultaneously (e.g. W + LeftShift for sprint)
- All held keys are automatically released when PlayMode exits
Global Options
| Option | Description |
|---|---|
--project-path <path> |
Target a specific Unity project (mutually exclusive with --port) |
-p, --port <port> |
Specify Unity TCP port directly (mutually exclusive with --project-path) |
Examples
bash
# One-shot key press (tap W once)
uloop simulate-keyboard --action Press --key W
# Jump (tap Space)
uloop simulate-keyboard --action Press --key Space
# Hold W for 2 seconds (move forward)
uloop simulate-keyboard --action Press --key W --duration 2.0
# Sprint forward (hold Shift + W, then release)
uloop simulate-keyboard --action KeyDown --key LeftShift
uloop simulate-keyboard --action KeyDown --key W
uloop screenshot --capture-mode rendering
uloop simulate-keyboard --action KeyUp --key W
uloop simulate-keyboard --action KeyUp --key LeftShift
Prerequisites
- Unity must be in PlayMode
- Input System package (
com.unity.inputsystem) must be installed - Active Input Handling must be set to Input System Package (New) or Both in Player Settings
- Game code must read input via Input System API (e.g.
Keyboard.current[Key.W].isPressed), not legacyInput.GetKey()
Didn't find tool you were looking for?