Physics 3D (Bullet3)
Os componentes de corpo rígido e o mundo Bullet3 existem, mas nenhum sistema de play mode os avança: a página regista a fatia implementada e o que falta.
Ficheiros:
src/caffeine/physics/PhysicsComponents3D.hpp,PhysicsWorld3D.cpp,PhysicsSystem3D.hppEstado: componentes + backend Bullet implementados; integração no runtime planeada
O ECS não inclui headers do Bullet. RigidBody3D e Collider3D são PODs serializáveis. Os
btRigidBody vivem em PhysicsWorld3D, indexados pelo id da entidade.
Componentes#
| Componente | Campos |
|---|---|
RigidBody3D |
mass, damping linear/angular, friction, restitution, bodyType (Dynamic / Kinematic / Static), lockRotation |
Collider3D |
Box (half extents), Sphere (halfExtents.x = raio), Capsule (x raio, y altura total), offset, isTrigger |
Ambos são necessários para um corpo. No Doppio: Add Component → Physics 3D. Os componentes são refletidos (ids 8 e 9) e serializados no blob da cena, por isso sobrevivem a save/load.
Estado da integração#
O PhysicsSystem3D é um ECS::ISystem normal que faz upsert dos corpos, chama
PhysicsWorld3D::step e escreve os resultados em Position3D, Transform, Rotation3D e
WorldTransform. Ninguém o registra ainda: nem o play mode do Doppio nem o caffeine-runtime
criam um sistema de física 3D, pelo que editar um RigidBody3D no Inspector não simula.
| Peça | Estado |
|---|---|
| Componentes, reflexão, serialização | Implementado |
Mundo Bullet3 (upsertBody, step, stateOf) |
Implementado |
Driver ECS PhysicsSystem3D |
Implementado, não registado |
| Tick em play mode, debug draw, joints, colliders de heightfield/mesh | Não implementado |
Política#
- Gravidade por defeito:
(0, -9.81, 0). - Corpos dinâmicos: a física escreve
Position3D,TransformeRotation3D. - Corpos estáticos e cinemáticos: a pose do ECS é empurrada para o Bullet a cada passo.
Scale3D/Transform.scaleentram no tamanho do collider.PhysicsWorld3D::stepusastepSimulation(dt, 4, 1/60)do Bullet — no máximo 4 substeps de 1/60 s.
Build: CAFFEINE_ENABLE_BULLET3=ON (default). Sem a flag, PhysicsWorld3D::isAvailable()
devolve false e o sistema é no-op.