react-three-game 0.0.51 → 0.0.52

package/dist/tools/prefabeditor/components/PhysicsComponent.d.ts

@@ -1,5 +1,7 @@
 import type { RigidBodyOptions } from "@react-three/rapier";
 import { Component } from "./ComponentRegistry";
-export type PhysicsProps = RigidBodyOptions;
+export type PhysicsProps = RigidBodyOptions & {
+    activeCollisionTypes?: 'all' | undefined;
+};
 declare const PhysicsComponent: Component;
 export default PhysicsComponent;

package/dist/tools/prefabeditor/components/PhysicsComponent.js

@@ -10,7 +10,7 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 import { jsx as _jsx } from "react/jsx-runtime";
-import { RigidBody } from "@react-three/rapier";
+import { RigidBody, useRapier } from "@react-three/rapier";
 import { useRef, useEffect, useCallback } from 'react';
 import { FieldRenderer } from "./Input";
 import { gameEvents, getEntityIdFromRigidBody } from "../GameEvents";
@@ -82,14 +82,24 @@ const physicsFields = [
         type: 'boolean',
         label: 'Sensor (Trigger Only)',
     },
+    {
+        name: 'activeCollisionTypes',
+        type: 'select',
+        label: 'Collision Detection',
+        options: [
+            { value: '', label: 'Default (Dynamic only)' },
+            { value: 'all', label: 'All (includes kinematic & fixed)' },
+        ],
+    },
 ];
 function PhysicsComponentEditor({ component, onUpdate }) {
     return (_jsx(FieldRenderer, { fields: physicsFields, values: component.properties, onChange: (props) => onUpdate(Object.assign(Object.assign({}, component), { properties: Object.assign(Object.assign({}, component.properties), props) })) }));
 }
 function PhysicsComponentView({ properties, children, position, rotation, scale, editMode, nodeId, registerRigidBodyRef }) {
-    const { type, colliders, sensor } = properties, otherProps = __rest(properties, ["type", "colliders", "sensor"]);
+    const { type, colliders, sensor, activeCollisionTypes } = properties, otherProps = __rest(properties, ["type", "colliders", "sensor", "activeCollisionTypes"]);
     const colliderType = colliders || (type === 'fixed' ? 'trimesh' : 'hull');
     const rigidBodyRef = useRef(null);
+    const { rapier } = useRapier();
     // Register RigidBody ref when it's available
     useEffect(() => {
         if (nodeId && registerRigidBodyRef && rigidBodyRef.current) {
@@ -101,6 +111,19 @@ function PhysicsComponentView({ properties, children, position, rotation, scale,
             }
         };
     }, [nodeId, registerRigidBodyRef]);
+    // Configure active collision types for kinematic/sensor bodies
+    useEffect(() => {
+        if (activeCollisionTypes === 'all' && rigidBodyRef.current) {
+            const rb = rigidBodyRef.current;
+            // Apply to all colliders on this rigid body
+            for (let i = 0; i < rb.numColliders(); i++) {
+                const collider = rb.collider(i);
+                collider.setActiveCollisionTypes(rapier.ActiveCollisionTypes.DEFAULT |
+                    rapier.ActiveCollisionTypes.KINEMATIC_FIXED |
+                    rapier.ActiveCollisionTypes.KINEMATIC_KINEMATIC);
+            }
+        }
+    }, [activeCollisionTypes, rapier, type, colliders]);
     // Event handlers for physics interactions
     const handleIntersectionEnter = useCallback((payload) => {
         if (!nodeId)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-three-game",
-  "version": "0.0.51",
+  "version": "0.0.52",
   "description": "Batteries included React Three Fiber game engine",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/react-three-game-skill/react-three-game/SKILL.md

@@ -22,7 +22,7 @@ Agents can programmatically generate 3D assets:
 ```tsx
 import { useRef, useEffect } from 'react';
 import { PrefabEditor, exportGLBData } from 'react-three-game';
-import type { PrefabEditorRef } from 'react-three-game';
+import type { PrefabEditorRef } from 'react-three-game'
 
 const jsonPrefab = {
   root: {
@@ -116,7 +116,7 @@ Scenes are defined as JSON prefabs with a root node containing children:
 | Transform | `Transform` | `position: [x,y,z]`, `rotation: [x,y,z]` (radians), `scale: [x,y,z]` |
 | Geometry | `Geometry` | `geometryType`: box/sphere/plane/cylinder, `args`: dimension array |
 | Material | `Material` | `color`, `texture?`, `metalness?`, `roughness?`, `repeat?`, `repeatCount?` |
-| Physics | `Physics` | `type`: dynamic/fixed/kinematicPosition/kinematicVelocity, `mass?`, `restitution?`, `friction?`, `linearDamping?`, `angularDamping?`, `gravityScale?`, plus any Rapier RigidBody props - [See advanced physics guide](./rules/ADVANCED_PHYSICS.md) |
+| Physics | `Physics` | `type`: dynamic/fixed/kinematicPosition/kinematicVelocity, `mass?`, `restitution?`, `friction?`, `linearDamping?`, `angularDamping?`, `gravityScale?`, `sensor?`, `activeCollisionTypes?: 'all'` (enable kinematic/fixed collision detection), plus any Rapier RigidBody props - [See advanced physics guide](./rules/ADVANCED_PHYSICS.md) |
 | Model | `Model` | `filename` (GLB/FBX path), `instanced?` for GPU batching |
 | SpotLight | `SpotLight` | `color`, `intensity`, `angle`, `penumbra`, `distance?`, `castShadow?` |
 | DirectionalLight | `DirectionalLight` | `color`, `intensity`, `castShadow?`, `targetOffset?: [x,y,z]` |
@@ -414,6 +414,8 @@ Physics components automatically emit these events:
 | `collision:enter` | A collision starts | `{ sourceEntityId, targetEntityId, targetRigidBody }` |
 | `collision:exit` | A collision ends | `{ sourceEntityId, targetEntityId, targetRigidBody }` |
 
+**Collision filtering**: By default, kinematic/fixed bodies don't detect each other. For kinematic sensors or projectiles to detect walls/floors, add `"activeCollisionTypes": "all"` to the Physics properties.
+
 See [Advanced Physics](./rules/ADVANCED_PHYSICS.md) for sensor setup and collision handling patterns.
 
 ### TypeScript: Typed Custom Events

package/react-three-game-skill/react-three-game/rules/ADVANCED_PHYSICS.md

@@ -49,7 +49,8 @@ Complete reference for `Physics` component properties:
 | `enabledTranslations` | `[bool, bool, bool]` | `[true, true, true]` | Lock per axis (X, Y, Z) |
 | `enabledRotations` | `[bool, bool, bool]` | `[true, true, true]` | Lock rotation per axis |
 | `ccd` | `boolean` | `false` | Continuous collision detection (fast objects) |
-| `sensor` | `boolean` | `false` | Trigger only, no collision response (see Sensors & Events) |
+| `sensor` | `boolean` | `false` | Trigger only, no collision response |
+| `activeCollisionTypes` | `'all'` | - | Enable kinematic/fixed collision detection (default: dynamic only) |
 | `collisionGroups` | `number` | - | Rapier collision groups bitfield |
 | `solverGroups` | `number` | - | Rapier solver groups bitfield |
 
@@ -367,6 +368,21 @@ Set `sensor: true` in the Physics component:
 }
 ```
 
+**Kinematic/Fixed Collision Detection**: By default, sensors only detect `dynamic` bodies. For kinematic sensors (like bullets) or to detect kinematic players, add `"activeCollisionTypes": "all"`:
+
+```json
+{
+  "physics": {
+    "type": "Physics",
+    "properties": {
+      "type": "kinematicPosition",
+      "sensor": true,
+      "activeCollisionTypes": "all"  // Detects walls, floors, kinematic bodies
+    }
+  }
+}
+```
+
 ### Physics Event Payload
 
 All physics events include:

package/src/tools/prefabeditor/components/PhysicsComponent.tsx

@@ -1,4 +1,4 @@
-import { RigidBody, RapierRigidBody } from "@react-three/rapier";
+import { RigidBody, RapierRigidBody, useRapier } from "@react-three/rapier";
 import type { RigidBodyOptions, CollisionPayload, IntersectionEnterPayload, IntersectionExitPayload } from "@react-three/rapier";
 import type { ReactNode } from 'react';
 import { useRef, useEffect, useCallback } from 'react';
@@ -7,7 +7,9 @@ import { FieldRenderer, FieldDefinition } from "./Input";
 import { ComponentData } from "../types";
 import { gameEvents, getEntityIdFromRigidBody } from "../GameEvents";
 
-export type PhysicsProps = RigidBodyOptions;
+export type PhysicsProps = RigidBodyOptions & {
+    activeCollisionTypes?: 'all' | undefined;
+};
 
 const physicsFields: FieldDefinition[] = [
     {
@@ -77,6 +79,15 @@ const physicsFields: FieldDefinition[] = [
         type: 'boolean',
         label: 'Sensor (Trigger Only)',
     },
+    {
+        name: 'activeCollisionTypes',
+        type: 'select',
+        label: 'Collision Detection',
+        options: [
+            { value: '', label: 'Default (Dynamic only)' },
+            { value: 'all', label: 'All (includes kinematic & fixed)' },
+        ],
+    },
 ];
 
 function PhysicsComponentEditor({ component, onUpdate }: { component: ComponentData; onUpdate: (newComp: any) => void }) {
@@ -101,9 +112,10 @@ interface PhysicsViewProps {
 }
 
 function PhysicsComponentView({ properties, children, position, rotation, scale, editMode, nodeId, registerRigidBodyRef }: PhysicsViewProps) {
-    const { type, colliders, sensor, ...otherProps } = properties;
+    const { type, colliders, sensor, activeCollisionTypes, ...otherProps } = properties;
     const colliderType = colliders || (type === 'fixed' ? 'trimesh' : 'hull');
     const rigidBodyRef = useRef<RapierRigidBody>(null);
+    const { rapier } = useRapier();
 
     // Register RigidBody ref when it's available
     useEffect(() => {
@@ -117,6 +129,22 @@ function PhysicsComponentView({ properties, children, position, rotation, scale,
         };
     }, [nodeId, registerRigidBodyRef]);
 
+    // Configure active collision types for kinematic/sensor bodies
+    useEffect(() => {
+        if (activeCollisionTypes === 'all' && rigidBodyRef.current) {
+            const rb = rigidBodyRef.current;
+            // Apply to all colliders on this rigid body
+            for (let i = 0; i < rb.numColliders(); i++) {
+                const collider = rb.collider(i);
+                collider.setActiveCollisionTypes(
+                    rapier.ActiveCollisionTypes.DEFAULT |
+                    rapier.ActiveCollisionTypes.KINEMATIC_FIXED |
+                    rapier.ActiveCollisionTypes.KINEMATIC_KINEMATIC
+                );
+            }
+        }
+    }, [activeCollisionTypes, rapier, type, colliders]);
+
     // Event handlers for physics interactions
     const handleIntersectionEnter = useCallback((payload: IntersectionEnterPayload) => {
         if (!nodeId) return;