@ignifx/physics 0.8.0 → 0.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +18 -33
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +23 -160
- package/dist/index.js.map +1 -1
- package/package.json +6 -6
- package/skills/physics/SKILL.md +10 -9
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ignifx/physics",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.10.0",
|
|
4
4
|
"description": "ignifx 3D physics on Havok through Babylon Lite: rigidbodies, colliders, triggers, character controller, queries.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"ignifx",
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
"devDependencies": {
|
|
35
35
|
"@arethetypeswrong/cli": "^0.18.5",
|
|
36
36
|
"@babylonjs/havok": "^1.3.14",
|
|
37
|
-
"@babylonjs/lite": "1.
|
|
37
|
+
"@babylonjs/lite": "1.34.0",
|
|
38
38
|
"@microsoft/api-extractor": "^7.59.0",
|
|
39
39
|
"@types/node": "^24.13.3",
|
|
40
40
|
"@types/webxr": "^0.5.0",
|
|
@@ -45,13 +45,13 @@
|
|
|
45
45
|
"typedoc-plugin-markdown": "^4.13.0",
|
|
46
46
|
"typescript-native": "npm:typescript@7.0.2",
|
|
47
47
|
"vitest": "^5.0.0",
|
|
48
|
-
"@ignifx/core": "0.
|
|
49
|
-
"@ignifx/terrain": "0.
|
|
48
|
+
"@ignifx/core": "0.10.0",
|
|
49
|
+
"@ignifx/terrain": "0.10.0"
|
|
50
50
|
},
|
|
51
51
|
"peerDependencies": {
|
|
52
52
|
"@babylonjs/havok": "^1.3.14",
|
|
53
|
-
"@babylonjs/lite": "1.
|
|
54
|
-
"@ignifx/core": "0.
|
|
53
|
+
"@babylonjs/lite": "1.34.0",
|
|
54
|
+
"@ignifx/core": "0.10.0"
|
|
55
55
|
},
|
|
56
56
|
"ignifx": {
|
|
57
57
|
"extension": true,
|
package/skills/physics/SKILL.md
CHANGED
|
@@ -3,7 +3,7 @@ name: physics
|
|
|
3
3
|
description: Adds 3D physics to an ignifx game with @ignifx/physics: Havok simulation on a separate headless scene, Rigidbody, box/sphere/capsule/mesh colliders, physics materials, triggers, CharacterController, raycasts and shape queries, the collision layer matrix, and render interpolation. Use when adding or editing 3D physics bodies, colliders, triggers, character movement, or physics queries in an ignifx project, or when the user mentions @ignifx/physics, Rigidbody, Havok, or collision layers.
|
|
4
4
|
license: Apache-2.0
|
|
5
5
|
metadata:
|
|
6
|
-
ignifx-version: "0.
|
|
6
|
+
ignifx-version: "0.10.0"
|
|
7
7
|
---
|
|
8
8
|
|
|
9
9
|
# @ignifx/physics
|
|
@@ -21,8 +21,8 @@ through, or has to be asked "what is under the crosshair".
|
|
|
21
21
|
|
|
22
22
|
## Environment
|
|
23
23
|
|
|
24
|
-
- Engine: ignifx `0.
|
|
25
|
-
- Peer dependencies: `@babylonjs/lite` (exactly `1.
|
|
24
|
+
- Engine: ignifx `0.10.0`; this package targets `@ignifx/core` `>=0.0.0 <1.0.0`.
|
|
25
|
+
- Peer dependencies: `@babylonjs/lite` (exactly `1.34.0`) and `@babylonjs/havok` (`^1.3.0`).
|
|
26
26
|
- Browsers, Electron, and Node. The Vite plugin copies `HavokPhysics.wasm` into the public asset
|
|
27
27
|
path, so the browser loads it from `assets/HavokPhysics.wasm`; under Node the extension reads the
|
|
28
28
|
binary out of the installed `@babylonjs/havok` package, so a headless test needs no setup.
|
|
@@ -234,10 +234,9 @@ collides with everything. Havok tests a pair in both directions, so one side ref
|
|
|
234
234
|
- **`MeshCollider` needs a GPU app.** Babylon Lite cannot build mesh or convex-hull shapes on the
|
|
235
235
|
null engine and a headless `MeshAsset` uploads no geometry, so a headless mesh collider reports
|
|
236
236
|
`IGX-0906`. Use a primitive collider in headless tests.
|
|
237
|
-
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
that recovers the identities.
|
|
237
|
+
- **A collision reaches only the two entities in the contact**, and each gets the other as
|
|
238
|
+
`collision.other`. `other` is `null` only when the other body is not an entity's, such as a
|
|
239
|
+
`CharacterController`'s capsule; use `CharacterController.onCollided` for what a character pushes.
|
|
241
240
|
- **Event objects are pooled.** `TriggerEvent` and `Collision` (and its `contacts`) are reused for
|
|
242
241
|
every event of a step: copy anything you keep past the callback.
|
|
243
242
|
- **Type the callback parameter, do not cast it.** Core declares `onTriggerEnter?(trigger: unknown)`
|
|
@@ -255,6 +254,9 @@ collides with everything. Havok tests a pair in both directions, so one side ref
|
|
|
255
254
|
of `Update`. That is deliberate: a follow camera in `lateUpdate` must frame the character where the
|
|
256
255
|
frame draws it, or the two judder against each other.
|
|
257
256
|
- **A resting body sleeps.** Changing `app.physics.gravity` does not wake it; apply an impulse.
|
|
257
|
+
- **In an edit-mode app (`createApp({ editMode: true })`) nothing simulates.** No fixed step runs, so
|
|
258
|
+
no body is built, nothing falls, interpolation never touches a transform, and a query throws
|
|
259
|
+
`IGX-0902` as it does before a game's first step. Draw collider gizmos from the component fields.
|
|
258
260
|
|
|
259
261
|
## Deprecated (current window)
|
|
260
262
|
|
|
@@ -263,5 +265,4 @@ None (pre-1.0: no deprecation window; breaking changes are listed in the changel
|
|
|
263
265
|
## Where to look next
|
|
264
266
|
|
|
265
267
|
`skills/ignifx/SKILL.md` for the engine entry skill · `skills/ignifx/references/api/physics.md` for
|
|
266
|
-
the generated API · `docs/architecture/09-physics.md` and ADR-0003
|
|
267
|
-
rationale.
|
|
268
|
+
the generated API · `docs/architecture/09-physics.md` and ADR-0003 for the design rationale.
|