Agent Skills
返回列表
💻

Godot 手游转桌面适配

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/thedivergentai-gd-agentic-skills-godot-adapt-mobile-to-desktop。

技能介绍

问题从哪来

不少 Godot 项目先做成触屏手游:InputEventScreenTouch、虚拟摇杆、固定竖屏分辨率、44pt 触控按钮。上架 PC 时若只改导出目标,玩家会遇到鼠标悬停无效、窗口无法全屏/无边框、没有画质选项,以及「大屏上还像手机 UI」的体验断层。技能把移动端假设和桌面端惯例拆成可执行的改造清单,而不是笼统说「加键鼠支持」。

技能如何组织改造

核心是按顺序挂载脚本 + 明确禁止项。输入侧优先读 desktop_input_adapter.gd:在不重写移动玩法的前提下,把触控动作桥接到 InputMap 的 WASD/鼠标;UI 需悬停时用 hover_bridge.gd;FPS/轨道视角在适配器发出 mouse_look_bridge_requested 后必须接上 mouse_capture_look.gd(单靠 get_aim_vector() 只适合俯视角)。窗口与生命周期走 dynamic_window_manager.gd、multi_monitor_handling.gd、quit_confirmation.gd(set_auto_accept_quit(false) + 关窗存档提示)。UI 密度用 desktop_ui_scaler.gd 把拇指级控件缩约 30–50%,并配合容器布局扩展热键栏/小地图等区域。画质侧用 resolution_dropdown.gd、uncapped_framerate.gd 和可持久化的质量阶梯,不要继续锁移动分辨率或隐藏图形设置。

推荐移植顺序与 SKILL 中的 Port Procedure 一致:输入桥接 → UI 缩放与布局 → 窗口/多屏/退出确认 → 分辨率与帧率 → 更深 OS 集成(可转 godot-platform-desktop)。Steam/Discord 等商店能力要求用 GDExtension 分支,本里程碑可整段省略,避免把假 API 写进玩法脚本。超出首遍键盘鼠标时读 desktop-port-deep.md;发版前跑 desktop-port-testing-checklist.md,不要自创半截清单。

边界与注意点

技能面向同一 Godot 工程从移动控制/UI 假设迁到 PC,不是从零写桌面游戏。若项目尚无统一的 InputMap 与动作抽象,需先结合 godot-input-handling 理清事件管线。逆向需求(桌面后再保留触控)应对照 godot-adapt-desktop-to-mobile。

使用场景

  • Godot 手游已上线,需在同一工程中增加键鼠与可改键,而不重写角色移动与技能逻辑
  • 触屏虚拟摇杆项目要发 Steam,需把 pinch 缩放改成滚轮并实现无边框/独占全屏切换
  • 移动版 HUD 按钮过大,要在 1920×1080 下缩小控件并扩展热键栏、小地图等桌面布局
  • PC 版缺少关窗确认与多显示器启动位置,要在 WM 关闭时提示存档并跟随光标所在屏幕

适合人员

  • 独立开发者:手游用 Godot 做完,打算同一仓库导出 Windows/macOS 并要分步检查清单
  • Gameplay 程序员:负责把 `InputEventScreenTouch` 管线替换成键鼠,且 FPS 视角要接 `mouse_capture_look`
  • 技术负责人:评估是否在本里程碑接入 Steam/Discord,还是延后到 GDExtension 再做
  • UI 程序:要把移动安全区布局改成桌面锚点/容器,并恢复按钮悬停与主题变化