Godot引擎输入处理脚本库：高级缓冲、重绑定、手势与辅助功能支持

切勿在 _process() 中轮询输入以处理游戏操作 — 使用 _physics_process() 或 _unhandled_input()。_process() 依赖于帧率，在低 FPS 时会导致输入丢失 [22]。
切勿使用硬编码的按键检查（例如 KEY_W） — 始终使用 InputMap 动作。硬编码的按键会阻止重绑定，并破坏与非 QWERTY 布局的兼容性 [23]。
切勿忽略模拟摇杆的死区 — 在 0.05 幅度下漂移的摇杆会导致意外移动。在代码或设置中实现径向死区（而非轴向）[24]。
切勿假设只有单一输入设备 — 玩家可能在游戏过程中在键盘和控制器之间切换。使用 Input.joy_connection_changed 来动态更新 UI 提示 [25]。
切勿使用 _input() 处理游戏操作 — _input() 会触发所有事件（包括 UI）。使用 _unhandled_input()，这样点击菜单时就不会触发游戏逻辑 [26]。
切勿在快节奏游戏中省略输入缓冲 — 如果玩家在落地前 50 毫秒按下跳跃键，没有缓冲的话输入就会丢失。实现 100-150 毫秒的缓冲以获得“紧凑”的手感 [27]。
切勿使用 Input.is_action_pressed() 处理一次性触发 — 它在按键按住的每一帧都返回 true。对于跳跃、攻击和切换操作，请使用 _just_pressed 以避免逻辑重复触发。
切勿在多个地方手动实现“按住与切换”逻辑 — 将其集中在一个设置或输入包装器中，以确保整个游戏的辅助功能一致性。
切勿忘记在 UI 导航中处理 InputEvent.is_echo() — 回显事件（键盘重复）应该移动菜单，但很少应该触发“确认”或“返回”操作。
切勿在没有“释放”快捷键的情况下捕获鼠标 — 如果你的游戏崩溃或阻塞了 ui_cancel，用户就会被困住。始终为鼠标捕获提供一个备用退出方式。

# 检查本帧是否按下了动作
if Input.is_action_just_pressed("jump"):
    jump()

# 检查动作是否被按住
if Input.is_action_pressed("fire"):
    shoot()

# 检查动作是否被释放
if Input.is_action_just_released("jump"):
    release_jump()

# 获取轴（-1 到 1）
var direction := Input.get_axis("move_left", "move_right")

# 获取向量
var input_vector := Input.get_vector("left", "right", "up", "down")

🇺🇸English

Input Handling

Handle keyboard, mouse, gamepad, and touch input with proper buffering and accessibility support.

Available Scripts

advanced_input_buffer.gd

Frame-perfect input buffering system for responsive jumps, dashes, and combo chains.

safe_runtime_rebind.gd

Dynamic input rebinding with conflict detection, persistence, and multi-device support.

analog_deadzone_manager.gd

Radial deadzone management for analog sticks to eliminate drift while maintaining natural follow-through.

multi_touch_gestures.gd

Handling touch, drags, and pinch-to-zoom gestures for mobile and touchscreen compatibility.

input_echo_filter.gd

Filtering echo events to distinguish between hold-to-navigate (UI) and one-time gameplay actions.

mouse_capture_manager.gd

Robust mouse capture and sensitivity scaling logic for FPS and mouse-intensive systems.

hold_toggle_accessibility.gd

Software-side support for user-defined 'Hold' vs 'Toggle' accessibility preferences.

glyph_prompt_manager.gd

Real-time switching between Keyboard and Gamepad UI prompts based on the last active device.

action_state_machine.gd

Tracking the lifecycle of an action ('Just Pressed', 'Held', 'Released') for complex state logic.

unhandled_input_priority.gd

Demonstrating the correct use of _unhandled_input to prevent gameplay logic from leaking into UI.

MANDATORY - For Responsive Controls : Read input_buffer.gd before implementing jump/dash mechanics.

NEVER Do in Input Handling

NEVER poll input in_process() for gameplay actions — Use _physics_process() or _unhandled_input(). _process() is frame-rate dependent, causing dropped inputs at low FPS [22].
NEVER use hardcoded key checks (e.g.,KEY_W) — Always use InputMap actions. Hardcoded keys prevent rebinding and break compatibility with non-QWERTY layouts [23].
NEVER ignore analog stick deadzones — Drifting sticks at 0.05 magnitude will cause unintended movement. Implement a radial deadzone (not axial) in code or settings [24].
NEVER assume a single input device — Players may switch between Keyboard and Controller mid-session. Use Input.joy_connection_changed to update UI prompts dynamically [25].
NEVER use_input() for gameplay actions — fires for ALL events (including UI). Use so gameplay logic doesn't trigger while clicking menus [26].

InputMap Actions

Setup: Project Settings → Input Map → Add action

# Check if action pressed this frame
if Input.is_action_just_pressed("jump"):
    jump()

# Check if action held
if Input.is_action_pressed("fire"):
    shoot()

# Check if action released
if Input.is_action_just_released("jump"):
    release_jump()

# Get axis (-1 to 1)
var direction := Input.get_axis("move_left", "move_right")

# Get vector
var input_vector := Input.get_vector("left", "right", "up", "down")

InputEvent Processing

func _input(event: InputEvent) -> void:
    if event is InputEventKey:
        if event.keycode == KEY_ESCAPE and event.pressed:
            pause_game()
    
    if event is InputEventMouseButton:
        if event.button_index == MOUSE_BUTTON_LEFT and event.pressed:
            click_position = event.position

Gamepad Support

# Detect controller connection
func _ready() -> void:
    Input.joy_connection_changed.connect(_on_joy_connection_changed)

func _on_joy_connection_changed(device: int, connected: bool) -> void:
    if connected:
        print("Controller ", device, " connected")

Reference

Godot Docs: InputEvent

Master Skill: godot-master

Weekly Installs

Repository

thedivergentai/…c-skills

GitHub Stars

First Seen

Feb 10, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode74

codex72

gemini-cli72

kimi-cli71

github-copilot71

amp71

Godot引擎输入处理脚本库：高级缓冲、重绑定、手势与辅助功能支持

🇨🇳中文介绍

输入处理

可用脚本

相关 Skills

输入处理中切勿做的事项

InputMap 动作

InputEvent 处理

游戏手柄支持

参考

相关