Class SystemBeforeEvents

Example: systemEventListeners.ts

import { system, StartupEvent, ShutdownEvent } from "@minecraft/server";

// Example of handling system startup events
function setupSystemEventListeners() {
    // Handle startup events
    system.beforeEvents.startup.subscribe((event: StartupEvent) => {
        console.log("Server is starting up!");

        // Register custom block components during startup
        event.blockComponentRegistry.registerCustomComponent("custom:my_block", {
            onPlayerInteract: (eventData, params) => {
                console.log("Custom block was interacted with!");
            },
            onPlace: (eventData, params) => {
                console.log("Custom block was placed!");
            },
        });

        // Register custom item components during startup
        event.itemComponentRegistry.registerCustomComponent("custom:my_item", {
            onUse: (eventData, params) => {
                console.log("Custom item was used!");
            },
            onHitEntity: (eventData, params) => {
                console.log("Custom item hit an entity!");
            },
        });

        // Register custom commands during startup
        event.customCommandRegistry.registerCommand(
            {
                name: "custom:hello",
                description: "A simple greeting command",
                permissionLevel: 0, // Any permission level
                cheatsRequired: false,
                mandatoryParameters: [],
                optionalParameters: [],
            },
            (origin, args) => {
                return {
                    status: 0, // Success
                    message: "Hello from custom command!",
                };
            }
        );

        console.log("Custom components and commands registered successfully!");
    });

    // Handle shutdown events
    system.beforeEvents.shutdown.subscribe((event: ShutdownEvent) => {
        console.log("Server is shutting down!");

        // Perform cleanup operations
        console.log("Performing cleanup operations...");

        // Save any important data
        console.log("Saving important data before shutdown...");

        // Log final statistics
        console.log("Server shutdown cleanup completed.");
    });
}

// Example: Check if we're in an editor world
function checkEditorWorld() {
    if (system.isEditorWorld) {
        console.log("Running in Minecraft Editor world");
        // Handle editor-specific logic
    } else {
        console.log("Running in regular Minecraft world");
        // Handle normal gameplay logic
    }
}

// Call these functions to set up the listeners
setupSystemEventListeners();
checkEditorWorld();
Copy