Waypoints

Waypoints is a server-side plugin for Paper and Folia that turns homesick players loose on foot instead of teleporting them home outright. Direction indicators such as beacons, compasses, and floating text guide players toward saved locations, keeping survival travel meaningful.

Server software and versions

• Folia: Minecraft 1.19.4 to 26.2. The newest build needs no dependencies, optionally Pl3xMap, squaremap, Dynmap® and BlueMap; some builds for 1.20.1 to 1.20.6 require CommandAPI.
• Paper: Minecraft 1.17.1 to 26.2. The newest build needs no dependencies, optionally Pl3xMap, squaremap, Dynmap® and BlueMap; some builds for 1.20.1 to 1.20.6 require CommandAPI.
• Spigot: Minecraft 1.17.1 to 1.20.2, builds stopped after October 2023. The newest build needs no dependencies, optionally squaremap, Dynmap® and BlueMap.

Direction indicators

Waypoints ships seven indicator types that can be combined so players always have a way to tell which direction to walk.

• Bossbar compass highlighting the direction toward the waypoint
• Beacon beam that appears once the waypoint enters render distance
• Floating hologram text marking the waypoint location
• Blinking block sequence for pinpointing the exact spot up close
• Physical compass item that points at the destination
• Actionbar indicator showing rough direction without needing a compass
• Directional particles at the player's feet

Player tracking and customization

Player tracking is disabled by default; turning it on adds a menu for locking onto another player's location, with opt-in visibility and a notification sent to whoever gets tracked. Admins can cap how many waypoints or folders each player keeps, set custom icons per waypoint or folder, and charge escalating teleport costs through Vault. Seven languages ship out of the box, and the plugin is fully translatable beyond that.

Commands and permissions

Every feature is exposed through the waypoints command tree, gated behind granular permission nodes so admins decide who can create, view, or manage waypoints.

• waypoints opens the management interface
• waypoints set creates a private waypoint, setPublic makes it visible to everyone
• waypoints teleport moves a player to a saved location
• waypoints other views another player's waypoints
• waypoints reload reloads the configuration, a full reload of the running instance is not supported

Compatibility

Public waypoints can surface on Dynmap, squaremap, Pl3xMap, and BlueMap when those map plugins are installed, though none of them are required to run Waypoints. Data lives in a local SQLite file, so no external database is needed. Spigot builds stopped after October 2023, leaving Paper and Folia as the only actively maintained targets, and setup follows the same steps as any other plugin.