Compatibility
Minecraft: Java Edition
Platforms
Links
Tags
Creators
Details
๐บ๏ธ Waystones
Travel instantly across your worlds
A lightweight, 100% server-side teleportation plugin for Paper/Spigot
Create named teleportation points anywhere on your server โ Overworld, Nether, End โ and let your players travel with a single click through a clear, intuitive menu. No client mod, no resource pack required.
Inspired by the well-known Waystones mod in the Minecraft community, this plugin reuses its core idea โ named, reusable teleportation points โ but as a server-side plugin only. Nothing to install on the client, no resource pack to distribute: everything runs directly on the server, through a simple in-game menu. A lightweight alternative for Paper/Spigot servers that can't or don't want to use client-side mods.
โจ Features
- ๐บ๏ธ Menu sorted by world โ points are automatically grouped by dimension: Overworld, Nether, End
- ๐ท๏ธ Renamable categories โ customize the menu category names (e.g. "Nether" โ "Underworld") to fit your server's theme
- ๐จ Colored icons โ green, red, or purple glass depending on the point's world of origin
- ๐ Available in 4 languages โ French, English, Brazilian Portuguese, Quรฉbec French, changeable anytime via an admin command
- โก Free, instant teleportation โ with a configurable anti-spam cooldown
- ๐ Admin-only management โ only OPs can create, rename, or remove a point
- ๐ท๏ธ Custom names โ every point can be named and renamed at any time
- ๐ Periodic update checks โ the menu icon tells you whether you're up to date or a new version is out
- ๐พ Reliable storage โ persistent YAML storage, no data loss on restart
๐ How it works
- An admin goes to the desired spot and types
/waystone create <name>โ the point is created instantly - A player types
/waystoneโ the world selection menu opens - They pick a world โ the list of points in that dimension is displayed
- Clicking a point โ immediate, free teleportation No complex configuration, no block to craft: everything happens through commands and the menu.
๐งญ Commands
| Command | Description | Permission |
|---|---|---|
/waystone |
Opens the teleportation menu | waystones.use |
/waystone create <name> |
Creates a point at the player's position | waystones.admin |
/waystone remove <name> |
Removes a point | waystones.admin |
/waystone rename <old> <new> |
Renames a point | waystones.admin |
/waystone list |
Lists all existing points | waystones.use |
/waystone tp <name> |
Direct teleportation via command | waystones.use |
/waystone setlang <fr|en|pt-br|fr-ca> |
Changes the plugin's language | waystones.admin |
/waystone setcategoryname <overworld|nether|end> <name|reset> |
Renames a menu category | waystones.admin |
/waystone reload |
Reloads the configuration | waystones.admin |
๐ Permissions
| Permission | Effect | Default |
|---|---|---|
waystones.use |
Use the menu and teleport | All players |
waystones.admin |
Create / rename / remove, reload config | OP only |
โ๏ธ Configuration
The config.yml file lets you customize:
languageโ plugin language (fr,en,pt-br, orfr-ca), changeable in-game via/waystone setlangteleport-cooldown-secondsโ anti-spam delay between two teleportseffects-enabledโ enable/disable sound and particle effectsupdate-checker-enabledโ enable/disable update checkingupdate-check-interval-hoursโ interval between automatic checks (12h by default) Player-facing text is not editable: it's built into the plugin, in all 4 supported languages, to guarantee reliable and consistent behavior. Category names, however, are customizable via the/waystone setcategorynamecommand.
๐ Supported languages
| Language | Code |
|---|---|
| ๐ซ๐ท French | fr |
| ๐ฌ๐ง๐บ๐ธ English | en |
| ๐ง๐ท Portuguese (Brazil) | pt-br |
| ๐จ๐ฆ French (Quรฉbec) | fr-ca |
The language is set globally by the server admin (no automatic per-player detection), with an automatic fallback to English if a text is missing. It can be changed at any time, without a restart, via /waystone setlang <fr|en|pt-br|fr-ca>.
๐ Compatibility
| Plugin version | Compatible Minecraft version(s) | Paper/Spigot API |
|---|---|---|
| v1.0 โ v5.2 | 1.12.2 | 1.12 |
| v5.2 | 1.13.x (1.13, 1.13.1, 1.13.2) | 1.13 |
| v5.2 | 1.14.x (1.14 โ 1.14.4) | 1.14 |
| v5.2 | 1.15.x (1.15 โ 1.15.2) | 1.15 |
| v5.2 | 1.16.x (1.16 โ 1.16.5) | 1.16 |
| v5.2 | 1.17.x (1.17 โ 1.17.1) | 1.17 |
| v5.2 | 1.18.x (1.18 โ 1.18.2) | 1.18 |
| v5.2 | 1.19.x (1.19 โ 1.19.4) | 1.19 |
| v5.2 | 1.20.x (1.20 โ 1.20.6) | 1.20 |
| v5.2 | 1.21.x (1.21 โ 1.21.11) | 1.21 |
| v5.2 | 26.1.x (26.1 โ 26.1.2) | 26.1 |
| v6.0 | 26.2.x (current version) | 26.2 |
โ Complete compatibility roadmap โ Waystones covers every officially supported Minecraft version, from 1.12.2 up to the current version. New features (v6.0: renamable categories, periodic update checker) are available on the 26.2.x line; earlier versions intentionally remain on the v5.2 feature set, with no backport planned.
๐ท๏ธ Understanding version numbers
Every plugin file follows a simple format: Waystone-<plugin version>-<Minecraft version>.jar. For example, Waystone-6.0-26.2.x.jar means: plugin version 6.0, compatible with the current Minecraft 26.2.x version. The same plugin is also available as Waystone-5.2-1.12.x.jar for the 1.12.x line โ different version numbers, since 1.12.x hasn't received the v6.0 features yet.
Two important things to know:
- The plugin version and the Minecraft version evolve independently. Porting Waystones to a new Minecraft version without any feature change doesn't change the plugin's version number โ only the Minecraft suffix changes.
- The plugin version number follows a major.minor logic (e.g. 5.0 โ 5.1):
- A minor change (5.0 โ 5.1) is a small adjustment or addition to an existing feature.
- A major change (5.1 โ 6.0) is a significant new feature or a major rework of the plugin.
๐ Statistics
Waystones uses bStats to collect anonymous usage statistics (server count, versions, language used...). No personal data is collected. Publicly viewable, and can be disabled at any time server-side via plugins/bStats/config.yml.
๐ Installation
- Download the jar matching your Minecraft version:
Waystone-5.2-1.12.x.jarfor 1.12.2Waystone-5.2-1.13.x.jarfor the 1.13.x lineWaystone-5.2-1.14.x.jarfor the 1.14.x lineWaystone-5.2-1.15.x.jarfor the 1.15.x lineWaystone-5.2-1.16.x.jarfor the 1.16.x lineWaystone-5.2-1.17.x.jarfor the 1.17.x lineWaystone-5.2-1.18.x.jarfor the 1.18.x lineWaystone-5.2-1.19.x.jarfor the 1.19.x lineWaystone-5.2-1.20.x.jarfor the 1.20.x lineWaystone-5.2-1.21.x.jarfor the 1.21.x lineWaystone-5.2-26.1.x.jarfor the 26.1.x lineWaystone-6.0-26.2.x.jarfor 26.2.x (current version, latest features)
- Drop it into your server's
plugins/folder - Restart the server
- Grant the
waystones.adminpermission to your team to start placing points
๐ Found a bug or have a suggestion? Leave a comment or open a support ticket โ all feedback is welcome.


