Script API - v1.26.10.25
    Preparing search index...

    Class LocatorBarBeta

    Manages the collection of waypoints displayed on a player's locator bar. Allows adding, removing, and querying waypoints with a maximum capacity limit.

    Invalid waypoints in the locator bar will be automatically removed in the next tick. This includes waypoints tied to entities that have been removed from the world.

    Note: You can control whether vanilla player waypoints are automatically added to the locator bar using the locatorbar GameRule. This game rule is currently named locatorbar but will likely be renamed in a future update to be more descriptive.

    Note: You can only modify, remove, or query waypoints that were added by this pack.

    /\*
    import { world, LocationWaypoint, WaypointTextureSelector, WaypointTexture } from "@minecraft/server"

    function sharedWaypoint() {
      const players = world.getAllPlayers();

      if (players.length < 2) {
        console.warn("Need at least 2 players for this example.");
        return;
      }

      const playerA = players[0];
      const playerB = players[1];

      // Create a single waypoint at a specific location
      const textureSelector: WaypointTextureSelector = {
        textureBoundsList: [
          { lowerBound: 0, texture: WaypointTexture.Circle }
        ]
      };

      const waypoint = new LocationWaypoint(
        { dimension: playerA.dimension, x: 100, y: 64, z: 100 },
        textureSelector,
        { red: 1, green: 0, blue: 0 } // Initially red
      );

      // Add the same waypoint to both players' locator bars
      playerA.locatorBar.addWaypoint(waypoint);
      playerB.locatorBar.addWaypoint(waypoint);

      // Change the color - this affects both players
      waypoint.color = { red: 0, green: 1, blue: 0 }; // Now green for both players
    }
    */
    Index

    Constructors

    constructor

    Properties

    count maxCount

    Methods

    addWaypoint getAllWaypoints hasWaypoint removeAllWaypoints removeWaypoint

    Constructors

    Properties

    count: number

    The current number of waypoints in the locator bar.

    This property can't be read in early-execution mode.

    maxCount: number

    The maximum number of waypoints that can be added to the locator bar.

    This property can't be read in early-execution mode.

    Methods

    • Returns Waypoint[]

      Returns an array of all waypoints currently in the locator bar.

      This function can't be called in restricted-execution mode.

      This function can't be called in early-execution mode.

    • Parameters

      Returns boolean

      Checks whether the specified waypoint exists in the locator bar.

      This function can't be called in restricted-execution mode.

      This function can't be called in early-execution mode.

    • Returns void

      Removes all waypoints from the locator bar, clearing it completely.

      This function can't be called in restricted-execution mode.

      This function can throw errors.

      minecraftcommon.EngineError

      This function can't be called in early-execution mode.

    • Parameters

      Returns void

      Removes a specific waypoint from the locator bar. Returns an error if the waypoint does not exist in the locator bar.

      This function can't be called in restricted-execution mode.

      This function can throw errors.

      minecraftcommon.EngineError

      LocatorBarError

      This function can't be called in early-execution mode.

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Methods