Waypoints

Waypoints

• Create and save waypoints, with optional automatic death waypoints for all players.
• Manager UI (.waypoints or apostrophe key) which sorts, highlights and filters waypoints.
• Compass overlay: Show a bar at the top of the screen that shows the waypoint icons in your field of view
  • Shows names of waypoints when you're directly facing them
  • Adjustable position and transparency
  • Moves out of the way of boss/town bars
  • Optionally shows death position
  • Optionally shows logout locations
• Coordinates overlay: Show your direction and current XYZ position above the compass overlay
• Preset icons; skull, arrow, heart etc.
• Features: name, co-ordinates, dimension, icon, visibility, lines, color, copy button, opposite co-ordinates (nether), death pruning.
• Constant-size labels and optional tracers.
• Stored per world/server under wurst/waypoints/<worldId>.json.
• Xaero's Minimap integration, allows exporting and importing of waypoint data (disconnect & reconnect to update).
• VoxelMap and Xaero waypoint import and export from the waypoint manager.
• Supports duplicate detection, dimension mapping, colors, icons, visibility, beacon settings, and world-specific files.
• Adjustable Tri-state Beacon Mode on waypoints (On/Off/ESP) that matches the waypoint's color.
• Toggleable automatic portal logging, logs numerically each portal you enter and matches it in the opposite dimension with the same number.
• Optional distance based label scaling.
• Optional dimming or hiding of on-screen waypoints unless looking directly at them.
• Crosshair line-distance readout for waypoint lines.
• When you look near a visible waypoint line, the distance is displayed under the crosshair.
• The readout uses the waypoint color and respects waypoint fade behaviour.
• Waypoint line targeting uses an angle-to-waypoint calculation instead of a simple boolean check.
• Friends can create persistent waypoints from received friend pings via .friends waypoint.

Waypoint Commands

Create a waypoint at the given coords (player position used when coords omitted).

Set color, icon, visibility, line/beacon behavior, auto-action when near, max visible distance and label scale.

.waypoint add <name> [x=<int>] [y=<int>] [z=<int>] [dim=<overworld|nether|end>] [color=<#RRGGBB|#AARRGGBB>] [icon=<square|circle|triangle|star|diamond|skull|heart|check|x|arrow_down|sun|snowflake>] [visible=<true|false>] [lines=<true|false>] [opposite=<true|false>] [beacon=<off|solid|esp>] [action=<disabled|hide|delete>] [actiondist=<int>] [maxvisible=<int>] [scale=<decimal>]

Radius command

Modify or remove waypoints within blocks of the player (current dimension only).

.waypoint radius <radius> [key=value ...] (alias: setradius)

Common keys: delete/remove, clear, color=, visible=, lines=, beacon=, maxvisible=, icon=.

Booleans: true/false/1/0/yes/no/on/off. Color accepts leading # or 0x; 6‑digit -> opaque.

Reports number of waypoints changed.

---

Parent: What's new in this fork?
Children: Waypoint Commands | Radius command