# Server Waypoint [![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://opensource.org/licenses/MIT) ![Modrinth Version](https://img.shields.io/modrinth/v/server_waypoint?style=flat-square&label=Version) ![both](https://img.shields.io/badge/Environment-Server%26Client-4caf50?style=flat-square) [![Modrinth Downloads](https://img.shields.io/modrinth/dt/server_waypoint?style=flat-square&logo=modrinth&logoColor=%2300AF5C&label=Modrinth%20Downloads&color=%2300AF5C)](https://modrinth.com/plugin/server_waypoint) [![CurseForge Downloads](https://img.shields.io/curseforge/dt/1416929?style=flat-square&logo=curseforge&logoColor=%23F16436&label=CurseForge%20Downloads&color=%23F16436)](https://www.curseforge.com/minecraft/mc-mods/server-waypoint) ![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/2676959/server_waypoint/total?style=flat-square&logo=github&logoColor=%23181717&label=GitHub%20Downloads&color=%23181717) ![Static Badge](https://img.shields.io/badge/1.20.x-5395FD?style=flat-square) ![Static Badge](https://img.shields.io/badge/1.21--1.21.10-5395FD?style=flat-square) [![fabric](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/supported/fabric_vector.svg)](https://modrinth.com/plugin/server_waypoint/versions?l=fabric) [![paper](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/supported/paper_vector.svg)](https://modrinth.com/plugin/server_waypoint/versions?l=paper) Manage waypoints and sync them to other player's client automatically. Compatible with Xaero's minimap. ## Features - Syncing waypoints from server automatically. - Interactive waypoint list TUI allowing player click to teleport to a waypoint or edit it. - Commands auto-completion. - Custom permission for `/wp ` commands. Compatible with [LuckPerms](https://modrinth.com/plugin/luckperms). - Support adding waypoint conveniently from Xaero's minimap waypoint chat sharing message without requiring client side installation. ## Dependencies Required: - [Fabric API](https://modrinth.com/mod/fabric-api) Optional: - [LuckPerms](https://modrinth.com/plugin/luckperms) - [Xaero's Minimap](https://modrinth.com/mod/xaeros-minimap) Not required for serverside installation. ## Commands - `/wp add` add a new waypoint. Cannot add waypoint with duplicate name. Prompts user to use `/wp edit` to replace the existing one. - `/wp add ` add a waypoint list. - `/wp download` download waypoints and add to Xaero's Minimap (will not work without client installation). - `/wp edit` edit a waypoint. - `/wp list` list all waypoints. Shows all waypoints in a tree hierarchy. Allowing user to click to teleport, edit and remove the waypoint. - `/wp reload` reload `config.json` and translation files in `\config\server_waypoint\lang`, feature `sendXaerosWorldId` requires restarting to take effect. - `/wp remove` remove a waypoint by name. Shows the removed waypoint and click it to restore that waypoint. - `/wp remove ` remove an empty waypoint list. - `/wp tp` teleport the executor player to a waypoint ## Translation This mod currently has built-in translations for English and Simplified Chinese. Command feedbacks will be automatically translated based on the language setting on the sender's client if the corresponding lang file is loaded. - ### Add translations Place the lang files under the directory: `\config\server_waypoint\lang\`. This mod will load them on server starting, use `/wp reload` if the server is already running. - ### Create a lang file Follow the format used in [`en_us.json`](./common/src/main/resources/lang/en_us.json), [`zh_cn.json`](./common/src/main/resources/lang/zh_cn.json). Name the lang file with a [valid language code](https://minecraft.wiki/w/Language#Languages). ## Waypoints - #### Save Path For a dedicated server: `\config\server_waypoint\waypoints\` For a single player world: `\saves\\server_waypoint\waypoints\` - #### File Format All waypoints are saved in json files. Each json file contains all waypoints in one dimension and the filename is the converted full registry name of that dimension. For example, all waypoints in the overworld is stored in `minecraft$overworld.json`. ## Configurations The configuration file is stored at `\config\server_waypoint\config.json`. Some changes made in `config.json` may take effects after server restarts. - ### Command Permission Changes the vanilla [permission level](https://minecraft.wiki/w/Permission_level) required to execute the command. This will be overridden by the permission set by [LuckPerms](https://modrinth.com/plugin/luckperms). Default value: ```json5 { "CommandPermission": { // /wp add "add": 0, // /wp edit "edit": 0, // /wp remove "remove": 0, // /wp tp "tp": 2, // /wp reload "reload": 2 } } ``` - ### Features - #### addWaypointFromChatSharing Default value: `true` Prompts the user to add the waypoint they shared in chat. Requires `/wp add` permission. Example: ```json5 { "Features": { "addWaypointFromChatSharing": true } } ``` - #### sendXaerosWorldId Default value: `true` Send world id to client to help Xaero's map mod recognize the server. **This should be set to `false` if `xaero-map-protocol` on the [Leaves](https://leavesmc.org/) server or some similar features provided by other plugin or mod is enabled.** Example: ```json5 { "Features": { "sendXaerosWorldId": true } } ```

2676959

2676959's Plugins

ServerWaypoint by 2676959

2676959's Organizations

Stars

Watching

ServerWaypoint by