@directivegames/genesys.js 3.1.24

package/dist/src/actors/Pawn.js

@@ -0,0 +1,384 @@
+/**
+ * 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.
+ */
+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);
+};
+import { isEquipment } from '../components/gameplay/Equipment.js';
+import { DirectionalLightComponent } from '../components/lights/DirectionalLightComponent.js';
+import { SceneComponent } from '../components/SceneComponent.js';
+import { EngineClass } from '../systems/ClassRegistry.js';
+import { ConsoleCommand } from '../systems/ConsoleManager.js';
+import { Delegate } from '../utils/Delegate.js';
+import { Actor } from './Actor.js';
+let Pawn = class Pawn extends Actor {
+    constructor(options) {
+        options.enableDirectionalLightFollowing ??= true;
+        super(options);
+        Object.defineProperty(this, "_movementComponent", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "playerController", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "onKeyDown", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        Object.defineProperty(this, "onKeyUp", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        Object.defineProperty(this, "onMouseDown", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        Object.defineProperty(this, "onMouseUp", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        Object.defineProperty(this, "onGamepadButtonDown", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        Object.defineProperty(this, "onGamepadButtonUp", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        Object.defineProperty(this, "onGamepadAxisChange", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        Object.defineProperty(this, "onPossessed", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        Object.defineProperty(this, "onUnpossessed", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        Object.defineProperty(this, "directionalLight", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        if (options.movementComponent) {
+            this._movementComponent = options.movementComponent;
+            this.rootComponent.add(options.movementComponent);
+        }
+        if (options.camera) {
+            this.rootComponent.add(options.camera);
+        }
+    }
+    /**
+     * Gets the movement component
+     */
+    get movementComponent() {
+        return this._movementComponent;
+    }
+    /**
+     * Sets the movement component
+     */
+    set movementComponent(component) {
+        if (this._movementComponent) {
+            this._movementComponent.removeFromParent();
+        }
+        this._movementComponent = component;
+        if (component) {
+            this.rootComponent.add(component);
+        }
+    }
+    getExportedConstructor() {
+        return {
+            ...super.getExportedConstructor(),
+            // no need to export the camera component as it will be exported as part of the actor
+            camera: undefined,
+        };
+    }
+    /**
+       * 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, isAbsolute = false) {
+        this.movementComponent?.addForwardInput(value, isAbsolute);
+    }
+    /**
+       * 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, isAbsolute = false) {
+        this.movementComponent?.addRightInput(value, isAbsolute);
+    }
+    /**
+       * 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, isAbsolute = false) {
+        this.movementComponent?.addLookUpInput(value, isAbsolute);
+    }
+    /**
+       * 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, isAbsolute = false) {
+        this.movementComponent?.addLookRightInput(value, isAbsolute);
+    }
+    /**
+       * 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, isAbsolute = false) {
+        this.movementComponent?.addZoomInput(value, isAbsolute);
+    }
+    /**
+       * Sets the player controller that controls this pawn
+       * @param playerController The player controller instance or null to clear
+       */
+    setPlayerController(playerController) {
+        if (this.playerController === playerController) {
+            return;
+        }
+        if (this.playerController) {
+            this.onUnpossessed.invoke(this, this.playerController);
+        }
+        this.playerController = playerController;
+        if (this.playerController) {
+            this.onPossessed.invoke(this, this.playerController);
+        }
+    }
+    /**
+       * Gets the player controller that controls this pawn
+       * @returns The current player controller or null if none
+       */
+    getPlayerController() {
+        return this.playerController;
+    }
+    /**
+       * Jumps the pawn
+       */
+    jump(strength = 1) {
+        this.movementComponent?.jump(strength);
+    }
+    /**
+     * Stops the pawn's jump
+     */
+    stopJump() {
+        this.movementComponent?.stopJump();
+    }
+    /**
+       * Fire or use the equipment
+       * @returns True if the fire was successful, false otherwise
+       */
+    beginFire() {
+        return this.callEquipment('beginFire');
+    }
+    /**
+       * Stop firing or using the equipment
+       * @returns True if the stop was successful, false otherwise
+       */
+    endFire() {
+        return this.callEquipment('endFire');
+    }
+    /**
+       * Fire or use the equipment
+       * @returns True if the fire was successful, false otherwise
+       */
+    beginAltFire() {
+        return this.callEquipment('beginAltFire');
+    }
+    /**
+       * Stop firing or using the equipment
+       * @returns True if the stop was successful, false otherwise
+       */
+    endAltFire() {
+        return this.callEquipment('endAltFire');
+    }
+    /**
+       * Reload the equipped weapon
+       * @returns True if the reload was initiated, false otherwise
+       */
+    reload() {
+        return this.callEquipment('reload');
+    }
+    /**
+     * Sets the world transform of the pawn
+     * @param transform The transform to set
+     */
+    setWorldTransform(transform) {
+        this.movementComponent?.setPawnWorldTransform(transform);
+    }
+    /**
+     * Handles key down events from the input system
+     * @param e The keyboard event
+     * @returns True if the event was handled, false otherwise
+     */
+    handleKeyDown(e) {
+        return this.onKeyDown.invokeWithPredicate(result => result, e).at(-1) ?? false;
+    }
+    /**
+     * Handles key up events from the input system
+     * @param e The keyboard event
+     * @returns True if the event was handled, false otherwise
+     */
+    handleKeyUp(e) {
+        return this.onKeyUp.invokeWithPredicate(result => result, e).at(-1) ?? false;
+    }
+    /**
+     * 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, e) {
+        return this.onMouseDown.invokeWithPredicate(result => result, button, e).at(-1) ?? false;
+    }
+    /**
+     * 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, e) {
+        return this.onMouseUp.invokeWithPredicate(result => result, button, e).at(-1) ?? false;
+    }
+    /**
+     * 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, buttonIndex, value) {
+        return this.onGamepadButtonDown.invokeWithPredicate(result => result, gamepadIndex, buttonIndex, value).at(-1) ?? false;
+    }
+    /**
+     * 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, buttonIndex) {
+        return this.onGamepadButtonUp.invokeWithPredicate(result => result, gamepadIndex, buttonIndex, 0).at(-1) ?? false;
+    }
+    /**
+     * 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, axisIndex, value) {
+        return this.onGamepadAxisChange.invokeWithPredicate(result => result, gamepadIndex, axisIndex, value).at(-1) ?? false;
+    }
+    isNetRelevant() {
+        return this.playerController !== null || super.isNetRelevant();
+    }
+    getNetDynamicState(lastReplicatedState) {
+        return null;
+    }
+    setNetDynamicState(dynamicState) {
+    }
+    tickPrePhysics(deltaTime) {
+        super.tickPrePhysics(deltaTime);
+        // make the directional light follow the pawn when it's possessed
+        if (this.options.enableDirectionalLightFollowing && this.getPlayerController()) {
+            if (!this.directionalLight) {
+                const actors = this.getWorld()?.getActors() ?? [];
+                for (const actor of actors) {
+                    this.directionalLight = actor.getComponent(DirectionalLightComponent);
+                    if (this.directionalLight) {
+                        break;
+                    }
+                }
+            }
+            if (this.directionalLight) {
+                this.directionalLight.moveTargetTo(this.getWorldPosition());
+            }
+        }
+    }
+    //====================================================================================================
+    callEquipment(method) {
+        for (const component of this.getComponents(SceneComponent)) {
+            if (isEquipment(component) && component[method]()) {
+                return true;
+            }
+        }
+        return false;
+    }
+    doBeginPlay() {
+        super.doBeginPlay();
+        this.getWorld()?.consoleManager.addCommandHandler(this);
+    }
+    doEndPlay() {
+        super.doEndPlay();
+        this.getWorld()?.consoleManager.removeCommandHandler(this);
+    }
+    jumpCommand(strength = '1') {
+        this.jump(Number(strength));
+        return 'Jumped';
+    }
+    //====================================================================================================
+    // Editor Functions
+    //====================================================================================================
+    getEditorClassIcon() {
+        return 'Icon_Pawn';
+    }
+};
+__decorate([
+    ConsoleCommand('jump', 'Make the pawn jump (usage: jump [strength])'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", String)
+], Pawn.prototype, "jumpCommand", null);
+Pawn = __decorate([
+    EngineClass('Pawn'),
+    __metadata("design:paramtypes", [Object])
+], Pawn);
+export { Pawn };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUGF3bi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9hY3RvcnMvUGF3bi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7O0dBWUc7Ozs7Ozs7Ozs7QUFFSCxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0scUNBQXFDLENBQUM7QUFDbEUsT0FBTyxFQUFFLHlCQUF5QixFQUFFLE1BQU0sbURBQW1ELENBQUM7QUFDOUYsT0FBTyxFQUFFLGNBQWMsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQ2pFLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUMxRCxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFDOUQsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBRWhELE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFtQjVCLElBQU0sSUFBSSxHQUFWLE1BQU0sSUFBaUQsU0FBUSxLQUFlO0lBaUJuRixZQUFZLE9BQWlCO1FBQzNCLE9BQU8sQ0FBQywrQkFBK0IsS0FBSyxJQUFJLENBQUM7UUFFakQsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBbkJUOzs7O21CQUF1RCxJQUFJO1dBQUM7UUFDNUQ7Ozs7bUJBQTRDLElBQUk7V0FBQztRQUV6Qzs7OzttQkFBbUMsSUFBSSxRQUFRLEVBQTRCO1dBQUM7UUFDNUU7Ozs7bUJBQWlDLElBQUksUUFBUSxFQUE0QjtXQUFDO1FBQzFFOzs7O21CQUFrQyxJQUFJLFFBQVEsRUFBc0M7V0FBQztRQUNyRjs7OzttQkFBZ0MsSUFBSSxRQUFRLEVBQXNDO1dBQUM7UUFFbkY7Ozs7bUJBQWtELElBQUksUUFBUSxFQUE0QztXQUFDO1FBQzNHOzs7O21CQUFnRCxJQUFJLFFBQVEsRUFBNEM7V0FBQztRQUN6Rzs7OzttQkFBZ0QsSUFBSSxRQUFRLEVBQTBDO1dBQUM7UUFDdkc7Ozs7bUJBQW1DLElB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

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

@@ -0,0 +1,177 @@
+/**
+ * PlayerController - actor that translates user input into pawn movement.
+ *
+ * Detailed explanation:
+ * - Reads keyboard, mouse, and gamepad events, applying sensitivity and pointer lock options.
+ * - Forwards movement axes and button presses to the currently possessed `Pawn` instance.
+ * - Exposes delegate hooks so games can intercept raw input or extend processing logic.
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Spawn one per player and call `possess` with a pawn instance to begin controlling it.
+ * - Bind to delegates like `onKeyDown` when you need custom handling beyond the default movement.
+ * - Disable pointer lock with the `noPointerLock` option for menu-driven or top-down games.
+ */
+import * as THREE from 'three';
+import { MouseButton } from '../systems/InputManager.js';
+import { VirtualJoystickIndex } from '../systems/InputManager.js';
+import { Actor } from './Actor.js';
+import type { ActorOptions } from './Actor.js';
+import type { Pawn } from './Pawn.js';
+import type { GamepadAxisEventDelegate, GamepadButtonEventDelegate, IInputHandler, InputManager, KeyboardEventDelegate, MouseEventDelegate, VirtualJoystickData } from '../systems/InputManager.js';
+/**
+ * Options for the PlayerController actor
+ */
+export interface PlayerControllerOptions extends ActorOptions {
+    /**
+     * If true, the player controller will not request pointer lock
+     */
+    noPointerLock?: boolean;
+}
+export declare class PlayerController extends Actor<PlayerControllerOptions> implements IInputHandler {
+    private pawn;
+    private forward;
+    private backward;
+    private left;
+    private right;
+    private zoom;
+    private forwardKeys;
+    private backwardKeys;
+    private leftKeys;
+    private rightKeys;
+    private zoomInKeys;
+    private zoomOutKeys;
+    private jumpKeys;
+    private reloadKeys;
+    private inputManager;
+    static inputSettings: {
+        lookSensitivity: number;
+        gamepadLookSensitivity: number;
+        joystickLookSensitivity: number;
+        joystickMovementSensitivity: number;
+    };
+    private mouseLookUp;
+    private mouseLookRight;
+    private gamepadLookUp;
+    private gamepadLookRight;
+    private joystickLookUp;
+    private joystickLookRight;
+    private lastInputDevice;
+    private joystickStartData;
+    readonly onKeyDown: KeyboardEventDelegate;
+    readonly onKeyUp: KeyboardEventDelegate;
+    readonly onMouseDown: MouseEventDelegate;
+    readonly onMouseUp: MouseEventDelegate;
+    readonly onGamepadButtonDown: GamepadButtonEventDelegate;
+    readonly onGamepadButtonUp: GamepadButtonEventDelegate;
+    readonly onGamepadAxisChange: GamepadAxisEventDelegate;
+    /**
+       * Sets the input manager for this controller
+       * @param manager The input manager to use, or null to remove
+       */
+    setInputManager(manager: InputManager | null): void;
+    /**
+       * Gets the current input manager
+       * @returns The current input manager or null if none is set
+       */
+    getInputManager(): InputManager | null;
+    /**
+       * Gets the currently possessed pawn
+       * @returns The possessed pawn or null if no pawn is possessed
+       */
+    getPawn(): Pawn | null;
+    /**
+       * 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 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 event
+       * @returns True if the event was handled, false otherwise
+       */
+    handleMouseUp(button: MouseButton, e: MouseEvent): boolean;
+    /**
+       * Handles mouse movement events from the input system
+       * @param e The mouse event
+       * @returns True if the event was handled, false otherwise
+       */
+    handleMouseMove(e: MouseEvent): boolean;
+    /**
+       * Handles mouse click events from the input system
+       * @param button The mouse button that was clicked
+       * @param e The mouse event
+       * @returns True if the event was handled, false otherwise
+       */
+    handleMouseClick(button: MouseButton, e: MouseEvent): boolean;
+    /**
+     * Handles virtual joystick events from the input system
+     * @param index The index of the virtual joystick
+     * @param joystickData The data from the virtual joystick
+     * @returns True if the event was handled, false otherwise
+     */
+    handleVirtualJoystick(index: VirtualJoystickIndex, joystickData: VirtualJoystickData): boolean;
+    /**
+       * Track the active input device with a timestamp
+       * @param device The input device that was just used
+       */
+    private setActiveInputDevice;
+    /**
+       * Handles gamepad button down events from the gamepad system
+       * @param gamepadIndex The index of the gamepad
+       * @param buttonIndex The index of the button
+       * @param value The value of the button press (0.0 to 1.0)
+       * @returns True if the event was handled, false otherwise
+       */
+    handleGamepadButtonDown(gamepadIndex: number, buttonIndex: number, value: number): boolean;
+    /**
+       * Handles gamepad button up events from the gamepad system
+       * @param gamepadIndex The index of the gamepad
+       * @param buttonIndex The index of the button
+       * @returns True if the event was handled, false otherwise
+       */
+    handleGamepadButtonUp(gamepadIndex: number, buttonIndex: number): boolean;
+    /**
+       * Handles gamepad axis change events from the gamepad system
+       * @param gamepadIndex The index of the gamepad
+       * @param axisIndex The index of the axis
+       * @param value The value of the axis (-1.0 to 1.0)
+       * @returns True if the event was handled, false otherwise
+       */
+    handleGamepadAxisChange(gamepadIndex: number, axisIndex: number, value: number): boolean;
+    /**
+       * Called before physics simulation to process input and update the controlled pawn
+       * @param deltaTime Time elapsed since the last frame in seconds
+       */
+    tickPrePhysics(deltaTime: number): void;
+    /**
+       * Releases control of the currently possessed pawn
+       */
+    unpossess(): void;
+    /**
+       * Takes control of the specified pawn
+       * @param pawn The pawn to possess (control)
+       */
+    possess(pawn: Pawn): void;
+    /**
+       * Restarts the player at the player start or a specified location
+       */
+    restartPlayer(): void;
+    getCamera(): THREE.Camera | null;
+    protected doBeginPlay(): void;
+    protected doEndPlay(): void;
+    private restartPlayerCommand;
+    getEditorClassIcon(): string | null;
+}