Waystones

Minecraft 版本： 26.2

平台： paper purpur spigot

标签： game-mechanics transportation utility

?️ 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)

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

? 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.3, 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.3 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-<plugin version>-<Minecraft version>.jar, with an optional Alpha/Beta/Release prefix marking its stability status. For example, Waystone-Release-7.3-26.2.x.jar means: plugin version 7.3, 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.

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.

? 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
   • Waystone-Release-7.3-26.2.x.jar for 26.2.x (current version, latest features — including stable custom dimensions 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.