Scene commands

CommandBus looks up the command by the name in the FSM and gives it access to the current scene.

Placement needs a slot and coordinates. The command uses BaseTypedCommand. PlaceBlockCommand.ts

import { BaseTypedCommand } from '@gamedevland/engine/commands';

import { BlockPuzzleServices } from '../BlockPuzzleServices';
import { BlockPuzzleEventSchemas } from '../configs/event.schemas';

import type { InferDecoded } from '@gamedevland/engine/validation';

type PlaceBlockCommandPayload = InferDecoded<
  typeof BlockPuzzleEventSchemas.PlacementRequest
>;

export class PlaceBlockCommand extends BaseTypedCommand<PlaceBlockCommandPayload> {
  protected override readonly inputDecoder =
    BlockPuzzleEventSchemas.PlacementRequest;

  protected override execute(payload: PlaceBlockCommandPayload): void {
    this.getSceneService(BlockPuzzleServices.Gameplay).place(payload);
  }
}

Use the same command name in CommandsGroup and the FSM configuration.

BaseTypedCommand validates the data with inputDecoder before calling execute.

If the command returns a Promise, the FSM waits for it to finish before processing the next event.