🗺️ Waystones

Travel instantly across your worlds

A lightweight, 100% server-side teleportation plugin for Paper/Spigot and Purpur

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 (see gallery image #1)
• 🏷️ 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 (see gallery image #4)
• 🌐 Available in 30 languages — from the major European languages to Ukrainian, Georgian, Swahili, Japanese and Korean, changeable anytime via an admin command (see full list below)
• ⚡ 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
• 🖼️ Customizable icons — pick the block/item shown for each waystone and each menu category (see gallery image #6)
• 🔄 Periodic update checks — the menu icon glows and tells you whether you're up to date or a new version is out (see gallery image #2)
• 💬 Discord shortcut — a lectern icon in the main menu sends players a clickable link to the official support Discord (see gallery image #3)
• 💾 Reliable storage — persistent YAML storage, no data loss on restart
• 🌌 Custom dimensions — link categories to worlds created by other plugins, see the dedicated section below (see gallery image #5)
• 🗺️ Optional web map support — every waystone can appear on Dynmap, BlueMap, and/or Squaremap, each on its own dedicated layer, no setup required if you don't use any of them
• 🐴 Bring your companions along — tamed animals, leashed pets, and your current mount teleport with you automatically
• 🛡️ Combat safety — teleporting is blocked for a configurable delay after taking damage
• 🧩 ItemsAdder / Oraxen icons — use a custom item as a waystone or category icon, in addition to vanilla materials

📖 How it works

1. An admin goes to the desired spot and types /waystone create <name> → the point is created instantly
2. A player types /waystone → the world selection menu opens
3. They pick a world → the list of points in that dimension is displayed
4. Clicking a point → immediate, free teleportation No complex configuration, no block to craft: everything happens through commands and the menu.

🖼️ Choosing a custom icon

Add @<material> at the end of the name when creating, or use /waystone seticon afterward:

/waystone create Village Spawn @DIAMOND_BLOCK
/waystone seticon Village Spawn @NETHER_BRICK
/waystone seticon Village Spawn @reset

The material must be an exact Bukkit API name (e.g. DIAMOND_BLOCK, NETHER_BRICK, EMERALD_ORE). An invalid material is rejected without changing anything.

If you use ItemsAdder or Oraxen, seticon/setcategoryicon also accept a custom item instead of a vanilla material:

/waystone seticon Village Spawn itemsadder:mynamespace:custom_totem
/waystone setcategoryicon nether oraxen:custom_portal_icon

Falls back to the default icon if the corresponding plugin isn't installed or the item no longer exists — never breaks the menu.

📝 Adding a description

/waystone setdescription Village Spawn &7The starting point &e|&7Watch out for zombies at night
/waystone setcategorydescription nether &cDangerous zone

The | character separates lines, and & color codes work just like everywhere else in the plugin. reset (or no text) removes the description.

🧭 Commands

Player commands — available to everyone with waystones.use

Once inside a category, navigation is simple: a back button returns you to the world menu (gallery image #7), and a close button lets you exit instantly (gallery image #8).

Admin commands — require waystones.admin

🔑 Permissions

⚙️ Configuration

The config.yml file lets you customize:

• language — plugin language (30 languages available, see dedicated section below), changeable in-game via /waystone setlang
• teleport-cooldown-seconds — anti-spam delay between two teleports
• effects-enabled — enable/disable sound and particle effects
• update-checker-enabled — enable/disable update checking
• update-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 setcategoryname command.

🌐 Supported languages

30 languages, laid out two per row to keep this compact.

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 <code>.

📋 Compatibility

✅ Complete compatibility roadmap — Waystones covers every officially supported Minecraft version, from 1.12.2 up to the current version. New features (v6.0 through v7.8, breakdown below) are available on the 26.2.x line; earlier versions intentionally remain on the v5.2 feature set, with no backport planned. The exact jar for each line is listed in the Installation section below.

🧩 Which feature is in which version?

Every version listed below only applies to the 26.2.x jar (the only one receiving new features). The other 11 jars (1.12.x → 26.1.x) all stay on the v5.2 feature set, which already includes: per-world menu, free teleportation, configurable cooldown, custom names, YAML storage, a basic update checker, and 4 languages (fr/en/pt-br/fr-ca).

In short: if you're on the 26.2.x line, you get everything listed above (v7.8 includes everything before it). If you're on an earlier line (1.12.x → 26.1.x), you're limited to the v5.2 baseline.

🏷️ Understanding version numbers

Every plugin file follows a simple format: <Waystone(s)>-<plugin version>-<Minecraft version>.jar, with an optional Alpha/Beta/Release prefix marking its stability status. For example, Waystones-Release-7.8-26.2.x.jar means: plugin version 7.8, Release (stable) status, 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.x/v7.x features yet.

ℹ️ A one-time naming correction (v7.8): the 26.2.x jar is now named Waystones-... (with an "s"), matching the plugin's actual name everywhere else. Every other line (1.12.x through 26.1.x) remains frozen at v5.2 and keeps its original Waystone-... (no "s") filename, since those lines are no longer rebuilt. Both are the same plugin — only the filename convention differs depending on when that particular jar was last built.

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.

🌌 Custom dimensions — "The Emergence of Custom Dimensions"

Link Waystones categories to dimensions created by third-party plugins (DimensionControl, Multiverse-Core, or anything that adds a world) — declared explicitly by the admin, never guessed automatically.

/waystone createcategory royaume myrealm_world
/waystone create Entrance to the Realm #royaume

• A category only appears in the menu once it actually contains a waystone
• The server's own primary Overworld/Nether/End can never be hijacked into a custom category
• Custom categories glow subtly in the menu (togglable via /waystone setglint), and never lose their data if the linked world later disappears — they just turn grey and become admin-only until it's back (see gallery image #5 for the glow effect) See the full command list below for createcategory, removecategory, setcategory, and setglint.

🗺️ Web map support (Dynmap, BlueMap, Squaremap)

If Dynmap, BlueMap, and/or Squaremap are installed and enabled on your server, Waystones automatically adds a dedicated "Waystones" layer to each — no configuration needed. You can run several of them side by side; each integration is fully independent.

• Each waystone shows up as a marker, colored the same way as in-game (green for the Overworld, red for the Nether, purple for the End)
• Clicking a marker shows the waystone's name and description (if one is set)
• Markers stay in sync instantly whenever a waystone is created, removed, or renamed
• Don't use any of them? This does nothing at all — no error, no extra setup, nothing to disable Want to keep one specific waystone off the map (a secret base, for example) without removing it or hiding it from the in-game menu? Use /waystone setmapvisible <name> disabled. Every waystone is visible on the map by default; toggle it back with enabled.

Set dynmap-enabled: false, bluemap-enabled: false, and/or squaremap-enabled: false in config.yml to turn off any of the three integrations individually, even with the corresponding plugin installed.

🐴 Companions follow you

Tamed animals, leashed pets, and your current mount teleport with you automatically — no more leaving your wolves behind.

• Your current mount (horse, donkey, mule, strider, camel...) is teleported first, then you're placed back on it
• Tamed animals and leashed pets within pet-teleport-radius blocks of you (6 by default) come along too, landing near your destination
• Set pet-teleport-radius: 0 in config.yml to disable this entirely

🛡️ Combat safety

Players who took damage recently can't teleport — no escaping a fight through a waystone.

• Blocked for combat-protection-seconds after the last hit taken (10 seconds by default), on both the menu and /waystone tp
• A message shows how many seconds remain
• Server admins (waystones.admin) are never affected, same as the normal cooldown
• Set combat-protection-seconds: 0 in config.yml to disable this entirely

📊 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.

Alongside bStats, Waystones also uses FastStats for anonymous error tracking, helping catch bugs before they turn into support tickets. Like bStats, it's opt-out server-side via plugins/faststats/config.properties (enabled=false).

🚀 Installation

1. Download the jar matching your Minecraft version:
   • Waystone-5.2-1.12.x.jar for 1.12.2
   • Waystone-5.2-1.13.x.jar for the 1.13.x line
   • Waystone-5.2-1.14.x.jar for the 1.14.x line
   • Waystone-5.2-1.15.x.jar for the 1.15.x line
   • Waystone-5.2-1.16.x.jar for the 1.16.x line
   • Waystone-5.2-1.17.x.jar for the 1.17.x line
   • Waystone-5.2-1.18.x.jar for the 1.18.x line
   • Waystone-5.2-1.19.x.jar for the 1.19.x line
   • Waystone-5.2-1.20.x.jar for the 1.20.x line
   • Waystone-5.2-1.21.x.jar for the 1.21.x line
   • Waystone-5.2-26.1.x.jar for the 26.1.x line
   • Waystones-Release-7.8-26.2.x.jar for 26.2.x (current version, latest features — including companion teleportation, combat safety, and BlueMap/Squaremap support)
2. Drop it into your server's plugins/ folder
3. Restart the server
4. Grant the waystones.admin permission 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.