Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

2.4 KB
Raw Blame
// The input map: gameplay code queries named actions ("Move", "Fire") instead
// of physical keys, so keyboard, gamepad and rebound inputs all flow through
// one place. defineInputMap registers the per-frame evaluation system itself.
import {
    defineInputMap, Axis1D, Axis2D, Button, Keys1D, Keys2D, Stick, Key,
    GpAxis, GpButton, GamepadAxis, GamepadButton,
} from 'esengine';
import type { Binding } from 'esengine';

// No mouse button here on purpose: the HUD's own buttons are clicks, and Fire
// reads the raw button rather than asking whether the pointer is over UI. A mouse
// binding is reachable through the rebind below, which is where it belongs.
export const DEFAULT_FIRE: Binding[] = [Key('Space'), GpButton(GamepadButton.South)];

export const Actions = defineInputMap({
    Move: Axis2D(
        Keys2D('KeyW', 'KeyS', 'KeyA', 'KeyD'),
        Keys2D('ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight'),
        Stick('left'),
    ),
    Fire: Button(...DEFAULT_FIRE),
    // The keyboard and gamepad equivalent of the pinch gesture. GpAxis inverts
    // the raw stick Y, which points down, so pushing up grows the ship.
    Zoom: Axis1D(
        Keys1D('BracketLeft', 'BracketRight'),
        GpAxis(GamepadAxis.RightY, 0, -1),
    ),
});

/** Storage key for user rebinds (Actions.save / Actions.load). */
export const BINDINGS_KEY = 'input-actions.bindings';

function keyName(code: string): string {
    if (code.startsWith('Key')) return code.slice(3);
    if (code.startsWith('Digit')) return code.slice(5);
    return code;
}

export function formatBinding(b: Binding): string {
    switch (b.kind) {
        case 'key': return keyName(b.code);
        case 'mouse': return `Mouse ${b.button}`;
        case 'gpButton': return `Pad ${GamepadButton[b.button] ?? b.button}`;
        case 'gpAxis': return `Pad axis ${b.axis}`;
        case 'keys1d': return `${keyName(b.neg)}/${keyName(b.pos)}`;
        case 'keys2d': {
            const codes = [b.up, b.down, b.left, b.right];
            if (codes.every((c) => c.startsWith('Arrow'))) return 'Arrows';
            return [b.up, b.left, b.down, b.right].map(keyName).join('');
        }
        case 'stick': return b.stick === 'left' ? 'Left stick' : 'Right stick';
        case 'virtual': return `On-screen ${b.id}`;
    }
}

export function formatBindings(action: string): string {
    return Actions.getBindings(action).map(formatBinding).join(' / ');
}