| name | input-mapper |
| description | Manage Godot input action mappings in project.godot.
Use when adding input actions, changing key bindings, setting up controls
for a new genre, or validating that all referenced actions exist.
Use it while implementing mechanics or changing the project's controls.
|
Input Mapper
$ARGUMENTS
Read the GDD or user request, determine which input actions are needed,
and write the correct [input] section entries into project.godot.
Step 1 — Extract Required Actions
Source actions from one of:
- GDD Mechanics table — each mechanic implies input actions
(e.g., "Player can jump" →
jump action).
- Genre preset — use a preset from Step 3 as a starting point.
- Explicit request — user or dispatching role specifies exact actions.
For each action, determine: action name (snake_case), bound keys/buttons.
Step 2 — Write to project.godot [input] Section
For Object() serialization format, templates (keyboard, mouse, gamepad button, gamepad axis), and key code table, read references/serialization.md.
Step 3 — Genre Presets
Use these as starting points. Add gamepad bindings if the GDD mentions controller support.
Platformer
| Action | Keys |
|---|
move_left | A, Left Arrow |
move_right | D, Right Arrow |
jump | Space, W, Up Arrow |
Top-down
| Action | Keys |
|---|
move_up | W, Up Arrow |
move_down | S, Down Arrow |
move_left | A, Left Arrow |
move_right | D, Right Arrow |
Shooter (top-down or twin-stick)
| Action | Keys / Buttons |
|---|
move_up | W, Up Arrow |
move_down | S, Down Arrow |
move_left | A, Left Arrow |
move_right | D, Right Arrow |
shoot | LMB (mouse button 1) |
reload | R |
UI (add to all genres)
Note: ui_accept, ui_cancel, ui_left, ui_right, ui_up, ui_down are
built-in Godot actions — do NOT redefine them in [input] unless overriding defaults.
Step 4 — Validation
Check that every Input.is_action_*("action_name") and event.is_action("action_name")
call in .gd files has a matching entry in project.godot [input] or is a built-in
Godot action (prefixed with ui_).
To validate:
- Grep all
.gd files for is_action\w*\("([^"]+)"\) — extract action names.
- Parse
project.godot [input] section for defined actions.
- Built-in actions (do not need definition):
ui_accept, ui_cancel, ui_select,
ui_left, ui_right, ui_up, ui_down, ui_focus_next, ui_focus_prev,
ui_page_up, ui_page_down, ui_home, ui_end, ui_text_*, ui_filedialog_*,
ui_graph_*, ui_copy, ui_cut, ui_paste, ui_undo, ui_redo.
- Report any action referenced in code but missing from project.godot.
