@directivegames/genesys.js 3.1.24

package/dist/src/components/movement/VehicleMovementComponent.js

@@ -0,0 +1,402 @@
+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);
+};
+/**
+ * VehicleMovementComponent handles vehicle physics simulation and input processing.
+ *
+ * This component integrates Rapier's vehicle controller with the Genesys component
+ * system, providing a unified interface for vehicle physics, input handling, and
+ * visual synchronization. It extends BasePawnMovementComponent to support standard
+ * movement input patterns while adding vehicle-specific controls like acceleration,
+ * braking, and steering.
+ *
+ * Features:
+ * - Rapier physics-based vehicle simulation with realistic wheel physics
+ * - Configurable vehicle properties (engine power, steering angles, suspension)
+ * - Automatic wheel mesh synchronization with physics simulation
+ * - Support for different vehicle types through configuration
+ * - Input handling for keyboard, gamepad, and touch controls
+ * - Network replication support for multiplayer vehicles
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Attach to a vehicle actor with a chassis mesh and wheel meshes
+ * - Configure wheel positions and vehicle properties via options
+ * - Use addAccelerateInput, addBrakeInput, and addSteerInput for control
+ * - Call setupVehiclePhysics() after the actor's mesh is initialized
+ */
+import * as THREE from 'three';
+import { PhysicsVectorParam } from '../../physics/PhysicsEngine.js';
+import { PhysicsMotionType } from '../../physics/PhysicsTypes.js';
+import { EngineClass } from '../../systems/ClassRegistry.js';
+import { Delegate } from '../../utils/Delegate.js';
+import { PrimitiveComponent } from '../PrimitiveComponent.js';
+import { BasePawnMovementComponent } from './BasePawnMovementComponent.js';
+/**
+ * Vehicle movement component that handles both physics simulation and input processing
+ */
+let VehicleMovementComponent = class VehicleMovementComponent extends BasePawnMovementComponent {
+    static get DEFAULT_OPTIONS() {
+        const wheelBaseWidth = 2.6;
+        const wheelBaseLength = 3.0;
+        const wheelBaseHeight = 0;
+        const suspensionRestLength = 0.6;
+        const wheelRadius = 0.5;
+        const wheelWidth = 0.4;
+        const suspensionStiffness = 20;
+        const suspensionCompression = 0.83;
+        const suspensionRelaxation = 0.88;
+        const maxSuspensionForce = 6000.0;
+        const maxSuspensionTravel = 5.0;
+        const sideFrictionStiffness = 2;
+        const frictionSlip = 10.5;
+        return {
+            ...BasePawnMovementComponent.DEFAULT_OPTIONS,
+            maxEnginePower: 35,
+            maxSteeringAngle: Math.PI / 6, // 30 degrees
+            maxBrakeForce: 1,
+            engineResponseRate: 8.0,
+            steeringResponseRate: 12.0,
+            brakeResponseRate: 15.0,
+            createWheelMeshes: true,
+            wheelMaterialColor: 0x333333,
+            autoBreakWhenNotPossessed: 1,
+            autoStopBreak: 0.5,
+            wheels: [
+                // Default 4-wheel configuration
+                {
+                    position: new THREE.Vector3(-wheelBaseWidth / 2, wheelBaseHeight, -wheelBaseLength / 2), // Front left
+                    radius: wheelRadius,
+                    width: wheelWidth,
+                    canSteer: true,
+                    isPowered: false,
+                    canBrake: true,
+                    suspensionRestLength,
+                    suspensionStiffness,
+                    suspensionCompression,
+                    suspensionRelaxation,
+                    maxSuspensionForce,
+                    maxSuspensionTravel,
+                    sideFrictionStiffness,
+                    frictionSlip,
+                },
+                {
+                    position: new THREE.Vector3(wheelBaseWidth / 2, wheelBaseHeight, -wheelBaseLength / 2), // Front right
+                    radius: wheelRadius,
+                    width: wheelWidth,
+                    canSteer: true,
+                    isPowered: false,
+                    canBrake: true,
+                    suspensionRestLength,
+                    suspensionStiffness,
+                    suspensionCompression,
+                    suspensionRelaxation,
+                    maxSuspensionForce,
+                    maxSuspensionTravel,
+                    sideFrictionStiffness,
+                    frictionSlip,
+                },
+                {
+                    position: new THREE.Vector3(-wheelBaseWidth / 2, wheelBaseHeight, wheelBaseLength / 2), // Rear left
+                    radius: wheelRadius,
+                    width: wheelWidth,
+                    canSteer: false,
+                    isPowered: true,
+                    canBrake: true,
+                    suspensionRestLength,
+                    suspensionStiffness,
+                    suspensionCompression,
+                    suspensionRelaxation,
+                    maxSuspensionForce,
+                    maxSuspensionTravel,
+                    sideFrictionStiffness,
+                    frictionSlip,
+                },
+                {
+                    position: new THREE.Vector3(wheelBaseWidth / 2, wheelBaseHeight, wheelBaseLength / 2), // Rear right
+                    radius: wheelRadius,
+                    width: wheelWidth,
+                    canSteer: false,
+                    isPowered: true,
+                    canBrake: true,
+                    suspensionRestLength,
+                    suspensionStiffness,
+                    suspensionCompression,
+                    suspensionRelaxation,
+                    maxSuspensionForce,
+                    maxSuspensionTravel,
+                    sideFrictionStiffness,
+                    frictionSlip,
+                },
+            ],
+        };
+    }
+    constructor(options) {
+        super(options);
+        Object.defineProperty(this, "onWheelUpdated", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        Object.defineProperty(this, "brakeInput", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        // Current smoothed control values
+        Object.defineProperty(this, "currentEngineForce", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "currentBrakeForce", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "currentSteering", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        // Physics integration
+        Object.defineProperty(this, "physicsVehicle", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "wheelMeshes", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+    }
+    /**
+     * Gets the input state for the vehicle movement component
+     * @returns The input state
+     */
+    getInputState() {
+        return {
+            ...super.getInputState(),
+            brakeInput: this.brakeInput,
+        };
+    }
+    endPlay() {
+        this.cleanupVehiclePhysics();
+        super.endPlay();
+    }
+    getPhysicsVehicle() {
+        return this.physicsVehicle;
+    }
+    /**
+     * Gets the current steering angle in radians
+     */
+    getCurrentSteeringAngle() {
+        return this.currentSteering * this.options.maxSteeringAngle;
+    }
+    tickPrePhysics(deltaTime) {
+        super.tickPrePhysics(deltaTime);
+        this.createVehiclePhysics();
+        this.updateVehicleControls(deltaTime);
+    }
+    tickPostPhysics(deltaTime) {
+        super.tickPostPhysics(deltaTime);
+        this.updateWheels();
+    }
+    jump(strength = 1) {
+        this.brakeInput = 1;
+    }
+    stopJump() {
+        this.brakeInput = 0;
+    }
+    /**
+     * Sets up the vehicle physics simulation
+     */
+    createVehiclePhysics() {
+        if (this.physicsVehicle)
+            return;
+        const physicsEngine = this.getPhysicsEngine();
+        if (!physicsEngine)
+            return;
+        const actor = this.getActor();
+        // TOOD: for now the root component is assumed to be the chassis, this may be somewhat limiting
+        const chassisComponent = actor.rootComponent;
+        if (!(chassisComponent instanceof PrimitiveComponent) || chassisComponent.getMotionType() !== PhysicsMotionType.Dynamic)
+            return;
+        // Create vehicle controller through physics engine
+        this.physicsVehicle = physicsEngine.createVehicle(this, chassisComponent);
+        if (!this.physicsVehicle)
+            return;
+        // Setup wheels
+        this.wheelMeshes.clear();
+        const numWheels = this.options.wheels.length;
+        for (let i = 0; i < numWheels; i++) {
+            const wheelConfig = this.options.wheels[i];
+            // Add wheel to vehicle controller
+            const wheelIndex = this.physicsVehicle.addWheel(wheelConfig);
+            if (this.options.createWheelMeshes) {
+                // Create wheel mesh
+                const geometry = new THREE.CylinderGeometry(wheelConfig.radius, wheelConfig.radius, wheelConfig.width, 16);
+                geometry.rotateZ(Math.PI * 0.5); // Orient wheel correctly
+                const material = new THREE.MeshStandardMaterial({
+                    color: this.options.wheelMaterialColor
+                });
+                const wheelMesh = new THREE.Mesh(geometry, material);
+                wheelMesh.castShadow = true;
+                wheelMesh.position.copy(wheelConfig.position);
+                wheelMesh.setTransient(true);
+                // Add wheel to chassis mesh
+                chassisComponent.add(wheelMesh);
+                this.wheelMeshes.set(wheelIndex, wheelMesh);
+            }
+        }
+        console.log(`VehicleMovementComponent: Created ${this.physicsVehicle.numWheels()} wheels`);
+    }
+    /**
+     * Updates vehicle control inputs with smoothing
+     */
+    updateVehicleControls(deltaTime) {
+        if (!this.physicsVehicle)
+            return;
+        const accelerationInput = -this.forwardInput.value;
+        let brakeInput = this.brakeInput;
+        const steeringInput = -this.rightInput.value;
+        if (this.isPlayerControlled()) {
+            if (accelerationInput === 0 && brakeInput === 0 && steeringInput === 0) {
+                if (this.options.autoStopBreak > 0) {
+                    brakeInput += this.options.autoStopBreak;
+                }
+            }
+        }
+        else {
+            if (this.options.autoBreakWhenNotPossessed > 0) {
+                brakeInput += this.options.autoBreakWhenNotPossessed;
+            }
+        }
+        // Smooth engine force
+        const targetEngineForce = accelerationInput * this.options.maxEnginePower * this.speedModifier;
+        this.currentEngineForce = THREE.MathUtils.lerp(this.currentEngineForce, targetEngineForce, this.options.engineResponseRate * deltaTime);
+        // Smooth brake force
+        const targetBrakeForce = brakeInput * this.options.maxBrakeForce * this.speedModifier;
+        this.currentBrakeForce = THREE.MathUtils.lerp(this.currentBrakeForce, targetBrakeForce, this.options.brakeResponseRate * deltaTime);
+        // Smooth steering
+        this.currentSteering = THREE.MathUtils.lerp(this.currentSteering, steeringInput, this.options.steeringResponseRate * deltaTime);
+        try {
+            this.physicsVehicle.setEngineForce(this.currentEngineForce);
+            this.physicsVehicle.setBrakeForce(this.currentBrakeForce);
+            this.physicsVehicle.setSteering(this.currentSteering * this.options.maxSteeringAngle);
+        }
+        catch (error) {
+            console.error(error);
+        }
+    }
+    /**
+     * Updates wheel visual positions and rotations based on physics
+     */
+    updateWheels() {
+        if (!this.physicsVehicle)
+            return;
+        for (let i = 0; i < this.physicsVehicle.numWheels(); i++) {
+            const wheelState = this.physicsVehicle.getWheelState(i);
+            if (!wheelState)
+                continue;
+            this.onWheelUpdated.invoke(this, i, wheelState);
+            const wheelMesh = this.wheelMeshes.get(i);
+            if (wheelMesh) {
+                wheelMesh.position.copy(wheelState.relativePosition);
+                wheelMesh.quaternion.copy(wheelState.relativeQuaternion);
+            }
+        }
+    }
+    /**
+     * Cleans up vehicle physics
+     */
+    cleanupVehiclePhysics() {
+        const physicsEngine = this.getPhysicsEngine();
+        if (!physicsEngine)
+            return;
+        // Destroy vehicle controller
+        if (this.physicsVehicle) {
+            this.physicsVehicle.destroy();
+            this.physicsVehicle = null;
+        }
+        this.wheelMeshes.clear();
+        console.log('VehicleMovementComponent: Physics cleaned up');
+    }
+    /**
+     * Flips the vehicle if it's upside down
+     * @param forceFlip If true, flips the vehicle regardless of orientation
+     * @returns True if the vehicle was flipped, false otherwise
+     */
+    flipVehicle(forceFlip = false) {
+        const actor = this.getActor();
+        if (!actor)
+            return false;
+        const rootComponent = actor.rootComponent;
+        if (!rootComponent)
+            return false;
+        // Get the vehicle's current up vector
+        const vehicleUp = new THREE.Vector3(0, 1, 0);
+        const worldQuaternion = new THREE.Quaternion();
+        rootComponent.getWorldQuaternion(worldQuaternion);
+        vehicleUp.applyQuaternion(worldQuaternion);
+        // Check if the vehicle needs flipping (upside down or on its side)
+        const worldUp = new THREE.Vector3(0, 1, 0);
+        const upDot = vehicleUp.dot(worldUp);
+        // Vehicle needs flipping if:
+        // - Upside down (dot product < 0)
+        // - Tilted more than 60 degrees from upright (dot product < 0.5)
+        const needsFlip = upDot < 0.5;
+        if (forceFlip || needsFlip) {
+            // Get current position and rotation
+            const currentPosition = new THREE.Vector3();
+            const currentQuaternion = new THREE.Quaternion();
+            rootComponent.getWorldPosition(currentPosition);
+            rootComponent.getWorldQuaternion(currentQuaternion);
+            // Set upright rotation directly, preserving only the Y (yaw) rotation
+            const currentEuler = new THREE.Euler();
+            currentEuler.setFromQuaternion(currentQuaternion, 'YXZ');
+            // Create upright rotation keeping only the Y rotation (yaw)
+            const uprightEuler = new THREE.Euler(0, currentEuler.y, 0, 'YXZ');
+            const newQuaternion = new THREE.Quaternion();
+            newQuaternion.setFromEuler(uprightEuler);
+            // Lift the vehicle slightly to avoid collision issues
+            currentPosition.y += 2;
+            // Apply the new transform
+            rootComponent.setWorldPosition(currentPosition);
+            rootComponent.setWorldQuaternion(newQuaternion);
+            // Reset physics velocity to prevent tumbling
+            const physicsEngine = this.getPhysicsEngine();
+            if (physicsEngine && rootComponent instanceof PrimitiveComponent) {
+                physicsEngine.setVectorParam(rootComponent, PhysicsVectorParam.LinearVelocity, [0, 0, 0]);
+                physicsEngine.setVectorParam(rootComponent, PhysicsVectorParam.AngularVelocity, [0, 0, 0]);
+            }
+            return true;
+        }
+        return false;
+    }
+    //====================================================================================================
+    // Editor Functions
+    //====================================================================================================
+    getEditorClassIcon() {
+        return 'Icon_Vehicle';
+    }
+};
+VehicleMovementComponent = __decorate([
+    EngineClass('VehicleMovementComponent'),
+    __metadata("design:paramtypes", [Object])
+], VehicleMovementComponent);
+export { VehicleMovementComponent };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVmVoaWNsZU1vdmVtZW50Q29tcG9uZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvbW92ZW1lbnQvVmVoaWNsZU1vdmVtZW50Q29tcG9uZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7OztBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBc0JHO0FBQ0gsT0FBTyxLQUFLLEtBQUssTUFBTSxPQUFPLENBQUM7QUFFL0IsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDcEUsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFDbEUsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQzdELE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUNuRCxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUU5RCxPQUFPLEVBQUUseUJBQXlCLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQW1EM0U7O0dBRUc7QUFFSSxJQUFNLHdCQUF3QixHQUE5QixNQUFNLHdCQUEyRixTQUFRLHlCQUFtQztJQVFqSixNQUFNLEtBQWMsZUFBZTtRQUNqQyxNQUFNLGNBQWMsR0FBRyxHQUFHLENBQUM7UUFDM0IsTUFBTSxlQUFlLEdBQUcsR0FBRyxDQUFDO1FBQzVCLE1BQU0sZUFBZSxHQUFHLENBQUMsQ0FBQztRQUMxQixNQUFNLG9CQUFvQixHQUFHLEdBQUcsQ0FBQztRQUNqQyxNQUFNLFdBQVcsR0FBRyxHQUFHLENBQUM7UUFDeEIsTUFBTSxVQUFVLEdBQUcsR0FBRyxDQUFDO1FBQ3ZCLE1BQU0sbUJBQW1CLEdBQUcsRUFBRSxDQUFDO1FBQy9CLE1BQU0scUJBQXFCLEdBQUcsSUFBSSxDQUFDO1FBQ25DLE1BQU0sb0JBQW9CLEdBQUcsSUFBSSxDQUFDO1FBQ2xDLE1BQU0sa0JBQWtCLEdBQUcs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

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

@@ -0,0 +1,19 @@
+/**
+ * Movement components aggregate export.
+ *
+ * This barrel file exposes all movement-related components used by the Genesys
+ * engine. Importing from this module grants access to base pawn movement along
+ * with specialized implementations like character and airplane controllers.
+ * Keeping these exports centralized simplifies dependency management and helps
+ * AI assistants discover available movement behaviors.
+ */
+export * from './BasePawnMovementComponent.js';
+export * from './CharacterMovementComponent.js';
+export * from './TopDownMovementComponent.js';
+export * from './AirplaneMovementComponent.js';
+export * from './AerialMovementComponent.js';
+export * from './NpcMovementComponent.js';
+export * from './PathMovementComponent.js';
+export * from './DirectionalCharacterMovementComponent.js';
+export * from './VehicleMovementComponent.js';
+export * from './TweenMovementComponent.js';

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

@@ -0,0 +1,20 @@
+/**
+ * Movement components aggregate export.
+ *
+ * This barrel file exposes all movement-related components used by the Genesys
+ * engine. Importing from this module grants access to base pawn movement along
+ * with specialized implementations like character and airplane controllers.
+ * Keeping these exports centralized simplifies dependency management and helps
+ * AI assistants discover available movement behaviors.
+ */
+export * from './BasePawnMovementComponent.js';
+export * from './CharacterMovementComponent.js';
+export * from './TopDownMovementComponent.js';
+export * from './AirplaneMovementComponent.js';
+export * from './AerialMovementComponent.js';
+export * from './NpcMovementComponent.js';
+export * from './PathMovementComponent.js';
+export * from './DirectionalCharacterMovementComponent.js';
+export * from './VehicleMovementComponent.js';
+export * from './TweenMovementComponent.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvY29tcG9uZW50cy9tb3ZlbWVudC9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7R0FRRztBQUNILGNBQWMsZ0NBQWdDLENBQUM7QUFDL0MsY0FBYyxpQ0FBaUMsQ0FBQztBQUNoRCxjQUFjLCtCQUErQixDQUFDO0FBQzlDLGNBQWMsZ0NBQWdDLENBQUM7QUFDL0MsY0FBYyw4QkFBOEIsQ0FBQztBQUM3QyxjQUFjLDJCQUEyQixDQUFDO0FBQzFDLGNBQWMsNEJBQTRCLENBQUM7QUFDM0MsY0FBYyw0Q0FBNEMsQ0FBQztBQUMzRCxjQUFjLCtCQUErQixDQUFDO0FBQzlDLGNBQWMsNkJBQTZCLENBQUMifQ==

package/dist/src/components/physics/RagdollComponent.d.ts

@@ -0,0 +1,118 @@
+/**
+ * RagdollComponent manages physics-based character ragdoll simulation.
+ *
+ * This component creates individual physics bodies for major body parts (head, torso, limbs)
+ * and connects them with spherical joints. It integrates with the existing GLTFMeshComponent
+ * to drive skeletal animation from physics simulation.
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Attach to actors that have a GLTFMeshComponent with a humanoid skeleton
+ * - Call activateRagdoll() to transition from animation to physics simulation
+ * - Use deactivateRagdoll() to return to normal animation
+ * - Configure bone mapping and physics properties via options
+ */
+import * as THREE from 'three';
+import { SceneComponent } from '../SceneComponent.js';
+import type { SceneComponentOptions } from '../SceneComponent.js';
+export interface RagdollBoneConfig {
+    boneName: string;
+    size: THREE.Vector3;
+    mass: number;
+    offset?: THREE.Vector3;
+}
+export interface RagdollJointConfig {
+    parentLimb: string;
+    childLimb: string;
+    localAnchor1: THREE.Vector3;
+    localAnchor2: THREE.Vector3;
+}
+export interface RagdollComponentOptions extends SceneComponentOptions {
+    /** Whether ragdoll is initially active */
+    initiallyActive?: boolean;
+    /** Bone mapping configuration */
+    boneMapping?: {
+        [limbName: string]: string;
+    };
+    /** Physics configuration for each limb */
+    limbConfigs?: {
+        [limbName: string]: RagdollBoneConfig;
+    };
+    /** Joint configuration */
+    joints?: RagdollJointConfig[];
+    /** Default mass for limbs */
+    defaultMass?: number;
+    /** Overall scale factor for physics bodies */
+    physicsScale?: number;
+    /** Whether to show debug spheres at physics body locations */
+    debugSpheres?: boolean;
+}
+type RagdollLimbs = 'hips' | 'head' | 'torso' | 'armUpperRight' | 'armLowerRight' | 'armUpperLeft' | 'armLowerLeft' | 'thighRight' | 'shinRight' | 'thighLeft' | 'shinLeft';
+export declare class RagdollComponent extends SceneComponent<RagdollComponentOptions> {
+    static get DEFAULT_OPTIONS(): RagdollComponentOptions;
+    private gltfComponent;
+    private physicsEngine;
+    private isActive;
+    private ragdollBodies;
+    private joints;
+    private initialBoneWorldQuaternions;
+    private initialBoneLocalTransforms;
+    private boneMapping;
+    private animationMixer;
+    private debugSpheres;
+    private debugSphereMaterial;
+    constructor(options?: RagdollComponentOptions);
+    beginPlay(): void;
+    endPlay(): void;
+    tickPostPhysics(deltaTime: number): void;
+    /**
+     * Activates the ragdoll physics simulation
+     */
+    activateRagdoll(): void;
+    /**
+     * Deactivates the ragdoll physics simulation
+     */
+    deactivateRagdoll(): void;
+    /**
+     * Applies an impulse to a specific limb
+     */
+    applyImpulseToLimb(limbName: RagdollLimbs, impulse: THREE.Vector3): void;
+    /**
+     * Gets whether the ragdoll is currently active
+     */
+    isRagdollActive(): boolean;
+    private storeInitialBoneOrientations;
+    private createRagdollBodies;
+    private getDefaultBodyConfigs;
+    private createJoints;
+    private updateBoneTransforms;
+    private cleanup;
+    /**
+     * Creates debug spheres to visualize physics body positions
+     */
+    private createDebugSpheres;
+    /**
+     * Updates debug sphere positions to match physics bodies
+     */
+    private updateDebugSpheres;
+    /**
+     * Destroys all debug spheres and cleans up resources
+     */
+    private destroyDebugSpheres;
+    /**
+     * Forces a complete skeleton update after bone transforms have been modified
+     */
+    private forceSkeletonUpdate;
+    /**
+     * Updates the skeleton after bone transforms have been modified (legacy method)
+     */
+    private updateSkeleton;
+    /**
+     * Restores all bones to their original poses when deactivating ragdoll
+     */
+    private restoreOriginalPose;
+    /**
+     * Gets the parent limb name for kinematic chain calculations
+     */
+    private getParentLimbName;
+}
+export {};