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.