Skip to content
SkillModel-led2,852 tokens in use

godot-physics

Guides an agent through Godot 4.7 physics in 2D and 3D: body types, collision layers and masks, Area signals, raycasts and Jolt differences.

9,684 stars on the repository Apache License 2.0gamedev-skills/awesome-gamedev-agent-skills · skills/godot/godot-physics
npx skills add gamedev-skills/awesome-gamedev-agent-skills
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing godot-physics costs

105tokens idle
2,852tokens in use
3,980tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

Nothing detected: no shell, network, file writes, git or credentials in its files.

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter12/15
  • Structure22/25
  • Examples12/15
  • Output10/15
  • Size13/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent

No findings.

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity92
  • Maintenance96
  • Community60
  • Maturity24
  • Momentum40

This skill helps an agent get Godot 4.7 physics right: picking a body type, wiring collision layers and masks, detecting overlaps with Area nodes, casting rays and knowing where the Jolt 3D engine behaves differently. It starts by reading project.godot to see which 3D engine runs.

It includes patterns for a safe RigidBody teleport, a one-shot ray that skips the caster and a headless test that proves a hurtbox sees a body. A gotcha list covers layer versus mask confusion, signals that never fire and fast objects that tunnel.

What You Get

  • A core workflow from reading the physics engine setting in project.godot to choosing bodies, layers, masks, Area signals and rays
  • GDScript patterns for a RigidBody impulse and safe teleport, a one-shot ray that excludes the caster, and a headless Area overlap test
  • A gotcha list for layer versus mask confusion, missing body_entered signals, empty overlap lists after spawn, stale raycasts and tunnelling
  • A list of Jolt differences, including ray face indices, joint limits, kinematic contacts and the world boundary plane sign change in 4.7

Common Use Cases

  • Debugging objects that pass through each other
  • Finding out why body_entered or area_entered never fires
  • Building a hurtbox or pickup trigger with Area nodes
  • Fixing a raycast that hits the object casting it

What Makes It Unique

The skill reads which 3D physics engine the project uses before any debugging, because Jolt and GodotPhysics3D differ in joints, ray results and contacts. It proves behaviour with a headless test runner and an exit code, and hands off movement, tile collision and engine-neutral tuning to sibling skills.

Under The Hood

The agent loads the SKILL.md and, when needed, a reference on body types, shape queries and joints. It reads project.godot and scene files, writes small GDScript test files into your project, and runs the Godot binary headless on them, then reads the exit code and log. If you edited scene files by hand it also runs the Python project checker from a sibling skill. It fetches no web pages and calls no APIs; if there is no Godot binary it asks you to run the command and paste the output.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers