# godot-platform-desktop

Скилл для ИИ-агента, который ведёт вас через настройки окна, ребинд клавиш и интеграцию со Steam в Godot. Пригодится, когда игра выходит на Windows, Linux или macOS.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 372 установки · ★ 893
- Автор: thedivergentai
- Лицензия: LGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-platform-desktop/SKILL.md
- Обновлён: 2026-10-16
- HTML: https://affpapa.org/nevibecode/skills/godot-platform-desktop

## Что делает

Скилл описывает, как правильно устроить десктопную часть игры на Godot: меню настроек, управление окном, переназначение клавиш, работу с магазинами вроде Steam и Epic. Внутри — набор готовых скриптов, которые агент читает перед тем, как что-то писать. Среди них `desktop_window_manager.gd` для позиционирования окна с учётом DPI и нескольких мониторов, `desktop_settings_persistent.gd` для хранения настроек через `ConfigFile`, `physical_input_rebinder.gd` для ребинда по `physical_keycode` и `platform_sdk_wrapper.gd` для безопасных вызовов Steamworks и Epic.

Порядок работы задан жёстко: сначала окно и DPI, потом настройки, потом ребинд, потом перехват закрытия окна, и только затем обращения к SDK магазина. Настройки и данные пользователя скилл требует писать в `user://`, потому что `res://` в собранной игре доступен только для чтения. Для движения используется `physical_keycode`, иначе на AZERTY или Dvorak раскладках ребинд развалится. Вызовы Steam и Epic оборачиваются в проверку `Engine.has_singleton()`, чтобы игра не падала без установленного оверлея.

Есть и мелкие ловушки, о которых легко забыть. При потере фокуса окна (Alt-Tab) скилл советует снимать зажатые действия через `Input.action_release`, иначе персонаж продолжит бежать после возврата. Перед выходом нужно перехватить `NOTIFICATION_WM_CLOSE_REQUEST` и успеть записать `ConfigFile`. Скилл рассчитан на Godot 4 и требует, чтобы агент сначала прочитал нужный скрипт, а не писал код по памяти.

## Требования
- Работает с: Godot

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-platform-desktop -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/godot-platform-desktop/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/godot-platform-desktop/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-platform-desktop -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/godot-platform-desktop/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-platform-desktop -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/godot-platform-desktop/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install thedivergentai/Game-Dev-Agentic-Skills godot-platform-desktop
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/godot-platform-desktop/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-platform-desktop -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-platform-desktop
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/godot-platform-desktop/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-platform-desktop -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-platform-desktop/SKILL.md

## Когда брать
- сделать меню настроек с разрешением, режимом окна и громкостью
- переназначить клавиши так, чтобы WASD работал на AZERTY и Dvorak
- сохранить настройки между запусками в `user://`
- подключить Steamworks или Epic без падений на сборках без SDK
- корректно закрыть игру по Alt+F4, не потеряв настройки

## Примеры запросов агенту
- Добавь меню настроек с выбором разрешения и режима окна, используй скрипты из скилла godot-platform-desktop
- Сделай ребинд управления через physical_keycode, чтобы раскладка не ломала движение
- Оберни вызовы Steam в Engine.has_singleton и добавь заглушку для сборок без SDK

## Похожие
- [spritecook-use-assets-in-godot](https://affpapa.org/nevibecode/skills/spritecook-use-assets-in-godot.md) — скилл · 555 установок
- [godot-gdscript](https://affpapa.org/nevibecode/skills/godot-gdscript.md) — скилл · 6500 установок
- [godot-shaders](https://affpapa.org/nevibecode/skills/godot-shaders.md) — скилл · 6500 установок
- [godot-asset-generator](https://affpapa.org/nevibecode/skills/godot-asset-generator.md) — скилл · 1000 установок
- [godot-mcp-enhanced](https://affpapa.org/nevibecode/mcp/godot-mcp-enhanced.md) — MCP-сервер · ★ 103

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md