# Improved Waypoints
Improved Waypoints is a powerful and easy-to-use Minecraft Bedrock addon that gives players a better way to save, manage, share, and travel to important locations.
Players can create custom waypoints anywhere in their world. Each waypoint can be named, updated, deleted, or selected as a teleport destination through the in-game menu.
Waypoints can remain private for personal use or be shared publicly with everyone in the world. Public waypoints are ideal for:
* Towns
* Bases
* Shops
* Farms
* Event areas
* Community buildings
* Adventure locations
* Important landmarks
> **Achievement Compatibility Notice**
>
> Following a recent Minecraft Bedrock update, activating custom behavior packs may cause Minecraft to display **“Achievements disabled.”**
>
> Improved Waypoints uses stable Script APIs and does not require experimental Beta APIs. However, Minecraft controls achievement eligibility, and there is currently no supported manifest option that can force achievements to remain enabled.
>
> Until Mojang changes this behavior, Improved Waypoints should be considered **not achievement-compatible on affected Minecraft versions**.
# Features
* Create private waypoints
* Share public waypoints with everyone
* Teleport to saved waypoints
* Rename existing waypoints
* Update saved waypoint locations
* Delete unwanted waypoints
* Send teleport requests to other players
* Accept or deny teleport requests through the menu
* Upgrade waypoint capacity
* Randomly teleport to a new location
* Teleport directly to entered coordinates
* Return near your last death location
* Remove saved death locations
* Display safe-return coordinates
* Includes a resource pack with custom menu icons
* Automatically provides the waypoint menu item
* Craft a replacement menu item if the original is lost
# Private and Public Waypoints
Private waypoints belong to the player who created them and are available only through that player’s waypoint menu.
Public waypoints are shared with everyone in the world. They can be used to provide quick access to important community locations such as towns, shops, farms, public bases, or event areas.
Players can change the name or location of their waypoints and remove locations they no longer need.
# Waypoint Capacity Upgrades
Players can unlock additional waypoint slots as they progress.
This gives Survival worlds a progression system while keeping each player’s waypoint list organized and manageable.
# Teleport Requests
The built-in teleport-request system lets players request to teleport through the waypoint menu.
Players can:
* Send teleport requests
* View incoming requests
* Accept requests
* Deny requests
* Manage travel without entering commands
This provides a cleaner and more organized way for players to travel to one another.
# Random and Coordinate Teleportation
Improved Waypoints includes additional travel options.
## Random Teleport
Players can use Random Teleport to travel to another location for exploration.
## Coordinate Teleport
Players with access to the option can enter coordinates and teleport directly to that location.
# Death Return System
When a player dies, Improved Waypoints saves the death location and provides a **Teleport Back to Death** option in the main menu.
The addon also records a safe fallback location while the player travels. This helps return the player near the death location without placing them directly into a dangerous or obstructed position.
Death Return features include:
* Saves the player’s death location
* Tracks a separate safe-return location
* Displays the safe-return coordinates
* Provides a Teleport Back to Death button
* Provides an option to remove the saved death location
* Automatically clears applicable death information after a successful return
* Uses an increased return distance of approximately 50 blocks
# Custom Menu Icons
Improved Waypoints includes a resource pack containing custom menu icons.
Icons are used throughout the interface for:
* Main menu actions
* Private waypoints
* Public waypoints
* Waypoint management
* Teleport requests
* Random teleportation
* Coordinate teleportation
* Death Return options
* Additional menu actions
The resource pack improves readability and gives the addon a cleaner, more polished interface.
# Waypoint Menu Item
The waypoint menu item is provided automatically when the player joins the world.
If the item is lost, players can craft a replacement.
Use the item to open the Improved Waypoints menu and manage saved locations, teleport requests, upgrades, and travel options.
# Installation
1. Download Improved Waypoints.
2. Import the Behavior Pack into Minecraft Bedrock Edition.
3. Import the Resource Pack.
4. Activate both packs on your world.
5. Ensure both packs are the same version.
6. Join the world.
7. The waypoint menu item will be provided automatically.
8. Use the item to begin creating and managing waypoints.
The resource pack is required for the complete menu-icon experience in version 2.0.0 and newer.
# Updating From an Older Version
1. Back up your world.
2. Remove the old Improved Waypoints Behavior Pack from the world.
3. Remove the old Improved Waypoints Resource Pack.
4. Import the new versions of both packs.
5. Reactivate both updated packs on the same world.
6. Join the world and allow the addon to update its saved data.
7. Test existing private and public waypoints.
Existing waypoint data should remain available. Newer versions also include improved data migration, synchronization, and duplicate-name handling.
# Important Notes
* Always back up your world before installing an update.
* Keep the Behavior Pack and Resource Pack on the same version.
* The resource pack is required for the full visual experience.
* Public waypoints are shared across the entire world.
* Private waypoints belong to individual players.
* Safe-return coordinates are updated while players travel.
* The Death Return system attempts to return players near their death location.
* Random and coordinate teleportation should be used carefully.
* Minecraft controls achievement eligibility; the addon cannot override it.
# Compatibility
Improved Waypoints is designed for:
* Minecraft Bedrock Edition
* Survival worlds
* Single-player worlds
* Multiplayer worlds
* Minecraft Realms
* Bedrock Dedicated Servers
* Community hubs
* Adventure worlds
* Long-term worlds
The addon uses stable Script APIs and does not require experimental Beta APIs.
# Credits
Improved Waypoints is an enhanced version based on the foundational work provided by Rezn1r in the original Basic Waypoints project.
You can view the original project on [CurseForge](https://www.curseforge.com/minecraft-bedrock/addons/basic-waypoints).
# Improved Waypoints v2.0.0 Changelog
## Death Return
* Added the Death Return system.
* Added a Teleport Back to Death button after a player dies.
* Added a Remove Death Location button.
* Added Death Return options directly to the main waypoint menu.
* Death Return now saves both the death location and a separate safe-return location.
* Added background tracking for safe-return positions.
* Safe-return information only updates after the player travels far enough from the previous saved position.
* Increased the Death Return distance to approximately 50 blocks.
* Added saved safe-return coordinates to the main menu.
* Death Return data now automatically clears only after the player uses the return option and reaches the death area.
## Public Waypoint Improvements
* Improved public-waypoint synchronization.
* Fixed an issue where removing a waypoint from Public Waypoints could leave it marked as public under My Waypoints.
* Added unique waypoint IDs for more reliable matching and synchronization.
* Improved support for duplicate waypoint names.
* Improved matching and migration of older saved waypoint data.
## Stability Improvements
* Improved waypoint saving.
* Improved public and private waypoint synchronization.
* Improved Death Return handling.
* Added general performance and stability improvements.
# Improved Waypoints Resource Pack v2.0.0 Changelog
* Added the Improved Waypoints Resource Pack.
* Added custom icons throughout the waypoint interface.
* Added icons for main menu actions.
* Added icons for waypoint-management menus.
* Added icons for teleport-request buttons.
* Added icons for public and private waypoint options.
* Added icons for Death Return actions.
* Added support for custom icons through menu layouts.
* Improved the overall appearance of the interface.
* Improved menu readability and navigation.
* The Resource Pack is now required for the complete visual experience.
# Support
join my [Discord server](https://discord.com/invite/2bvzPfuY54).
