godot-adapt-2d-to-3d — Claude Code skill: what it does, how to install
godot-adapt-2d-to-3d migrates Godot games from 2D to 3D. It handles node mapping, SpringArm3D camera rigs, physics layers, and camera-relative movement.
LGPL-3.0 342 installs ★ 983 updated 2026-10-16
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-2d-to-3d -a claude-codeWhat godot-adapt-2d-to-3d does
This skill guides the agent through transitioning Godot projects into three dimensions. It maps classic 2D nodes to their 3D counterparts, substituting CharacterBody2D with CharacterBody3D, replacing Camera2D with a SpringArm3D and Camera3D hierarchy, and adjusting shape resources for static bodies.
Included helper scripts handle vector conversion, billboard Sprite3D setups, projected UI, and camera-relative motion across the XZ plane. A direct conversion of Vector2 into Vector3(x, y, 0) is forbidden because it lacks gameplay depth. 3D physics requires separate layer settings, unlit scenes render black without lights, and raw camera parenting causes visual stutter.
What it helps with
- convert CharacterBody2D and Area2D scenes into 3D equivalents
- build a third-person camera using SpringArm3D and Camera3D
- rebuild collision layer bitmasks for 3D physics
- calculate camera-relative movement vectors across the XZ plane
- set up 2.5D billboard sprites using Sprite3D or QuadMesh
Example prompts for the agent
- Convert my CharacterBody2D movement script to camera-relative CharacterBody3D
- Help me reconfigure physics layers for 3D nodes
- Set up a Sprite3D billboard that faces the camera
How to install godot-adapt-2d-to-3d
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-2d-to-3d -a claude-code2Manually: put the files in place
~/.claude/skills/godot-adapt-2d-to-3d/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-adapt-2d-to-3d/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-2d-to-3d -a codex2Manually: put the files in place
.agents/skills/godot-adapt-2d-to-3d/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-2d-to-3d -a cursor2Manually: put the files in place
.cursor/skills/godot-adapt-2d-to-3d/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-adapt-2d-to-3d2Manually: put the files in place
.github/skills/godot-adapt-2d-to-3d/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-2d-to-3d -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-adapt-2d-to-3dManually: put the files in place
.devin/skills/godot-adapt-2d-to-3d/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-2d-to-3d -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about godot-adapt-2d-to-3d
How to install godot-adapt-2d-to-3d in Claude Code?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-2d-to-3d -a claude-code. The skill will be saved to ~/.claude/skills/godot-adapt-2d-to-3d/SKILL.md.
What does godot-adapt-2d-to-3d do?
It gives coding agents structured workflows and scripts for converting 2D Godot scenes, physics, cameras, and sprites into functional 3D systems.
Why does the skill require a SpringArm3D setup?
Barely attaching a Camera3D to a moving player causes clipping issues and camera jitter during physics updates.