@directivegames/genesys.js 3.1.28 → 3.1.30

package/dist/src/components/visual/SplineMeshComponent.js

@@ -0,0 +1,373 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+/**
+ * SplineMeshComponent generates a flat ribbon mesh along a Catmull-Rom spline.
+ *
+ * Use cases include roads, paths, rivers, and any geometry that follows a curved path.
+ * The component samples points along the spline and creates a ribbon with proper
+ * UV mapping for texture tiling based on world distance.
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Provide an array of control points defining the path
+ * - Adjust width, segments, and tension for desired appearance
+ * - Use uvScale to control texture tiling density
+ * - Enable showDebug to visualize control points and spline curve
+ */
+import * as THREE from 'three';
+import { MaterialUtils } from '../../materials.js';
+import { EngineClass } from '../../systems/ClassRegistry.js';
+import { resourceManager } from '../../utils/ResourceManager.js';
+import { isNode } from '../../utils/Utils.js';
+import { PrimitiveComponent } from '../PrimitiveComponent.js';
+let SplineMeshComponent = class SplineMeshComponent extends PrimitiveComponent {
+    static get DEFAULT_OPTIONS() {
+        return {
+            ...PrimitiveComponent.DEFAULT_OPTIONS,
+            // Provide default starter points so the spline is visible when created
+            points: [
+                new THREE.Vector3(-2, 0, 0),
+                new THREE.Vector3(0, 0, 1),
+                new THREE.Vector3(2, 0, 0),
+            ],
+            width: 1,
+            segments: 50,
+            closed: false,
+            tension: 0.5,
+            uvScale: 1,
+            material: '', // Asset path to material JSON file
+            showDebug: false,
+            physicsOptions: {
+                ...PrimitiveComponent.DEFAULT_PHYSICS_OPTIONS,
+                enabled: false,
+            },
+        };
+    }
+    constructor(options = {}) {
+        super(options);
+        Object.defineProperty(this, "mesh", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "curve", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "debugGroup", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        this.rebuildMesh();
+    }
+    /**
+     * Returns the THREE.Mesh object associated with this component
+     */
+    getMesh() {
+        return this.mesh;
+    }
+    /**
+     * Returns the underlying Catmull-Rom curve
+     */
+    getCurve() {
+        return this.curve;
+    }
+    /**
+     * Sets new control points and rebuilds the mesh
+     */
+    setPoints(points) {
+        this.options.points = points;
+        this.rebuildMesh();
+    }
+    /**
+     * Sets the ribbon width and rebuilds the mesh
+     */
+    setWidth(width) {
+        this.options.width = width;
+        this.rebuildMesh();
+    }
+    /**
+     * Sets the segment count and rebuilds the mesh
+     */
+    setSegments(segments) {
+        this.options.segments = segments;
+        this.rebuildMesh();
+    }
+    /**
+     * Sets the Catmull-Rom tension and rebuilds the mesh
+     */
+    setTension(tension) {
+        this.options.tension = tension;
+        this.rebuildMesh();
+    }
+    /**
+     * Sets the UV scale and rebuilds the mesh
+     */
+    setUvScale(uvScale) {
+        this.options.uvScale = uvScale;
+        this.rebuildMesh();
+    }
+    /**
+     * Sets whether the spline is closed and rebuilds the mesh
+     */
+    setClosed(closed) {
+        this.options.closed = closed;
+        this.rebuildMesh();
+    }
+    /**
+     * Sets the material for the mesh
+     */
+    setMaterial(material) {
+        this.options.material = material;
+        if (this.mesh) {
+            resourceManager.loadGenericMaterial(material).then((loadedMaterial) => {
+                if (loadedMaterial && this.mesh) {
+                    this.mesh.material = loadedMaterial;
+                }
+            });
+        }
+        else {
+            // Mesh doesn't exist yet - rebuild to create it with the new material
+            this.rebuildMesh();
+        }
+    }
+    /**
+     * Toggles debug visualization
+     */
+    setShowDebug(show) {
+        this.options.showDebug = show;
+        this.updateDebugVisualization();
+    }
+    /**
+     * Rebuilds the ribbon mesh based on current options
+     */
+    rebuildMesh() {
+        // Filter out null/undefined points and ensure they are Vector3 instances
+        // (points may be plain {x,y,z} objects after deserialization)
+        const rawPoints = this.options.points ?? [];
+        const points = rawPoints
+            .filter((p) => p != null)
+            .map(p => p instanceof THREE.Vector3 ? p : new THREE.Vector3(p.x, p.y, p.z));
+        if (points.length < 2) {
+            this.clearMesh();
+            return;
+        }
+        // Create the Catmull-Rom curve
+        this.curve = new THREE.CatmullRomCurve3(points, this.options.closed ?? false, 'catmullrom', this.options.tension ?? 0.5);
+        const segments = this.options.segments ?? 50;
+        const width = this.options.width ?? 1;
+        const uvScale = this.options.uvScale ?? 1;
+        const halfWidth = width / 2;
+        // Generate geometry
+        const geometry = this.generateRibbonGeometry(this.curve, segments, halfWidth, uvScale);
+        // Remove old mesh if exists
+        if (this.mesh) {
+            this.mesh.removeFromParent();
+            this.mesh.geometry.dispose();
+        }
+        // Create new mesh with default material initially
+        this.mesh = new THREE.Mesh(geometry, MaterialUtils.DefaultMaterial);
+        this.mesh.setTransient(true);
+        this.bindObject3DProperties(this.mesh, ['castShadow', 'receiveShadow']);
+        this.add(this.mesh);
+        // Load material if specified
+        if (!isNode() && this.options.material) {
+            resourceManager.loadGenericMaterial(this.options.material).then((loadedMaterial) => {
+                if (loadedMaterial && this.mesh) {
+                    this.mesh.material = loadedMaterial;
+                }
+            });
+        }
+        // Update debug visualization
+        this.updateDebugVisualization();
+    }
+    /**
+     * Generates a ribbon geometry along the curve
+     */
+    generateRibbonGeometry(curve, segments, halfWidth, uvScale) {
+        const vertices = [];
+        const normals = [];
+        const uvs = [];
+        const indices = [];
+        const totalLength = curve.getLength();
+        const up = new THREE.Vector3(0, 1, 0);
+        const tempTangent = new THREE.Vector3();
+        const tempNormal = new THREE.Vector3();
+        const tempBinormal = new THREE.Vector3();
+        // Sample points along the curve
+        for (let i = 0; i <= segments; i++) {
+            const t = i / segments;
+            const point = curve.getPointAt(t);
+            const tangent = curve.getTangentAt(t).normalize();
+            // Calculate binormal (perpendicular to tangent and up)
+            tempBinormal.crossVectors(up, tangent).normalize();
+            // Handle degenerate case when tangent is parallel to up
+            if (tempBinormal.lengthSq() < 0.001) {
+                tempBinormal.set(1, 0, 0);
+            }
+            // Calculate normal (perpendicular to tangent and binormal)
+            tempNormal.crossVectors(tangent, tempBinormal).normalize();
+            // Create two vertices at this point (left and right edges)
+            const leftPoint = point.clone().addScaledVector(tempBinormal, -halfWidth);
+            const rightPoint = point.clone().addScaledVector(tempBinormal, halfWidth);
+            vertices.push(leftPoint.x, leftPoint.y, leftPoint.z);
+            vertices.push(rightPoint.x, rightPoint.y, rightPoint.z);
+            // Normals point up
+            normals.push(tempNormal.x, tempNormal.y, tempNormal.z);
+            normals.push(tempNormal.x, tempNormal.y, tempNormal.z);
+            // UVs: U tiles along length based on world distance, V is 0-1 across width
+            const distanceAlongCurve = t * totalLength;
+            const u = distanceAlongCurve * uvScale;
+            uvs.push(u, 0); // Left edge
+            uvs.push(u, 1); // Right edge
+        }
+        // Generate indices for triangle strip (CCW winding for upward-facing normals)
+        for (let i = 0; i < segments; i++) {
+            const baseIndex = i * 2;
+            // First triangle: left[i] -> left[i+1] -> right[i]
+            indices.push(baseIndex, baseIndex + 2, baseIndex + 1);
+            // Second triangle: right[i] -> left[i+1] -> right[i+1]
+            indices.push(baseIndex + 1, baseIndex + 2, baseIndex + 3);
+        }
+        const geometry = new THREE.BufferGeometry();
+        geometry.setAttribute('position', new THREE.Float32BufferAttribute(vertices, 3));
+        geometry.setAttribute('normal', new THREE.Float32BufferAttribute(normals, 3));
+        geometry.setAttribute('uv', new THREE.Float32BufferAttribute(uvs, 2));
+        geometry.setIndex(indices);
+        return geometry;
+    }
+    /**
+     * Clears the current mesh
+     */
+    clearMesh() {
+        if (this.mesh) {
+            this.mesh.removeFromParent();
+            this.mesh.geometry.dispose();
+            this.mesh = null;
+        }
+        this.curve = null;
+        this.clearDebugVisualization();
+    }
+    /**
+     * Updates debug visualization showing control points and spline
+     */
+    updateDebugVisualization() {
+        this.clearDebugVisualization();
+        if (!this.options.showDebug || !this.curve) {
+            return;
+        }
+        this.debugGroup = new THREE.Group();
+        this.debugGroup.setTransient(true);
+        // Filter out null/undefined points and ensure they are Vector3 instances
+        const rawPoints = this.options.points ?? [];
+        const points = rawPoints
+            .filter((p) => p != null)
+            .map(p => p instanceof THREE.Vector3 ? p : new THREE.Vector3(p.x, p.y, p.z));
+        // Draw control point spheres
+        const sphereGeometry = new THREE.SphereGeometry(0.15);
+        const sphereMaterial = new THREE.MeshBasicMaterial({ color: 0xff0000 });
+        for (let i = 0; i < points.length; i++) {
+            const sphere = new THREE.Mesh(sphereGeometry, sphereMaterial);
+            sphere.position.copy(points[i]);
+            this.debugGroup.add(sphere);
+        }
+        // Draw spline curve line
+        const curvePoints = this.curve.getPoints(100);
+        const lineGeometry = new THREE.BufferGeometry().setFromPoints(curvePoints);
+        const lineMaterial = new THREE.LineBasicMaterial({ color: 0x00ff00 });
+        const line = new THREE.Line(lineGeometry, lineMaterial);
+        this.debugGroup.add(line);
+        // Draw tangent indicators at control points
+        const arrowMaterial = new THREE.LineBasicMaterial({ color: 0x0000ff });
+        for (let i = 0; i < points.length; i++) {
+            const t = this.options.closed ? i / points.length : i / (points.length - 1);
+            const tangent = this.curve.getTangentAt(Math.min(t, 1)).normalize();
+            const arrowPoints = [
+                points[i].clone(),
+                points[i].clone().addScaledVector(tangent, 0.5)
+            ];
+            const arrowGeometry = new THREE.BufferGeometry().setFromPoints(arrowPoints);
+            const arrow = new THREE.Line(arrowGeometry, arrowMaterial);
+            this.debugGroup.add(arrow);
+        }
+        this.add(this.debugGroup);
+    }
+    /**
+     * Clears debug visualization
+     */
+    clearDebugVisualization() {
+        if (this.debugGroup) {
+            this.debugGroup.removeFromParent();
+            this.debugGroup.traverse((child) => {
+                if (child instanceof THREE.Mesh || child instanceof THREE.Line) {
+                    child.geometry.dispose();
+                    if (Array.isArray(child.material)) {
+                        child.material.forEach(m => m.dispose());
+                    }
+                    else {
+                        child.material.dispose();
+                    }
+                }
+            });
+            this.debugGroup = null;
+        }
+    }
+    calcBoundingBox() {
+        if (this.mesh) {
+            this.mesh.geometry.computeBoundingBox();
+            this._boundingBox.copy(this.mesh.geometry.boundingBox).applyMatrix4(this.mesh.matrixWorld);
+        }
+    }
+    getEditorClassIcon() {
+        return 'Icon_Path';
+    }
+    onEditorPropertyChanged(path, value, result) {
+        super.onEditorPropertyChanged(path, value, result);
+        // Rebuild mesh when any spline-related property changes
+        if (result.isOptions) {
+            if (path === 'material') {
+                this.setMaterial(value);
+            }
+            else if (path === 'points' || path.startsWith('points[') || path.startsWith('points.')) {
+                // Handle array changes: full replacement, element changes, or property changes
+                this.rebuildMesh();
+            }
+            else if (['width', 'segments', 'tension', 'uvScale', 'closed', 'showDebug'].includes(path)) {
+                this.rebuildMesh();
+            }
+        }
+    }
+};
+Object.defineProperty(SplineMeshComponent, "EDITOR_CLASS_META", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: {
+        ...PrimitiveComponent.EDITOR_CLASS_META,
+        points: { array: { child: { type: THREE.Vector3 } } },
+        width: { number: { min: 0.1, max: 100, step: 0.1, decimals: 2 } },
+        segments: { integer: { min: 2, max: 500, step: 1 } },
+        tension: { number: { min: 0, max: 1, step: 0.05, decimals: 2 } },
+        uvScale: { number: { min: 0.01, max: 10, step: 0.1, decimals: 2 } },
+        closed: { boolean: {} },
+        showDebug: { boolean: {} },
+        material: { type: ['material'] },
+    }
+});
+SplineMeshComponent = __decorate([
+    EngineClass('SplineMeshComponent'),
+    __metadata("design:paramtypes", [Object])
+], SplineMeshComponent);
+export { SplineMeshComponent };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiU3BsaW5lTWVzaENvbXBvbmVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9jb21wb25lbnRzL3Zpc3VhbC9TcGxpbmVNZXNoQ29tcG9uZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7OztBQUFBOzs7Ozs7Ozs7Ozs7R0FZRztBQUNILE9BQU8sS0FBSyxLQUFLLE1BQU0sT0FBTyxDQUFDO0FBRS9CLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUNuRCxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDN0QsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQ2pFLE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUM5QyxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQTBCdkQsSUFBTSxtQkFBbUIsR0FBekIsTUFBTSxtQkFBb0IsU0FBUSxrQkFBOEM7SUFpQnJGLE1BQU0sS0FBYyxlQUFlO1FBQ2pDLE9BQU87WUFDTCxHQUFHLGtCQUFrQixDQUFDLGVBQWU7WUFDckMsdUVBQXVFO1lBQ3ZFLE1BQU0sRUFBRTtnQkFDTixJQUFJLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUMsQ0FBQztnQkFDM0IsSUFBSSxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsQ0FBQyxDQUFDO2dCQUMxQixJQUFJLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQyxFQUFFLENBQUMsRUFBRSxDQUFDLENBQUM7YUFDM0I7WUFDRCxLQUFLLEVBQUUsQ0FBQztZQUNSLFFBQVEsRUFBRSxFQUFFO1lBQ1osTUFBTSxFQUFFLEtBQUs7WUFDYixPQUFPLEVBQUUsR0FBRztZQUNaLE9BQU8sRUFBRSxDQUFDO1lBQ1YsUUFBUSxFQUFFLEVBQUUsRUFBRyxtQ0FB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

package/dist/src/components/visual/index.d.ts

@@ -21,3 +21,4 @@ export * from './TerrainMeshComponent.js';
 export * from './SkyboxComponent.js';
 export * from './FogComponent.js';
 export * from './UI3DComponent.js';
+export * from './SplineMeshComponent.js';

package/dist/src/components/visual/index.js

@@ -21,4 +21,5 @@ export * from './TerrainMeshComponent.js';
 export * from './SkyboxComponent.js';
 export * from './FogComponent.js';
 export * from './UI3DComponent.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvY29tcG9uZW50cy92aXN1YWwvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7O0dBUUc7QUFDSCxjQUFjLHlCQUF5QixDQUFDO0FBQ3hDLGNBQWMsaUNBQWlDLENBQUM7QUFDaEQsY0FBYyw4QkFBOEIsQ0FBQztBQUM3QyxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMseUJBQXlCLENBQUM7QUFDeEMsY0FBYyxxQ0FBcUMsQ0FBQztBQUNwRCxjQUFjLGlDQUFpQyxDQUFDO0FBQ2hELGNBQWMsNkJBQTZCLENBQUM7QUFDNUMsY0FBYyxvQkFBb0IsQ0FBQztBQUNuQyxjQUFjLCtCQUErQixDQUFDO0FBQzlDLGNBQWMsMkJBQTJCLENBQUM7QUFDMUMsY0FBYyxzQkFBc0IsQ0FBQztBQUNyQyxjQUFjLG1CQUFtQixDQUFDO0FBQ2xDLGNBQWMsb0JBQW9CLENBQUMifQ==
+export * from './SplineMeshComponent.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvY29tcG9uZW50cy92aXN1YWwvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7O0dBUUc7QUFDSCxjQUFjLHlCQUF5QixDQUFDO0FBQ3hDLGNBQWMsaUNBQWlDLENBQUM7QUFDaEQsY0FBYyw4QkFBOEIsQ0FBQztBQUM3QyxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMseUJBQXlCLENBQUM7QUFDeEMsY0FBYyxxQ0FBcUMsQ0FBQztBQUNwRCxjQUFjLGlDQUFpQyxDQUFDO0FBQ2hELGNBQWMsNkJBQTZCLENBQUM7QUFDNUMsY0FBYyxvQkFBb0IsQ0FBQztBQUNuQyxjQUFjLCtCQUErQixDQUFDO0FBQzlDLGNBQWMsMkJBQTJCLENBQUM7QUFDMUMsY0FBYyxzQkFBc0IsQ0FBQztBQUNyQyxjQUFjLG1CQUFtQixDQUFDO0FBQ2xDLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYywwQkFBMEIsQ0FBQyJ9

package/dist/test/prefab.test.js

@@ -53,7 +53,7 @@ QUnit.module('Prefab', hooks => {
         for (let index = 0; index < 4; index++) {
             const instanceRootData = [index === 0 ? -123 : undefined, index === 1 ? -456 : undefined];
             const instanceComponentData = [index === 2 ? -789 : undefined, index === 3 ? -101 : undefined];
-            // laod an instance actor them modify its properties
+            // load an instance actor then modify its properties
             const instanceActor = await ENGINE.Actor.spawnPrefabActor(prefabName, {
                 position: instancePosition,
                 rotation: instanceRotation,

package/games/index.ts

@@ -12,6 +12,7 @@ export * from './performance-test-demo.js';
 export * from './postprocess-demo.js';
 export * from './ragdoll-demo-simple.js';
 export * from './ragdoll-demo.js';
+export * from './spline-mesh-demo.js';
 export * from './swipe-tap-demo.js';
 export * from './tween-demo.js';
 export * from './ui-demo.js';

package/games/spline-mesh-demo.ts

@@ -0,0 +1,119 @@
+import * as ENGINE from '@directivegames/genesys.js';
+import * as THREE from 'three';
+
+/**
+ * SplineMeshDemo showcases the SplineMeshComponent.
+ *
+ * Demonstrates:
+ * - Creating a road-like path using control points
+ * - Debug visualization of control points and spline curve
+ * - UV tiling for texture mapping
+ */
+export class SplineMeshDemo extends ENGINE.BaseGameLoop {
+  private splineActor: ENGINE.Actor | null = null;
+  private splineComponent: ENGINE.SplineMeshComponent | null = null;
+
+  protected override async preStart(): Promise<void> {
+    // Setup camera
+    const { pawn } = ENGINE.GameBuilder.createDefaultPawn(this.world, new THREE.Vector3(0, 15, 20));
+    const camera = pawn.getComponent(THREE.Camera)!;
+    camera.position.set(0, 15, 20);
+    camera.lookAt(0, 0, 0);
+
+    // Setup lighting
+    ENGINE.GameBuilder.createDefaultLighting(this.world);
+
+    // Create ground plane with grass color
+    const groundMaterial = new THREE.MeshStandardMaterial({ color: 0x228833 });
+    const groundGeometry = new THREE.BoxGeometry(50, 0.1, 50);
+    const ground = new ENGINE.Actor({
+      rootComponent: new ENGINE.MeshComponent({
+        position: new THREE.Vector3(0, -0.1, 0),
+        geometry: groundGeometry,
+        material: groundMaterial,
+      })
+    });
+    this.world.addActor(ground);
+
+    // Create a winding road path
+    this.createRoadPath();
+
+    // Create a river path
+    this.createRiverPath();
+  }
+
+  private createRoadPath(): void {
+    // Define control points for a winding road
+    const roadPoints = [
+      new THREE.Vector3(-15, 0, -10),
+      new THREE.Vector3(-8, 0, -5),
+      new THREE.Vector3(-3, 0, 0),
+      new THREE.Vector3(0, 0, 5),
+      new THREE.Vector3(5, 0, 3),
+      new THREE.Vector3(10, 0, -2),
+      new THREE.Vector3(15, 0, 0),
+    ];
+
+    // Create the spline mesh component with a texture
+    this.splineComponent = new ENGINE.SplineMeshComponent({
+      points: roadPoints,
+      width: 3,
+      segments: 80,
+      tension: 0.3,
+      uvScale: 0.5,
+      material: '@engine/assets/dev/materials/RoadAsphalt.json',
+      showDebug: true, // Enable debug visualization
+    });
+
+    // Create actor and add component
+    this.splineActor = new ENGINE.Actor();
+    this.splineActor.rootComponent.add(this.splineComponent);
+    this.world.addActor(this.splineActor);
+  }
+
+  private createRiverPath(): void {
+    // Define control points for a river
+    const riverPoints = [
+      new THREE.Vector3(-12, 0.01, 8),
+      new THREE.Vector3(-6, 0.01, 12),
+      new THREE.Vector3(0, 0.01, 10),
+      new THREE.Vector3(6, 0.01, 14),
+      new THREE.Vector3(12, 0.01, 12),
+    ];
+
+    // Create river material with blue color
+    const riverMaterial = new THREE.MeshStandardMaterial({
+      color: 0x2266aa,
+      roughness: 0.2,
+      metalness: 0.3,
+      transparent: true,
+      opacity: 0.8,
+    });
+
+    // Create the spline mesh component for river
+    const riverComponent = new ENGINE.SplineMeshComponent({
+      points: riverPoints,
+      width: 2,
+      segments: 60,
+      tension: 0.5,
+      uvScale: 1,
+      material: riverMaterial,
+      showDebug: true,
+    });
+
+    // Create actor and add component
+    const riverActor = new ENGINE.Actor();
+    riverActor.rootComponent.add(riverComponent);
+    this.world.addActor(riverActor);
+  }
+
+  public override destroy(): void {
+    if (this.splineActor) {
+      this.splineActor.destroy();
+      this.splineActor = null;
+    }
+    this.splineComponent = null;
+    super.destroy();
+  }
+}
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@directivegames/genesys.js",
-  "version": "3.1.28",
+  "version": "3.1.30",
   "description": "Mini game engine built on top of three.js",
   "license": "UNLICENSED",
   "main": "./dist/src/index.js",

package/src/actors/Actor.ts

@@ -196,6 +196,7 @@ export class Actor<TOptions extends ActorOptions = ActorOptions> extends Playabl
   constructor(readonly options: TOptions = {} as TOptions) {
     super();
     this.ctorArgOptions = options;
+
     options = { ...Actor.DEFAULT_OPTIONS, ...options, };
     this.name = ObjectNamingSystem.generateName(this);
     this.actorTags = options.actorTags ? [...options.actorTags] : [];
@@ -236,6 +237,13 @@ export class Actor<TOptions extends ActorOptions = ActorOptions> extends Playabl
     if (legacyPrefabName) {
       this.prefabName = legacyPrefabName;
     }
+
+    // HACK copy the ctorArgOptions and delete the transform data, so they get populated by the data stored in root component when loaded
+    // and also this won't mutate the original `options` passed in
+    this.ctorArgOptions = {...this.ctorArgOptions};
+    delete this.ctorArgOptions.position;
+    delete this.ctorArgOptions.rotation;
+    delete this.ctorArgOptions.scale;
   }
 
   /**
@@ -263,7 +271,7 @@ export class Actor<TOptions extends ActorOptions = ActorOptions> extends Playabl
   }
 
   /**
-   * Sets the prefab name and data of this actor
+   * @deprecated deprecated, use $$prefab, setAsPrefabInstance instead
    * @param name The prefab name
    * @param data The prefab data
    * @param inheritanceChain The full prefab inheritance chain (optional)
@@ -277,7 +285,7 @@ export class Actor<TOptions extends ActorOptions = ActorOptions> extends Playabl
   }
 
   /**
-   * Clears the prefab name and data of this actor
+   * @deprecated Clears the prefab name and data of this actor. Use setAsPrefabInstance(null) instead
    * @returns This actor instance for method chaining
    */
   public clearPrefab(): this {