react-three-game 0.0.107 → 0.0.109

package/README.md

@@ -29,7 +29,7 @@ npm install react-three-game @react-three/drei @react-three/fiber three
 Here is a minimal example that renders a prefab inside a normal R3F app:
 
 ```tsx
-import { GameCanvas, PrefabRoot, ground } from "react-three-game";
+import { GameCanvas, PrefabRoot, ground } from "react-three-game/viewer";
 
 const prefab = {
   id: "starter-scene",
@@ -80,7 +80,7 @@ This example renders a simple authored prefab with a ground plane and mesh conte
 In addition to the runtime renderer, there is a visual editor for authoring prefabs.
 
 ```tsx
-import { PrefabEditor } from "react-three-game";
+import { PrefabEditor } from "react-three-game/editor";
 
 export default function App() {
   return <PrefabEditor initialPrefab={prefab} onChange={console.log} />;
@@ -110,6 +110,13 @@ That means authored content stays as a prefab, and the same prefab can be:
 
 Custom component `View`s use normal React Three Fiber composition with `children`.
 
+When you import or decompose a `.glb` or `.gltf` model, mesh names can opt into imported Crashcat colliders:
+
+* `MeshName_col` keeps the mesh visible and adds a fixed `CrashcatPhysics` `trimesh` collider.
+* `MeshName_colonly` adds the same collider but hides the decomposed mesh render.
+
+This mirrors the common Blender authoring workflow: export helper collision meshes in the GLB, then edit the generated `CrashcatPhysics` properties if that body needs a different motion type or collider shape.
+
 For agent-authored custom meshes, use `BufferGeometry` with flat numeric arrays:
 
 ```json
@@ -157,7 +164,7 @@ Use the editor or root ref for scene-native object access, and the `Scene` mutat
 
 ```tsx
 import { useEffect, useRef } from "react";
-import { PrefabEditor, type PrefabEditorRef } from "react-three-game";
+import { PrefabEditor, type PrefabEditorRef } from "react-three-game/editor";
 
 function RaiseBall() {
   const editorRef = useRef<PrefabEditorRef>(null);
@@ -192,7 +199,7 @@ ball?.rotateY(0.5);
 For runtime integrations that need to react to authored scene changes, subscribe through the prefab store:
 
 ```tsx
-import { usePrefabStoreApi } from "react-three-game";
+import { usePrefabStoreApi } from "react-three-game/editor";
 
 const store = usePrefabStoreApi();
 const stop = store.subscribe(
@@ -207,7 +214,7 @@ For runtime-owned imperative state, register node-local handles instead of reach
 
 ```tsx
 import { useEffect } from "react";
-import { useAssetRuntime, useNode, useNodeHandle } from "react-three-game";
+import { useAssetRuntime, useNode, useNodeHandle } from "react-three-game/viewer";
 
 function SpinnerView({ children }: { children?: React.ReactNode }) {
   const { nodeId } = useNode();

package/dist/editor.d.ts

@@ -0,0 +1,22 @@
+import { registerBuiltinComponents } from "./tools/prefabeditor/components";
+import "./viewer";
+export { registerBuiltinComponents };
+export * from "./viewer";
+export { default as PrefabEditor } from "./tools/prefabeditor/PrefabEditor";
+export type { PrefabEditorProps, PrefabEditorRef } from "./tools/prefabeditor/PrefabEditor";
+export { useEditorContext, useEditorRef } from "./tools/prefabeditor/EditorContext";
+export type { EditorContextType } from "./tools/prefabeditor/EditorContext";
+export { usePrefabStore, usePrefabStoreApi } from "./tools/prefabeditor/prefabStore";
+export type { PrefabStoreApi, PrefabStoreState } from "./tools/prefabeditor/prefabStore";
+export { FieldRenderer, FieldGroup, ListEditor, Label, Vector3Input, Vector3Field, NumberField, ColorInput, ColorField, StringInput, StringField, BooleanInput, BooleanField, SelectInput, SelectField, } from "./tools/prefabeditor/components/Input";
+export { loadJson, saveJson, exportGLB, exportGLBData, regenerateIds, computeParentWorldMatrix, } from "./tools/prefabeditor/utils";
+export type { ExportGLBOptions } from "./tools/prefabeditor/utils";
+export { decomposeModelToPrefabNodes } from "./tools/prefabeditor/modelPrefab";
+export type { DecomposeModelOptions } from "./tools/prefabeditor/modelPrefab";
+export type { FieldDefinition, FieldType } from "./tools/prefabeditor/components/Input";
+export { MaterialOverridesProvider, useMaterialOverrides } from "./tools/prefabeditor/components/MaterialComponent";
+export type { MaterialOverrides } from "./tools/prefabeditor/components/MaterialComponent";
+export { float, positionLocal, sin, time, uniform, vec3, } from "three/tsl";
+export { loadFiles } from "./tools/dragdrop/DragDropLoader";
+export type { AssetLoadOptions } from "./tools/dragdrop/DragDropLoader";
+export { ModelListViewer, SoundListViewer, ModelPicker, SoundPicker, TextureListViewer, TexturePicker, SingleModelViewer, SingleSoundViewer, SingleTextureViewer, SharedCanvas, } from "./tools/assetviewer/page";

package/dist/editor.js

@@ -0,0 +1,15 @@
+import { registerBuiltinComponents } from "./tools/prefabeditor/components";
+import "./viewer";
+registerBuiltinComponents();
+export { registerBuiltinComponents };
+export * from "./viewer";
+export { default as PrefabEditor } from "./tools/prefabeditor/PrefabEditor";
+export { useEditorContext, useEditorRef } from "./tools/prefabeditor/EditorContext";
+export { usePrefabStore, usePrefabStoreApi } from "./tools/prefabeditor/prefabStore";
+export { FieldRenderer, FieldGroup, ListEditor, Label, Vector3Input, Vector3Field, NumberField, ColorInput, ColorField, StringInput, StringField, BooleanInput, BooleanField, SelectInput, SelectField, } from "./tools/prefabeditor/components/Input";
+export { loadJson, saveJson, exportGLB, exportGLBData, regenerateIds, computeParentWorldMatrix, } from "./tools/prefabeditor/utils";
+export { decomposeModelToPrefabNodes } from "./tools/prefabeditor/modelPrefab";
+export { MaterialOverridesProvider, useMaterialOverrides } from "./tools/prefabeditor/components/MaterialComponent";
+export { float, positionLocal, sin, time, uniform, vec3, } from "three/tsl";
+export { loadFiles } from "./tools/dragdrop/DragDropLoader";
+export { ModelListViewer, SoundListViewer, ModelPicker, SoundPicker, TextureListViewer, TexturePicker, SingleModelViewer, SingleSoundViewer, SingleTextureViewer, SharedCanvas, } from "./tools/assetviewer/page";

package/dist/plugins/crashcat/CrashcatPhysicsComponent.js

@@ -5,7 +5,7 @@ import { useEffect, useMemo, useRef } from "react";
 import { BooleanField, FieldRenderer, StringField, Vector3Field, } from "../../tools/prefabeditor/components/Input";
 import { useAssetRuntime, useNode } from "../../tools/prefabeditor/assetRuntime";
 import { usePrefabStoreApi } from "../../tools/prefabeditor/prefabStore";
-import { PrefabEditorMode, useScene } from "../../tools/prefabeditor/PrefabRoot";
+import { PrefabEditorMode, useScene } from "../../tools/prefabeditor/SceneContext";
 import { box, capsule, convexHull, MotionQuality, MotionType, rigidBody, sphere, triangleMesh, } from "crashcat";
 import { Matrix4, Quaternion, Vector3 } from "three";
 import { useCrashcat } from "./CrashcatRuntime";
@@ -198,6 +198,49 @@ function bodyTransformChanged(body, lastPosition, lastQuaternion) {
 function getRegisteredBody(api, nodeId, body) {
     return api && body && api.getBody(nodeId) === body ? body : null;
 }
+function createAndRegisterBody(api, nodeId, object, physics) {
+    const shape = createShapeForObject(object, physics);
+    if (!shape)
+        return null;
+    object.updateWorldMatrix(true, true);
+    object.getWorldPosition(scratchPosition);
+    const wq = new Quaternion();
+    object.getWorldQuaternion(wq);
+    const motionType = toMotionType(physics);
+    const motionQuality = toMotionQuality(physics);
+    const isKinematic = motionType === MotionType.KINEMATIC;
+    const isStatic = motionType === MotionType.STATIC;
+    const body = rigidBody.create(api.world, {
+        shape,
+        motionType,
+        motionQuality,
+        objectLayer: isStatic ? api.staticObjectLayer : api.movingObjectLayer,
+        position: [scratchPosition.x, scratchPosition.y, scratchPosition.z],
+        quaternion: [wq.x, wq.y, wq.z, wq.w],
+        sensor: Boolean(physics.sensor),
+        collideKinematicVsNonDynamic: isKinematic,
+        friction: physics.friction,
+        restitution: physics.restitution,
+        userData: { nodeId },
+    });
+    if (physics.linearVelocity) {
+        rigidBody.setLinearVelocity(api.world, body, physics.linearVelocity);
+    }
+    if (physics.angularVelocity) {
+        rigidBody.setAngularVelocity(api.world, body, physics.angularVelocity);
+    }
+    api.register(nodeId, body, {
+        motionType,
+        sensor: Boolean(physics.sensor),
+        events: {
+            collisionEnter: physics.collisionEnterEventName,
+            collisionExit: physics.collisionExitEventName,
+            sensorEnter: physics.sensorEnterEventName,
+            sensorExit: physics.sensorExitEventName,
+        },
+    });
+    return { body, motionType };
+}
 function CrashcatPhysicsView({ properties, children }) {
     const { nodeId, getObject } = useNode();
     const scene = useScene();
@@ -207,6 +250,7 @@ function CrashcatPhysicsView({ properties, children }) {
     const revision = getAssetRevision();
     const bodyRef = useRef(null);
     const motionTypeRef = useRef(MotionType.STATIC);
+    const needsRegistrationRef = useRef(false);
     const syncPositionRef = useRef([0, 0, 0]);
     const syncQuaternionRef = useRef([0, 0, 0, 1]);
     const lastPositionRef = useRef(null);
@@ -241,61 +285,40 @@ function CrashcatPhysicsView({ properties, children }) {
         sensorExitEventName,
         type,
     ]);
-    useEffect(() => {
-        // Rebuild mesh-derived colliders when referenced assets finish loading.
-        void revision;
-        if (!api)
+    const tryRegisterBody = () => {
+        if (!api || getRegisteredBody(api, nodeId, bodyRef.current)) {
+            needsRegistrationRef.current = false;
             return;
+        }
         const object = getObject();
-        if (!object)
+        if (!object) {
+            needsRegistrationRef.current = true;
             return;
-        const shape = createShapeForObject(object, physics);
-        if (!shape)
-            return;
-        object.updateWorldMatrix(true, true);
-        object.getWorldPosition(scratchPosition);
-        const wq = new Quaternion();
-        object.getWorldQuaternion(wq);
-        const motionType = toMotionType(physics);
-        const motionQuality = toMotionQuality(physics);
-        const isKinematic = motionType === MotionType.KINEMATIC;
-        const isStatic = motionType === MotionType.STATIC;
-        const body = rigidBody.create(api.world, {
-            shape,
-            motionType,
-            motionQuality,
-            objectLayer: isStatic ? api.staticObjectLayer : api.movingObjectLayer,
-            position: [scratchPosition.x, scratchPosition.y, scratchPosition.z],
-            quaternion: [wq.x, wq.y, wq.z, wq.w],
-            sensor: Boolean(physics.sensor),
-            collideKinematicVsNonDynamic: isKinematic,
-            friction: physics.friction,
-            restitution: physics.restitution,
-            userData: { nodeId },
-        });
-        if (physics.linearVelocity) {
-            rigidBody.setLinearVelocity(api.world, body, physics.linearVelocity);
         }
-        if (physics.angularVelocity) {
-            rigidBody.setAngularVelocity(api.world, body, physics.angularVelocity);
+        const registration = createAndRegisterBody(api, nodeId, object, physics);
+        if (!registration) {
+            needsRegistrationRef.current = true;
+            return;
         }
-        bodyRef.current = body;
-        motionTypeRef.current = motionType;
+        bodyRef.current = registration.body;
+        motionTypeRef.current = registration.motionType;
+        needsRegistrationRef.current = false;
         lastPositionRef.current = null;
         lastQuaternionRef.current = null;
-        api.register(nodeId, body, {
-            motionType,
-            sensor: Boolean(physics.sensor),
-            events: {
-                collisionEnter: physics.collisionEnterEventName,
-                collisionExit: physics.collisionExitEventName,
-                sensorEnter: physics.sensorEnterEventName,
-                sensorExit: physics.sensorExitEventName,
-            },
-        });
+    };
+    useEffect(() => {
+        // Rebuild mesh-derived colliders when referenced assets finish loading.
+        void revision;
+        needsRegistrationRef.current = true;
+        if (api) {
+            api.unregister(nodeId);
+        }
+        bodyRef.current = null;
+        tryRegisterBody();
         return () => {
             bodyRef.current = null;
-            api.unregister(nodeId);
+            needsRegistrationRef.current = false;
+            api === null || api === void 0 ? void 0 : api.unregister(nodeId);
         };
     }, [
         api,
@@ -304,6 +327,11 @@ function CrashcatPhysicsView({ properties, children }) {
         physics,
         revision,
     ]);
+    useFrame(() => {
+        if (needsRegistrationRef.current) {
+            tryRegisterBody();
+        }
+    }, -3);
     useEffect(() => {
         const syncEditBody = () => {
             const body = getRegisteredBody(api, nodeId, bodyRef.current);

package/dist/plugins/crashcat/CrashcatRagdoll.d.ts

@@ -0,0 +1,58 @@
+import type { Vec3 } from "mathcat";
+import { rigidBody, type World } from "crashcat";
+import type { Component, NodeInteractionHandlers } from "../../tools/prefabeditor/components/ComponentRegistry";
+export declare enum RagdollBodyPart {
+    UpperBody = 0,
+    Head = 1,
+    UpperLeftArm = 2,
+    LowerLeftArm = 3,
+    UpperRightArm = 4,
+    LowerRightArm = 5,
+    Pelvis = 6,
+    UpperLeftLeg = 7,
+    LowerLeftLeg = 8,
+    UpperRightLeg = 9,
+    LowerRightLeg = 10
+}
+type ShapeConfig = {
+    args: Vec3;
+    density: number;
+    position: Vec3;
+};
+type JointConfig = {
+    bodyA: RagdollBodyPart;
+    bodyB: RagdollBodyPart;
+    pivotA: Vec3;
+    pivotB: Vec3;
+    axisA: Vec3;
+    axisB: Vec3;
+    angle: number;
+    twistAngle: number;
+};
+type SkeletonJoint = {
+    bodyPart: RagdollBodyPart;
+    parentBodyPart: RagdollBodyPart | null;
+};
+export type RagdollSettings = {
+    shapes: Map<RagdollBodyPart, ShapeConfig>;
+    joints: JointConfig[];
+    skeleton: SkeletonJoint[];
+};
+export type CrashcatRagdollProps = {
+    position?: [number, number, number];
+    scale?: number;
+    swingAngle?: number;
+    shoulderAngle?: number;
+    twistAngle?: number;
+    stabilize?: boolean;
+    initialLinearVelocity?: [number, number, number];
+    initialAngularVelocity?: [number, number, number];
+    color?: string;
+    clickImpulse?: number;
+    nodeInteractionHandlers?: NodeInteractionHandlers;
+};
+export declare function createRagdollSettings(scale?: number, angleA?: number, angleB?: number, twistAngle?: number): RagdollSettings;
+export declare function CrashcatRagdoll({ position, scale, swingAngle, shoulderAngle, twistAngle, stabilize, initialLinearVelocity, initialAngularVelocity, color, clickImpulse, nodeInteractionHandlers, }: CrashcatRagdollProps): import("react/jsx-runtime").JSX.Element;
+declare const CrashcatRagdollComponent: Component;
+export default CrashcatRagdollComponent;
+export declare function createStaticBoxBody(world: World, objectLayer: number, halfExtents: Vec3, position: Vec3): rigidBody.RigidBody;