@minecraft/server 1.0.0-preview.1.19.60.22 → 1.0.0-rc.1.19.60-preview.23

package/index.d.ts

@@ -1,213 +1,220 @@
-// Type definitions for Minecraft Bedrock Edition script APIs
-// Project: https://docs.microsoft.com/minecraft/creator/
-// Definitions by: Jake Shirley <https://github.com/JakeShirley>
-//                 Mike Ammerlaan <https://github.com/mammerla>
-
-/* *****************************************************************************
-   Copyright (c) Microsoft Corporation.
-   ***************************************************************************** */
-/**
- * @packageDocumentation
- * Contains many types related to manipulating a Minecraft
- * world, including entities, blocks, dimensions, and more.
- *
- * Manifest Details
- * ```json
- * {
- *   "module_name": "@minecraft/server",
- *   "version": "1.1.0-internal.preview.1.19.60.22"
- * }
- * ```
- *
- */
-/**
- * Contains return data on the result of a command execution.
- */
-export class CommandResult {
-    protected constructor();
-    /**
-     * If the command operates against a number of entities,
-     * blocks, or items, this returns the number of successful
-     * applications of this command.
-     */
-    readonly successCount: number;
-}
-/**
- * A class that represents a particular dimension (e.g., The
- * End) within a world.
- */
-export class Dimension {
-    protected constructor();
-    /**
-     * Identifier of the dimension.
-     * @throws This property can throw when used.
-     */
-    readonly id: string;
-    /**
-     * @remarks
-     * Runs a particular command asynchronously from the context of
-     * the broader dimension.  Note that there is a maximum queue
-     * of 128 asynchronous commands that can be run in a given
-     * tick.
-     * @param commandString
-     * Command to run. Note that command strings should not start
-     * with slash.
-     * @returns
-     * For commands that return data, returns a CommandResult with
-     * an indicator of command results.
-     * @throws This function can throw errors.
-     */
-    runCommandAsync(commandString: string): Promise<CommandResult>;
-}
-/**
- * Represents the state of an entity (a mob, the player, or
- * other moving objects like minecarts) in the world.
- */
-export class Entity {
-    protected constructor();
-    /**
-     * Unique identifier of the entity. This identifier is intended
-     * to be consistent across loads of a world instance. No
-     * meaning should be inferred from the value and structure of
-     * this unique identifier - do not parse or interpret it.
-     * @throws This property can throw when used.
-     */
-    readonly id: string;
-    /**
-     * Unique identifier of the type of the entity - for example,
-     * 'minecraft:skeleton'.
-     * @throws This property can throw when used.
-     */
-    readonly typeId: string;
-    /**
-     * @remarks
-     * Runs a particular command asynchronously from the context of
-     * this entity. Note that there is a maximum queue of 128
-     * asynchronous commands that can be run in a given tick.
-     * @param commandString
-     * Command to run. Note that command strings should not start
-     * with slash.
-     * @returns
-     * For commands that return data, returns a JSON structure with
-     * command response values.
-     * @throws This function can throw errors.
-     */
-    runCommandAsync(commandString: string): Promise<CommandResult>;
-}
-/**
- * A collection of default Minecraft dimension types.
- */
-// tslint:disable-next-line:no-unnecessary-class
-export class MinecraftDimensionTypes {
-    protected constructor();
-    /**
-     * The Nether is a collection of biomes separate from the
-     * Overworld, including Soul Sand Valleys and Crimson forests.
-     * Nether fortresses contain exclusive resources. Mobs such as
-     * Blaze, Hoglins, Piglins, and Ghasts congregate here.
-     */
-    static readonly nether = 'minecraft:nether';
-    /**
-     * The overworld is a collection of biomes, including forests,
-     * plains, jungles, mountains, deserts, taiga, and more. This
-     * is the default starter dimension for Minecraft. Mobs such as
-     * Axolotl, Cows, Creepers, and Zombies congregate here.
-     */
-    static readonly overworld = 'minecraft:overworld';
-    /**
-     * The End is separate from the Overworld and the Nether and is
-     * generated whenever you create an End portal. Here, a giant
-     * center island is surrounded by several smaller areas and
-     * islands. You can find Endermen here. End midlands are larger
-     * areas that transition you from the center to the outer edges
-     * of the End. They contain Shulkers, Endermen, End gateway
-     * portals, and End cities. End gateway portals are commonly
-     * found at the outermost edge of the void. You usually find
-     * End barrens toward the edges of the main areas or land in
-     * the End.
-     */
-    static readonly theEnd = 'minecraft:the_end';
-}
-/**
- * Represents a player within the world.
- */
-export class Player extends Entity {
-    protected constructor();
-    /**
-     * Unique identifier of the player. This identifier is intended
-     * to be consistent across loads of a world instance. No
-     * meaning should be inferred from the value and structure of
-     * this unique identifier - do not parse or interpret it.
-     * @throws This property can throw when used.
-     */
-    readonly id: string;
-    /**
-     * Name of the player.
-     * @throws This property can throw when used.
-     */
-    readonly name: string;
-    /**
-     * Unique identifier of the type of the entity - for example,
-     * 'minecraft:player'.
-     * @throws This property can throw when used.
-     */
-    readonly typeId: string;
-    /**
-     * @remarks
-     * Runs a particular command asynchronously from the context of
-     * this entity.  Note that there is a maximum queue of 128
-     * asynchronous commands that can be run in a given tick.
-     * @param commandString
-     * Command to run. Note that command strings should not start
-     * with slash.
-     * @returns
-     * For commands that return data, returns a JSON structure with
-     * command response values.
-     * @throws This function can throw errors.
-     */
-    runCommandAsync(commandString: string): Promise<CommandResult>;
-}
-/**
- * A class that provides system-level events and functions.
- */
-export class System {
-    protected constructor();
-    /**
-     * @remarks
-     * Runs a specified function at a future time. This is
-     * frequently used to implement delayed behaviors and game
-     * loops.
-     * @param callback
-     * Function callback to run when the tickDelay time criteria is
-     * met.
-     * @returns
-     * An opaque identifier that can be used with the `clearRun`
-     * function to cancel the execution of this run.
-     */
-    run(callback: () => void): number;
-}
-/**
- * A class that wraps the state of a world - a set of
- * dimensions and the environment of Minecraft.
- */
-export class World {
-    protected constructor();
-    getAllPlayers(): Player[];
-    /**
-     * @param dimensionId
-     * @returns
-     * The requested dimension
-     * @throws
-     * Throws if the given dimension name is invalid
-     */
-    getDimension(dimensionId: string): Dimension;
-}
-/**
- * A class that provides system-level events and functions.
- */
-export const system: System;
-/**
- * A class that wraps the state of a world - a set of
- * dimensions and the environment of Minecraft.
- */
-export const world: World;
+// Type definitions for Minecraft Bedrock Edition script APIs
+// Project: https://docs.microsoft.com/minecraft/creator/
+// Definitions by: Jake Shirley <https://github.com/JakeShirley>
+//                 Mike Ammerlaan <https://github.com/mammerla>
+
+/* *****************************************************************************
+   Copyright (c) Microsoft Corporation.
+   ***************************************************************************** */
+/**
+ * @packageDocumentation
+ * Contains many types related to manipulating a Minecraft
+ * world, including entities, blocks, dimensions, and more.
+ *
+ * Manifest Details
+ * ```json
+ * {
+ *   "module_name": "@minecraft/server",
+ *   "version": "1.1.0-internal.1.19.60-preview.23"
+ * }
+ * ```
+ *
+ */
+/**
+ * Contains return data on the result of a command execution.
+ */
+export class CommandResult {
+    protected constructor();
+    /**
+     * If the command operates against a number of entities,
+     * blocks, or items, this returns the number of successful
+     * applications of this command.
+     */
+    readonly successCount: number;
+}
+/**
+ * A class that represents a particular dimension (e.g., The
+ * End) within a world.
+ */
+export class Dimension {
+    protected constructor();
+    /**
+     * Identifier of the dimension.
+     * @throws This property can throw when used.
+     */
+    readonly id: string;
+    /**
+     * @remarks
+     * Runs a particular command asynchronously from the context of
+     * the broader dimension.  Note that there is a maximum queue
+     * of 128 asynchronous commands that can be run in a given
+     * tick.
+     * @param commandString
+     * Command to run. Note that command strings should not start
+     * with slash.
+     * @returns
+     * For commands that return data, returns a CommandResult with
+     * an indicator of command results.
+     * @throws This function can throw errors.
+     */
+    runCommandAsync(commandString: string): Promise<CommandResult>;
+}
+/**
+ * Represents the state of an entity (a mob, the player, or
+ * other moving objects like minecarts) in the world.
+ */
+export class Entity {
+    protected constructor();
+    /**
+     * Unique identifier of the entity. This identifier is intended
+     * to be consistent across loads of a world instance. No
+     * meaning should be inferred from the value and structure of
+     * this unique identifier - do not parse or interpret it.
+     * @throws This property can throw when used.
+     */
+    readonly id: string;
+    /**
+     * Unique identifier of the type of the entity - for example,
+     * 'minecraft:skeleton'.
+     * @throws This property can throw when used.
+     */
+    readonly typeId: string;
+    /**
+     * @remarks
+     * Runs a particular command asynchronously from the context of
+     * this entity. Note that there is a maximum queue of 128
+     * asynchronous commands that can be run in a given tick.
+     * @param commandString
+     * Command to run. Note that command strings should not start
+     * with slash.
+     * @returns
+     * For commands that return data, returns a JSON structure with
+     * command response values.
+     * @throws This function can throw errors.
+     */
+    runCommandAsync(commandString: string): Promise<CommandResult>;
+}
+/**
+ * A collection of default Minecraft dimension types.
+ */
+// tslint:disable-next-line:no-unnecessary-class
+export class MinecraftDimensionTypes {
+    protected constructor();
+    /**
+     * The Nether is a collection of biomes separate from the
+     * Overworld, including Soul Sand Valleys and Crimson forests.
+     * Nether fortresses contain exclusive resources. Mobs such as
+     * Blaze, Hoglins, Piglins, and Ghasts congregate here.
+     */
+    static readonly nether = 'minecraft:nether';
+    /**
+     * The overworld is a collection of biomes, including forests,
+     * plains, jungles, mountains, deserts, taiga, and more. This
+     * is the default starter dimension for Minecraft. Mobs such as
+     * Axolotl, Cows, Creepers, and Zombies congregate here.
+     */
+    static readonly overworld = 'minecraft:overworld';
+    /**
+     * The End is separate from the Overworld and the Nether and is
+     * generated whenever you create an End portal. Here, a giant
+     * center island is surrounded by several smaller areas and
+     * islands. You can find Endermen here. End midlands are larger
+     * areas that transition you from the center to the outer edges
+     * of the End. They contain Shulkers, Endermen, End gateway
+     * portals, and End cities. End gateway portals are commonly
+     * found at the outermost edge of the void. You usually find
+     * End barrens toward the edges of the main areas or land in
+     * the End.
+     */
+    static readonly theEnd = 'minecraft:the_end';
+}
+/**
+ * Represents a player within the world.
+ */
+export class Player extends Entity {
+    protected constructor();
+    /**
+     * Unique identifier of the player. This identifier is intended
+     * to be consistent across loads of a world instance. No
+     * meaning should be inferred from the value and structure of
+     * this unique identifier - do not parse or interpret it.
+     * @throws This property can throw when used.
+     */
+    readonly id: string;
+    /**
+     * Name of the player.
+     * @throws This property can throw when used.
+     */
+    readonly name: string;
+    /**
+     * Unique identifier of the type of the entity - for example,
+     * 'minecraft:player'.
+     * @throws This property can throw when used.
+     */
+    readonly typeId: string;
+    /**
+     * @remarks
+     * Runs a particular command asynchronously from the context of
+     * this entity.  Note that there is a maximum queue of 128
+     * asynchronous commands that can be run in a given tick.
+     * @param commandString
+     * Command to run. Note that command strings should not start
+     * with slash.
+     * @returns
+     * For commands that return data, returns a JSON structure with
+     * command response values.
+     * @throws This function can throw errors.
+     */
+    runCommandAsync(commandString: string): Promise<CommandResult>;
+}
+/**
+ * A class that provides system-level events and functions.
+ */
+export class System {
+    protected constructor();
+    /**
+     * @remarks
+     * Runs a specified function at a future time. This is
+     * frequently used to implement delayed behaviors and game
+     * loops.
+     * @param callback
+     * Function callback to run when the tickDelay time criteria is
+     * met.
+     * @returns
+     * An opaque identifier that can be used with the `clearRun`
+     * function to cancel the execution of this run.
+     */
+    run(callback: () => void): number;
+}
+/**
+ * A class that wraps the state of a world - a set of
+ * dimensions and the environment of Minecraft.
+ */
+export class World {
+    protected constructor();
+    /**
+     * @remarks
+     * Returns an array of all active players within the world.
+     * @throws This function can throw errors.
+     */
+    getAllPlayers(): Player[];
+    /**
+     * @remarks
+     * Returns a dimension object.
+     * @param dimensionId
+     * @returns
+     * The requested dimension
+     * @throws
+     * Throws if the given dimension name is invalid
+     */
+    getDimension(dimensionId: string): Dimension;
+}
+/**
+ * A class that provides system-level events and functions.
+ */
+export const system: System;
+/**
+ * A class that wraps the state of a world - a set of
+ * dimensions and the environment of Minecraft.
+ */
+export const world: World;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server",
-  "version": "1.0.0-preview.1.19.60.22",
+  "version": "1.0.0-rc.1.19.60-preview.23",
   "description": "",
   "contributors": [
     {

package/tests.ts

@@ -1,286 +1,286 @@
-/* eslint-disable  @typescript-eslint/no-unused-vars */
-import * as mc from '@minecraft/server';
-
-export function createExplosion(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
-    const overworld = mc.world.getDimension('overworld');
-
-    log('Creating an explosion of radius 10.');
-    overworld.createExplosion(targetLocation, 10);
-}
-
-export function createNoBlockExplosion(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
-    const overworld = mc.world.getDimension('overworld');
-
-    const explodeNoBlocksLoc = new mc.Location(
-        Math.floor(targetLocation.x + 1),
-        Math.floor(targetLocation.y + 2),
-        Math.floor(targetLocation.z + 1),
-    );
-
-    log('Creating an explosion of radius 15 that does not break blocks.');
-    overworld.createExplosion(explodeNoBlocksLoc, 15, { breaksBlocks: false });
-}
-
-export function createFireAndWaterExplosions(
-    log: (message: string, status?: number) => void,
-    targetLocation: mc.Location,
-) {
-    const overworld = mc.world.getDimension('overworld');
-
-    const explosionLoc = new mc.Location(targetLocation.x + 0.5, targetLocation.y + 0.5, targetLocation.z + 0.5);
-
-    log('Creating an explosion of radius 15 that causes fire.');
-    overworld.createExplosion(explosionLoc, 15, { causesFire: true });
-
-    const belowWaterLoc = new mc.Location(targetLocation.x + 3, targetLocation.y + 1, targetLocation.z + 3);
-
-    log('Creating an explosion of radius 10 that can go underwater.');
-    overworld.createExplosion(belowWaterLoc, 10, { allowUnderwater: true });
-}
-
-export function itemStacks(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
-    const overworld = mc.world.getDimension('overworld');
-
-    const oneItemLoc = new mc.BlockLocation(targetLocation.x + targetLocation.y + 3, 2, targetLocation.z + 1);
-    const fiveItemsLoc = new mc.BlockLocation(targetLocation.x + 1, targetLocation.y + 2, targetLocation.z + 1);
-    const diamondPickaxeLoc = new mc.BlockLocation(targetLocation.x + 2, targetLocation.y + 2, targetLocation.z + 4);
-
-    const oneEmerald = new mc.ItemStack(mc.MinecraftItemTypes.emerald, 1, 0);
-    const onePickaxe = new mc.ItemStack(mc.MinecraftItemTypes.diamondPickaxe, 1, 0);
-    const fiveEmeralds = new mc.ItemStack(mc.MinecraftItemTypes.emerald, 5, 0);
-
-    log(`Spawning an emerald at (${oneItemLoc.x}, ${oneItemLoc.y}, ${oneItemLoc.z})`);
-    overworld.spawnItem(oneEmerald, oneItemLoc);
-
-    log(`Spawning five emeralds at (${fiveItemsLoc.x}, ${fiveItemsLoc.y}, ${fiveItemsLoc.z})`);
-    overworld.spawnItem(fiveEmeralds, fiveItemsLoc);
-
-    log(`Spawning a diamond pickaxe at (${diamondPickaxeLoc.x}, ${diamondPickaxeLoc.y}, ${diamondPickaxeLoc.z})`);
-    overworld.spawnItem(onePickaxe, diamondPickaxeLoc);
-}
-
-export function quickFoxLazyDog(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
-    const overworld = mc.world.getDimension('overworld');
-
-    const fox = overworld.spawnEntity(
-        'minecraft:fox',
-        new mc.BlockLocation(targetLocation.x + 1, targetLocation.y + 2, targetLocation.z + 3),
-    );
-    fox.addEffect(mc.MinecraftEffectTypes.speed, 10, 20);
-    log('Created a fox.');
-
-    const wolf = overworld.spawnEntity(
-        'minecraft:wolf',
-        new mc.BlockLocation(targetLocation.x + 4, targetLocation.y + 2, targetLocation.z + 3),
-    );
-    wolf.addEffect(mc.MinecraftEffectTypes.slowness, 10, 20);
-    wolf.isSneaking = true;
-    log('Created a sneaking wolf.', 1);
-}
-
-export function runEntityCreatedEvent(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
-    // register a new function that is called when a new entity is created.
-    mc.world.events.entityCreate.subscribe((entityEvent: mc.EntityCreateEvent) => {
-        if (entityEvent && entityEvent.entity) {
-            log(`New entity of type '${entityEvent.entity}' created!`, 1);
-        } else {
-            log(`The entity event didn't work as expected.`, -1);
-        }
-    });
-}
-
-export function createOldHorse(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
-    const overworld = mc.world.getDimension('overworld');
-
-    log("Create a horse and triggering the 'ageable_grow_up' event, ensuring the horse is created as an adult");
-    overworld.spawnEntity('minecraft:horse<minecraft:ageable_grow_up>', targetLocation);
-}
-
-export function pistonEvent(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
-    const pistonLoc = new mc.BlockLocation(
-        Math.floor(targetLocation.x) + 1,
-        Math.floor(targetLocation.y) + 2,
-        Math.floor(targetLocation.z) + 1,
-    );
-
-    mc.world.events.beforePistonActivate.subscribe((pistonEvent: mc.BeforePistonActivateEvent) => {
-        if (pistonEvent.piston.location.equals(pistonLoc)) {
-            log('Cancelling piston event');
-            pistonEvent.cancel = true;
-        }
-    });
-}
-
-export function spawnItem(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
-    const featherItem = new mc.ItemStack(mc.MinecraftItemTypes.feather, 1, 0);
-
-    overworld.spawnItem(featherItem, targetLocation);
-    log(`New feather created at ${targetLocation.x}, ${targetLocation.y}, ${targetLocation.z}!`);
-}
-
-export function testThatEntityIsFeatherItem(
-    log: (message: string, status?: number) => void,
-    targetLocation: mc.Location,
-) {
-    const overworld = mc.world.getDimension('overworld');
-
-    const items = overworld.getEntities({
-        location: targetLocation,
-        maxDistance: 20,
-    });
-
-    for (const item of items) {
-        const itemComp = item.getComponent('item') as any;
-
-        if (itemComp) {
-            if (itemComp.itemStack.id.endsWith('feather')) {
-                log('Success! Found a feather', 1);
-            }
-        }
-    }
-}
-
-export function trapTick() {
-    const overworld = mc.world.getDimension('overworld');
-
-    try {
-        // Minecraft runs at 20 ticks per second
-        if (ticks % 1200 === 0) {
-            overworld.runCommandAsync('say Another minute passes...');
-        }
-
-        ticks++;
-    } catch (e) {
-        console.warn('Error: ' + e);
-    }
-
-    mc.system.run(trapTick);
-}
-
-export default class SampleManager {
-    tickCount = 0;
-
-    _availableFuncs: {
-        [name: string]: Array<(log: (message: string, status?: number) => void, location: mc.Location) => void>;
-    };
-
-    pendingFuncs: Array<{
-        name: string;
-        func: (log: (message: string, status?: number) => void, location: mc.Location) => void;
-        location: mc.Location;
-    }> = [];
-
-    gameplayLogger(message: string, status?: number) {
-        if (status !== undefined && status > 0) {
-            message = 'SUCCESS: ' + message;
-        } else if (status !== undefined && status < 0) {
-            message = 'FAIL: ' + message;
-        }
-
-        this.say(message);
-    }
-    say(message: string) {
-        mc.world.getDimension('overworld').runCommand('say ' + message);
-    }
-
-    newChatMessage(chatEvent: mc.ChatEvent) {
-        const message = chatEvent.message.toLowerCase();
-
-        if (message.startsWith('howto') && chatEvent.sender) {
-            const nearbyBlock = chatEvent.sender.getBlockFromViewVector();
-            if (!nearbyBlock) {
-                this.gameplayLogger('Please look at the block where you want me to run this.');
-                return;
-            }
-
-            const nearbyBlockLoc = nearbyBlock.location;
-            const nearbyLoc = new mc.Location(nearbyBlockLoc.x, nearbyBlockLoc.y + 1, nearbyBlockLoc.z);
-
-            const sampleId = message.substring(5).trim();
-
-            if (sampleId.length < 2) {
-                let availableFuncStr = 'Here is my list of available samples:';
-
-                for (const sampleFuncKey in this._availableFuncs) {
-                    availableFuncStr += ' ' + sampleFuncKey;
-                }
-
-                this.say(availableFuncStr);
-            } else {
-                for (const sampleFuncKey in this._availableFuncs) {
-                    if (sampleFuncKey.toLowerCase() === sampleId) {
-                        const sampleFunc = this._availableFuncs[sampleFuncKey];
-
-                        this.runSample(sampleFuncKey + this.tickCount, sampleFunc, nearbyLoc);
-
-                        return;
-                    }
-                }
-
-                this.say(`I couldn't find the sample '${sampleId}"'`);
-            }
-        }
-    }
-
-    runSample(
-        sampleId: string,
-        snippetFunctions: Array<(log: (message: string, status?: number) => void, location: mc.Location) => void>,
-        targetLocation: mc.Location,
-    ) {
-        for (let i = snippetFunctions.length - 1; i >= 0; i--) {
-            this.pendingFuncs.push({ name: sampleId, func: snippetFunctions[i], location: targetLocation });
-        }
-    }
-
-    worldTick() {
-        if (this.tickCount % 10 === 0) {
-            if (this.pendingFuncs.length > 0) {
-                const funcSet = this.pendingFuncs.pop();
-
-                if (funcSet) {
-                    funcSet.func(this.gameplayLogger, funcSet.location);
-                }
-            }
-        }
-
-        this.tickCount++;
-    }
-
-    constructor() {
-        this._availableFuncs = {};
-
-        this.gameplayLogger = this.gameplayLogger.bind(this);
-
-        mc.world.events.tick.subscribe(this.worldTick.bind(this));
-        mc.world.events.chat.subscribe(this.newChatMessage.bind(this));
-    }
-
-    registerSamples(sampleSet: {
-        [name: string]: Array<(log: (message: string, status?: number) => void, location: mc.Location) => void>;
-    }) {
-        for (const sampleKey in sampleSet) {
-            if (sampleKey.length > 1 && sampleSet[sampleKey]) {
-                this._availableFuncs[sampleKey] = sampleSet[sampleKey];
-            }
-        }
-    }
-}
-
-const mojangMinecraftFuncs: {
-    [name: string]: Array<(log: (message: string, status?: number) => void, location: mc.Location) => void>;
-} = {
-    runEntityCreatedEvent: [runEntityCreatedEvent, createOldHorse],
-    createOldHorse: [createOldHorse],
-    spawnItem: [spawnItem, testThatEntityIsFeatherItem],
-    createNoBlockExplosion: [createExplosion],
-    createFireAndWaterExplosions: [createFireAndWaterExplosions],
-    createExplosion: [createExplosion],
-    itemStacks: [itemStacks],
-    quickFoxLazyDog: [quickFoxLazyDog],
-    pistonEvent: [pistonEvent],
-    trapTick: [trapTick],
-};
-
-export function register(sampleManager: SampleManager) {
-    sampleManager.registerSamples(mojangMinecraftFuncs);
-}
+/* eslint-disable  @typescript-eslint/no-unused-vars */
+import * as mc from '@minecraft/server';
+
+export function createExplosion(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
+    const overworld = mc.world.getDimension('overworld');
+
+    log('Creating an explosion of radius 10.');
+    overworld.createExplosion(targetLocation, 10);
+}
+
+export function createNoBlockExplosion(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
+    const overworld = mc.world.getDimension('overworld');
+
+    const explodeNoBlocksLoc = new mc.Location(
+        Math.floor(targetLocation.x + 1),
+        Math.floor(targetLocation.y + 2),
+        Math.floor(targetLocation.z + 1),
+    );
+
+    log('Creating an explosion of radius 15 that does not break blocks.');
+    overworld.createExplosion(explodeNoBlocksLoc, 15, { breaksBlocks: false });
+}
+
+export function createFireAndWaterExplosions(
+    log: (message: string, status?: number) => void,
+    targetLocation: mc.Location,
+) {
+    const overworld = mc.world.getDimension('overworld');
+
+    const explosionLoc = new mc.Location(targetLocation.x + 0.5, targetLocation.y + 0.5, targetLocation.z + 0.5);
+
+    log('Creating an explosion of radius 15 that causes fire.');
+    overworld.createExplosion(explosionLoc, 15, { causesFire: true });
+
+    const belowWaterLoc = new mc.Location(targetLocation.x + 3, targetLocation.y + 1, targetLocation.z + 3);
+
+    log('Creating an explosion of radius 10 that can go underwater.');
+    overworld.createExplosion(belowWaterLoc, 10, { allowUnderwater: true });
+}
+
+export function itemStacks(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
+    const overworld = mc.world.getDimension('overworld');
+
+    const oneItemLoc = new mc.BlockLocation(targetLocation.x + targetLocation.y + 3, 2, targetLocation.z + 1);
+    const fiveItemsLoc = new mc.BlockLocation(targetLocation.x + 1, targetLocation.y + 2, targetLocation.z + 1);
+    const diamondPickaxeLoc = new mc.BlockLocation(targetLocation.x + 2, targetLocation.y + 2, targetLocation.z + 4);
+
+    const oneEmerald = new mc.ItemStack(mc.MinecraftItemTypes.emerald, 1, 0);
+    const onePickaxe = new mc.ItemStack(mc.MinecraftItemTypes.diamondPickaxe, 1, 0);
+    const fiveEmeralds = new mc.ItemStack(mc.MinecraftItemTypes.emerald, 5, 0);
+
+    log(`Spawning an emerald at (${oneItemLoc.x}, ${oneItemLoc.y}, ${oneItemLoc.z})`);
+    overworld.spawnItem(oneEmerald, oneItemLoc);
+
+    log(`Spawning five emeralds at (${fiveItemsLoc.x}, ${fiveItemsLoc.y}, ${fiveItemsLoc.z})`);
+    overworld.spawnItem(fiveEmeralds, fiveItemsLoc);
+
+    log(`Spawning a diamond pickaxe at (${diamondPickaxeLoc.x}, ${diamondPickaxeLoc.y}, ${diamondPickaxeLoc.z})`);
+    overworld.spawnItem(onePickaxe, diamondPickaxeLoc);
+}
+
+export function quickFoxLazyDog(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
+    const overworld = mc.world.getDimension('overworld');
+
+    const fox = overworld.spawnEntity(
+        'minecraft:fox',
+        new mc.BlockLocation(targetLocation.x + 1, targetLocation.y + 2, targetLocation.z + 3),
+    );
+    fox.addEffect(mc.MinecraftEffectTypes.speed, 10, 20);
+    log('Created a fox.');
+
+    const wolf = overworld.spawnEntity(
+        'minecraft:wolf',
+        new mc.BlockLocation(targetLocation.x + 4, targetLocation.y + 2, targetLocation.z + 3),
+    );
+    wolf.addEffect(mc.MinecraftEffectTypes.slowness, 10, 20);
+    wolf.isSneaking = true;
+    log('Created a sneaking wolf.', 1);
+}
+
+export function runEntityCreatedEvent(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
+    // register a new function that is called when a new entity is created.
+    mc.world.events.entityCreate.subscribe((entityEvent: mc.EntityCreateEvent) => {
+        if (entityEvent && entityEvent.entity) {
+            log(`New entity of type '${entityEvent.entity}' created!`, 1);
+        } else {
+            log(`The entity event didn't work as expected.`, -1);
+        }
+    });
+}
+
+export function createOldHorse(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
+    const overworld = mc.world.getDimension('overworld');
+
+    log("Create a horse and triggering the 'ageable_grow_up' event, ensuring the horse is created as an adult");
+    overworld.spawnEntity('minecraft:horse<minecraft:ageable_grow_up>', targetLocation);
+}
+
+export function pistonEvent(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
+    const pistonLoc = new mc.BlockLocation(
+        Math.floor(targetLocation.x) + 1,
+        Math.floor(targetLocation.y) + 2,
+        Math.floor(targetLocation.z) + 1,
+    );
+
+    mc.world.events.beforePistonActivate.subscribe((pistonEvent: mc.BeforePistonActivateEvent) => {
+        if (pistonEvent.piston.location.equals(pistonLoc)) {
+            log('Cancelling piston event');
+            pistonEvent.cancel = true;
+        }
+    });
+}
+
+export function spawnItem(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
+    const featherItem = new mc.ItemStack(mc.MinecraftItemTypes.feather, 1, 0);
+
+    overworld.spawnItem(featherItem, targetLocation);
+    log(`New feather created at ${targetLocation.x}, ${targetLocation.y}, ${targetLocation.z}!`);
+}
+
+export function testThatEntityIsFeatherItem(
+    log: (message: string, status?: number) => void,
+    targetLocation: mc.Location,
+) {
+    const overworld = mc.world.getDimension('overworld');
+
+    const items = overworld.getEntities({
+        location: targetLocation,
+        maxDistance: 20,
+    });
+
+    for (const item of items) {
+        const itemComp = item.getComponent('item') as any;
+
+        if (itemComp) {
+            if (itemComp.itemStack.id.endsWith('feather')) {
+                log('Success! Found a feather', 1);
+            }
+        }
+    }
+}
+
+export function trapTick() {
+    const overworld = mc.world.getDimension('overworld');
+
+    try {
+        // Minecraft runs at 20 ticks per second
+        if (ticks % 1200 === 0) {
+            overworld.runCommandAsync('say Another minute passes...');
+        }
+
+        ticks++;
+    } catch (e) {
+        console.warn('Error: ' + e);
+    }
+
+    mc.system.run(trapTick);
+}
+
+export default class SampleManager {
+    tickCount = 0;
+
+    _availableFuncs: {
+        [name: string]: Array<(log: (message: string, status?: number) => void, location: mc.Location) => void>;
+    };
+
+    pendingFuncs: Array<{
+        name: string;
+        func: (log: (message: string, status?: number) => void, location: mc.Location) => void;
+        location: mc.Location;
+    }> = [];
+
+    gameplayLogger(message: string, status?: number) {
+        if (status !== undefined && status > 0) {
+            message = 'SUCCESS: ' + message;
+        } else if (status !== undefined && status < 0) {
+            message = 'FAIL: ' + message;
+        }
+
+        this.say(message);
+    }
+    say(message: string) {
+        mc.world.getDimension('overworld').runCommand('say ' + message);
+    }
+
+    newChatMessage(chatEvent: mc.ChatEvent) {
+        const message = chatEvent.message.toLowerCase();
+
+        if (message.startsWith('howto') && chatEvent.sender) {
+            const nearbyBlock = chatEvent.sender.getBlockFromViewVector();
+            if (!nearbyBlock) {
+                this.gameplayLogger('Please look at the block where you want me to run this.');
+                return;
+            }
+
+            const nearbyBlockLoc = nearbyBlock.location;
+            const nearbyLoc = new mc.Location(nearbyBlockLoc.x, nearbyBlockLoc.y + 1, nearbyBlockLoc.z);
+
+            const sampleId = message.substring(5).trim();
+
+            if (sampleId.length < 2) {
+                let availableFuncStr = 'Here is my list of available samples:';
+
+                for (const sampleFuncKey in this._availableFuncs) {
+                    availableFuncStr += ' ' + sampleFuncKey;
+                }
+
+                this.say(availableFuncStr);
+            } else {
+                for (const sampleFuncKey in this._availableFuncs) {
+                    if (sampleFuncKey.toLowerCase() === sampleId) {
+                        const sampleFunc = this._availableFuncs[sampleFuncKey];
+
+                        this.runSample(sampleFuncKey + this.tickCount, sampleFunc, nearbyLoc);
+
+                        return;
+                    }
+                }
+
+                this.say(`I couldn't find the sample '${sampleId}"'`);
+            }
+        }
+    }
+
+    runSample(
+        sampleId: string,
+        snippetFunctions: Array<(log: (message: string, status?: number) => void, location: mc.Location) => void>,
+        targetLocation: mc.Location,
+    ) {
+        for (let i = snippetFunctions.length - 1; i >= 0; i--) {
+            this.pendingFuncs.push({ name: sampleId, func: snippetFunctions[i], location: targetLocation });
+        }
+    }
+
+    worldTick() {
+        if (this.tickCount % 10 === 0) {
+            if (this.pendingFuncs.length > 0) {
+                const funcSet = this.pendingFuncs.pop();
+
+                if (funcSet) {
+                    funcSet.func(this.gameplayLogger, funcSet.location);
+                }
+            }
+        }
+
+        this.tickCount++;
+    }
+
+    constructor() {
+        this._availableFuncs = {};
+
+        this.gameplayLogger = this.gameplayLogger.bind(this);
+
+        mc.world.events.tick.subscribe(this.worldTick.bind(this));
+        mc.world.events.chat.subscribe(this.newChatMessage.bind(this));
+    }
+
+    registerSamples(sampleSet: {
+        [name: string]: Array<(log: (message: string, status?: number) => void, location: mc.Location) => void>;
+    }) {
+        for (const sampleKey in sampleSet) {
+            if (sampleKey.length > 1 && sampleSet[sampleKey]) {
+                this._availableFuncs[sampleKey] = sampleSet[sampleKey];
+            }
+        }
+    }
+}
+
+const mojangMinecraftFuncs: {
+    [name: string]: Array<(log: (message: string, status?: number) => void, location: mc.Location) => void>;
+} = {
+    runEntityCreatedEvent: [runEntityCreatedEvent, createOldHorse],
+    createOldHorse: [createOldHorse],
+    spawnItem: [spawnItem, testThatEntityIsFeatherItem],
+    createNoBlockExplosion: [createExplosion],
+    createFireAndWaterExplosions: [createFireAndWaterExplosions],
+    createExplosion: [createExplosion],
+    itemStacks: [itemStacks],
+    quickFoxLazyDog: [quickFoxLazyDog],
+    pistonEvent: [pistonEvent],
+    trapTick: [trapTick],
+};
+
+export function register(sampleManager: SampleManager) {
+    sampleManager.registerSamples(mojangMinecraftFuncs);
+}