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 — A 1920x1080 fullscreen on a 4K monitor is blurry. Always provide a settings menu with a resolution dropdown and a mode toggle.
• NEVER ignore DPI scale factors — Manually centering windows without DisplayServer.screen_get_scale() results in incorrect positioning on HiDPI displays.
• NEVER skip a borderless window option — Exclusive fullscreen can break multi-monitor focus. Offer WINDOW_MODE_FULLSCREEN (borderless).

Input & Persistence

• NEVER use keycode for movement rebinds — Use physical_keycode to ensure WASD works correctly across international keyboard layouts (AZERTY/Dvorak).
• NEVER save settings or user data to res:// — Filesystem is read-only in exported releases. Always use user://.
• NEVER skip NOTIFICATION_WM_CLOSE_REQUEST — Failing to handle quit signals causes data loss. Intercept and flush and ConfigFile data before get_tree().quit().