Interface BiomeSearchOptionsBeta

Example: findBiome.js

// Script by WavePlayz

import { world, system, BlockTypes } from "@minecraft/server"; // Import necessary modules from the Minecraft server API

// Listen for the `chatSend` event, which is triggered when a player sends a message in chat
world.afterEvents.chatSend.subscribe(async (eventData) => {
    // Destructure the `eventData` object to get the sender (player who sent the message) and the message itself
    const { sender, message } = eventData;

    // Check if the player sent the message "find biome"
    if (message === "find biome") {
        // Send a message to all players in the world, asking the player to close the chat
        world.sendMessage("Close chat (2s)");

        // Wait for 2 seconds (40 ticks) before continuing the script
        await system.waitTicks(20 * 2);

        // Define the biome ID to search for (in this case, "plains")
        const biomeId = BlockTypes.get("plains").id;

        // Define the dimensions of the bounding box (the area within which the search will be conducted)
        const length = 100;
        const height = 100;
        const width = 100;

        // Create a `BiomeSearchOptions` object with the defined bounding box dimensions
        const biomeSearchOptions = {
            boundingSize: { x: length, y: height, z: width },
        };

        // Use the player's current dimension to find the closest biome matching the specified `biomeId`
        // The search will start from the player's current location and use the `biomeSearchOptions`
        const biomeLocation = sender.dimension.findClosestBiome(
            sender.location,
            biomeId,
            biomeSearchOptions
        );

        // Check if a biome was found
        if (biomeLocation) {
            // If found, send a message to the player with the coordinates of the biome
            sender.sendMessage(
                `Found biome '${biomeId}' at location: ${biomeLocation.x}, ${biomeLocation.y}, ${biomeLocation.z}`
            );
        } else {
            // If not found, send a message to the player indicating that the biome was not found
            sender.sendMessage(`Biome '${biomeId}' not found`);
        }
    }
});
Copy