Godot Physics
/godot-physics
Use Godot 4.7 physics bodies and detection in 2D and 3D: RigidBody, StaticBody, Area, and CharacterBody; collision layers vs masks; contact/overlap signals; and raycasts (RayCast nodes and direct space-state queries).
- GitHub stars
- 2,085 (repository stars as of 2026-10-21)
- License
- Apache-2.0
- Last commit
- 2026/10/09
- By
- gamedev-skills
Part of
Awesome Gamedev Agent Skills
74 portable SKILL.md skills for Godot, Unity, Unreal, Phaser, PixiJS, three.js, Bevy, pygame, LÖVE and Roblox, with a router.
Listed from the author's README. GameSkill has not run this end to end yet. Agent support and install steps are as documented by the author.
Install
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill godot-physicsInstalls only this skill. Add -a claude-code (puts it in .claude/skills/), -a codex or -a cursor (.agents/skills/) to choose the agent, and -g to install it for your user instead of the project.
Commands are copied from the project's README. Check the repository before running anything on your machine.
Install for a specific agent
| Agents | -a | Folder |
|---|---|---|
| Claude Code | claude-code | .claude/skills/ |
| Codex | codex | .agents/skills/ |
| Cursor | cursor | .agents/skills/ |
| Gemini CLI | gemini-cli | .agents/skills/ |
| GitHub Copilot | github-copilot | .agents/skills/ |
| OpenCode | opencode | .agents/skills/ |
| Windsurf | windsurf | .windsurf/skills/ |
Add -a <flag> to the command. These are project folders; add -g to install for your user account instead.
What you get
- Worked steps: Collision layers vs masks; Area2D as a trigger / hurtbox; Applying force and impulse to a RigidBody3D; Raycast two ways
- A pitfalls section with the mistakes to avoid
- Bundled 1 reference doc the agent reads when needed
- Written for Godot 4.7
Good fit
- Configuring collision layers/masks, detecting overlaps with Area2D/Area3D, applying forces to a RigidBody
- Casting rays in a Godot project (.tscn with physics bodies), including 3D projects running Jolt Physics, the default 3D engine for projects created in 4.6+
Try this prompt
Set up collision layers, an Area2D hurtbox and a raycast for line of sight.About this skill
Use Godot 4.7 physics bodies and detection in 2D and 3D: RigidBody, StaticBody, Area, and CharacterBody; collision layers vs masks; contact/overlap signals; and raycasts (RayCast nodes and direct space-state queries). Use when configuring collision layers/masks, detecting overlaps with Area2D/Area3D, applying forces to a RigidBody, or casting rays in a Godot project (.tscn with physics bodies), including 3D projects running Jolt Physics, the default 3D engine for projects created in 4.6+.
From the godot-physics SKILL.md in gamedev-skills/awesome-gamedev-agent-skills.
What's inside
- Collision layers vs masks (set from code)
- Area2D as a trigger / hurtbox
- Applying force and impulse to a RigidBody3D
- Raycast two ways
- Jolt Physics (3D) differences
Requirements
- Godot 4.7
FAQ
Works well with
Skills the author points to as related or as the better fit for neighbouring tasks.
Godot 2D Movement
2D character movement in Godot 4.7 with CharacterBody2D: platformer jumping, top-down motion, slopes and reading collisions.
Godot TileMap
Tile-based 2D levels in Godot 4.7 with TileMapLayer: collision and navigation on tiles, terrain autotiling and editing cells from code.
Game Physics Tuning
Stable, good-feeling physics: fixed timestep with interpolation, mass and drag, CCD against tunneling, jitter fixes and collision layers.
Godot 3D Essentials
Set up 3D scenes in Godot 4.7: transforms, cameras, lights, WorldEnvironment, materials and GridMap levels.
More from Awesome Gamedev Agent Skills
See all 412D Platformer
Build a 2D platformer: run/jump control with coyote time, jump buffering, and variable jump height, plus tiled levels and hazards.
Behavior Trees & Utility AI
Build a behavior-tree runtime and a Utility AI system with response curves, plus hybrid agents where the behavior tree drives utility scoring.
Bevy ECS
Structure a Bevy app around ECS: plugins, components and resources, systems with Query and Commands, system ordering and Time.
Card Game
Build a card game: card data, deck/hand/discard zones, draw/shuffle/reshuffle, a turn structure, costs, and effect resolution.
Similar skills
Claude Code Game Studios
Turns Claude Code into a full game studio: 49 agents and 72 workflow skills arranged like a real studio hierarchy.
Godogen
Autonomous game development with Claude Code and Codex. Publishes a ready game repo for Godot, Bevy, Babylon.js or three.js.
Godot MCP (Coding-Solo)
MCP server for Godot: launch the editor, run projects, capture debug output and edit scenes.
Godot AI
Production-grade MCP server and editor plugin for Godot 4.7+: 46 tools and 120+ operations for scenes, nodes, scripts, UI and more.