@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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ignifx/physics",
3
- "version": "0.6.1",
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.6.1",
49
- "@ignifx/terrain": "0.6.1"
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.6.1"
54
+ "@ignifx/core": "0.8.0"
55
55
  },
56
56
  "ignifx": {
57
57
  "extension": true,
@@ -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.1"
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.6.1`; this package targets `@ignifx/core` `>=0.0.0 <1.0.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