GS - Physics

GS - Physics

Uses AI
MIT

A Godot asset for handling physics.

Named collision layers and named physics settings for Godot, so you stop writing 1 << 3 | 1 << 7 and stop hunting through ProjectSettings for solver numbers.

  • Layouts give each collision layer a name and declare who collides with whom once.
  • Profiles are physics settings (tick rate, gravity, solver iterations) named for how they feel. A dedicated server can switch profile from the command line.
  • Surfaces map a collider to a material (friction, restitution, impact sound), so a ray hit can tell you it hit concrete.

The addon only decides what Godot is told. Godot still does the simulation.

Install

  1. Copy addons/dot_physics/ and addons/dot_core/ into your project.
  2. Enable both in Project > Project Settings > Plugins.

Needs Godot 4.7 or newer.

Use

var physics := DotPhysicsWorld.new()
physics.profile  = DotPhysicsProfile.arcade_shooter()
physics.layout   = DotPhysicsLayout.shooter_3d()
physics.surfaces = DotPhysicsSurfaceSet.standard()
add_child(physics)

var res := physics.setup()
if not res.ok:
    push_error(res.error.message)

physics.classify(player_body, &"player")   # layer and mask, by name
var hit := physics.query().shot_3d(world, muzzle, muzzle + dir * 100.0)
if not hit.is_empty():
    var surface: DotPhysicsSurface = hit["surface"]
    audio.play(surface.impact_sound)

DotPhysicsWorld remembers every setting it changed and restores them when it leaves the tree. A server that switches between two games therefore never keeps the first game's gravity.

Layouts

Layout What it is
shooter_3d Named layers for a first-person shooter, including player and NPC clip volumes, debris that touches only the world, and a query-only hitbox layer for lag-compensated hit registration.
sandbox_3d The shooter layout plus held_prop and frozen_prop. A held prop does not push the player holding it.
platformer_2d Side-on. One-way platforms have their own layer.
top_down_2d No gravity, many bodies, players pass through each other.
DotPhysicsLayout.custom() Your own layer list.

Each layout declares a collision relation once ("debris collides with world") and build() makes it symmetric. An unknown layer name is an error at build time, not silently ignored.

Profiles

Profile Feel
arcade_shooter 128 Hz, gravity 20, no interpolation, characters are not pushed by bodies.
grounded 64 Hz, gravity 12, 16 solver iterations, interpolation on.
sandbox 24 solver iterations so crate stacks hold, aggressive sleeping so many settled props are cheap.
floaty_platformer Long jumps, generous slopes.
top_down No gravity.

These numbers are the defaults of each profile, not limits. Every profile is a DotConfig, so values can be overridden in layers: defaults, then a JSON file, then environment variables, then the command line, for example --physics-tick-rate 128.

Surfaces

DotPhysicsSurfaceSet.standard() has 11 materials with friction, restitution, density, sheet thickness, movement multipliers and sound/effect ids. for_collider() looks a surface up from node metadata, then groups, then the node name (a best guess, for mapper-built levels).

This is not dot-player-controller's surface table. That one scales player movement; this one tells the solver about rigid bodies.

More

Status and licence

Part of the TMC dot-* family of Godot addons. Written with Claude Code and maintained by gamemann. Every addon has headless tests, but little of this has been played by real users yet, so expect rough edges and please open an issue when you hit one.

MIT licence, see LICENSE. The only closed part of the TMC platform is the web back end; you can use your own instead of TMC's.

Engagement Over Time

Loading…
Step

GS - Physics is a Godot asset. It has 1 download, 45 views, and 0 favorites. This item belongs to 1 collection and 2 tags.

Reviews

Log in to leave a review.

Loading…

Comments (0)

Log in to comment.

Loading…

Discover more

See what the community is up to