Skip to content
SkillModel-led2,964 tokens in use

physics-tuning

Fixes jittery motion, tunnelling and floaty physics with a fixed timestep, interpolation, CCD, damping and a named collision layer matrix, proved by headless Godot tests.

9,682 stars on the repository Apache License 2.0gamedev-skills/awesome-gamedev-agent-skills · skills/disciplines/physics-tuning
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 physics-tuning costs

89tokens idle
2,964tokens in use
4,416tokens, 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
  • Structure25/25
  • Examples12/15
  • Output5/15
  • Size15/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

Physics Tuning is an engine-neutral skill for the settings behind bad-feeling physics. It covers the fixed simulation step versus the render frame, interpolation, continuous collision detection, mass, damping, restitution, solver iterations, sleeping and the collision layer matrix, with Godot and Unity mappings.

The agent reads the project’s current physics settings first, changes one knob at a time, and proves the result with a tunnelling test and a frame-rate probe that run headless. It then asks you to judge feel with specific questions.

What You Get

  • A fixed-step versus render-frame split for forces, velocities and collision reads
  • Interpolation set up with the engine’s built-in option before any hand-rolled version
  • A CCD or speed-cap choice for small fast bodies, with a tunnel test that exits 1 on failure
  • A named collision layer table written into both code and the engine’s layer names
  • A frame-rate independence probe that prints a position at two frame rates
  • A gotchas list covering stacks, joints, sleeping, teleports and tick-rate changes

Common Use Cases

  • Bullets or fast projectiles pass through thin walls
  • A character or camera jitters even though the physics step is fixed
  • A stack of crates explodes or joints shake
  • Movement speed changes with the player’s frame rate

What Makes It Unique

Most physics skills document one engine’s API. This one owns the engine-neutral decisions and the checks that prove them: a headless tunnel test, a rate probe and a layer matrix as data. It records results from real test runs, such as the Godot 2D ray CCD mode stopping tunnelling where the shape mode did not, and points to the engine skills for API details.

Under The Hood

The skill is a SKILL.md with one reference file on timestep and CCD. The agent reads project settings files such as project.godot and Unity’s time and dynamics settings, edits game code and writes small test scripts under a tools folder. It runs the engine headless from the command line, for example Godot with a script argument, to execute the tunnel test and the rate probe. It does not fetch web pages or call outside services.

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