Easily create quick travel points! This public waypoint system includes a “My Favorites” list, and each player can create and share up to 999 waypoints. There’s no limit to the number of players online at the same time, and it works smoothly with any addons you may be using. Plus, you’ll enjoy cool camera effects every time you teleport.
A waypoint is a specific location in the world that you can teleport to from any distance. You can set one anywhere—regardless of the dimension you’re in. And it’s not just for you—every online player in your world can create and use their own waypoints too, with no player limit.
With this addon, every new player who joins the world automatically receives the “Waypoint Menu” item. When used, it opens a UI window where they can create, teleport to, delete, rename, and manage their waypoints in various ways.
🧩 Fully works with nearly all addons — no need for player.json or extra files!
🌍 Public waypoint sharing system! Each player can make their waypoints available for a chosen amount of time, and anyone in the world can check them out! Includes great moderation features, a “My Favorites” section, highlighted waypoints, and more! All settings like limits, cooldowns, and rules can be adjusted individually for each dimension!
Advertisement
⛔ Blocklist for public waypoints! You can track who accessed your shared waypoints and when. If needed, you can ban specific players from visiting them — and each waypoint has its own separate blocklist.
💵 Built-in cost system! You can activate a price (using XP levels or scoreboard values) for teleporting, placing, or editing waypoint locations! The fee depends on factors like dimension, distance, and more. Everything can be customized to your liking!
Advertisement
📱 Clean interface with sleek animations! The menu is intuitive and well-organized, with icons for every function. When teleporting, the camera features a stylish animation — with two unique versions based on how far you’re traveling.
🚓 Admin tools included! Server moderators can fully access and manage all players’ waypoints, plus they get several helpful extras! There’s also a “report” button on public waypoints so players can flag anything suspicious to the admin.
Advertisement
🛠️ Incredibly flexible settings! You can control the number of waypoints per player, adjust wait times for teleportation or editing, toggle visual effects, and a lot more. All options are configurable per dimension.
👌 Balanced mechanics for fair play! To use or update a waypoint, players must stay still and connected, which helps avoid cheating — especially in PvP situations.
Advertisement
🎨 Customizable experience for everyone! Players can tweak settings like interface language, mute sounds, choose font styles, and more to suit their preferences.
⚡ Optimized for top performance! Capable of supporting tons of players and thousands of waypoints without lag.
🚨 Designed with stability in mind! Every possible issue or exploit has been accounted for — no trolls or glitches will ruin your world!
🌐 Translated into several languages — and you’re free to localize it into your own!
💎 High-quality and trustworthy! Each release is tested thoroughly, with a 95% chance that bugs are fixed before it’s uploaded. If anything slips through, feel free to leave a comment and report it!
Once you join the world with this addon enabled, you’ll find a new item in your inventory called “Waypoint Menu”.
🖱️ Tap it lightly on a block, hold down, or right-click to bring up the menu:
As you can see, we don’t have any waypoints yet — let’s go ahead and set up our very first one!
💡 Reminder: You can only create, access, and manage waypoints that are within the dimension you’re currently in. For example, to place or teleport to a waypoint in the Nether, you must be in the Nether yourself.
The button also shows which dimension you’re in (green icon = Overworld), and how many waypoints you’ve made (0/5 in this case).
Right now, we’re located in the Overworld, so any waypoint we create will be saved here.
➡️ Tap the “Create new waypoint” button.
A prompt will appear asking you to name your waypoint — feel free to type in a custom name, or just stick with the default if you prefer:
The length of the name is limited to 100 characters, and it also supports paragraph colors (e.g., §4)
Also, here you can choose an icon for your waypoint:
Finally, click “Submit” to create a waypoint in the dimension where you are.
And the countdown will start, during which you have to be immovable:
Particles also spawn during the countdown, and they can be seen by other players:
❓ What if you start moving? The waypoint creation will be interrupted, and you’ll need to open the menu again to try creating it once more.
⏳ Does the countdown feel too long? No worries — this addon is highly customizable, and we’ll explore how to tweak those settings in the final section.
✅ Once the countdown finishes, your new waypoint will be successfully created! Go ahead and open the menu again to see it listed:
Now you’ll notice two new options: “Teleport to waypoint” and “Manage my waypoints”.
Let’s try teleporting to the one we just created! Tap the “Teleport to waypoint” button.
📍 A list of all your saved waypoints will appear:
Next to each waypoint’s name, you’ll see its distance and direction.
📏 The distance is shown in meters (1 meter = 1 block). 🧭 The direction tells you which way to head, based on compass orientation.
Tap on the waypoint you’d like to teleport to.
⏳ Once selected, a countdown will begin — and when it reaches zero, you’ll be instantly teleported to that location:
During the countdown, particles are spawn near you and near the place where you are teleported to. And at the end of the countdown, a beautiful teleportation animation appears.
Third-person view:
If the distance to the waypoint is more than 150 blocks, the teleport animation looks different:
Don’t like particles or camera effects? You can turn them off in the settings, too, which we’ll cover in the last section.
In the menu, click “Manage my waypoints“:
Then select the waypoint you want to change:
And here you can rename, update coordinates and delete the selected waypoint:
The “Rename & change icon” option allows you to rename the selected waypoint
The “Update coordinates” option will set the coordinates of the selected waypoint to where you are now. There is a countdown like when you create a waypoint.
The “Delete waypoint” option allows you to delete the selected waypoint
Also near the dimension icon you can see the coordinates of the waypoint
In the menu, click “Explore public waypoints“, and this window will open:
Ashed a waypoint yet, so let’s do it!
Click on “My published waypoints” and then on “Publish new waypoint”. You will see a list of your waypoints that you can publish:
Click on the waypoint you want to publish. Now you can specify the duration for which it will be published. By default, the maximum duration available for this dimension is entered. (The administrator can change the maximum duration in the addon config)
Click on “Submit”, and you have published your first waypoint! Now you see a list of your published waypoints. Under the name of each waypoint, its statistics are displayed: the number of visits, how many players have added it to favorites, and the remaining expiration time.
In the menu, click “Explore public waypoints“, and this window will open:
You see a list of public waypoints available in the current dimension. Click on the waypoint you would like to view.
And here you can see the nickname of the waypoint owner and its statistics: the number of visits, how many players have added it to favorites, and the remaining expiration time.
To visit a waypoint, click on the corresponding button. Additionally, you can add the waypoint to your favorites to make it easier to find and teleport to. When you have waypoints in your favorites, you will see a “My favorites” button in the “Explore public waypoints” menu:
⛔ BLACKLISTING A VISITOR TO PREVENT THEM FROM VISITING MY PUBLISHED WAYPOINT
In the menu, click “Explore public waypoints“, then click on “My published waypoints“. Select the waypoint for which you want to add a visitor to the blacklist:
Then click on the “Manage visitors” button to see who and when visited this published waypoint:
Now select the visitor you want to add to the blacklist:
Also, in addition to the visitor’s nickname, this list shows how many times the visitor has visited this waypoint, and how long ago the last visit was.
Now, finally, you see the button for adding to the blacklist. Click on it.
The final step is to briefly describe the reason why you are adding this player to the blacklist. The player who is added to the blacklist will see this reason when they attempt to visit this waypoint.
Lastly, just click “Submit,” and you can be sure this player won’t visit your waypoint anymore!
For players who have been blacklisted, you will also see the number of “blocked visits” – this indicates how many times the player attempted to visit your waypoint, but the visit was blocked by the blacklist:
🚓 HOW TO REPORT ABOUT SUSPICIOUS PUBLISHED WAYPOINT
In the menu, click “Explore public waypoints“, then click on “My published waypoints“. Select the waypoint for which you want to add a visitor to the blacklist:
Then click on the “Manage visitors” button to see who and when visited this published waypoint:
Now select the visitor you want to add to the blacklist:
Also, in addition to the visitor’s nickname, this list shows how many times the visitor has visited this waypoint, and how long ago the last visit was.
Now, finally, you see the button for adding to the blacklist. Click on it.
The final step is to briefly describe the reason why you are adding this player to the blacklist. The player who is added to the blacklist will see this reason when they attempt to visit this waypoint.
Lastly, just click “Submit,” and you can be sure this player won’t visit your waypoint anymore!
For players who have been blacklisted, you will also see the number of “blocked visits” – this indicates how many times the player attempted to visit your waypoint, but the visit was blocked by the blacklist:
📙 HOW CAN A WAYPOINT ADMIN CHECK REPORTS ON WAYPOINTS
In the control panel menu, click “View waypoints reports“. Then select the report you want to view:
Also, in this list, under each report, it displays the number of reports on this waypoint, its name, and the nickname of its owner.
When you click on a report, you will see detailed information about the waypoint, such as the owner’s full nickname, the number of visits, how many players have added it to their favorites, and so on. Additionally, in the “Reports” section, you can read all reports about this waypoint (since multiple players may report the same waypoint).
Also, this menu contains these buttons:
Visit waypoint — allows you to visit the reported waypoint so that you can verify if the report is indeed justified.
Delete reports — This will delete all reports for this waypoint, and remove the “Explore with caution” label and poop icon. Use it if you’re sure this waypoint complies with server rules and the reports were baseless.
Punish the owner — Contains various methods of punishment, such as “Unpublish waypoint,” “Delete waypoint,” and so on. Use them last, as any of these actions will also remove all reports about this waypoint, and you will no longer see it in the reports list!
⭐ HOW TO CREATE A FEATURED WAYPOINT FOR AN IMPORTANT LOCATION
In the control panel menu, click “Manage featured waypoints“. A window will open:
Then click on “New featured waypoint“, and a waypoint creation form will open. Now you can set the name, icon, coordinates, dimension, etc. Most of the parameters are automatically filled or have default values, so you don’t have to fill them all:
In the menu, click “My preferences“. And here you can customize your player preferences (these are not addon settings):
Most of the settings are self-explanatory, we will focus on the “Unlock waypoint menu item”
The “Waypoint Menu” item that you are given when you first enter the world is locked by default. What does this mean? It means that you cannot get rid of the item in any way. Even when you die, it doesn’t drop from you. But if you want for example to put this item in the chest, you can activate this option.
But if you lose this item, don’t worry, just type ./waypoint-menu into the chat, and you will get a new item
First, enter /function sirobwaypoints_admin into the chat to become a waypoints’ admin:
There can be any number of players as waypoints admins
To revoke the waypoint admin rights, just enter the above command again
After that you will become a waypoints admin and in the chat will write the following:
You also get a new item: “Waypoint Control Panel”:
Use it to open the control panel UI:
Click the “Addon config” button and the addon settings window will open:
Here is the documentation for all available settings:
General Settings:
Contains the basic settings of the addon.
Description of the options:
🔧”Allow players to unlock the “Waypoints Menu” item in their preferences” – If enabled, a “unlock waypoint menu item” toggle will be displayed in players’ preferences, which will unlock the waypoint menu item for the player. If the player activates it, they will be able to drop the waypoint menu item, put it in a chest, etc., and it will also drop upon their death.
🔧”Give players who are joining the world for the first time the “Waypoints Menu” item” – If enabled, every new player who joins the world for the first time will receive a waypoints menu item. If the player has visited the world before, they will not receive the item.
Language Settings:
Contains language-related settings.
Description of the options:
📃”Default language” – The language that will be set in the preferences of players who join the world for the first time
🔧”Allow players to change language in their preferences” – If disabled, players will not be able to change the language of their waypoints menu in their preferences.
Here you can configure the waypoint publishing system, its limits and restrictions, or completely disable it for a specific dimension.
This menu contains the following submenus:
Main system switch
Here you can enable or disable the publishing system for a specific dimension. If it is disabled, the “Explore public waypoints” button will not be displayed in the “Waypoints Menu”.
Publication count limits
Here you can configure how many waypoints can be simultaneously in a published state from one player in a specific dimension.
Waypoint expiration settings
Here you can configure the maximum allowable expiration time that a player can set when publishing a waypoint in a specific dimension.
The expiration time is the duration during which the waypoint will be publicly accessible, and when it expires, the player needs to republish the waypoint.
Cooldowns between republishing
Here you can configure how often can a player republish their waypoints in a specific dimension.
Republishing – it’s “refreshing” a published waypoint by resetting or modifying the expiration countdown. Additionally, it will move the waypoint to the top of the recently published waypoints list and enhances its ranking in other categories. In short, regular republishing shows that the author of the waypoint is active and that the waypoint is not abandoned.
Countdown & Limits:
Contains settings that control the limit of waypoints a player can have in a specific dimension, as well as the duration of countdowns during teleportation or when creating waypoints.
This menu contains the following submenus:
Waypoints count limits
Controls how many waypoints each player can have in a specific dimension. The range of values is from 0 to 999, and if it’s set to 0, the player won’t be able to use waypoints in that dimension.
Teleport countdowns
Controls how many seconds a player must remain still to teleport to a waypoint in a specific dimension. The range of values is from 0 to 999, and if it’s set to 0, the teleportation will be instant, without particles or any camera effects.
Create & Update countdowns
Controls how many seconds a player must remain still to create or update a waypoint’s coordinates in a specific dimension. The range of values is from 0 to 999, and if it’s set to 0, the creation or update of a waypoint will be instant, without particles or any camera effects.
Economy Settings:
Here you can configure fees that will be charged to players for certain actions with waypoints. Each fee is configured separately for each dimension. By default, all of them are turned off (using the addon for players is free).
Actions for which you can enable fees:
Teleportation fee
Choose the dimension for which you want to configure the fee. Also, on the right side, icons of active fee types in this dimension are displayed (or free if there is none). After you have chosen a dimension, you will see a list of available fee types for this action in this dimension:
Now choose the fee type you want to enable. The fee type determines what the player will pay for this action (XP or scoreboard). Also, pay attention to the color. If the name of the fee type is red, it is turned off, and if it is green, it is turned on. On the right side, a preview of the costs is displayed (you will learn about them below).
Available fee types:
XP levels
This fee consumes the player’s XP levels when they teleport to their waypoint in the selected dimension. If there are not enough XP levels, the teleportation fails.
List of variables for this fee:
Teleportation fee – Determines the initial cost, which is also the minimum cost under ideal conditions.
Additional fee for every 100 blocks of distance to waypoint – Adds this value to the initial cost for every 100 blocks of distance from the player to the waypoint to which they are teleporting.
Additional fee for every 100 blocks of distance from the player to the center of the current dimension – Adds this value to the initial cost for every 100 blocks of distance from the player to the center of the dimension.
Position of the dimension center – The coordinates that will be considered the center of the dimension, and from which additional fees will be calculated from the center of the dimension. By default, these are 000 coordinates, but if this dimension has a “spawn” or “hub”, enter its coordinates.
scoreboard
This fee decreases the score in the player’s scoreboard when they teleport to their waypoint in the selected dimension. If the score in the scoreboard is not enough, the teleportation fails.
List of variables for this fee:
Teleportation fee – Determines the initial cost, which is also the minimum cost under ideal conditions.
Scoreboard objective name – Enter the name of the objective from which the fee will be deducted from the player. This is not the “display name,” but rather the name you used in the command “/scoreboard objectives add <name>”. Also, the player must be present in the objective (have any score), otherwise this fee will be ignored for this player.
Additional fee for every 100 blocks of distance to waypoint – Adds this value to the initial cost for every 100 blocks of distance from the player to the waypoint to which they are teleporting.
Additional fee for every 100 blocks of distance from the player to the center of the current dimension – Adds this value to the initial cost for every 100 blocks of distance from the player to the center of the dimension.
Position of the dimension center – The coordinates that will be considered the center of the dimension, and from which additional fees will be calculated from the center of the dimension. By default, these are 000 coordinates, but if this dimension has a “spawn” or “hub”, enter its coordinates.
Waypoint creation fee
Choose the dimension for which you want to configure the fee. Also, on the right side, icons of active fee types in this dimension are displayed (or free if there is none). After you have chosen a dimension, you will see a list of available fee types for this action in this dimension:
Now choose the fee type you want to enable. The fee type determines what the player will pay for this action (XP or scoreboard). Also, pay attention to the color. If the name of the fee type is red, it is turned off, and if it is green, it is turned on. On the right side, a preview of the costs is displayed (you will learn about them below).
Available fee types:
XP levels
This fee consumes the player’s XP levels when they create new waypoint in the selected dimension. If there are not enough XP levels, the creation fails.
List of variables for this fee:
Waypoint creation fee – Determines the initial cost, which is also the minimum cost under ideal conditions.
Additional fee for every 100 blocks of distance from the player to the center of the current dimension – Adds this value to the initial cost for every 100 blocks of distance from the player to the center of the dimension.
Position of the dimension center – The coordinates that will be considered the center of the dimension, and from which additional fees will be calculated from the center of the dimension. By default, these are 000 coordinates, but if this dimension has a “spawn” or “hub”, enter its coordinates.
scoreboard
This fee decreases the score in the player’s scoreboard when they create new waypoint in the selected dimension. If the score in the scoreboard is not enough, the creation fails.
List of variables for this fee:
Waypoint creation fee – Determines the initial cost, which is also the minimum cost under ideal conditions.
Scoreboard objective name – Enter the name of the objective from which the fee will be deducted from the player. This is not the “display name,” but rather the name you used in the command “/scoreboard objectives add <name>”. Also, the player must be present in the objective (have any score), otherwise this fee will be ignored for this player.
Additional fee for every 100 blocks of distance from the player to the center of the current dimension – Adds this value to the initial cost for every 100 blocks of distance from the player to the center of the dimension.
Position of the dimension center – The coordinates that will be considered the center of the dimension, and from which additional fees will be calculated from the center of the dimension. By default, these are 000 coordinates, but if this dimension has a “spawn” or “hub”, enter its coordinates.
Waypoint updating fee
Choose the dimension for which you want to configure the fee. Also, on the right side, icons of active fee types in this dimension are displayed (or free if there is none). After you have chosen a dimension, you will see a list of available fee types for this action in this dimension:
Now choose the fee type you want to enable. The fee type determines what the player will pay for this action (XP or scoreboard). Also, pay attention to the color. If the name of the fee type is red, it is turned off, and if it is green, it is turned on. On the right side, a preview of the costs is displayed (you will learn about them below).
Available fee types:
XP levels
This fee consumes the player’s XP levels when they update waypoint coordinates in the selected dimension. If there are not enough XP levels, the updating fails.
List of variables for this fee:
Waypoint updating fee – Determines the initial cost, which is also the minimum cost under ideal conditions.
Additional fee for every 100 blocks of distance to the previous waypoint coordinates – Adds this value to the initial fee for every 100 blocks of distance from the player to the previous waypoint coordinates.
Additional fee for every 100 blocks of distance from the player to the center of the current dimension – Adds this value to the initial cost for every 100 blocks of distance from the player to the center of the dimension.
Position of the dimension center – The coordinates that will be considered the center of the dimension, and from which additional fees will be calculated from the center of the dimension. By default, these are 000 coordinates, but if this dimension has a “spawn” or “hub”, enter its coordinates.
scoreboard
This fee decreases the score in the player’s scoreboard when they update waypoint coordinates in the selected dimension. If the score in the scoreboard is not enough, the updating fails.
List of variables for this fee:
Waypoint updating fee – Determines the initial cost, which is also the minimum cost under ideal conditions.
Scoreboard objective name – Enter the name of the objective from which the fee will be deducted from the player. This is not the “display name,” but rather the name you used in the command “/scoreboard objectives add <name>”. Also, the player must be present in the objective (have any score), otherwise this fee will be ignored for this player.
Additional fee for every 100 blocks of distance to the previous waypoint coordinates – Adds this value to the initial fee for every 100 blocks of distance from the player to the previous waypoint coordinates.
Additional fee for every 100 blocks of distance from the player to the center of the current dimension – Adds this value to the initial cost for every 100 blocks of distance from the player to the center of the dimension.
Position of the dimension center – The coordinates that will be considered the center of the dimension, and from which additional fees will be calculated from the center of the dimension. By default, these are 000 coordinates, but if this dimension has a “spawn” or “hub”, enter its coordinates.
Player Permissions:
Controls the permissions that a players will have in a specific dimension. By permission, I mean a specific button in the “Waypoints Menu” for players.
The checkboxes in each button indicate the permission state for that button in each dimension. The first checkbox in the row is for the overworld, the second for the nether, and the third for the end.
To change permissions for a specific button, simply click on it, and the permission menu for that button will open:
For example, if I disallow the “teleport to waypoint” button in the overworld, it will not be displayed for players who are in the overworld:
Appearence Settings:
Contains settings related to appearance, effects, and the way pop-ups are displayed. They are applied globally to all players and cannot be changed in their preferences (to prevent cheating by disabling particles and other things).
Description of the options:
🔧”Enable particles when teleporting or creating waypoints” – If disabled, particles will not appear around the player and the waypoint during the countdown.
🔧”Enable cinematic camera effects when teleporting to waypoints” – If disabled, there will be no camera effects during teleportation to a waypoint, making it more abrupt.
🔧”Enable purple camera fade when teleporting to waypoints” – If disabled, the camera will not have a purple fade for a few seconds during teleportation to a waypoint.
📃”Popups display mode” – Controls the way pop-ups are displayed during countdown. By pop-up, I mean a small semi-transparent window above the hotbar that displays the countdown, the name of the waypoint, its icon, and other information. It has three display options, each of which affects the size of the pop-up. This setting is mainly used to resolve compatibility issues with addons that use the same method for displaying pop-ups.
Sounds Settings:
Contains strings with sounds played during various events (teleportation, waypoint creation, countdown ticking, etc). The value of each input field should follow this pattern:
“sound.name” [volume, pitch]
sound.name – The name of the sound to be used in /playsound
volume – Volume of the played sound (value ranging from 0.1 to 1).
pitch – Speed multiplier of the played sound (value ranging from 0.1 to 5). A value of 1 equals normal speed.
In the control panel, click “Manage players waypoints” button:
Then select a player. Next to the nickname, it says how many waypoints the player has in each dimension:
Only players who are online are displayed in the list
Then select the waypoint. Next to the name of the waypoint, it says the dimension in which it is located:
This list also contains a “waypoints management” button, which has the following menus:
WayPoints Managements:
This menu allows you to perform various manipulations on the waypoints of the selected player, and also allows you to set certain “permissions” specifically for that player.
This menu contains the following sub-menus:
Add waypoint
Instantly adds a new waypoint for the selected player.
Set permissions
It allows you to set permissions for the selected player. The permissions changed here take precedence over the global permissions (which are in the addon config), and overwrite the global permissions for this player.
Unchanged permissions continue to follow global permissions. If the permission matches a global permission, it is marked as “(as in config)”, and will follow the global permission.
Delete waypoints
It allows you to delete all waypoints of this player in all dimensions at once.
And here you can completely control this waypoint: visit, rename, change coordinates and delete:
Also near the dimension icon you can see the coordinates of the waypoint
