Server Waypoint

Changelog

Server Waypoint 4.0.0

A major release: navigation that works without the client mod, waypoint icons, uploads from map mods, VoxelMap support, cross-server waypoints through Velocity, and redesigned commands and screens.

Before you update

- Update servers and clients together. 4.0.0 changes the network protocol and doesn't sync with 3.x. Use matching builds on Velocity and every participating backend too. - `/wp edit` has a new syntax. It changes one property at a time: /wp edit waypoint <dimension> <list> <waypoint> set <property> [<value>], or clear <property> for an optional one. The 3.x form that took every property at once is gone, so update command blocks and scripts that use it. /wp add still accepts its 3.x syntax. - Paper now applies the `CommandPermission` levels. In 3.x, players without an explicit permission node needed operator status. They now get the level set in config.json, so with the defaults every player can use /wp add, /wp edit, /wp remove and /wp navigate. To limit these to operators again, set their levels to 2 or deny the nodes in your permission plugin. - Xaero's Minimap sets synced by 3.x stay behind. By default, Server Waypoint now marks the sets it creates and changes only those. Sets synced by 3.x have plain list names, so they remain next to the new ones as your own sets. Delete them in Xaero's Minimap if you don't need them. - Direct sync into Xaero's Default set is optional and off by default. Turning on Sync into Xaero's default set makes syncing the server list gui.xaero_default replace that set's contents, including personal waypoints. Leave it off to use a separate server-owned set. - Custom translation files need updating. Most server message keys were renamed, so language files made for 3.x no longer override them. Start a new file from the 4.0.0 en_us.json. - Choose the Paper JAR for your Minecraft version. The ranges are now 1.21–1.21.8, 1.21.9–1.21.10, 1.21.11 plus 26.1–26.1.2, and 26.2–26.3. The new 1.21.9 build provides native chat icons. - NeoForge 1.21.6 and 1.21.7–1.21.8 have separate JARs. Select the download for your exact version range. - Waypoint files, config.json and client settings from 3.x load as they are.

Navigation

- /wp navigate <dimension> <list> <waypoint> guides you to a waypoint with a compass, a map, the boss bar, the action bar or a floating label. It runs on the server, so it works without the client mod. - /wp navigate shows your target and switches methods on and off. /wp navigate config text_display moves, turns and resizes the floating label. - defaultNavigationMethods in config.json chooses the methods a new session starts with (default: actionbar). CommandPermission.navigate sets who can navigate (default: level 0). - Navigation resumes when you rejoin, and the compass, map and label follow edits to the waypoint. - Navigation maps remember explored terrain when you change targets or regions. Returning to a previously visited region restores its terrain, including after a server restart; unexplored regions start blank. - Compass and map tooltips show the waypoint and dimension with clearer formatting.

Waypoints

- Choose an item or a VoxelMap image as a waypoint's icon. Icons appear on in-world markers and in the waypoint manager. Supported VoxelMap images also sync to VoxelMap; item icons use its default waypoint image. - Waypoints have an optional display name, keywords and description. Lists can have a display name too. - /wp remove answers with a Restore link that works once within 10 minutes.

Commands

- /wp opens a menu: most features are a click away, and each reply links to the next steps. /wp help [<topic>] explains every command with usages you can click and examples. - The console, RCON and command blocks get the same information as plain text. - On Minecraft 1.21.9 and later, chat feedback shows supported vanilla item sprites and player heads without the client mod. Older versions and unsupported icons retain text or initials. - Commands run through /execute as send feedback to the executing player and a copy labelled Viewed as to the original sender. Teleport confirmations name the player who teleported. - /wp list can search, sort by name, distance or colour, change the page size, and show lists, a tree or flat rows. /wp list dimensions lists every dimension with its waypoint count. defaultPageLimit in config.json sets the default page size. - /wp details shows every property of a waypoint or list, with buttons to edit each one. - /wp add on its own picks a list for a waypoint where you stand. /wp add <x y z> <list> <name> fills in the initials, a random colour and your facing; put a dimension first to add it elsewhere. The full form also takes keywords, a description and an icon. - /wp edit waypoint ... set color and set yaw without a value open a colour picker and a facing picker. set color random picks a colour. - Errors explain the problem and link to a way to fix it. - /wp reload now applies defaultPageLimit, defaultNavigationMethods, CommandPermission, addWaypointFromChatSharing and compressChunkedMessages immediately.

Map mods

- VoxelMap (Fabric; Forge 1.21.11, 26.1-26.1.2 and 26.2; NeoForge 1.21.2-1.21.4, 1.21.11, 26.1-26.1.2, 26.2 and 26.3): server waypoints sync to VoxelMap. Its waypoint list marks them with a sync icon, and editing one opens Server Waypoint's manager. - Upload: /wp upload <xaero|voxelmap> imports waypoints from the map mod on your client. Add force local to overwrite conflicts with your copy, or force local delete to also remove what your map doesn't have. It also works in singleplayer and for the host of a LAN world. Uploading needs level 2 (upload) and deleting needs level 4 (uploadDelete). - Xaero's World Map: right-click the map to add a waypoint to the server at that spot, or right-click a waypoint to add it to the server or edit its server copy. - Xaero's Minimap and VoxelMap: editing a synced Minimap waypoint opens the server form. VoxelMap's map popup offers actions to add a waypoint to the server or edit its server copy. - Sharing a Xaero or VoxelMap waypoint in chat prompts the sender to add it to the server through a prefilled form. Waypoints already identified as server waypoints do not prompt again. - Xaero's Minimap and VoxelMap show synced sets and waypoints under their server names. - The server list gui.xaero_default syncs to a separate Xaero set by default. Sync into Xaero's default set applies on the next sync; other lists always use separate sets. - The client settings list each map mod with its auto sync setting and a Sync now button. - /wp download explicitly refreshes map-mod waypoints even when automatic sync is disabled or the server revision has not changed. Downloading one waypoint refreshes that waypoint without treating the rest of its list as synchronized. - VoxelMap reports synchronized waypoint updates in chat. - Opening a singleplayer or LAN host world no longer automatically replaces its saved map-mod waypoints. Use Sync now for a full refresh; normal waypoint changes still sync when auto sync is enabled. - World Map editing resolves the waypoint's own dimension and server-owned list, preserving display names, icons, keywords and descriptions. Unresolved VoxelMap markers keep their normal VoxelMap edit screen. - VoxelMap uploads generate initials from waypoint names and skip waypoints outside the active subworld.

Cross-server waypoints (Velocity)

- A new Velocity plugin, server_waypoint-4.0.0-velocity.jar, links the servers behind one proxy. It's disabled by default and requires Java 25. Get it from [Modrinth](https://modrinth.com/plugin/server_waypoint/versions?l=ve… or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/

Server Waypoint 3.0.4

- Fixed waypoint cache issues during proxy server transfers. - Added Traditional Chinese, Hong Kong Chinese, Spanish, and Hebrew translations.

Minecraft 26.2

runs on paper 26.1.1 and 26.1.2

2.8.4 update: - fix crashing by FileSystemAlreadyExistsException when loading with some mods together

- from this version, waypoints will be saved in json format - support RGB color for waypoint - /wp list now only lists waypoints in the current dimension, use /wp list all to list all waypoints on server. - /wp list <dimension> to list waypoints in one dimension, /wp list <dimension> <list name> to list one waypoint list.

supports Paper and its forks for 1.21.x