@minecraft/server 1.1.0-beta.1.19.60-preview.25 → 1.1.0-beta.1.19.60-stable

package/README.md

@@ -2,8 +2,6 @@
 
 Contains many types related to manipulating a Minecraft world, including entities, blocks, dimensions, and more.
 
-## **NOTE: This version of this module is still in pre-release.  It may change or it may be removed in future releases.**
-
 See full documentation for this module here:
 
 https://learn.microsoft.com/en-us/minecraft/creator/scriptapi/@minecraft/server/@minecraft/server

package/index.d.ts

@@ -7,7 +7,6 @@
    Copyright (c) Microsoft Corporation.
    ***************************************************************************** */
 /**
- * @beta
  * @packageDocumentation
  * Contains many types related to manipulating a Minecraft
  * world, including entities, blocks, dimensions, and more.
@@ -16,7 +15,7 @@
  * ```json
  * {
  *   "module_name": "@minecraft/server",
- *   "version": "1.1.0-internal.1.19.60-preview.25"
+ *   "version": "1.0.0"
  * }
  * ```
  *
@@ -775,10 +774,10 @@ export class Block {
      * @throws This function can throw errors.
      * @example check_block_tags.js
      * ```typescript
-     *        import { world, BlockLocation } from "@minecraft/server";
+     *        import { world } from "@minecraft/server";
      *
      *        // Fetch the block
-     *        const block = world.getDimension("overworld").getBlock(new BlockLocation(1, 2, 3));
+     *        const block = world.getDimension("overworld").getBlock({ x: 1, y: 2, z: 3 });
      *
      *        console.log(`Block is dirt: ${block.hasTag("dirt")}`);
      *        console.log(`Block is wood: ${block.hasTag("wood")}`);
@@ -1296,10 +1295,10 @@ export class BlockPermutation {
      * Returns `true` if the permutation has the tag, else `false`.
      * @example check_block_tags.js
      * ```typescript
-     *        import { world, BlockLocation } from "@minecraft/server";
+     *        import { world } from "@minecraft/server";
      *
      *        // Fetch the block
-     *        const block = world.getDimension("overworld").getBlock(new BlockLocation(1, 2, 3));
+     *        const block = world.getDimension("overworld").getBlock({ x: 1, y: 2, z: 3 });
      *        const blockPerm = block.getPermutation();
      *
      *        console.log(`Block is dirt: ${blockPerm.hasTag("dirt")}`);
@@ -2670,37 +2669,39 @@ export class Dimension {
      * ```
      * @example createFireAndWaterExplosions.ts
      * ```typescript
-     *          const explosionLoc = new mc.Location(targetLocation.x + 0.5, targetLocation.y + 0.5, targetLocation.z + 0.5);
+     *        const explosionLoc: mc.Vector3 = { x: targetLocation.x + 0.5, y: targetLocation.y + 0.5, z: targetLocation.z + 0.5 };
+     *
+     *        const fireExplosionOptions = new mc.ExplosionOptions();
      *
-     *          const fireExplosionOptions = new mc.ExplosionOptions();
+     *        // Explode with fire
+     *        fireExplosionOptions.causesFire = true;
      *
-     *          // Explode with fire
-     *          fireExplosionOptions.causesFire = true;
+     *        overworld.createExplosion(explosionLoc, 15, fireExplosionOptions);
+     *        const waterExplosionOptions = new mc.ExplosionOptions();
      *
-     *          overworld.createExplosion(explosionLoc, 15, fireExplosionOptions);
-     *          const waterExplosionOptions = new mc.ExplosionOptions();
+     *        // Explode in water
+     *        waterExplosionOptions.allowUnderwater = true;
      *
-     *          // Explode in water
-     *          waterExplosionOptions.allowUnderwater = true;
+     *        const belowWaterLoc: mc.Vector3 = { x: targetLocation.x + 3, y: targetLocation.y + 1, z: targetLocation.z + 3 };
      *
-     *          const belowWaterLoc = new mc.Location(targetLocation.x + 3, targetLocation.y + 1, targetLocation.z + 3);
+     *        overworld.createExplosion(belowWaterLoc, 10, waterExplosionOptions);
      *
-     *          overworld.createExplosion(belowWaterLoc, 10, waterExplosionOptions);
      * ```
      * @example createNoBlockExplosion.ts
      * ```typescript
-     *          const explosionOptions = new mc.ExplosionOptions();
+     *        const explosionOptions = new mc.ExplosionOptions();
      *
-     *          // Start by exploding without breaking blocks
-     *          explosionOptions.breaksBlocks = false;
+     *        // Start by exploding without breaking blocks
+     *        explosionOptions.breaksBlocks = false;
      *
-     *          const explodeNoBlocksLoc = new mc.Location(
-     *            Math.floor(targetLocation.x + 1),
-     *            Math.floor(targetLocation.y + 2),
-     *            Math.floor(targetLocation.z + 1)
-     *          );
+     *        const explodeNoBlocksLoc: mc.Vector3 = {
+     *          x: Math.floor(targetLocation.x + 1),
+     *          y: Math.floor(targetLocation.y + 2),
+     *          z: Math.floor(targetLocation.z + 1),
+     *        };
+     *
+     *        overworld.createExplosion(explodeNoBlocksLoc, 15, explosionOptions);
      *
-     *          overworld.createExplosion(explodeNoBlocksLoc, 15, explosionOptions);
      * ```
      */
     createExplosion(location: Location, radius: number, explosionOptions?: ExplosionOptions): void;
@@ -2834,20 +2835,23 @@ export class Dimension {
      * ```
      * @example quickFoxLazyDog.ts
      * ```typescript
-     *          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 fox = overworld.spawnEntity("minecraft:fox", {
+     *          x: targetLocation.x + 1,
+     *          y: targetLocation.y + 2,
+     *          z: targetLocation.z + 3,
+     *        });
+     *        fox.addEffect(mc.MinecraftEffectTypes.speed, 10, 20);
+     *        log("Created a fox.");
+     *
+     *        const wolf = overworld.spawnEntity("minecraft:wolf", {
+     *          x: targetLocation.x + 4,
+     *          y: targetLocation.y + 2,
+     *          z: targetLocation.z + 3,
+     *        });
+     *        wolf.addEffect(mc.MinecraftEffectTypes.slowness, 10, 20);
+     *        wolf.isSneaking = true;
+     *        log("Created a sneaking wolf.", 1);
      *
-     *          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);
      * ```
      * @example trapTick.ts
      * ```typescript
@@ -2877,17 +2881,18 @@ export class Dimension {
      * @throws This function can throw errors.
      * @example itemStacks.ts
      * ```typescript
-     *          const oneItemLoc = new mc.BlockLocation(3, 2, 1);
-     *          const fiveItemsLoc = new mc.BlockLocation(1, 2, 1);
-     *          const diamondPickaxeLoc = new mc.BlockLocation(2, 2, 4);
+     *        const oneItemLoc: mc.Vector3 = { x: 3, y: 2, z: 1 };
+     *        const fiveItemsLoc: mc.Vector3 = { x: 1, y: 2, z: 1 };
+     *        const diamondPickaxeLoc: mc.Vector3 = { x: 2, y: 2, 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);
      *
-     *          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);
+     *        overworld.spawnItem(oneEmerald, oneItemLoc);
+     *        overworld.spawnItem(fiveEmeralds, fiveItemsLoc);
+     *        overworld.spawnItem(onePickaxe, diamondPickaxeLoc);
      *
-     *          overworld.spawnItem(oneEmerald, oneItemLoc);
-     *          overworld.spawnItem(fiveEmeralds, fiveItemsLoc);
-     *          overworld.spawnItem(onePickaxe, diamondPickaxeLoc);
      * ```
      * @example spawnItem.ts
      * ```typescript
@@ -3267,29 +3272,34 @@ export class Entity {
      * @example addEffect.js
      * ```typescript
      *        const villagerId = "minecraft:villager_v2<minecraft:ageable_grow_up>";
-     *        const villagerLoc = new BlockLocation(1, 2, 1);
+     *        const villagerLoc: mc.Vector3 = { x: 1, y: 2, z: 1 };
      *        const villager = test.spawn(villagerId, villagerLoc);
      *        const duration = 20;
      *
      *        villager.addEffect(MinecraftEffectTypes.poison, duration, 1);
      *
+     *
      * ```
      * @example quickFoxLazyDog.ts
      * ```typescript
-     *          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 fox = overworld.spawnEntity("minecraft:fox", {
+     *          x: targetLocation.x + 1,
+     *          y: targetLocation.y + 2,
+     *          z: targetLocation.z + 3,
+     *        });
+     *        fox.addEffect(mc.MinecraftEffectTypes.speed, 10, 20);
+     *        log("Created a fox.");
+     *
+     *        const wolf = overworld.spawnEntity("minecraft:wolf", {
+     *          x: targetLocation.x + 4,
+     *          y: targetLocation.y + 2,
+     *          z: targetLocation.z + 3,
+     *        });
+     *        wolf.addEffect(mc.MinecraftEffectTypes.slowness, 10, 20);
+     *        wolf.isSneaking = true;
+     *        log("Created a sneaking wolf.", 1);
+     *
      *
-     *          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);
      * ```
      */
     addEffect(effectType: EffectType, duration: number, amplifier?: number, showParticles?: boolean): void;
@@ -3946,7 +3956,7 @@ export class EntityHealthComponent extends IEntityComponent {
      * @param value
      * @throws This function can throw errors.
      */
-    setCurrent(value: number): void;
+    setCurrent(value: number): boolean;
 }
 /**
  * @beta
@@ -4434,7 +4444,7 @@ export class EntityLavaMovementComponent extends IEntityComponent {
      * @param value
      * @throws This function can throw errors.
      */
-    setCurrent(value: number): void;
+    setCurrent(value: number): boolean;
 }
 /**
  * @beta
@@ -4624,7 +4634,7 @@ export class EntityMovementComponent extends IEntityComponent {
      * @param value
      * @throws This function can throw errors.
      */
-    setCurrent(value: number): void;
+    setCurrent(value: number): boolean;
 }
 /**
  * @beta
@@ -5945,7 +5955,7 @@ export class EntityUnderwaterMovementComponent extends IEntityComponent {
      * @param value
      * @throws This function can throw errors.
      */
-    setCurrent(value: number): void;
+    setCurrent(value: number): boolean;
 }
 /**
  * @beta
@@ -13242,24 +13252,36 @@ export class MinecraftItemTypes {
 export class MolangVariableMap {
     /**
      * @remarks
-     * Sets a Molang rendering/animation variable with the value of
-     * a Red/Green/Blue color.
+     * Adds the following variables to Molang:
+     * - `<variable_name>.r` - Red color value [0-1]
+     * - `<variable_name>.g` - Green color value [0-1]
+     * - `<variable_name>.b` - Blue color value [0-1]
      * @param variableName
      * @param color
      */
     setColorRGB(variableName: string, color: Color): MolangVariableMap;
     /**
      * @remarks
-     * Sets a Molang rendering/animation variable with the value of
-     * a Red/Green/Blue color + Alpha (transparency) value.
+     * Adds the following variables to Molang:
+     * - `<variable_name>.r` - Red color value [0-1]
+     * - `<variable_name>.g` - Green color value [0-1]
+     * - `<variable_name>.b` - Blue color value [0-1]
+     * - `<variable_name>.a` - Alpha (transparency) color value
+     * [0-1]
      * @param variableName
      * @param color
      */
     setColorRGBA(variableName: string, color: Color): MolangVariableMap;
     /**
      * @remarks
-     * Sets the speed and direction for a Molang (rendering and
-     * animation) variable.
+     * Adds the following variables to Molang:
+     * - `<variable_name>.speed` - Speed number provided
+     * - `<variable_name>.direction_x` - X value from the {@link
+     * Vector3} provided
+     * - `<variable_name>.direction_y` - Y value from the {@link
+     * Vector3} provided
+     * - `<variable_name>.direction_z` - Z value from the {@link
+     * Vector3} provided
      * @param variableName
      * @param speed
      * @param direction
@@ -13267,8 +13289,13 @@ export class MolangVariableMap {
     setSpeedAndDirection(variableName: string, speed: number, direction: Vector): MolangVariableMap;
     /**
      * @remarks
-     * Sets a vector value for a Molang (rendering and animation)
-     * variable.
+     * Adds the following variables to Molang:
+     * - `<variable_name>.x` - X value from the {@link Vector3}
+     * provided
+     * - `<variable_name>.y` - Y value from the {@link Vector3}
+     * provided
+     * - `<variable_name>.z` - Z value from the {@link Vector3}
+     * provided
      * @param variableName
      * @param vector
      */
@@ -13352,21 +13379,23 @@ export class PistonActivateEventSignal {
      * @param callback
      * @example pistonEvent.ts
      * ```typescript
-     *          let canceled = false;
+     *        let canceled = false;
+     *
+     *        const pistonLoc: mc.Vector3 = {
+     *          x: Math.floor(targetLocation.x) + 1,
+     *          y: Math.floor(targetLocation.y) + 2,
+     *          z: Math.floor(targetLocation.z) + 1,
+     *        };
+     *
+     *        const pistonCallback = mc.world.events.beforePistonActivate.subscribe((pistonEvent: mc.BeforePistonActivateEvent) => {
+     *          if (pistonEvent.piston.location.equals(pistonLoc)) {
+     *            log("Cancelling piston event");
+     *            pistonEvent.cancel = true;
+     *            canceled = true;
+     *          }
+     *        });
      *
-     *          const pistonLoc = new mc.BlockLocation(
-     *            Math.floor(targetLocation.x) + 1,
-     *            Math.floor(targetLocation.y) + 2,
-     *            Math.floor(targetLocation.z) + 1
-     *          );
      *
-     *          const pistonCallback = mc.world.events.beforePistonActivate.subscribe((pistonEvent: mc.BeforePistonActivateEvent) => {
-     *            if (pistonEvent.piston.location.equals(pistonLoc)) {
-     *              log("Cancelling piston event");
-     *              pistonEvent.cancel = true;
-     *              canceled = true;
-     *            }
-     *          });
      * ```
      */
     subscribe(callback: (arg: PistonActivateEvent) => void): (arg: PistonActivateEvent) => void;
@@ -13768,7 +13797,7 @@ export class Player extends Entity {
      * @param message
      * @throws This function can throw errors.
      */
-    tell(message: RawMessage | string): void;
+    tell(message: (RawMessage | string)[] | RawMessage | string): void;
     /**
      * @beta
      * @remarks
@@ -14153,6 +14182,7 @@ export class Scoreboard {
      * @throws This function can throw errors.
      */
     getParticipants(): ScoreboardIdentity[];
+    getScore(objective: ScoreboardObjective, participant: ScoreboardIdentity): number;
     /**
      * @remarks
      * Removes an objective from the scoreboard.
@@ -14172,6 +14202,7 @@ export class Scoreboard {
         displaySlotId: string,
         objectiveDisplaySetting: ScoreboardObjectiveDisplayOptions,
     ): ScoreboardObjective;
+    setScore(objective: ScoreboardObjective, participant: ScoreboardIdentity, score: number): boolean;
 }
 /**
  * @beta
@@ -14198,6 +14229,9 @@ export class ScoreboardIdentity {
      * @throws This function can throw errors.
      */
     getEntity(): Entity;
+    getScore(objective: ScoreboardObjective): number;
+    removeFromObjective(objective: ScoreboardObjective): boolean;
+    setScore(objective: ScoreboardObjective, score: number): boolean;
 }
 /**
  * @beta
@@ -14236,6 +14270,8 @@ export class ScoreboardObjective {
      * @throws This function can throw errors.
      */
     getScores(): ScoreboardScoreInfo[];
+    removeParticipant(participant: ScoreboardIdentity): boolean;
+    setScore(participant: ScoreboardIdentity, score: number): boolean;
 }
 /**
  * @beta
@@ -14852,7 +14888,7 @@ export class World {
      * @param message
      * @throws This function can throw errors.
      */
-    say(message: RawMessage | string): void;
+    say(message: (RawMessage | string)[] | RawMessage | string): void;
     /**
      * @beta
      * @remarks
@@ -15225,7 +15261,7 @@ export interface RawMessage {
     rawtext?: (RawMessage | string)[];
     text?: string;
     translate?: string;
-    with?: (RawMessage | string)[];
+    with?: string[] | RawMessage;
 }
 /**
  * @beta

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minecraft/server",
-  "version": "1.1.0-beta.1.19.60-preview.25",
+  "version": "1.1.0-beta.1.19.60-stable",
   "description": "",
   "contributors": [
     {

package/tests.ts

@@ -1,21 +1,21 @@
 /* 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) {
+export function createExplosion(log: (message: string, status?: number) => void, targetLocation: mc.Vector3) {
     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) {
+export function createNoBlockExplosion(log: (message: string, status?: number) => void, targetLocation: mc.Vector3) {
     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),
-    );
+    const explodeNoBlocksLoc = {
+        x: Math.floor(targetLocation.x + 1),
+        y: Math.floor(targetLocation.y + 2),
+        z: Math.floor(targetLocation.z + 1),
+    };
 
     log('Creating an explosion of radius 15 that does not break blocks.');
     overworld.createExplosion(explodeNoBlocksLoc, 15, { breaksBlocks: false });
@@ -23,27 +23,31 @@ export function createNoBlockExplosion(log: (message: string, status?: number) =
 
 export function createFireAndWaterExplosions(
     log: (message: string, status?: number) => void,
-    targetLocation: mc.Location,
+    targetLocation: mc.Vector3,
 ) {
     const overworld = mc.world.getDimension('overworld');
 
-    const explosionLoc = new mc.Location(targetLocation.x + 0.5, targetLocation.y + 0.5, targetLocation.z + 0.5);
+    const explosionLoc: mc.Vector3 = {
+        x: targetLocation.x + 0.5,
+        y: targetLocation.y + 0.5,
+        z: 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);
+    const belowWaterLoc: mc.Vector3 = { x: targetLocation.x + 3, y: targetLocation.y + 1, z: 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) {
+export function itemStacks(log: (message: string, status?: number) => void, targetLocation: mc.Vector3) {
     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 oneItemLoc: mc.Vector3 = { x: targetLocation.x + targetLocation.y + 3, y: 2, z: targetLocation.z + 1 };
+    const fiveItemsLoc: mc.Vector3 = { x: targetLocation.x + 1, y: targetLocation.y + 2, z: targetLocation.z + 1 };
+    const diamondPickaxeLoc: mc.Vector3 = { x: targetLocation.x + 2, y: targetLocation.y + 2, z: targetLocation.z + 4 };
 
     const oneEmerald = new mc.ItemStack(mc.MinecraftItemTypes.emerald, 1, 0);
     const onePickaxe = new mc.ItemStack(mc.MinecraftItemTypes.diamondPickaxe, 1, 0);
@@ -59,26 +63,28 @@ export function itemStacks(log: (message: string, status?: number) => void, targ
     overworld.spawnItem(onePickaxe, diamondPickaxeLoc);
 }
 
-export function quickFoxLazyDog(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
+export function quickFoxLazyDog(log: (message: string, status?: number) => void, targetLocation: mc.Vector3) {
     const overworld = mc.world.getDimension('overworld');
 
-    const fox = overworld.spawnEntity(
-        'minecraft:fox',
-        new mc.BlockLocation(targetLocation.x + 1, targetLocation.y + 2, targetLocation.z + 3),
-    );
+    const fox = overworld.spawnEntity('minecraft:fox', {
+        x: targetLocation.x + 1,
+        y: targetLocation.y + 2,
+        z: 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),
-    );
+    const wolf = overworld.spawnEntity('minecraft:wolf', {
+        x: targetLocation.x + 4,
+        y: targetLocation.y + 2,
+        z: 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) {
+export function runEntityCreatedEvent(log: (message: string, status?: number) => void, targetLocation: mc.Vector3) {
     // 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) {
@@ -89,19 +95,19 @@ export function runEntityCreatedEvent(log: (message: string, status?: number) =>
     });
 }
 
-export function createOldHorse(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
+export function createOldHorse(log: (message: string, status?: number) => void, targetLocation: mc.Vector3) {
     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,
-    );
+export function pistonEvent(log: (message: string, status?: number) => void, targetLocation: mc.Vector3) {
+    const pistonLoc: mc.Vector3 = {
+        x: Math.floor(targetLocation.x) + 1,
+        y: Math.floor(targetLocation.y) + 2,
+        z: Math.floor(targetLocation.z) + 1,
+    };
 
     mc.world.events.beforePistonActivate.subscribe((pistonEvent: mc.BeforePistonActivateEvent) => {
         if (pistonEvent.piston.location.equals(pistonLoc)) {
@@ -111,7 +117,7 @@ export function pistonEvent(log: (message: string, status?: number) => void, tar
     });
 }
 
-export function spawnItem(log: (message: string, status?: number) => void, targetLocation: mc.Location) {
+export function spawnItem(log: (message: string, status?: number) => void, targetLocation: mc.Vector3) {
     const featherItem = new mc.ItemStack(mc.MinecraftItemTypes.feather, 1, 0);
 
     overworld.spawnItem(featherItem, targetLocation);
@@ -120,7 +126,7 @@ export function spawnItem(log: (message: string, status?: number) => void, targe
 
 export function testThatEntityIsFeatherItem(
     log: (message: string, status?: number) => void,
-    targetLocation: mc.Location,
+    targetLocation: mc.Vector3,
 ) {
     const overworld = mc.world.getDimension('overworld');
 
@@ -161,13 +167,13 @@ export default class SampleManager {
     tickCount = 0;
 
     _availableFuncs: {
-        [name: string]: Array<(log: (message: string, status?: number) => void, location: mc.Location) => void>;
+        [name: string]: Array<(log: (message: string, status?: number) => void, location: mc.Vector3) => void>;
     };
 
     pendingFuncs: Array<{
         name: string;
-        func: (log: (message: string, status?: number) => void, location: mc.Location) => void;
-        location: mc.Location;
+        func: (log: (message: string, status?: number) => void, location: mc.Vector3) => void;
+        location: mc.Vector3;
     }> = [];
 
     gameplayLogger(message: string, status?: number) {
@@ -194,7 +200,7 @@ export default class SampleManager {
             }
 
             const nearbyBlockLoc = nearbyBlock.location;
-            const nearbyLoc = new mc.Location(nearbyBlockLoc.x, nearbyBlockLoc.y + 1, nearbyBlockLoc.z);
+            const nearbyLoc: mc.Vector3 = { x: nearbyBlockLoc.x, y: nearbyBlockLoc.y + 1, z: nearbyBlockLoc.z };
 
             const sampleId = message.substring(5).trim();
 
@@ -224,8 +230,8 @@ export default class SampleManager {
 
     runSample(
         sampleId: string,
-        snippetFunctions: Array<(log: (message: string, status?: number) => void, location: mc.Location) => void>,
-        targetLocation: mc.Location,
+        snippetFunctions: Array<(log: (message: string, status?: number) => void, location: mc.Vector3) => void>,
+        targetLocation: mc.Vector3,
     ) {
         for (let i = snippetFunctions.length - 1; i >= 0; i--) {
             this.pendingFuncs.push({ name: sampleId, func: snippetFunctions[i], location: targetLocation });
@@ -256,7 +262,7 @@ export default class SampleManager {
     }
 
     registerSamples(sampleSet: {
-        [name: string]: Array<(log: (message: string, status?: number) => void, location: mc.Location) => void>;
+        [name: string]: Array<(log: (message: string, status?: number) => void, location: mc.Vector3) => void>;
     }) {
         for (const sampleKey in sampleSet) {
             if (sampleKey.length > 1 && sampleSet[sampleKey]) {
@@ -267,7 +273,7 @@ export default class SampleManager {
 }
 
 const mojangMinecraftFuncs: {
-    [name: string]: Array<(log: (message: string, status?: number) => void, location: mc.Location) => void>;
+    [name: string]: Array<(log: (message: string, status?: number) => void, location: mc.Vector3) => void>;
 } = {
     runEntityCreatedEvent: [runEntityCreatedEvent, createOldHorse],
     createOldHorse: [createOldHorse],