godot-adapt-3d-to-2d — Godot skill for 3D to 2D ports
godot-adapt-3d-to-2d is a Claude Code skill with patterns for adapting Godot 3D games to 2D, including fake depth, isometric math, physics swaps, and model-to-sprite baking.
LGPL-3.0 327 installs ★ 983 updated 2026-10-16
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-3d-to-2d -a claude-codeWhat godot-adapt-3d-to-2d does
This skill handles the rough edges of moving a Godot project from 3D to 2D. It ships scripts for simulated Z-height, isometric projections, Y-sort ownership, fake shadows, and multi-angle sprite baking.
The core rule: never flatten the Z-axis without gameplay compensation. Swapping CharacterBody3D for CharacterBody2D alone throws away spatial strategy, so the skill pushes layers, jump height variation, and similar depth mechanics instead.
For 2.5D scenes, four scripts are mandatory: ortho_simulation.gd, jump_z_axis_sim.gd, hitbox_depth_manager.gd, and depth_sorting_y_sort.gd. Skip them and gravity scaling plus ground-versus-air collisions will misbehave.
What it helps with
- convert CharacterBody3D to CharacterBody2D without losing gameplay
- build a 2.5D scene with fake depth and proper Y-sort
- set up isometric math without 2D node transforms
- separate ground and air hits in Area2D
- bake GLB models into multi-angle sprites
Example prompts for the agent
- Port my Godot project from 3D to 2.5D with fake depth using this skill's scripts
- Set up isometric projection through
isometric_math_core.gd - Convert my GLB models to sprites with
model_to_sprite_bake.gd
How to install godot-adapt-3d-to-2d
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-3d-to-2d -a claude-code2Manually: put the files in place
~/.claude/skills/godot-adapt-3d-to-2d/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/godot-adapt-3d-to-2d/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-3d-to-2d -a codex2Manually: put the files in place
.agents/skills/godot-adapt-3d-to-2d/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-3d-to-2d -a cursor2Manually: put the files in place
.cursor/skills/godot-adapt-3d-to-2d/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-adapt-3d-to-2d2Manually: put the files in place
.github/skills/godot-adapt-3d-to-2d/SKILL.md1Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-3d-to-2d -a gemini-cli2Platform CLI
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-adapt-3d-to-2dManually: put the files in place
.devin/skills/godot-adapt-3d-to-2d/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-3d-to-2d -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-3d-to-2d
How do I install godot-adapt-3d-to-2d in Claude Code?
Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-3d-to-2d -a claude-code. The skill lands at ~/.claude/skills/godot-adapt-3d-to-2d/SKILL.md.
What does godot-adapt-3d-to-2d do?
It gives you patterns and scripts for porting Godot 3D games to 2D: height simulation, isometric projections, fake depth, physics conversion, and model-to-sprite baking.
Why not just use an orthographic Camera3D as a 2D mode?
You still pay for 3D transforms and lighting, and you lose CanvasItem batching. The skill recommends Camera2D plus 2D nodes, with ortho_simulation.gd reserved for simulated height only.