WaypointPlus

Advanced multiplayer waypoint plugin for Minecraft 1.21.11 (Spigot/Paper).

Features

• Create, manage, and organize waypoints with 10 categories (home, base, farm, mine, nether, end, poi, danger, shop, default)
• BossBar navigation with real-time direction compass, distance tracking, and progress indicator
• Particle trails pointing toward your active waypoint
• ActionBar display with live distance and coordinates
• Compass integration — your compass automatically points to the tracked waypoint
• Full GUI system — everything controllable via clickable chest menus
  • Main waypoint list with sorting and pagination
  • Per-waypoint management (navigate, teleport, rename, category, description, share, public/private, move, delete)
  • Visual category selector with Material icons
  • Player head share selector with toggle
  • Sort mode selector (name, distance, date, category)
  • Delete confirmation dialog
  • Shared-with-me and public waypoint browsers
  • Create waypoints via GUI with chat input
• Multiplayer sharing — share waypoints with specific players or make them public
• Death waypoints — automatic waypoint creation on death
• Import/Export — text-based waypoint transfer
• Admin tools (OP only) — stats, player management, purge, config reload
• Fully configurable — 100+ settings in config.yml, all messages customizable

Requirements

• Minecraft 1.21.11
• Spigot or Paper server
• Java 21

Installation

1. Build with mvn clean package or run build.bat
2. Copy target/WaypointPlus-2.4.1.jar to your server's plugins/ folder
3. Restart the server
4. Edit plugins/WaypointPlus/config.yml to customize

Player Commands

Main command: /waypoint — Aliases: /wp, /wps

Command	Description
/wp or /wp gui	Open waypoint GUI
/wp create <name> [category]	Create waypoint at your location
/wp delete <name>	Delete waypoint
/wp rename <old> <new>	Rename waypoint
/wp update <name>	Move waypoint to current location
/wp desc <name> <text>	Set description
/wp category <name> <cat>	Set category
/wp public <name>	Toggle public/private
/wp info <name>	Show waypoint details
/wp navigate <name>	Start BossBar tracking with particles
/wp stop	Stop tracking
/wp list [sort] [page]	List waypoints (sort: name, distance, date, category)
/wp near [radius]	Find nearby waypoints
/wp share <name> <player>	Share waypoint with a player
/wp unshare <name> <player>	Revoke share
/wp export	Export all waypoints as text
/wp import <data>	Import waypoint from text
/wp help	Show help

Admin Commands (OP only)

Command: /waypointadmin — Aliases: /wpa, /wpadmin

Command	Description
/wpa reload	Reload configuration
/wpa stats	Show server statistics
/wpa list <player>	View a player's waypoints
/wpa delete <player> <name>	Delete a player's waypoint
/wpa purge <player>	Delete all waypoints of a player
/wpa purgeall	Delete ALL waypoints
/wpa migrate	Migration tool (future)

Permissions

Permission	Default	Description
waypoint.use	everyone	Basic waypoint commands
waypoint.create	everyone	Create waypoints
waypoint.share	everyone	Share waypoints
waypoint.navigate	everyone	Navigation & tracking
waypoint.gui	everyone	GUI access
waypoint.unlimited	op	No waypoint limit
waypoint.color	op	Colored waypoint names
waypoint.admin	op	Admin commands, teleport via GUI

Documentation

Open docs.html for full interactive documentation.

License

Private project.

---

Last reviewed: 2026-04-11