@ignifx/physics 0.6.1 → 0.8.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 +64 -9
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +160 -50
- package/dist/index.js.map +1 -1
- package/package.json +4 -4
- package/skills/physics/SKILL.md +12 -3
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ignifx/physics",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.8.0",
|
|
4
4
|
"description": "ignifx 3D physics on Havok through Babylon Lite: rigidbodies, colliders, triggers, character controller, queries.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"ignifx",
|
|
@@ -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.8.0",
|
|
49
|
+
"@ignifx/terrain": "0.8.0"
|
|
50
50
|
},
|
|
51
51
|
"peerDependencies": {
|
|
52
52
|
"@babylonjs/havok": "^1.3.14",
|
|
53
53
|
"@babylonjs/lite": "1.27.0",
|
|
54
|
-
"@ignifx/core": "0.
|
|
54
|
+
"@ignifx/core": "0.8.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.8.0"
|
|
7
7
|
---
|
|
8
8
|
|
|
9
9
|
# @ignifx/physics
|
|
@@ -21,7 +21,7 @@ through, or has to be asked "what is under the crosshair".
|
|
|
21
21
|
|
|
22
22
|
## Environment
|
|
23
23
|
|
|
24
|
-
- Engine: ignifx `0.
|
|
24
|
+
- Engine: ignifx `0.8.0`; this package targets `@ignifx/core` `>=0.0.0 <1.0.0`.
|
|
25
25
|
- Peer dependencies: `@babylonjs/lite` (exactly `1.27.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
|
|
@@ -113,6 +113,11 @@ app.log.info("crate at y:", crate.transform.position.y);
|
|
|
113
113
|
Every query needs at least one completed fixed step — Havok builds its broadphase there — and
|
|
114
114
|
reports `IGX-0902` before that.
|
|
115
115
|
|
|
116
|
+
Queries hit `Rigidbody` bodies, collider-only statics, and `CharacterController` capsules. A capsule
|
|
117
|
+
hit names the character's entity with `collider: null`. A ray whose `layerMask` leaves out the
|
|
118
|
+
character's layer passes through the capsule; a `shapeCast` still stops on it, because a sweep
|
|
119
|
+
cannot be layer-filtered, and reports `entity: null` — use `options.ignore` to sweep through it.
|
|
120
|
+
|
|
116
121
|
### `Rigidbody`
|
|
117
122
|
|
|
118
123
|
| Field / member | Default | Meaning |
|
|
@@ -144,7 +149,11 @@ entity's lossy scale when the shape is built; changing the scale afterwards need
|
|
|
144
149
|
`move(displacement)` from `fixedUpdate` (displacements accumulate), then read `isGrounded`,
|
|
145
150
|
`supportState`, `groundNormal`, and `velocity`. `setHeight(h, preserveFeet?)` crouches,
|
|
146
151
|
`teleport(position)` relocates, and `onCollided` reports every dynamic body the capsule pushed.
|
|
147
|
-
Gravity is **not** applied for you — a bare controller is purely kinematic.
|
|
152
|
+
Gravity is **not** applied for you — a bare controller is purely kinematic. `isGrounded` is true
|
|
153
|
+
on any surface up to `slopeLimit`, a `HeightfieldCollider` included; steeper reads
|
|
154
|
+
`supportState === "sliding"`. A controller pressed into an incline creeps down it (Lite's
|
|
155
|
+
character controller has no static friction), so cancel the down-slope part of a small ground-stick
|
|
156
|
+
push yourself, as `ThirdPersonController` does.
|
|
148
157
|
|
|
149
158
|
## Recipes
|
|
150
159
|
|