Waypoints

Waypoints

A lightweight Minecraft waypoint datapack that adds a survival-friendly fast travel and teleport system for singleplayer and SMP servers. Supports Minecraft Java 1.21.6+.

by
2.1K Downloads
datapackfabricforgeneoforgequiltgame-mechanicstechnologyutility
Rent Server with this Mod

About this Mod

Waypoints Teleport – Minecraft Waypoint & Fast Travel Datapack (1.21.6+)

Patreon

Waypoints Teleport is a lightweight Minecraft waypoint datapack that adds a survival-friendly fast travel and teleport system to your world. Save, manage, and instantly travel between custom locations across all dimensions using a clean dialog-based interface — no client-side mods required.

Perfect for survival worlds, SMP servers, multiplayer communities, and long-term exploration maps.

Craft and obtain a Waypoint Rod to unlock your personal teleport network.

Features

1

  • ✔ Create and manage up to 20 custom waypoints per player
  • ✔ Cross-dimension teleportation (Overworld, Nether, End)
  • ✔ Survival-balanced XP cost system (configurable)
  • ✔ Built-in teleport cooldown to prevent spam
  • ✔ Fully multiplayer compatible (server-side storage)
  • ✔ No resource pack required
  • ✔ Vanilla datapack – no Fabric or Forge needed
  • ✔ Designed for Minecraft Java Edition 1.21.6+

Requirements

  • Minecraft Version: 1.21.6 or later (Java Edition)
  • Type: Vanilla Datapack
  • Single Player/Server: Works on both

Getting Started

Obtaining the Waypoint Rod

Crafting Recipe:

2

  • R = Redstone
  • S = Stick

The Waypoint Rod acts as your portable fast travel controller. Right-click to open your waypoint management menu.

Using the Waypoints Menu

  1. Right-click the Waypoint Rod to open the main menu
  2. Choose from 5 options:
    • Create Waypoint – Save your current location
    • My Waypoints – View all saved locations
    • Teleport – Fast travel to a selected waypoint
    • Remove – Delete an existing waypoint
    • Help & Info – View system details

Teleporting (Fast Travel System)

  • Open the Teleport menu
  • Select a waypoint from the dialog interface
  • Instantly fast travel to that location
  • Cost: 2 XP Levels per teleport (configurable)
  • Cooldown: 10 seconds between teleports

Creating Waypoints

Click "Create Waypoint" and enter a custom name (up to 24 characters). If left blank, the system auto-generates names such as "Waypoint 1", "Waypoint 2", etc.

  • Max Waypoints: 20 per player (configurable)
  • Storage: Permanently saved server-side
  • Distance: Unlimited cross-dimension support

Commands

Command Effect
/trigger wp_menu set 1 Open the Waypoints menu
/trigger wp_list set 1 Show your waypoints in chat (legacy)
/trigger wp_list set -1 Show your waypoints in dialog
/trigger wp_create set 1 Create a new waypoint
/trigger wp_tp set -1 Open Teleport dialog
/trigger wp_remove set -1 Open Remove dialog
/function waypoints:admin/config Open admin configuration panel
/function waypoints:admin/reset_player @s Reset a specific player's saved waypoints
/function waypoints:admin/uninstall Safely uninstall the waypoint datapack

System Configuration

Customize the Minecraft waypoint and fast travel system:

  • XP cost per teleport
  • Teleport cooldown duration
  • Maximum waypoints per player
/function waypoints:admin/config

Dynamic Dialog System

Each waypoint displays:

  • Custom name (or auto-generated fallback)
  • X, Y, Z coordinates
  • Dimension (Overworld, Nether, End)

Teleportation Mechanics

Teleport instantly to any saved waypoint. The system:

  • Checks for sufficient XP before teleporting
  • Applies cooldown to prevent teleport spam
  • Provides visual and audio feedback
  • Displays waypoint confirmation in chat

Server-Side Storage System

All waypoints are stored per-player and persist through world reloads, server restarts, and re-joins. Multiplayer safe and fully isolated per player.

Limits & Balance

  • Max Waypoints: 20 per player (default)
  • Teleport Cost: 2 XP Levels (default)
  • Cooldown: 10 seconds
  • Name Length: 24 characters maximum
  • Waypoint Distance: Unlimited

Need to adjust XP cost?

  • Modify values via settings menu /function waypoints:admin/config

Technical Details

  • Type: Vanilla Minecraft Datapack
  • Pack Format: 80+ (Minecraft 1.21.6+)
  • Performance Impact: Minimal (only active during interaction)
  • Command Usage: ~15 execute commands per tick

Search Keywords: Minecraft waypoint datapack, Minecraft fast travel system, teleport datapack 1.21, survival teleport mod, SMP waypoint system, vanilla teleport datapack, multiplayer waypoint teleport.

Available Versions

1.01release
MC 1.21.6-pre4, 1.21.6-rc1, 1.21.6, 1.21.7-rc1, 1.21.7-rc2, 1.21.7, 1.21.8-rc1, 1.21.8, 1.21.9-pre1, 1.21.9-pre2, 1.21.9-pre3, 1.21.9-pre4, 1.21.9-rc1, 1.21.9, 1.21.10-rc1, 1.21.10, 1.21.11-pre1, 1.21.11-pre2, 1.21.11-pre3, 1.21.11-pre4, 1.21.11-pre5, 1.21.11-rc1, 1.21.11-rc2, 1.21.11-rc3, 1.21.11, 26.1-snapshot-1, 26.1-snapshot-2, 26.1-snapshot-3, 26.1-snapshot-4, 26.1-snapshot-5, 26.1-snapshot-6, 26.1-snapshot-7, 26.1-snapshot-8, 26.1-snapshot-9fabric, forge, neoforge, quilt
February 24, 2026
1.01release
MC 1.21.6-pre4, 1.21.6-rc1, 1.21.6, 1.21.7-rc1, 1.21.7-rc2, 1.21.7, 1.21.8-rc1, 1.21.8, 1.21.9-pre1, 1.21.9-pre2, 1.21.9-pre3, 1.21.9-pre4, 1.21.9-rc1, 1.21.9, 1.21.10-rc1, 1.21.10, 1.21.11-pre1, 1.21.11-pre2, 1.21.11-pre3, 1.21.11-pre4, 1.21.11-pre5, 1.21.11-rc1, 1.21.11-rc2, 1.21.11-rc3, 1.21.11, 26.1-snapshot-1, 26.1-snapshot-2, 26.1-snapshot-3, 26.1-snapshot-4, 26.1-snapshot-5, 26.1-snapshot-6, 26.1-snapshot-7, 26.1-snapshot-8, 26.1-snapshot-9datapack
February 24, 2026
initialrelease
MC 1.21.6-pre4, 1.21.6-rc1, 1.21.6, 1.21.7-rc1, 1.21.7-rc2, 1.21.7, 1.21.8-rc1, 1.21.8, 1.21.9-pre1, 1.21.9-pre2, 1.21.9-pre3, 1.21.9-pre4, 1.21.9-rc1, 1.21.9, 1.21.10-rc1, 1.21.10, 1.21.11-pre1, 1.21.11-pre2, 1.21.11-pre3, 1.21.11-pre4, 1.21.11-pre5, 1.21.11-rc1, 1.21.11-rc2, 1.21.11-rc3, 1.21.11, 26.1-snapshot-1, 26.1-snapshot-2, 26.1-snapshot-3, 26.1-snapshot-4, 26.1-snapshot-5, 26.1-snapshot-6, 26.1-snapshot-7, 26.1-snapshot-8, 26.1-snapshot-9fabric, forge, neoforge, quilt
February 21, 2026
initialrelease
MC 1.21.6-pre4, 1.21.6-rc1, 1.21.6, 1.21.7-rc1, 1.21.7-rc2, 1.21.7, 1.21.8-rc1, 1.21.8, 1.21.9-pre1, 1.21.9-pre2, 1.21.9-pre3, 1.21.9-pre4, 1.21.9-rc1, 1.21.9, 1.21.10-rc1, 1.21.10, 1.21.11-pre1, 1.21.11-pre2, 1.21.11-pre3, 1.21.11-pre4, 1.21.11-pre5, 1.21.11-rc1, 1.21.11-rc2, 1.21.11-rc3, 1.21.11, 26.1-snapshot-1, 26.1-snapshot-2, 26.1-snapshot-3, 26.1-snapshot-4, 26.1-snapshot-5, 26.1-snapshot-6, 26.1-snapshot-7, 26.1-snapshot-8, 26.1-snapshot-9datapack
February 21, 2026

How to Install Waypoints on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set datapack Loader

In the panel under "Egg", select the datapack loader and matching Minecraft version (26.1-snapshot-9).

3

Install Mod

Open the mod browser in the dashboard and search for "Waypoints". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

datapackfabricforgeneoforgequilt

Minecraft Versions

26.1-snapshot-9, 26.1-snapshot-8, 26.1-snapshot-7 (+31 more)

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Waypoints server crashes on startup – what to do?

Most common cause: wrong datapack version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.1-snapshot-9). You can switch loaders with one click in the panel.

Is Waypoints compatible with datapack and fabric and forge and neoforge and quilt?

Waypoints officially supports datapack, fabric, forge, neoforge, quilt for Minecraft 26.1-snapshot-9, 26.1-snapshot-8, 26.1-snapshot-7. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Waypoints – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Waypoints consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install Waypoints with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
GNU Affero General Public License v3.0 only
Server-side
Required

Supported Versions

26.1-snapshot-926.1-snapshot-826.1-snapshot-726.1-snapshot-626.1-snapshot-526.1-snapshot-426.1-snapshot-326.1-snapshot-226.1-snapshot-11.21.11+24 more