@directivegames/genesys.js 3.1.24

package/dist/src/actors/GlobalParticleManager.js

@@ -0,0 +1,365 @@
+/**
+ * GlobalParticleManager provides global VFX system management functionality.
+ *
+ * Manages wawa-vfx-vanilla VFX particles and emitters for advanced VFX effects.
+ * It serves as a container for fire-and-forget VFX spawning with automatic lifetime management.
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Use spawnVFX() or spawnVFXFromPath() to create fire-and-forget VFX effects
+ * - Use for one-off particle effects like explosions, sparks, or impact effects
+ * - Access through world.getParticleManager() or GlobalParticleManager.getInstance()
+ * - VFX are automatically managed and removed when their lifetime expires
+ *
+ * Legacy ParticleEmitterComponent support:
+ * - attachParticleEmitter() is deprecated, use spawnVFX() instead
+ * - Old particle system will be removed in future versions
+ */
+import * as THREE from 'three';
+import * as WawaVFX from 'wawa-vfx-vanilla';
+import { AssetPath } from '../storage/storageProvider.js';
+import { resourceManager } from '../utils/ResourceManager.js';
+import { VFXDefinition } from '../vfx/types.js';
+import { Actor } from './Actor.js';
+// We don't need to register the class, because it should not be instantiated, and it's
+// always transient. We could also drop the base class, but since it has a child component,
+// this solution is easier.
+// @EngineClass('GlobalParticleManager')
+export class GlobalParticleManager extends Actor {
+    constructor(options = {}) {
+        super({
+            ...options,
+            position: new THREE.Vector3(0, 0, 0)
+        });
+        Object.defineProperty(this, "attachedParticles", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "attachedVFX", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "vfxParticlesRegistry", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+    }
+    doEndPlay() {
+        this.cleanupAllParticles();
+        this.cleanupAllVFX();
+        this.cleanupVFXParticles();
+        super.doEndPlay();
+    }
+    tickPrePhysics(deltaTime) {
+        super.tickPrePhysics(deltaTime);
+        this.updateParticleLifecycles(deltaTime);
+        this.updateVFXLifecycles(deltaTime);
+        this.updateVFXParticles();
+    }
+    /**
+     * Attach a particle emitter component in a fire-and-forget fashion
+     * @param particleComponent The particle emitter component to attach
+     * @param options Configuration for the attachment
+     * @returns Unique identifier for this particle instance
+     * @deprecated Use spawnVFX() or spawnVFXFromPath() instead
+     */
+    attachParticleEmitter(particleComponent, options = {}) {
+        // Set position, rotation, and scale if provided
+        if (options.position) {
+            particleComponent.position.copy(options.position);
+        }
+        if (options.rotation) {
+            particleComponent.rotation.copy(options.rotation);
+        }
+        if (options.scale) {
+            particleComponent.scale.copy(options.scale);
+        }
+        // Attach the component to this actor's root
+        this.rootComponent.add(particleComponent);
+        const totalLifetime = options.lifetime ?? particleComponent.options.particleLifetime;
+        // Track the particle
+        const particleInfo = {
+            component: particleComponent,
+            attachTime: this.getWorld()?.getGameTime() ?? 0,
+            lifetime: totalLifetime,
+        };
+        this.attachedParticles.push(particleInfo);
+    }
+    /**
+     * Get information about all currently attached particles
+     * @returns Array of particle information
+     * @deprecated Use getAttachedVFX() instead
+     */
+    getAttachedParticles() {
+        return this.attachedParticles;
+    }
+    /**
+     * Manually cleanup all attached particles
+     * @deprecated Use cleanupAllVFX() instead
+     */
+    cleanupAllParticles() {
+        for (const particleInfo of this.attachedParticles) {
+            particleInfo.component.removeFromParent();
+        }
+        this.attachedParticles = [];
+    }
+    /**
+     * Update particle lifecycles and remove expired ones
+     * @deprecated - updates ParticleEmitterComponents which are not supported anymore
+     * @param deltaTime Time since last frame
+     */
+    updateParticleLifecycles(deltaTime) {
+        const world = this.getWorld();
+        if (!world)
+            return;
+        const currentTime = world.getGameTime();
+        const remainingParticles = [];
+        for (const particleInfo of this.attachedParticles) {
+            const elapsedTime = currentTime - particleInfo.attachTime;
+            if (elapsedTime < particleInfo.lifetime) {
+                remainingParticles.push(particleInfo);
+            }
+            else {
+                particleInfo.component.removeFromParent();
+            }
+        }
+        this.attachedParticles = remainingParticles;
+    }
+    /**
+     * Update VFX lifecycles and remove expired ones
+     * @param deltaTime Time since last frame
+     */
+    updateVFXLifecycles(deltaTime) {
+        const world = this.getWorld();
+        if (!world)
+            return;
+        const currentTime = world.getGameTime();
+        const remainingVFX = [];
+        for (const vfxInfo of this.attachedVFX) {
+            // Update the emitter with global time, not elapsed time
+            vfxInfo.emitter.update(currentTime, deltaTime);
+            const elapsedTime = currentTime - vfxInfo.attachTime;
+            if (elapsedTime < vfxInfo.lifetime) {
+                remainingVFX.push(vfxInfo);
+            }
+            else {
+                vfxInfo.emitter.removeFromParent();
+            }
+        }
+        this.attachedVFX = remainingVFX;
+    }
+    /**
+     * Update all registered VFXParticles systems
+     */
+    updateVFXParticles() {
+        const world = this.getWorld();
+        if (!world)
+            return;
+        const elapsedTime = world.getGameTime();
+        for (const vfxParticles of this.vfxParticlesRegistry.values()) {
+            vfxParticles.update(elapsedTime);
+        }
+    }
+    /**
+     * Manually cleanup all attached VFX
+     */
+    cleanupAllVFX() {
+        for (const vfxInfo of this.attachedVFX) {
+            vfxInfo.emitter.removeFromParent();
+        }
+        this.attachedVFX = [];
+    }
+    /**
+     * Cleanup all VFXParticles systems (dispose and remove from registry)
+     */
+    cleanupVFXParticles() {
+        const world = this.getWorld();
+        if (world) {
+            for (const [name, vfxParticles] of this.vfxParticlesRegistry) {
+                // Remove mesh from scene
+                world.scene.remove(vfxParticles.getMesh());
+                // Dispose VFXParticles
+                vfxParticles.dispose();
+            }
+        }
+        this.vfxParticlesRegistry.clear();
+    }
+    /**
+     * Get or create a VFXParticles instance for the given name
+     * @param name Unique identifier for the VFX particles system
+     * @param settings VFX particles settings
+     * @returns The VFXParticles instance
+     */
+    async getOrCreateVFXParticles(name, settings, alphaMap, geometry) {
+        let vfxParticles = this.vfxParticlesRegistry.get(name);
+        if (!vfxParticles) {
+            // Convert settings to wawa-vfx format
+            const internalSettings = {
+                nbParticles: settings.nbParticles ?? 1000,
+                intensity: settings.intensity ?? 1,
+                renderMode: settings.renderMode ?? 'billboard',
+                stretchScale: settings.stretchScale ?? 1.0,
+                fadeSize: settings.fadeSize ?? [0.1, 0.9],
+                fadeAlpha: settings.fadeAlpha ?? [0, 1.0],
+                gravity: settings.gravity ?? [0, 0, 0],
+                frustumCulled: settings.frustumCulled ?? true,
+                appearance: settings.appearance === 'circular' ? WawaVFX.AppearanceMode.Circular : WawaVFX.AppearanceMode.Square,
+                easeFunction: settings.easeFunction ?? 'easeLinear',
+                shadingHooks: settings.shadingHooks ?? {},
+            };
+            // Convert blending mode string to THREE constant
+            if (settings.blendingMode) {
+                switch (settings.blendingMode) {
+                    case 'normal':
+                        internalSettings.blendingMode = THREE.NormalBlending;
+                        break;
+                    case 'additive':
+                        internalSettings.blendingMode = THREE.AdditiveBlending;
+                        break;
+                    case 'subtractive':
+                        internalSettings.blendingMode = THREE.SubtractiveBlending;
+                        break;
+                    case 'multiply':
+                        internalSettings.blendingMode = THREE.MultiplyBlending;
+                        break;
+                }
+            }
+            // Load alpha map if specified
+            if (settings.alphaMapPath && !alphaMap) {
+                const world = this.getWorld();
+                if (world) {
+                    const assetPath = new AssetPath(settings.alphaMapPath);
+                    const loadedTexture = await resourceManager.loadTexture(assetPath);
+                    if (loadedTexture) {
+                        alphaMap = loadedTexture;
+                    }
+                }
+            }
+            // Load geometry if specified, or use default cube for mesh mode
+            if (settings.geometryPath && !geometry) {
+                const world = this.getWorld();
+                if (world) {
+                    const assetPath = new AssetPath(settings.geometryPath);
+                    const gltf = await resourceManager.loadModel(assetPath);
+                    if (gltf && gltf.scene.children[0] instanceof THREE.Mesh) {
+                        geometry = gltf.scene.children[0].geometry;
+                    }
+                }
+            }
+            else if (settings.renderMode === 'mesh') {
+                // Use default cube geometry for mesh mode
+                geometry = new THREE.BoxGeometry(1, 1, 1);
+            }
+            // Create VFXParticles
+            vfxParticles = new WawaVFX.VFXParticles(name, internalSettings, WawaVFX.vfxStore.getState(), alphaMap, geometry);
+            // Add to scene
+            const world = this.getWorld();
+            if (world) {
+                world.scene.add(vfxParticles.getMesh());
+            }
+            this.vfxParticlesRegistry.set(name, vfxParticles);
+        }
+        return vfxParticles;
+    }
+    /**
+     * Spawn a VFX effect from code (supports single or multiple emitters/particles)
+     * @param name Unique name for the VFX
+     * @param particlesSettings Particle system settings (single or array)
+     * @param emitterSettings Emitter settings (single or array)
+     * @param options Spawn options
+     * @returns Array of created emitters
+     */
+    async spawnVFX(name, particlesSettings, emitterSettings, options = {}) {
+        // Normalize to arrays
+        const particlesArray = Array.isArray(particlesSettings) ? particlesSettings : [particlesSettings];
+        const emittersArray = Array.isArray(emitterSettings) ? emitterSettings : [emitterSettings];
+        const definition = new VFXDefinition({
+            name,
+            particles: particlesArray,
+            emitters: emittersArray,
+        });
+        return this.spawnVFXFromDefinition(definition, options);
+    }
+    /**
+     * Spawn a VFX effect from a definition (v2 API for multiple emitters/particles)
+     * @param definition VFX definition with multiple particles and emitters
+     * @param options Spawn options
+     * @returns Array of created emitters
+     */
+    async spawnVFXFromDefinition(definition, options = {}) {
+        const emitters = [];
+        // Create all particle systems
+        for (let i = 0; i < definition.particles.length; i++) {
+            const particleSettings = definition.particles[i];
+            const particleName = `${definition.name}_particles_${i}`;
+            await this.getOrCreateVFXParticles(particleName, particleSettings);
+        }
+        // Create all emitters
+        for (let i = 0; i < definition.emitters.length; i++) {
+            const emitterSettings = definition.emitters[i];
+            const particlesIndex = emitterSettings.particlesIndex ?? 0;
+            const particleName = `${definition.name}_particles_${particlesIndex}`;
+            const emitter = new WawaVFX.VFXEmitter(particleName, emitterSettings, WawaVFX.vfxStore.getState());
+            // Set transform
+            if (options.position) {
+                emitter.position.copy(options.position);
+            }
+            if (options.rotation) {
+                emitter.rotation.copy(options.rotation);
+            }
+            if (options.scale) {
+                emitter.scale.copy(options.scale);
+            }
+            // Attach to root
+            this.rootComponent.add(emitter);
+            // Calculate lifetime from settings
+            const emitterLifetime = emitterSettings.duration ?? 1;
+            const particleLifetime = emitterSettings.particlesLifetime?.[1] ?? 1;
+            const totalLifetime = emitterSettings.loop ? Infinity : (emitterLifetime + particleLifetime);
+            // Track the VFX
+            const vfxInfo = {
+                emitter,
+                attachTime: this.getWorld()?.getGameTime() ?? 0,
+                lifetime: totalLifetime,
+            };
+            this.attachedVFX.push(vfxInfo);
+            // Start emitting
+            emitter.startEmitting(true);
+            emitters.push(emitter);
+        }
+        return emitters;
+    }
+    /**
+     * Spawn a VFX effect from a JSON file path (JSON-based)
+     * @param vfxPath Path to VFX definition JSON
+     * @param options Spawn options
+     * @returns Array of created emitters (v2) or single emitter (v1 compatibility)
+     */
+    async spawnVFXFromPath(vfxPath, options = {}) {
+        const assetPath = new AssetPath(vfxPath);
+        const json = await resourceManager.loadJsonObject(assetPath);
+        if (!json) {
+            throw new Error(`Failed to load VFX definition from ${vfxPath}`);
+        }
+        const definition = VFXDefinition.fromJSON(json);
+        return this.spawnVFXFromDefinition(definition, options);
+    }
+    /**
+     * Get the VFX store for advanced usage
+     */
+    getVFXStore() {
+        return WawaVFX.vfxStore.getState();
+    }
+    /**
+     * Get information about all currently attached VFX
+     */
+    getAttachedVFX() {
+        return this.attachedVFX;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR2xvYmFsUGFydGljbGVNYW5hZ2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2FjdG9ycy9HbG9iYWxQYXJ0aWNsZU1hbmFnZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7Ozs7Ozs7OztHQWVHO0FBQ0gsT0FBTyxLQUFLLEtBQUssTUFBTSxPQUFPLENBQUM7QUFDL0IsT0FBTyxLQUFLLE9BQU8sTUFBTSxrQkFBa0IsQ0FBQztBQUU1QyxPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFFMUQsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQzlELE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUVoRCxPQUFPLEVBQUUsS0FBSyxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBK0JuQyx1RkFBdUY7QUFDdkYsMkZBQTJGO0FBQzNGLDJCQUEyQjtBQUMzQix3Q0FBd0M7QUFDeEMsTUFBTSxPQUFPLHFCQUFzQixTQUFRLEtBQUs7SUFLOUMsWUFBWSxVQUF3QixFQUFrQjtRQUNwRCxLQUFLLENBQUM7WUFDSixHQUFHLE9BQU87WUFDVixRQUFRLEVBQUUsSUFBSSxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsQ0FBQyxDQUFDO1NBQ3JDLENBQUMsQ0FBQztRQVJHOzs7O21CQUE0QyxFQUFFO1dBQUM7UUFDL0M7Ozs7bUJBQWlDLEVBQUU7V0FBQztRQUNwQzs7OzttQkFBa0QsSUFBSSxHQUFHLEVBQUU7V0FBQztJQU9wRSxDQUFDO0lBRWUsU0FBUztRQUN2QixJQUFJLENBQUMsbUJBQW1CLEVBQUUsQ0FBQztRQUMzQixJQUFJLENBQUMsYUFBYSxFQUFFLENBQUM7UUFDckIsSUFBSSxDQUFDLG1CQUFtQixFQUFFLENBQUM7UUFDM0IsS0FBSyxDQUFDLFNBQVMsRUFBRSxDQUFDO0lBQ3BCLENBQUM7SUFFZSxjQUFjLENBQUMs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

package/dist/src/actors/Pawn.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Pawn - controllable actor that receives input from a PlayerController.
+ *
+ * Detailed explanation:
+ * - Owns a movement component and an optional camera component that define how it moves and what it sees.
+ * - Implements helper methods like `beginFire` and `jump` that delegate to equipped components.
+ * - Designed to be subclassed for game-specific behaviors while keeping input routing consistent.
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Possess an instance with `PlayerController` to drive it via keyboard or gamepad.
+ * - Override movement or input functions to integrate custom mechanics.
+ * - Use the provided delegates to intercept input events if you need bespoke logic.
+ */
+import { Delegate } from '../utils/Delegate.js';
+import { Actor } from './Actor.js';
+import type { ActorOptions } from './Actor.js';
+import type { PlayerController } from './PlayerController.js';
+import type { IEquipment } from '../components/gameplay/Equipment.js';
+import type { BasePawnMovementComponent } from '../components/movement/BasePawnMovementComponent.js';
+import type { GamepadAxis, GamepadAxisEventDelegate, GamepadButton, GamepadButtonEventDelegate, KeyboardEventDelegate, MouseButton, MouseEventDelegate } from '../systems/InputManager.js';
+import type * as THREE from 'three';
+export interface PawnOptions extends ActorOptions {
+    movementComponent: BasePawnMovementComponent | null;
+    camera: THREE.Camera | null;
+    enableDirectionalLightFollowing?: boolean;
+}
+export type PawnPossessDelegate = Delegate<[Pawn, PlayerController], void>;
+export declare class Pawn<TOptions extends PawnOptions = PawnOptions> extends Actor<TOptions> {
+    private _movementComponent;
+    private playerController;
+    readonly onKeyDown: KeyboardEventDelegate;
+    readonly onKeyUp: KeyboardEventDelegate;
+    readonly onMouseDown: MouseEventDelegate;
+    readonly onMouseUp: MouseEventDelegate;
+    readonly onGamepadButtonDown: GamepadButtonEventDelegate;
+    readonly onGamepadButtonUp: GamepadButtonEventDelegate;
+    readonly onGamepadAxisChange: GamepadAxisEventDelegate;
+    readonly onPossessed: PawnPossessDelegate;
+    readonly onUnpossessed: PawnPossessDelegate;
+    private directionalLight;
+    constructor(options: TOptions);
+    /**
+     * Gets the movement component
+     */
+    get movementComponent(): BasePawnMovementComponent | null;
+    /**
+     * Sets the movement component
+     */
+    set movementComponent(component: BasePawnMovementComponent | null);
+    protected getExportedConstructor(): any;
+    /**
+       * Adds input for forward/backward movement
+       * @param value The input value (positive for forward, negative for backward)
+       * @param isAbsolute True if the value represents an absolute amount, false if it represents a speed/rate
+       */
+    addForwardInput(value: number, isAbsolute?: boolean): void;
+    /**
+       * Adds input for right/left movement
+       * @param value The input value (positive for right, negative for left)
+       * @param isAbsolute True if the value represents an absolute amount, false if it represents a speed/rate
+       */
+    addRightInput(value: number, isAbsolute?: boolean): void;
+    /**
+       * Adds input for looking up/down
+       * @param value The input value (positive for up, negative for down)
+       * @param isAbsolute True if the value represents an absolute amount, false if it represents a speed/rate
+       */
+    addLookUpInput(value: number, isAbsolute?: boolean): void;
+    /**
+       * Adds input for looking right/left
+       * @param value The input value (positive for right, negative for left)
+       * @param isAbsolute True if the value represents an absolute amount, false if it represents a speed/rate
+       */
+    addLookRightInput(value: number, isAbsolute?: boolean): void;
+    /**
+       * Adds input for zooming in/out
+       * @param value The input value (positive for zoom in, negative for zoom out)
+       * @param isAbsolute True if the value represents an absolute amount, false if it represents a speed/rate
+       */
+    addZoomInput(value: number, isAbsolute?: boolean): void;
+    /**
+       * Sets the player controller that controls this pawn
+       * @param playerController The player controller instance or null to clear
+       */
+    setPlayerController(playerController: PlayerController | null): void;
+    /**
+       * Gets the player controller that controls this pawn
+       * @returns The current player controller or null if none
+       */
+    getPlayerController(): PlayerController | null;
+    /**
+       * Jumps the pawn
+       */
+    jump(strength?: number): void;
+    /**
+     * Stops the pawn's jump
+     */
+    stopJump(): void;
+    /**
+       * Fire or use the equipment
+       * @returns True if the fire was successful, false otherwise
+       */
+    beginFire(): boolean;
+    /**
+       * Stop firing or using the equipment
+       * @returns True if the stop was successful, false otherwise
+       */
+    endFire(): boolean;
+    /**
+       * Fire or use the equipment
+       * @returns True if the fire was successful, false otherwise
+       */
+    beginAltFire(): boolean;
+    /**
+       * Stop firing or using the equipment
+       * @returns True if the stop was successful, false otherwise
+       */
+    endAltFire(): boolean;
+    /**
+       * Reload the equipped weapon
+       * @returns True if the reload was initiated, false otherwise
+       */
+    reload(): boolean;
+    /**
+     * Sets the world transform of the pawn
+     * @param transform The transform to set
+     */
+    setWorldTransform(transform: {
+        position?: THREE.Vector3;
+        rotation?: THREE.Euler;
+        scale?: THREE.Vector3;
+    }): void;
+    /**
+     * Handles key down events from the input system
+     * @param e The keyboard event
+     * @returns True if the event was handled, false otherwise
+     */
+    handleKeyDown(e: KeyboardEvent): boolean;
+    /**
+     * Handles key up events from the input system
+     * @param e The keyboard event
+     * @returns True if the event was handled, false otherwise
+     */
+    handleKeyUp(e: KeyboardEvent): boolean;
+    /**
+     * Handles mouse down events from the input system
+     * @param button The mouse button
+     * @param e The mouse event
+     * @returns True if the event was handled, false otherwise
+     */
+    handleMouseDown(button: MouseButton, e: MouseEvent): boolean;
+    /**
+     * Handles mouse up events from the input system
+     * @param button The mouse button
+     * @param e The mouse event
+     * @returns True if the event was handled, false otherwise
+     */
+    handleMouseUp(button: MouseButton, e: MouseEvent): boolean;
+    /**
+     * Handles gamepad button down events
+     * @param gamepadIndex The index of the gamepad
+     * @param buttonIndex The button that was pressed
+     * @param value The intensity of the button press (0.0 to 1.0)
+     * @returns True if the event was handled, false otherwise
+     */
+    handleGamepadButtonDown(gamepadIndex: number, buttonIndex: GamepadButton, value: number): boolean;
+    /**
+     * Handles gamepad button up events
+     * @param gamepadIndex The index of the gamepad
+     * @param buttonIndex The button that was released
+     * @returns True if the event was handled, false otherwise
+     */
+    handleGamepadButtonUp(gamepadIndex: number, buttonIndex: GamepadButton): boolean;
+    /**
+     * Handles gamepad axis change events
+     * @param gamepadIndex The index of the gamepad
+     * @param axisIndex The axis that changed
+     * @param value The new value of the axis (-1.0 to 1.0)
+     * @returns True if the event was handled, false otherwise
+     */
+    handleGamepadAxisChange(gamepadIndex: number, axisIndex: GamepadAxis, value: number): boolean;
+    isNetRelevant(): boolean;
+    getNetDynamicState(lastReplicatedState: object | null): object | null;
+    setNetDynamicState(dynamicState: object): void;
+    tickPrePhysics(deltaTime: number): void;
+    protected callEquipment(method: keyof IEquipment): boolean;
+    protected doBeginPlay(): void;
+    protected doEndPlay(): void;
+    private jumpCommand;
+    getEditorClassIcon(): string | null;
+}