游戏引擎 / 系统课时

整理输入与项目运行设置

整理输入与项目运行设置

准备导出 Godot 4 的 3D 小游戏前,应先统一输入动作、启动场景、窗口行为和渲染选择。本课把分散在项目设置中的关键选项逐项检查,再用一段脚本验证,让游戏在换机器或导出后仍能从正确场景启动并接收操作。

学习目标

  • 用 Input Map 统一移动、跳跃和暂停动作及按键绑定。
  • 明确主场景、窗口尺寸、拉伸方式和渲染器的配置原则。
  • 运行自检脚本并完成桌面窗口与输入验收。

统一输入动作和按键

进入 Project → Project Settings → Input Map,按下表新建动作,再为每个动作添加按键事件。动作名是脚本访问的接口,不要把键盘按键名直接写进玩法判断;键位日后改变时,角色脚本便无需修改。

动作名 建议键位 用途
move_left / move_right A / D 水平移动
move_forward / move_back W / S 前进与后退
jump Space 跳跃
pause_game Esc 打开或关闭暂停菜单

在 Input Map 顶部输入动作名并添加,然后展开该动作,点击添加事件并选择相应键位。面向键盘 WASD 布局可优先选择 Physical Key,使移动操作依据键位位置;若要支持手柄,再给相同动作绑定手柄事件并测试死区和冲突。不要依赖引擎内置的 ui_* 动作直接承担全部玩法输入。

Godot 4 输入映射中添加动作及绑定按键的入口

动作绑定后,还应检查角色脚本中使用的名称是否一致。例如,调用 Input.get_vector() 时必须按负 X、正 X、负 Y、正 Y 的顺序传入左右前后四个动作,才能获得符合预期的二维移动输入。动作名称拼错时,游戏不会自动把按键解释为同义动作。

固定启动场景、窗口和渲染器

在 Project Settings → General → Application → Run 指定 Main Scene,选择真正的游戏入口场景,而不是仅供测试的关卡。按 F5 运行整个项目,确认先出现预期菜单或关卡;只按 F6 运行当前场景无法验证主场景配置。

在 General → Display → Window 中把基础视口宽高设为 1280 × 720,作为桌面横屏的起点。一般 3D 游戏若包含常规 Control HUD,可按项目需要选 Stretch Mode = canvas_items,再根据画面要求选 Aspect = expand(扩展可见区域)或 keep(保持比例、可能出现黑边);不要把拉伸方式误当成单独降低 3D 渲染分辨率的按钮。还应测试窗口缩放时的 UI 锚点和边缘布局。

Godot 4 窗口基础分辨率及拉伸选项的位置

渲染器在编辑器右上角的渲染器选择位置核对:Forward+ 适合需要较丰富 3D 光照特性的桌面目标,Mobile 或 Compatibility 适合相应性能与兼容性需求。不要为了提速临时切换后直接交付;切换可能影响材质、阴影和环境效果,必须重新查看目标设备上的实际画面。

项目名称、主场景和渲染方式属于交付前的基础配置。修改这些设置后,应重新运行项目并确认没有资源加载错误,而不只是观察设置面板里的数值是否已保存。

用脚本检查设置是否生效

在入口场景下添加一个 Node,挂载以下脚本。它会在启动时检查六个动作、基础视口尺寸与主场景是否已配置,并监听跳跃和暂停按键。运行前需按上文完成 Input Map 与窗口设置。

gdscript
extends Node

const REQUIRED_ACTIONS = [
    &"move_left", &"move_right", &"move_forward",
    &"move_back", &"jump", &"pause_game"
]

func _ready() -> void:
    # 缺失动作会让玩法脚本读不到预期输入
    var missing_count := 0
    for action in REQUIRED_ACTIONS:
        if not InputMap.has_action(action):
            missing_count += 1
    var width := int(ProjectSettings.get_setting("display/window/size/viewport_width"))
    var height := int(ProjectSettings.get_setting("display/window/size/viewport_height"))
    var main_scene := str(ProjectSettings.get_setting("application/run/main_scene", ""))
    print("missing_actions=", missing_count)
    print("viewport=", width, "x", height)
    print("main_scene_set=", not main_scene.is_empty())

func _process(_delta: float) -> void:
    # 单次按下才输出,不在持续按住期间刷屏
    if Input.is_action_just_pressed(&"jump"):
        print("jump=pressed")
    if Input.is_action_just_pressed(&"pause_game"):
        print("pause=pressed")

预期输出:按 F5 运行,依次按 Space 和 Esc,在 Output 面板中应依次看到:

text
missing_actions=0
viewport=1280x720
main_scene_set=true
jump=pressed
pause=pressed

此脚本只核对动作存在并打印按键事件,并未实现角色跳跃或暂停状态。若动作缺失、视口尺寸不匹配或主场景未设置,先修正项目设置,而不是在角色逻辑中临时补救。

若启动时前三项正确,但按键没有输出,应检查游戏窗口是否拥有键盘焦点、Input Map 是否保存了对应事件、是否把普通按键事件错误地绑定到不匹配的输入类型。若键盘正常而手柄失败,则应进一步检查手柄事件、摇杆方向与死区。

用实际窗口完成交付前验收

依次测试默认窗口、手动拉宽窗口和缩小窗口:确认 3D 画面未异常裁切、HUD 没有漂离锚点,WASD、Space、Esc 均按预期响应。还要检查游戏失去和恢复焦点后的输入状态,并在目标硬件上确认渲染器可以正常启动。

验收时重点检查以下结果:

  1. 按 F5 总能从预期入口场景启动,不依赖编辑器当前打开的场景。
  2. 同一个输入动作在脚本和 Input Map 中命名一致,不存在冲突的玩法绑定。
  3. 调整窗口大小后,交互按钮、生命条和提示文本仍处于正确位置。
  4. 目标平台能够正常创建渲染窗口,场景材质、灯光和阴影没有不可接受的差异。
  5. 导出后的程序能够完成启动、移动、跳跃和暂停的实际操作测试。

project.godot 保存项目设置,应随项目一同纳入版本管理。正式导出后再运行导出程序,重点复查主场景、输入和窗口表现;编辑器内通过不等于最终程序已经通过。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

整理输入与项目运行设置

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通