# Waypoints<\/p>\n
\n
\n<\/p>\n
Ever had the problem, that you were on a long trip and can’t find your base?<\/p>\n
You could set a warp with a conventional plugin at your home and simply teleport back. But if you want to keep the survival experience of not being able to
\nteleport like that, this plugin could be just what your server needs!<\/p>\n
## Direction Indicators<\/p>\n
So, instead of just bringing the player back where he started, this plugin shows him the direction he has to walk, so he can explore the world even more. To
\nshow the player the direction you can configure multiple direction indicators to guide the player to his destination.<\/p>\n
### Bossbar Indicator<\/p>\n
A compass will be visible at the top of the screen, with a highlighter marking in which direction the waypoint is<\/p>\n
### Beacon<\/p>\n
When the waypoint is in render distance, a beacon beam will appear at the location of the waypoint to make it easier to pinpoint the location of the waypoint.<\/p>\n
### Trail<\/p>\n
The plugin attempts to find a suitable path for you to walk and then shows it to you with particles.<\/p>\n
### Hologram<\/p>\n
Floating text like in the mods.<\/p>\n
### Blinking Block<\/p>\n
When the player is closer to the waypoint, the beacon will be replaced with a block sequence that will repeat. This is to help him get to the exact location.<\/p>\n
### Compass<\/p>\n
It won’t get any simpler than that if the player owns a compass. It will have the waypoint as it’s target and points into that direction.<\/p>\n
### Actionbar Indicator<\/p>\n
This is comparable to the compass but doesn’t require one. It will show the rough direction with small sections in the action bar of the player. If the player
\nis too far left, the sections in the right will light up and vice versa.<\/p>\n
### Particles<\/p>\n
Particles appear at the feet of the player pointing into the direction of the waypoint<\/p>\n
## Player tracking<\/p>\n
Although disabled by
\ndefault, when enabled adds a
\nmenu to the GUI where the player can choose another player to track. Now the compass, actionbar indicator and particles will help guide the player to the
\ntracked player.<\/p>\n
– Players can choose to hide themselves in the menu to others (if enabled)
\n– Players must show themselves to others in order to track a player (if enabled)
\n– The player that gets tracked receives a notification who started tracking him (if enabled)<\/p>\n
## Languages
\nThe plugin is shipping translations for the following languages:
\n– English
\n– German
\n– Italian (by marcotech81)
\n– Simplified Chinese (by SnowCutieOwO)
\n– Traditional Chinese (by ItzTheBear)
\n– Brazilian Portuguese (partial, by gaugt980131gg2)<\/p>\n
And if your language is not there, the plugin is fully translatable<\/p>\n
## Other notable features<\/p>\n
– Open the GUI by sneaking and right-clicking with a compass (by default)
\n– Set custom icons for waypoints and folders by clicking on their icon. The item in your main hand will be used
\n– Limit the amount of waypoints and folders a player can have
\n– Customizable teleport prices and price increases the more the player teleports (With Vault support)
\n– Direction indicators customizable
\n– Items in GUI fully customizable
\n– SQLite data storage<\/p>\n
## Integrations<\/p>\n
– Public waypoints are added to:
\n – Dynmap
\n – SquareMap
\n – BlueMap
\n – Pl3xMap<\/p>\n
## Videos<\/p>\n
DonKolia made a small video series of this plugins functionality where he demonstrates the basic functionality and all the available pointers.
\nIt is in Spanish but with English subtitles: Link to playlist<\/p>\n
## Commands<\/p>\n
`\/waypoints` – Opens the GUI<\/p>\n
`\/waypoints select `\/waypoints deselectAll` – Deselect all selected waypoints<\/p>\n `\/waypoints teleport `\/waypoints set `\/waypoints setPublic `\/waypoints setPermission `\/waypoints setTemporary `\/waypoints other `\/waypoints statistics` – Look at some rudimentary statistics about the database<\/p>\n `\/waypoints reload` – Reload the configuration. (`\/reload` **is not supported**)<\/p>\n ### Scripting<\/p>\n `\/waypointsscript deselectWaypoint `\/waypointsscript selectWaypoint `\/waypointsscript temporaryWaypoint `\/waypointsscript uuid ## Permissions<\/p>\n `waypoints.command.use`* – Allows the player to use the `\/waypoints` command and open the GUI<\/p>\n `waypoints.command.other` – Allows the player to use the `\/waypoints other` command<\/p>\n `waypoints.command.statistics` – Allows the player to use the `\/waypoints statistics` command<\/p>\n `waypoints.command.reload` – Allows the player to use the `\/waypoints reload` command<\/p>\n `waypoints.command.scripting` – Allows the player to use the `\/waypointsscript` command and get the UUID of waypoints<\/p>\n `waypoints.modify.private`* – Allows the player to create, alter and delete private waypoints<\/p>\n `waypoints.modify.public` – Allows the player to create, alter and delete public waypoints<\/p>\n `waypoints.modify.permission` – Allows the player to create, alter, delete and always see permission waypoints<\/p>\n `waypoints.modify.anywhere` – Allows the player to place waypoints wherever they want, ignoring disabled worlds<\/p>\n `waypoints.modify.other` – Allows the player to modify the waypoints of another player when using `\/waypoints other`<\/p>\n `waypoints.unlimited` – Allows the player to create more waypoints and folders than the limit in the config<\/p>\n `waypoints.temporaryWaypoint`* – Allows the player to create a waypoint that is only visible for the time he is online<\/p>\n `waypoints.temporaryWaypoint.other`* – Allows the player to create a waypoint for select players that is only visible for the time they is online<\/p>\n `waypoints.teleport.private` – Allows the player to teleport to private waypoints<\/p>\n `waypoints.teleport.public` – Allows the player to teleport to public waypoints<\/p>\n `waypoints.teleport.permission` – Allows the player to teleport to permission waypoints<\/p>\n `waypoints.tracking.enabled`* – Allows the player to use the player tracking feature<\/p>\n `waypoints.tracking.trackAll` – Allows the player to track players that are hidden<\/p>\n `waypoints.updateNotification` – The player receives a notification after a server restart if a new Version is found<\/p>\n *: These permissions are granted to all players by default<\/p>\n ## Configuration<\/p>\n Almost everything is configurable. To have a look at the current configuration file Also, you can change every piece of text to other languages or just change the colors. ## Additional notes<\/p>\n ### Metrics<\/p>\n This plugin uses bStats to collect basic metrics about the usage of this plugin. You can, of course, opt-out of this if you wish. For To view the metrics of this plugin, go here.<\/p>\n ### Java version<\/p>\n Java 21 is the minimum required version.<\/p>\n","protected":false},"excerpt":{"rendered":" Always find your way back home with SMP friendly server-side waypoints<\/p>\n","protected":false},"featured_media":169089,"template":"","meta":{"_minecraft_slug":"waypoints","_minecraft_project_id":"1c2olKOU","_minecraft_author":"md5lukas","_minecraft_license":"MIT","_minecraft_downloads":68017,"_minecraft_follows":134,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"waypoints.zip","_minecraft_size_bytes":41599272,"_minecraft_version_count":38,"_minecraft_updated_at":"2026-05-15T21:44:43.341073Z","_minecraft_date_created":"2022-12-29T17:49:33.632533Z","_minecraft_date_modified":"2025-12-08T18:12:41.213362Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/waypoints","_minecraft_icon_attachment_id":169089,"_minecraft_imported_at":"2026-06-09T20:02:36+00:00","_minecraft_import_hash":"08ac8919f274386c0c7126e55b14c9ab","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,125,127,129,92],"mod_loader":[131,132,134],"minecraft_version":[50,53,57,58,59,36,60,94,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-169088","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-folia","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-spigot","minecraft_version-1-17-1","minecraft_version-1-18-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-4","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\nclick here<\/p>\n
\nEnglish Translation File<\/p>\n
\nfurther information have a look at “What data is collected?”
\nand “Disabling bStats” over here.<\/p>\n