Godot Platform Desktop

This is your desktop platform checklist for Godot games shipping on Windows, Linux, or macOS. It covers the stuff players expect but is easy to mess up: resolution dropdowns that respect DPI scaling, keybind remapping using physical_keycode so WASD works on AZERTY keyboards, proper ConfigFile persistence to user://, and graceful shutdown handling so Alt+F4 doesn't nuke save data. The scripts include window management across multiple monitors, Steam SDK wrappers that don't crash non-Steam builds, and alt-tab pause guards to prevent stuck input states. If you're tired of hardcoding 1920x1080 fullscreen or wondering why your settings menu looks blurry on 4K displays, start here.

skills.sh installs: 234
GitHub stars: 464
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add thedivergentai/gd-agentic-skills --skill godot-platform-desktop --agent claude-code

Installs into .claude/skills of the current project.

Files

Platform: Desktop

Settings flexibility, window management, and kb/mouse precision define desktop gaming.

NEVER Do (Expert Desktop Rules)

Window & Display

NEVER hardcode resolution or fullscreen modes — Always provide a settings menu with resolution + mode toggle.
NEVER ignore DPI scale factors — Use DisplayServer.screen_get_scale() / usable rects.
NEVER skip a borderless window option — Offer WINDOW_MODE_FULLSCREEN (borderless) for multi-monitor focus.

Input & Persistence

NEVER use keycode for movement rebinds — Use physical_keycode for AZERTY/Dvorak.
NEVER save settings or user data to res:// — Always user://.
NEVER skip NOTIFICATION_WM_CLOSE_REQUEST — Flush ConfigFile before get_tree().quit().

Performance & Integration

NEVER run utility tools at max framerate — Enable OS.low_processor_usage_mode for static tools.
NEVER call proprietary SDKs (Steam/Epic) directly — Wrap with Engine.has_singleton() guards.
NEVER block the main thread with massive I/O — Offload to WorkerThreadPool.