Attuned Anchors

Mach9Games Studio

Attuned Anchors!

Attuned Anchors adds buildable waypoint shrines to Minecraft.

Instead of placing waypoints from a map screen, players build an Anchor structure in the world, activate it, and then use it through an in-game waypoint menu and HUD.

Installation

Install the same jar on both the client and server.

• Client: required
• Server: required

Features

• Buildable Local Anchors and Global Anchors
• In-game waypoint HUD with distance markers
• N menu for viewing, editing, teleporting, and managing Anchors
• Admin teleport button for fast travel
• Name Tag based access control
• Public Anchors, private Anchors, and assigned-user Anchors
• Automatic structure validation
• Broken Anchors disable themselves and reactivate when repaired
• Fully removed Anchors are cleaned from storage
• Persistent world storage

Anchor Types

Attuned Anchors has two Anchor types with different visibility ranges.

| Type | Visibility Range | Core Block | Item Frame |
|—|—|—|—|
| Local Anchor | < 256m | Iron Block | Ender Pearl |
| Global Anchor | > 256m | Diamond Block | Eye of Ender |

Local Anchors are short-range waypoints. By default, they are visible up to 256m away.

Global Anchors are long-range waypoints. They can be seen from beyond 256m and remain available from anywhere in the same dimension.

Access Control

Anchor access is controlled through Name Tags placed inside the Anchor barrels.

• Add a default Name Tag to make the Anchor public.
• Add renamed Name Tags with player names to make the Anchor visible only to those players.
• Leave out Name Tags to keep the Anchor disabled until access is configured.
• More barrels means more room for access names.

Waypoint Menu

Press N to open the Attuned Anchors menu.

From the menu, players can view available Anchors, toggle HUD visibility, inspect access, edit marker appearance, and manage Anchors they are allowed to control.

Deleting an Anchor uses a confirmation screen to prevent accidental removals.

Activation

Build the structure, place the required item frames, then interact with one of the Anchor item frames.

If the structure is valid, the Anchor is registered, its candles are managed by the mod, and it becomes visible to players with access.

Commands

The main command is /anchor, with /an as a shortcut.

• /anchor spawn <local | global> [<color> [<icon> [<name>]]] creates a complete Anchor.
• /anchor despawn removes the nearest registered Anchor structure within 32 blocks.
• /anchor list shows Anchors visible to the player.
• /anchor remove deletes the nearest registered Anchor record without breaking blocks.
• /anchor help [spawn | despawn | list | remove] shows command help.

Add this near the bottom, replacing the current Configuration section:

Configuration

Attuned Anchors creates its config files in:

config/attunedanchors/

Main Config

config/attunedanchors/config.json

Default values:

{
  "localRadius": 256,
  "validationIntervalSeconds": 60,
  "globalSameDimensionOnly": true,
  "anchorNameMaxLength": 16,
  "localNamePrefix": "[L] ",
  "globalNamePrefix": "[G] "
}

Anchor records are saved per world at:

data/attuned_anchors.tsv

Structure definitions are configurable through:

config/attunedanchors/structures.json

Admins and Permissions

Attuned Anchors supports the Fabric Permissions API.

Grant this node to give full access:

attunedanchors.admin

Individual permission nodes:

| Permission | Allows |
|—|—|
| attunedanchors.menu | Open the Anchor menu |
| attunedanchors.edit | Edit Anchor name, color, and icon |
| attunedanchors.manage | Manage Anchor users and delete Anchors |
| attunedanchors.teleport | Teleport to Anchors from the menu |
| attunedanchors.command.list | Use /anchor list |
| attunedanchors.command.spawn | Use /anchor spawn |
| attunedanchors.command.remove | Use /anchor remove |
| attunedanchors.command.despawn | Use /anchor despawn |

If you do not use a permissions mod, fallback admins can be added here:

config/attunedanchors/admins.json

Example:

{
  "uuids": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "names": [
  ]
}

{
  "uuids": [
  ],
  "names": [
    "PlayerName"
  ]
}