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.3 KB
Raw Blame
// SPDX-License-Identifier: Apache-2.0
// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
/**
 * @file    BehaviorTreeAgent.ts
 * @brief   BehaviorTreeAgent component + the tree store.
 *
 * The authorable half: which behavior tree to run (a registered name or a
 * `.esbt` asset path) plus the observable last root status. `*Agent` naming,
 * pure TS, mirroring StateMachineAgent.
 */

import { defineComponent } from '../../ecs/component';
import { isUuidRef } from '../../asset/AssetRegistry';
import type { BtDefinition } from './types';

export interface BehaviorTreeAgentData {
    /** Key of the tree to run: a `registerBt` name or a `.esbt` asset path. */
    bt: string;
    /** Last root status, written by the system each tick (observable). */
    status: string;
}

export const BehaviorTreeAgent = defineComponent<BehaviorTreeAgentData>('BehaviorTreeAgent', {
    bt: '',
    status: '',
}, {
    assetFields: [{ field: 'bt', type: 'behaviortree' }],
    // Preload a `.esbt` path or an editor-serialized uuid ref with the scene; a
    // plain `registerBt` name (code path) is left alone — this callback is the
    // discovery authority; the assetField above only drives the editor picker.
    discoverAssets: data => {
        const bt = data.bt;
        return typeof bt === 'string' && (bt.endsWith('.esbt') || isUuidRef(bt))
            ? [{ type: 'behaviortree', path: bt }]
            : [];
    },
    fields: {
        status: { advanced: true, tooltip: 'Last root status (runtime, read-only).' },
    },
});

/** Trees a game registered in CODE, process-wide — see the FSM store for why it
 *  is live rather than copied per App. An `.esbt` belongs to its realm, not
 *  here. A tree IS its definition — no compile. */
const btStore = new Map<string, BtDefinition>();

export function registerBt(key: string, def: BtDefinition): BtDefinition {
    btStore.set(key, def);
    return def;
}

export function getBt(key: string): BtDefinition | undefined {
    return btStore.get(key);
}

/** Every registered tree. What the schedule reads to learn what the BT system
 *  reaches for — that answer lives in the loaded trees, not in the system. */
export function allBts(): Iterable<BtDefinition> {
    return btStore.values();
}

/** Drop all registered trees (tests / hot-reload). */
export function clearBtStore(): void {
    btStore.clear();
}