bedrock-development/ts/app/types/server/animation_controller.ts

APIs for creating and editing files related to Minecraft Bedrock development.

import { Directories } from "../../file_manager.js";
import { NameData, currentFormatVersion } from "../../utils.js";
import { MinecraftDataType } from "../minecraft.js";
import { FormatVersion } from "../shared_types.js";

export type ServerACName = `controller.animation.${string}`;

export interface IServerAnimationController {
    format_version: FormatVersion;
    animation_controllers: {
        [key: ServerACName]: IServerAC;
    }
}

export interface IServerAC {
    initial_state: string;
    states: {
        [key: string]: IServerACState
    }
}

export interface IServerACState {
    on_entry?: string[];
    animations?: string[];
    transitions?: {[key:string]: string}[];
    on_exit?: string[];
}

export class ServerAnimationController extends MinecraftDataType implements IServerAnimationController {
    format_version: FormatVersion;
    animation_controllers: {
        [key: ServerACName]: IServerAC;
    }

    public static get DirectoryPath(): string {
        return Directories.BEHAVIOR_PATH + 'animation_controllers/';
    }
    
    constructor(filepath: string, template: IServerAnimationController) {
        super(filepath, template);
        this.format_version = template.format_version;
        this.animation_controllers = template.animation_controllers;
    }

    public static createFromTemplate(nameData: NameData): ServerAnimationController {
        return new ServerAnimationController(this.createFilePath(nameData), {
            format_version: currentFormatVersion,
            animation_controllers: {}
        });
    }

    addAnimationController(key: ServerACName, controller?: IServerAC) {
        this.animation_controllers[key] = controller ?? {
            initial_state: "default",
            states: {
                default: {}
            }
        };
    }

    addState(key: ServerACName, stateName: string, state: IServerACState) {
        if (!Object.getOwnPropertyNames(this.animation_controllers).includes(key)) {
            this.addAnimationController(key, {
                initial_state: stateName,
                states: {}
            });
        }

        this.animation_controllers[key].states[stateName] = state;
    }
}