# godot-adapt-desktop-to-mobile

A skill for porting desktop Godot games to mobile: touch controls, UI scaling for small screens, battery saving.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 349 installs · ★ 893
- Author: thedivergentai
- License: LGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-adapt-desktop-to-mobile/SKILL.md
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/skills/godot-adapt-desktop-to-mobile

## What it does

This skill covers moving a desktop Godot game onto mobile platforms. It ships GDScript files: a dynamic joystick that spawns where the finger lands on the left half of the screen, swipe and pinch detection, a UI adapter for small screens, resolution scaling, a battery saver mode, and an on-screen keyboard handler. Separate scripts handle safe-area padding for notches, one-finger pan with two-finger pinch on a Camera2D, haptic feedback, and stripping heavy shading on weak mobile renderers.

The port order is spelled out. Replace hover, right-click and scroll wheel with touch equivalents first. Then set up safe areas and the UI adapter for 44–48dp targets, keeping critical HUD above the fingers. After that, hook battery saver and offline save on pause and resume. Each step asks you to read the matching script before implementing it, so pasting joystick or gesture tutorials inline is not the way. A deeper recipe file exists, and it is not meant for a first-pass control remap.

The skill targets Godot 4: it leans on `InputEventScreenTouch`, `InputEventScreenDrag`, `DisplayServer.get_display_safe_area()` and `NOTIFICATION_APPLICATION_PAUSED`. On a Godot 3 project those calls need rewriting by hand. Deep Android and iOS IAP or permission work lives in a separate skill, `godot-platform-mobile`, and the advice is to load it only once the control, UI and performance gates pass.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-desktop-to-mobile -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/godot-adapt-desktop-to-mobile/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/godot-adapt-desktop-to-mobile/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-desktop-to-mobile -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/godot-adapt-desktop-to-mobile/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-desktop-to-mobile -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/godot-adapt-desktop-to-mobile/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

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

2. **Manually: put the files in place**
- File: `.github/skills/godot-adapt-desktop-to-mobile/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-desktop-to-mobile -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-adapt-desktop-to-mobile
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/godot-adapt-desktop-to-mobile/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-desktop-to-mobile -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-adapt-desktop-to-mobile/SKILL.md

## When to use it
- replace mouse hover and right-click with touch input
- add a virtual joystick on the left half of the screen
- detect swipes and pinches through signals
- rescale the HUD for 44–48dp targets and thumb reach
- drop FPS and save the game when it is backgrounded

## Example prompts
- read the godot-adapt-desktop-to-mobile skill and add a virtual joystick for my platformer
- port my game's controls to touch using the skill checklist
- set up safe areas and UI scaling for mobile screens

## Similar
- [godot-gdscript](https://affpapa.org/en/nevibecode/skills/godot-gdscript.md) — skill · 6500 installs
- [godot-physics](https://affpapa.org/en/nevibecode/skills/godot-physics.md) — skill · 6300 installs
- [godot-mcp-enhanced](https://affpapa.org/en/nevibecode/mcp/godot-mcp-enhanced.md) — MCP server · ★ 103
- [godot](https://affpapa.org/en/nevibecode/rules/godot.md) — rule · ★ 3579
- [godot-ui](https://affpapa.org/en/nevibecode/skills/godot-ui.md) — skill · 2700 installs
- [godot-asset-generator](https://affpapa.org/en/nevibecode/skills/godot-asset-generator.md) — skill · 1000 installs

From the same set: [thedivergentai/game-dev-agentic-skills](https://affpapa.org/en/nevibecode/by/thedivergentai/game-dev-agentic-skills.md) — 51 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md