EzWaypoints

Waypoints without a minimap.

Clean. Simple. Shareable. No extra stuff.

EzWaypoints is a client-only Fabric waypoint mod for Minecraft 1.21.8 through 1.21.11. It keeps waypoint data local, scopes it by singleplayer world or multiplayer server, and gives you a lightweight in-game manager instead of a minimap-heavy or command-driven workflow.

For a shorter storefront-style description, see MODRINTH.md.

Preview

Watch the preview video on YouTube: https://www.youtube.com/watch?v=UmbdtYSyb8Q

Screenshots

World labels	Add waypoint	Waypoint manager

What Is This?

Simple waypoint mod without a minimap.

• No clutter.
• No huge settings menu.
• No manual commands.

Just waypoints.

Why Use It?

Many waypoint mods are built around a minimap and a large pile of extra features.

EzWaypoints is for players who:

• do not want a minimap
• do not want to configure 50 settings
• just want clean waypoint labels in the world

If map-based waypoint mods like Xaero's feel too busy, EzWaypoints is the simpler option:

• easier to learn
• fewer hotkeys
• less menu clutter
• focused on waypoints only

Controls

• N opens the new waypoint screen.
• B shows waypoint labels.
• Open Waypoint Manager exists as a separate keybind and is unbound by default.
• There are no custom slash commands.
• The manager lets you switch B between Toggle and Hold mode.
• Saving or canceling from the new waypoint screen returns to the waypoint manager.
• The manager also exposes import and export for share codes.

Features

• Client-only implementation with no server-side component or custom protocol.
• In-game waypoint manager for creating, editing, deleting, and paging through saved points.
• Works on servers as a client-side mod.
• Copy and paste waypoint sharing via portable share codes.
• Import de-duplicates waypoints by name, dimension, coordinates, and color.
• Separate waypoint profiles for each multiplayer server and each singleplayer world instance.
• Singleplayer worlds with the same display name remain separate.
• Two display modes: current dimension only, or linked Overworld/Nether visibility.
• Colored labels using the standard Minecraft-style color palette.
• Adjustable label scale.
• Optional Y coordinate.
• Toggle or hold activation for showing labels.
• Teleport button when the current server exposes tp or teleport.
• Chat feedback for actions such as add, update, delete, import, copy, and mode changes.

Technical Details

Storage And Profile Scoping

• Waypoints are saved locally in config/ezwaypoints/ezwaypoints.json.
• Singleplayer saves also get a persistent world instance id in data/ezwaypoints/world-instance-id.txt.
• Multiplayer profile keys are based on the current server address.
• Singleplayer profile keys are based on world name, save folder, and persistent world instance id.
• This keeps recreated worlds or same-named worlds from collapsing into the same waypoint set.

Rendering And Visibility

• Waypoint labels render in world space instead of using a minimap overlay.
• Visibility can be limited to the current dimension or switched to linked Overworld/Nether mode.
• Linked mode shows Overworld waypoints in the Nether with X/Z / 8.
• Linked mode shows Nether waypoints in the Overworld with X/Z * 8.
• Y is left unchanged in linked mode.
• If a waypoint has no Y value, rendering falls back to the player's current height.

Import, Export, And Teleport

• Share codes export waypoint content for the current profile only.
• Import skips exact duplicates already present in the target profile.
• Duplicate detection uses name, dimension, coordinates, and color.
• The teleport button is shown only when the current command dispatcher exposes tp or teleport.
• Teleport fallback also uses the player's current height when the waypoint omits Y.

Compatibility

Minecraft	Status	Renderer	Notes
1.21.8	Supported	World-space labels	Uses the normal world render hook.
1.21.9	Supported	World-space queued labels	Uses a WorldRenderer mixin hook because the matching Fabric render event is not exposed here.
1.21.10	Supported	World-space labels	Shares the 1.21.10+ compatibility layer.
1.21.11	Supported	World-space labels	Shares the 1.21.10+ compatibility layer.

Installation

1. Install Fabric Loader for the Minecraft version you want to run.
2. Install the matching Fabric API version.
3. Drop the matching EzWaypoints jar into your instance mods folder.
4. Launch the game and use N to create a waypoint.

FAQ

Can I send my waypoints to another player?

Yes. Export them as a share code and send the code.

Does this mod add a minimap?

No. EzWaypoints only adds waypoints.

Does it work on servers?

Yes. It is a client-side mod.

Do I need to install it on the server?

No.

Are waypoints shared between servers or worlds?

No. Each world or server has its own waypoint profile.

Does importing add duplicates?

No. Exact duplicates are skipped during import.

Where are waypoints stored?

config/ezwaypoints/ezwaypoints.json

Why is there no teleport button?

It only appears if tp or teleport is available and you have permission to use it.

Behavior Notes

• Saving or canceling from the add waypoint screen returns to the waypoint manager instead of dropping you back into gameplay.
• Import and export are handled directly in the manager UI; there is no command-based workflow.
• Labels can be shown via toggle or hold behavior depending on the current manager setting.
• The same shared data model is used across all supported Minecraft versions, with renderer hooks swapped by compatibility layer where needed.

Build From Source

Java 21 is required.

./gradlew build

On Windows:

.\gradlew.bat build

Artifacts are written to the versioned subprojects under versions/*/build/libs/.

For local client runs on Windows, use the helper scripts in the repo root:

.\run-1.21.8.ps1
.\run-1.21.9.ps1
.\run-1.21.10.ps1
.\run-1.21.11.ps1

Project Layout

• common/ contains storage, settings, visibility rules, data models, and JUnit tests.
• fabric/ contains the shared Fabric client entrypoint, screens, renderers, and assets.
• fabric-compat/ contains version-specific compatibility shims and mixins.
• versions/ contains the per-Minecraft-version Gradle subprojects and output jars.

License

Licensed under MIT.