glint_box3d

The high-performance Box3D backend for Glint's general-purpose physics API. It provides real angular rigid bodies, CCD, sleeping, compound and cooked colliders, five joint families, collision/trigger events, spatial queries, fixed-step interpolation, and query filters that can exclude individual bodies. Glint's backend-neutral snapshots, replay verification, and stress runner work with this backend without Box3D-specific gameplay code. Shape casts honor body, trigger, and body-type exclusions even though the underlying single-hit native query cannot skip a rejected first hit.

await GlintBox3dWorld.ensureInitialized();
final world = GlintBox3dWorld(fixedTimeStep: 1 / 120);
final body = world.createBody(
  const GlintRigidBodyConfig(position: Vector3(0, 3, 0)),
);
body.addCollider(
  const GlintBoxCollider(Vector3(.5, .5, .5)),
  material: const GlintPhysicsMaterial(density: 100),
);

GlintRaycastVehicle lives in glint_engine, consumes only the portable contract, and is optional. The same is true of GlintCharacterController and GlintRagdoll; the backend itself is suitable for any 3D game or interactive simulation.

Stress benchmark

flutter test benchmark/physics_stress_test.dart --reporter expanded

The default seeded run exercises 512 dynamic bodies, two complete vehicles, 4,800 queries, dense contacts, sleeping, and state-digest generation. Override the workload with --dart-define=GLINT_STRESS_BODIES=... and the related defines documented in the root README.