ВЕРСИИ (205)

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

# 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=velocity) or the [GitHub releases](https://github.com/2676959/server_waypoint/releases) and follow the [setup guide](https://github.com/2676959/server_waypoint/blob/4.0.0/docs/tips/server-guide.md#cross-server-teleport-setup). - `/wp remote` shows the connected servers and their state. `/wp remote list` and `/wp remote details` browse the waypoints other servers share, and `/wp remote tp` teleports you to one. The destination checks the target and your permission before you switch and confirms your arrival. These commands work without the client mod. - With the client mod, the waypoint manager has a remote view with a server selector. - Servers connect over an encrypted channel authenticated with pinned public keys (`NOISE_KK`), or unencrypted over loopback on a single machine (`PLAINTEXT`). - Backend and proxy logs report specific connection failure reasons, including timeouts, protocol mismatches, authentication failures and duplicate server IDs. - `/serverwaypoint status` on Velocity reports the coordinator's state. `/sw-cross-server-keygen` on a backend console creates the backend's keys without a start-and-stop pass. `serverIconItem` sets the item a backend shows in the server selector. - New permissions: `remoteList` (default level 0) and `remoteTp` (default level 2). - Remote teleport checks `remote.tp` on the source player, independently of local `tp` and remote browsing permissions. The destination checks both its own `tp` and `remote.tp` before transfer and again on arrival. - Permission failures during destination preparation name the destination and show the separate `tp` and `remote.tp` results. Paper's offline checks honor LuckPerms decisions and each node's configured vanilla fallback level. ### Waypoint manager - New layout: a dimension rail, the waypoint list and a details panel. - Search by name; sort by name, distance or colour in either direction; group by list; show every dimension at once. Distances convert between Nether and Overworld coordinates. - The manager remembers its sorting, grouping and dimension view. - During the current server or world session, the manager also remembers scroll positions separately for each dimension and the all-dimensions view, restoring them when you switch views or reopen the screen. - Scrollbars in the waypoint list, details panel, client settings and theme variable list fade in on hover, stay visible while dragging and fade out after you leave. - Escape closes an open popup before the screen. Enter and Space press the focused button. - The current/remote scope control identifies which waypoints it shows and includes the current server name in its tooltip. Remote waypoints are read-only and show their server's availability. - In singleplayer, the manager keeps the world running; add, edit, client settings and theme screens pause it. ### Add and edit screens - A redesigned form with editable dimension and list comboboxes and suggestions for names, coordinates and facing. Initials follow the name until you type your own. - New fields for keywords, a description and an icon. Problems are marked on the field they belong to. ### Client settings and themes - A rebuilt settings screen: hover a row to see what it does and its default, ↺ resets one setting and **Reset to defaults…** resets them all. Mod Menu (Fabric) and the Mods screen (Forge and NeoForge) open it. - New setting: **Render waypoints under F1** (off by default). Waypoints are hidden on loading screens. - Colour themes: pick Classic (the default), Translucent Dark, Modern Dark, High Contrast or Light, with white glass surfaces and sky-blue accents, or edit the colours in game. The colour theme editor is a developer tool: it lists the theme's raw colour keys with their `#AARRGGBB` values, edits a key in an ARGB field, with the colour picker or with an Alpha slider, and shows an interactive preview of the mod's widgets that marks where the selected key is used. **Reset** undoes every change since you opened the editor, and **Save** is available only when something changed. - Themes can enable or disable text shadows, including in text fields and suggestions. GUI icons, matching-input feedback and On/Off toggles follow the selected theme's colours. Waypoint initials badges remain shadow-free for readability. - Tooltips in the mod's screens follow the colour theme. ### Action logging - Server consoles receive action logs with the player's name and UUID, the original command sender and UUID, and the outcome. Commands run through `/execute as` retain both identities through asynchronous completion. - Waypoint and list changes, restore, teleports, navigation, uploads, downloads, chat sharing and reload are logged. Save failures and partial uploads have distinct outcomes; browsing and routine synchronization do not produce action entries. ### Platforms - Minecraft 26.3 on Fabric, NeoForge and Paper. This branch's Forge builds cover versions through 26.2. - Folia support. - Waypoint sync, downloads and uploads use a new chunked network transport. `compressChunkedMessages` (default `true`) compresses its messages. - The Velocity plugin reports anonymous usage statistics to bStats, as the Paper plugin already does. - Release JARs include only the classes and resources their platform uses. Velocity packages the shared cross-server code and proxy services, reducing its size and removing backend code and translations. ### Translations - English and Simplified Chinese include all current server and client translation keys. Traditional Chinese, Hong Kong Chinese, Spanish and Hebrew fall back to English in the waypoint details panel, the manager's search, sort and grouping controls, and some navigation and networking messages. Help translate on [Crowdin](https://crowdin.com/project/server-waypoint). - Many 4.0.0 translations were generated by AI and may contain mistakes. Earlier community credits recognize past contributions; they do not imply review of these translations. Human review status is tracked in [the verification checklist](https://github.com/2676959/server_waypoint/blob/4.0.0/TRANSLATOR_CREDITS.md#human-verification-checklist-for-400). - Custom server translations use Java `MessageFormat` placeholders (`{0}`, `{1}`); literal apostrophes must be doubled (`''`). ### Fixes - In singleplayer, adding or editing waypoints could fail with "RenderSystem called from wrong thread", and some changes didn't refresh the markers, the waypoint manager or the map mods. - Players on Minecraft 1.21.2 and later receive interactive chat feedback instead of console-style output. - Movement keys work in waypoint screens on Forge and NeoForge while text entry is inactive. - Open colour pickers and combobox popups no longer leak hover to controls beneath them. - The waypoint details panel correctly handles its controls and lays out descriptions, including literal `\n` line breaks and formatted text. - Remote server status indicators keep their intended colours. Chat colour swatches have consistent sizes, and GUI icons use smoother filtering. - Paper destination preparation uses the configured `tp` and `remoteTp` levels for unset permissions, so allowing non-operators with level `0` works before transfer as well as on arrival. - NeoForge 1.21.7–1.21.8 registers client packet handling through the appropriate loader API, fixing startup failures. - VoxelMap icons load from the correct version-specific resources, preserve transparency and display decoded waypoint labels. Item waypoint icons on Minecraft 1.21 also preserve transparency. - Map-mod sync keeps waypoints in their correct dimensions and preserves personal map data. World Map actions retain the exact server waypoint identity and metadata. - Combobox selection on older Minecraft versions restores focus correctly. Saving a waypoint in singleplayer refreshes the waypoint manager and map integrations. - Suggestions and inline completions stay aligned when long input text scrolls horizontally. - On Minecraft 1.20.1, respawning preserves the player's language for server feedback and navigation. A failed chat broadcast to one player no longer prevents waypoint synchronization or delivery to other players. - A connection handshake with no waypoint updates no longer triggers an unnecessary full map-mod sync. - Hovered in-world waypoint icons render above overlapping markers so they remain visible. - Xaero dependency pins were aligned with the versions required by each map mod, including XaeroLib on Forge 1.20.1. - Language loading no longer closes a JAR filesystem owned by the mod loader. - Chat item icons resolve installed mod assets on supported Minecraft versions, so modded item sprites can appear alongside vanilla icons. - Text fields and comboboxes reset their horizontal view correctly when focus changes. Widget text alignment, waypoint initials contrast and disabled-icon visibility are more consistent. - The theme editor's preview supports its controls, popups, tooltips and confirmation dialogs interactively. ### Tools - `locations2waypoints.py` converts the waypoints of the MCDR plugins Locations and LocationMarker into Server Waypoint files. - Modrinth and CurseForge upload automation uses this changelog by default, while retaining explicit changelog overrides. Upload names identify the platform and Minecraft version range; Fabric uploads list Mod Menu as an optional integration. VoxelMap-Updated remains an optional Modrinth dependency only for targets with a supported build. - The README now provides installation and first-use instructions, with full command syntax and server setup in a separate reference. - A reusable live Minecraft verification runner supports disposable worlds, command checks and retained results.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

## 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

Minecraft 26.2

Minecraft 26.2

port to Minecraft 26.2

Add NeoForge support for 1.20.2-1.20.6 1.21.x 26.1.x

Add Forge support for 1.20.x 1.21.x 26.1.x

Fix some issues in rendering waypoints and waypoints manager screen

Support 26.1-26.1.2

Fix some bugs and improve stability

runs on paper 26.1.1 and 26.1.2

Support Minecraft 1.21.6-1.21.11 on Fabric

Fix some rendering issues and edit command doesn't check for used waypoint name.

- New client GUI for managing waypoints. - Customizable waypoints rendering. - Updates server-client handshake protocol. - Waypoints are synced list by list now, saving more data.

**compatible with Java 17**

fixed Network Protocol Error when joining server with Xaero's WorldMap installed on client.

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 running on LAN servers. Fix crashing when mod path contains special characters.

Supports using UTF-8 characters in waypoint list name, waypoint name and initials. When including charaters like Chinese, Japanese, Korean characters, emoji, etc, it should be quoted like this "😊".

update to Minecraft 1.21.10

update to Minecraft 1.21.9

supports Paper and its forks for 1.21.x

New features: - Now able to send world id packets to Xaero's minimap mod, no longer requires installing Xaeros's minimap mod on server to make client identifying the server. Enable by setting `"sendXaerosWorldId": true` in config.json. - Built-in English and Simplified Chinese translations, switch based on client's language setting. - Allow importing translations from this mod's or plugin's config directory `server_waypont/lang`. - New command `/wp reload`: reload command permissions and translation files. - New command `/wp tp`: teleport the executor to a waypoint

- NeoForge 1.21.5-1.21.8

- Fabric 1.21.5-1.21.8

- Fabric 1.21.3-1.21.4

- Add support for LuckPerms. The permission level set by `config.json` file is used as default value when LuckPerms is loaded. - Fabric 1.21-1.21.1

update Minecraft version 1.21.8

1.21.5-1.21.7

1.21.3.-1.21.4

1.21-1.21.1 Support adding waypoint conveniently from Xaero's minimap waypoint chat sharing message without requiring client side installation.

Supports 1.21.5-1.21.7

Supports 1.21.3-1.21.4

Xaero's minimap is no longer a required dependency when this mod is installed on serverside.

Support 1.21.5-1.21.7

Users can set permissions for following commands - `/wp add` - `/wp edit` - `/wp remove` Config file stored in `<minecraft_root_directory>/config/server_waypoint/config.json`.

Add supports for Minecraft 1.21.3-1.21.4

Add supports for Minecraft 1.21-1.21.1

Now supports Minecraft 1.21.5 and 1.21.6

Add command suggestions for - waypoint name - waypoint list name - name initials - waypoint yaw

- Add `/wp remove` command to remove waypoint by name. - Add buttons for editing and removing waypoint on waypoint list. - Hover text of the waypoint in the overworld or the nether also shows the coordinate mapped to the other dimension.

- Add `/wp edit` to edit an existing waypoint. - Bugs fixed.

## New Features - Now able to sync waypoints from server automatically. - Click the waypoint listed to teleport.