Waystones

Version 7.7 — Internal refactor + update checker fix

Another round of cleanup after the v7.6 bundle, plus a small but real bug fix in the update notification.

What changed under the hood

- The Dynmap/BlueMap/Squaremap integrations shared a lot of near-identical code (color code cleanup, popup text building, event wiring) — now factored into a single shared base class, so each integration only contains what's actually specific to its map - Three nearly-identical startup blocks (one per map integration) consolidated into one small, reusable check

Bug fix: false "update available" notice

- The update checker used to compare version strings by simple equality — any difference, including comparing against an older published version, would incorrectly trigger "a new version is available" - It now compares version numbers properly, and only flags an update when the published version is genuinely newer

What didn't change

- Every command, permission, message, and behavior works exactly as before — this release touches internals only - No config.yml or waystones.yml format changes, no migration needed, safe to update directly

Naming

- Minor version bump (7.6 → 7.7) — internal cleanup and a bug fix, no new feature - Generated jar: `Waystone-Release-7.7-26.2.x.jar` - Still 26.2.x only, like every v6.x/v7.x release

Version 7.6 — Companions, combat safety, more maps, custom icons

The biggest release since custom dimensions: four independent additions bundled together, none of which touch how teleportation itself works.

Bring your companions along

- Tamed animals and leashed pets within a configurable radius now teleport with you, not just your character - Your current mount (horse, donkey, strider...) is teleported first and you're placed back on it automatically - New pet-teleport-radius setting in config.yml (default: 6 blocks, set to 0 to disable)

Combat safety

- Players who took damage recently can no longer teleport (menu or /waystone tp) until a configurable delay has passed — no more escaping a fight through a waystone - New combat-protection-seconds setting in config.yml (default: 10 seconds, set to 0 to disable) - Server admins (waystones.admin) are never affected, same as the existing cooldown

BlueMap and Squaremap support

- Following v7.5's Dynmap integration, waystones can now also appear on BlueMap and Squaremap, independently of each other and of Dynmap - Same behavior as Dynmap: a dedicated "Waystones" layer, colored by dimension, zero setup if you don't use these maps - New bluemap-enabled and squaremap-enabled settings in config.yml, alongside the existing dynmap-enabled

ItemsAdder / Oraxen icons

- /waystone seticon and /waystone setcategoryicon now accept custom items from ItemsAdder (itemsadder:namespace:id) and Oraxen (oraxen:item_id), in addition to vanilla materials - Falls back cleanly to the default icon if the plugin isn't installed or the item no longer exists

Naming

- Major version bump (7.5 → 7.6) — four independent additions bundled into one release, comparable in scope to v7.0 - Generated jar: `Waystone-Release-7.6-26.2.x.jar` - Still 26.2.x only, like every v6.x/v7.x release

Version 7.5 — Dynmap support

A long-standing gap among Waystones-style plugins closes: your teleportation points can now show up right on your web map.

Optional Dynmap integration

- If [Dynmap](https://www.spigotmc.org/resources/dynmap%C2%AE.274/) is installed and enabled on your server, every waystone now gets a marker on a dedicated "Waystones" layer on the web map — toggleable by players like any other Dynmap layer - Marker color follows the same logic already used in-game: green for the Overworld, red for the Nether, purple for the End - Clicking a marker shows the waystone's name and its description, if it has one (the same description set via /waystone setdescription) - Zero setup required: if Dynmap isn't installed, this integration does nothing at all — no error, no extra config, the plugin behaves exactly as before - New dynmap-enabled: true setting in config.yml, in case you'd rather keep Dynmap installed for other plugins without exposing waystones on it

New command: per-waystone map visibility

- `/waystone setmapvisible <name> <enabled|disabled>` — hide a specific waystone from the map without removing it or touching its visibility in the in-game menu (handy for a secret base you don't want shown publicly) - Every waystone is visible on the map by default, matching how every other visibility setting in the plugin defaults to "on"

How it stays in sync

- Markers update instantly on creation, removal, and renaming — no delay, no periodic refresh task running in the background - The map is fully populated once at plugin startup from existing waystones, then kept in sync purely through these events from that point on

Naming

- Minor version bump (7.4 → 7.5) — a self-contained addition, doesn't touch teleportation, permissions, or existing commands - Generated jar: `Waystone-Release-7.5-26.2.x.jar` - Still 26.2.x only, like every v6.x/v7.x release

Version 7.4 — Internal refactor, no functional changes

Not every release adds a feature — this one is about paying down some technical debt behind the scenes, so future updates ship faster and more safely.

What changed under the hood

- Config-writing logic (used by the language setting, category names/icons/descriptions, command toggles, and the glint setting) was duplicated across 4 different places in the code — now centralized into a single shared utility - Permission and argument checks, repeated across all 17 /waystone subcommands, now go through small shared helpers instead of being copy-pasted in every handler - Waystone lookups by name and by block location now use direct index lookups instead of scanning every waystone on the server — no visible difference at today's scale, but scales better as server waystone counts grow - The teleport cooldown tracker now clears a player's entry when they disconnect, instead of holding onto it indefinitely

What didn't change

- Every command, permission, message, and behavior works exactly as before — this release touches internals only - No config.yml or waystones.yml format changes, no migration needed, safe to update directly

Naming

- Minor version bump (7.3 → 7.4) — internal cleanup, no new feature - Generated jar: `Waystone-Release-7.4-26.2.x.jar` - Still 26.2.x only, like every v6.x/v7.x release

Version 7.3 — Custom dimensions goes stable, FastStats added

After weeks in Alpha and real-world testing with positive community feedback, custom dimensions support graduates to a stable Release. Plus a new analytics partner joins the mix.

Custom dimensions: Alpha → Release

- The in-chat warning shown to players on join is gone — custom dimensions have proven stable through actual use - No functional changes to createcategory, removecategory, setcategory, or setglint — same commands, same safety guarantees (the server's primary Overworld/Nether/End can still never be hijacked, categories still only appear once they contain a waystone, orphaned categories are still handled gracefully) - This is a trust milestone, not a feature change: the underlying system has been solid since v7.0, this release just reflects that it's been proven out

FastStats added alongside bStats

- [FastStats](https://faststats.dev/project/waystones/minecraft-plugin) now runs in parallel with bStats for anonymous error tracking — catching bugs before they turn into support tickets - Like bStats, it's fully opt-out server-side (plugins/faststats/config.properties, enabled=false) - No personal data collected; the first server start after updating is silent (writes the config file and waits for a restart before sending anything, giving admins time to opt out if they choose)

Naming

- Same version number, prefix changed from Alpha to Release (7.3 → 7.3) - Generated jar: `Waystone-Release-7.3-26.2.x.jar` - Still 26.2.x only, like every v6.x/v7.x release

Version 7.2-Alpha — Translation completeness fix

A community bug report led to a real find — worth documenting honestly rather than glossing over.

What was found and fixed

While preparing in-game screenshots for the Modrinth gallery, it turned out that 12 out of 30 languages (Bulgarian, Czech, Hungarian, Japanese, Georgian, Korean, Lithuanian, Polish, Romanian, Slovak, Serbian Latin, Swahili) were each missing 48 translation keys that every other language already had — covering menu lore lines (teleport counts, click prompts, waystone details), navigation buttons, and command usage/help messages. Anyone running the plugin in one of these 12 languages would have seen a mix of their language and stray untranslated text in those specific spots.

What changed

- All 48 missing keys translated and added to the 12 affected languages - Automated cross-check confirming all 30 language files now share the exact same 109 keys, with zero gaps between what the code calls and what the language files provide

Naming

- Minor version bump (7.1 → 7.2) - Generated jar: `Waystone-Alpha-7.2-26.2.x.jar` - Still Alpha, same reasoning as the rest of v7.x

Version 7.1-Alpha — bStats visibility

More insight into how Waystones is actually used, and why that data matters — both delivered together.

What changed

14 new anonymous bStats charts, each reporting an aggregate state (yes/no, enabled/disabled, or a count bucket) — the same privacy-safe approach already used for the existing language chart: - Whether custom dimensions (v7) are in use - Whether category names, icons, or descriptions have been customized - Whether waystone icons or descriptions have been customized - Whether the list and tp commands are enabled - Whether the custom dimension glow effect is enabled - Whether the teleport cooldown and teleport effects are enabled - Whether the update checker is enabled - How many waystones exist (bucketed: 0, 1-5, 6-20, 21-50, 50+) - How many custom dimension categories exist (bucketed: 0, 1-3, 4-10, 10+) Alongside these charts, admins now see a one-time message explaining why anonymous bStats statistics matter to the project — shown to the first admin who joins after the plugin has just been updated, and never repeated until the next real update. The plugin tracks its own version across restarts (a small last-seen-version.txt file) to tell a genuine update apart from a simple server restart.

Naming

- Minor version bump (7.0 → 7.1) - Generated jar: `Waystone-Alpha-7.1-26.2.x.jar` - Still Alpha, following the same line-wide status as the rest of v7.x until custom dimensions graduate to Release

Version 7.0-Alpha — "The Emergence of Custom Dimensions"

After weeks of research, planning, and a few honest detours, the plugin's most requested and most carefully-designed feature is finally here — in Alpha, and worth reading the fine print before diving in.

The big idea

Server admins can now link Waystones categories to dimensions created by third-party plugins (DimensionControl, Multiverse-Core, or anything else that adds a world) — no automatic guessing, no scanning, no fragile detection. The admin declares the link explicitly, and Waystones takes it from there.

New commands (all admin-only)

- `/waystone createcategory <key> <world>` — links a new category to an existing, loaded world. Refuses if the world doesn't exist, is already linked, or is the server's own primary Overworld/Nether/End (protects the built-in categories from being hijacked) - `/waystone removecategory <key>` — removes a category, blocked if waystones still exist inside it (never deletes data silently) - `/waystone create <name> [@material] [#category]` — the new #category suffix is a safety check, not a free choice: it confirms the category matches the world you're actually standing in - `/waystone setcategory <name> <key|reset>` — verifies/confirms a waystone's category against its real world - `/waystone setglint <enabled|disabled>` — toggles the subtle glow shown on custom dimension icons

How it looks in the menu

- Row 3 stays empty as a visual buffer between the fixed categories and the custom ones - Custom dimension categories start on row 4, centered using the exact same pattern as Overworld/Nether/End (1, 2, or 3 per row) - A category only appears once it actually contains a waystone — same rule as the fixed categories - Valid custom categories get a subtle glow (Paper's official enchantment_glint_override, not the old fake-enchantment trick), which persists even with a custom icon - If a custom dimension's world gets unloaded or deleted later, its category doesn't vanish or break — it turns grey and shows "world unavailable," visible to admins only, with the underlying data always kept safe

This is an Alpha, read this part

Every player sees a red warning in chat on join for as long as this stays in Alpha: custom dimension support is new, experimental, and may contain bugs. Back up your world before relying on it. This warning (and this whole notice) will disappear once the feature graduates to a stable Release.

Naming

- Major version bump (6.7 → 7.0) — first substantial new capability since the compatibility roadmap wrapped up, and the first ever Alpha-prefixed release for this plugin - Generated jar: `Waystone-Alpha-7.0-26.2.x.jar` - Like every v6.x/v7.x release, this only concerns the 26.2.x line

Version 6.7 — Glowing update icon

A small addition born straight out of planning the next major feature — sometimes exploring what's next surfaces quick wins for today.

What changed

- The info icon (redstone block) in the main menu now glows whenever a plugin update is available, on top of the existing red lore line - Uses the same official enchantment_glint_override API (Paper's modern data-component approach) explored while designing an upcoming feature — not the old fake-enchantment-plus-hidden-flag trick, which had known glint-disappearing bugs - No new setting: the glow simply follows the existing update-available state, always on when relevant, always off otherwise

Naming

- Minor version bump (6.6 → 6.7) — tiny, self-contained addition - Generated jar: `Waystone-6.7-26.2.x.jar` - Like v6.0 through v6.6, this version only concerns the 26.2.x line

Version 6.6 — Discord icon

A quick way for players to find the support Discord, right from the main menu.

New feature

- A new Lectern icon appears in the top-right corner of the main menu, next to the info icon - Clicking it closes the menu and sends a clickable link in chat to join the official Waystones Discord server - The icon's lore invites players to add their Minecraft server's name to their Discord nickname, making it easier for the community to know where everyone comes from

Reliability

- The Discord invite link is a hardcoded constant in the plugin code, the same way the Modrinth project ID and bStats ID already are — not a config.yml setting. This is intentional: it's the plugin's official support channel, not something a server admin should be able to silently redirect by editing a text file - 3 new keys added across all 30 languages, automated cross-check confirming 44 identical keys in every file

Naming

- Minor version bump (6.5 → 6.6) — small standalone addition - Generated jar: `Waystone-6.6-26.2.x.jar` - Like v6.0 through v6.5, this version only concerns the 26.2.x line

Version 6.5 — Togglable list & tp commands

Server admins can now enable or disable the list and tp commands to fit how they want their server run.

New command

- `/waystone setcommand <list|tp> <enabled|disabled>` — toggles either command on or off - Also accepts true/false and on/off as synonyms for the state

How it works

- A disabled command shows a clear "this command is disabled" message instead of running - Disabled commands also disappear from the in-game help (/waystone with no arguments) and from tab-completion, so players don't stumble onto a command that won't work - The main menu (/waystone) keeps working normally regardless of these two settings — this only affects the standalone list and tp commands - Setting stored in config.yml (command-list-enabled, command-tp-enabled) via the same targeted-write approach used for every other customization, so comments are never lost

Reliability

- 5 new keys added across all 30 languages, automated cross-check confirming 41 identical keys in every file

Naming

- Minor version bump (6.4 → 6.5) — new configuration option, same pattern as previous minor releases - Generated jar: `Waystone-6.5-26.2.x.jar` - Like v6.0 through v6.4, this version only concerns the 26.2.x line

Version 6.4 — 18 new languages

The plugin jumps from 12 to 30 supported languages in one go.

New languages

Western & Central Europe / Americas: Icelandic (is), Hungarian (hu), Romanian (ro), Czech (cs), Slovak (sk), Polish (pl) Eastern Europe, Caucasus, Africa & Asia: Ukrainian (uk), Belarusian (be), Estonian (et), Latvian (lv), Lithuanian (lt), Serbian Latin (sr-latn), Bulgarian (bg), Georgian (ka), Swahili (sw), Indonesian (id), Japanese (ja), Korean (ko)

Notable choices

- Serbian: the Latin script (sr-latn) was chosen over Cyrillic, since it's more common in everyday digital use, even though both have equal constitutional status in Serbia - Non-Latin scripts (Cyrillic for uk/be/bg, Georgian for ka, Japanese for ja, Korean for ko): no encoding or in-game rendering concerns — all six are officially supported by Minecraft's own font system - A few languages were considered and deliberately left out: "Australian" and "Canadian" English/French (already covered by en/fr/fr-ca), "Mexican" Spanish (already covered by es), Guarani and Quechua (not part of Minecraft's own officially supported language list, which was the bar set for this batch)

Reliability

- Automated cross-check confirming all 30 language files share the exact same 36 keys, none missing - The "invalid language" error message was shortened across all 12 previously-existing languages — spelling out 30 language codes inline had become unreadable, so it now simply points to the plugin's Modrinth page for the full list

Naming

- Minor version bump (6.3 → 6.4) — extending the existing language system, same pattern as v6.2 - Generated jar: `Waystone-6.4-26.2.x.jar` - Like v6.0/6.1/6.2/6.3, this version only concerns the 26.2.x line

Version 6.3 — Customizable descriptions

Add a small descriptive note to any waystone or menu category.

New commands

- `/waystone setdescription <name> <text|reset>` — describes an existing waystone - `/waystone setcategorydescription <overworld|nether|end> <text|reset>` — describes a menu category

How it works

- The | character separates lines (multi-line descriptions supported) - & color codes work just like everywhere else in the plugin - reset (or no text) removes the description - The description shows up in the icon's lore, after the existing info (world/coordinates/owner for a waystone, count for a category) - Smart name recognition: since waystone names can contain spaces, the command tries the longest possible name first against existing waystones, no quotes needed

Reliability

- Storage: new description field in waystones.yml, new category-description-* keys in config.yml, same targeted-write approach as the other customizations - All 12 languages kept in sync, automated cross-check confirming 36 identical keys in every file

Naming

- Minor version bump (6.2 → 6.3) — extending existing customization features - Generated jar: `Waystone-6.3-26.2.x.jar` - Like v6.0/6.1/6.2, this version only concerns the 26.2.x line

Version 6.2 — 8 new languages

The plugin goes from 4 to 12 supported languages.

New languages

- Spanish (es) - Portugal Portuguese (pt-pt, distinct from the already-existing Brazilian Portuguese) - Norwegian Bokmål (nb) - Swedish (sv) - Finnish (fi) - Italian (it) - Dutch (nl) - German (de) Each language file fully translates the plugin's 32 keys (in-game messages, menus, categories, icons, update checker), with an automated cross-check confirming no key is missing in any language.

Heads-up

These 8 translations were produced by AI (no native review like for French/English/Brazilian Portuguese/Québec French). The general meaning should be correct, but a review by a native speaker is recommended before heavy production use.

Naming

- Minor version bump (6.1 → 6.2) — extending the existing language system - Generated jar: `Waystone-6.2-26.2.x.jar` - Like v6.0/6.1, this version only concerns the 26.2.x line

Version 6.1 — Customizable icons

Pick the block shown for each waystone and each menu category yourself.

New commands

- `/waystone create <name> [@material]` — optional material right at creation - `/waystone seticon <name> @<material|reset>` — changes an existing waystone's icon - `/waystone setcategoryicon <overworld|nether|end> <material|reset>` — changes a menu category's icon

Reliability

- Strict validation: invalid material = command rejected, nothing changed - Safe automatic fallback to the default icon if a stored material becomes invalid (e.g. removed in a future Minecraft version) — never crashes - Storage: new custom-icon field in waystones.yml, new category-icon-* keys in config.yml, same targeted-write approach as category names

Naming

- Minor version bump (6.0 → 6.1) — extending an existing feature, not a substantial novelty - Generated jar: `Waystone-6.1-26.2.x.jar` - Like v6.0, this version only concerns the 26.2.x line

Version 6.0 — Customizable categories & improved update tracking

Two significant new features, built after wrapping up the compatibility roadmap: the project keeps improving on substance, not just on compatibility.

Menu category renaming

- New command `/waystone setcategoryname <overworld|nether|end> <name|reset>` (admin) - Customize the display of the 3 main menu categories to fit your server's theme (e.g. "Nether" → "Underworld") - reset (or no name provided) restores the category to its default translated name - Stored in config.yml with targeted writes, same as the language setting: never a full file rewrite

Improved update checker

- Periodic checks in addition to the startup check — configurable interval via update-check-interval-hours (12h by default) - New "up to date" state tracked separately from "update available": - Red line in the info icon if an update exists - Green "up to date" line if the last check confirms everything is fine - Nothing at all until a check has succeeded at least once (avoids showing a false confirmation) - On network failure, the last known state is kept rather than flickering with every connectivity hiccup

Naming

- Major version bump (5.2 → 6.0), per the studio's rule (significant new features) - Generated jar: `Waystone-6.0-26.2.x.jar` - Other Minecraft version lines (1.12.x → 26.1.x) intentionally remain on the v5.2 feature set, with no backport planned

Version 5.2 — 26.2.x port (complete roadmap!)

Waystones now runs on 26.2.x, the current Minecraft version — and now covers every officially supported version, from 1.12.2 to today.

Adapting to the 26.2 API

- No code changes were needed — Spigot confirms no API breakage since 26.1 - No new JDK change — Java 25 remains sufficient - Tested and validated under real conditions on a test server (Falix) - No feature added or changed, hence why the version number stays 5.2

Naming

Generated jar: `Waystone-5.2-26.2.x.jar`

Full roadmap summary

Twelve distinct jars, a single codebase, zero functional regressions: | Minecraft line | JDK required | |---|---| | 1.12.x → 1.16.x | Java 8 | | 1.17.x → 1.19.x | Java 17 | | 1.20.x → 1.21.x | Java 21 | | 26.1.x → 26.2.x | Java 25 | Three JDK changes, two build tooling updates (maven-shade-plugin), a handful of block/sound renames fixed along the way — and the language system, bStats, and update checker built in v4/v5 never needed to be touched.

Version 5.2 — 26.1.x port

Waystones now runs under Minecraft's new year-based numbering (26.1.x) — same plugin, same features.

Adapting to the 26.1 API

- Third JDK change in the roadmap: now compiled with Java 25, required starting with 26.1 - No business-logic code changes — Spigot itself confirms no significant API breakage since 1.21.11 - Build tooling update (again): maven-shade-plugin bumped from 3.5.1 to 3.6.2, since Java 25 bytecode support was only added in 3.6.1 - Tested and validated under real conditions on a test server (Falix) - No feature added or changed, hence why the version number stays 5.2

Naming

Generated jar: `Waystone-5.2-26.1.x.jar` (coexists with the 1.12.x → 1.21.x jars)

Version 5.2 — 1.21.x port

Waystones now also runs on Minecraft 1.21.x (Tricky Trials), up to and including 1.21.11 — same plugin, same features.

Adapting to the 1.21 API

- No code changes were needed - No new JDK change — Java 21 remains sufficient across the whole 1.21.x line - Tested and validated under real conditions on a test server (Falix) - No feature added or changed, hence why the version number stays 5.2

Naming

Generated jar: `Waystone-5.2-1.21.x.jar` (coexists with the 1.12.x → 1.20.x jars)

End of classic numbering

This is the last version ported under the old 1.X.Y scheme. The next step will follow the new year-based numbering (26.1.x, 26.2.x) adopted by Mojang in late 2025.

Version 5.2 — 1.20.x port

Waystones now also runs on Minecraft 1.20.x (Trails & Tales), up to and including 1.20.6 — same plugin, same features.

Adapting to the 1.20 API

- Second JDK change in the roadmap: now compiled with Java 21, required starting with 1.20.5 (a requirement Mojang tightened mid version-line) - The much-discussed item component rework in 1.20.5/1.20.6 ultimately required no business-logic code changes — the setDisplayName/setLore methods Waystones relies on remain functional (deprecated but not removed) - Build tooling update: maven-shade-plugin bumped from 3.4.1 to 3.5.1, since the older version couldn't parse Java 21 bytecode - Tested and validated under real conditions on a test server (Falix) - No feature added or changed, hence why the version number stays 5.2

Naming

Generated jar: `Waystone-5.2-1.20.x.jar` (coexists with the 1.12.x → 1.19.x jars)

Version 5.2 — 1.19.x port

Waystones now also runs on Minecraft 1.19.x (The Wild Update) — same plugin, same features.

Adapting to the 1.19 API

- No code changes were needed — the Wild Update added mangrove, warden, sculk, and the deep dark without touching any block/sound already used by Waystones - No new JDK change — Java 17 remains sufficient - Tested and validated under real conditions on a test server (Falix) - No feature added or changed, hence why the version number stays 5.2

Naming

Generated jar: `Waystone-5.2-1.19.x.jar` (coexists with the 1.12.x → 1.18.x jars)

Heads-up for what's next

The next step (1.20.x) includes a real item API rework in 1.20.5/1.20.6 (component system) — the first step since 1.13 where a deeper code change is genuinely expected.

Version 5.2 — 1.18.x port

Waystones now also runs on Minecraft 1.18.x (Caves & Cliffs II) — same plugin, same features.

Adapting to the 1.18 API

- No code changes were needed — 1.18 mainly concerns world generation (height, caves) and doesn't touch any block/sound used by Waystones - No new JDK change — Java 17 remains sufficient - Tested and validated under real conditions on a test server (Falix) - No feature added or changed, hence why the version number stays 5.2

Naming

Generated jar: `Waystone-5.2-1.18.x.jar` (coexists with the 1.12.x → 1.17.x jars)

Version 5.2 — 1.17.x port

Waystones now also runs on Minecraft 1.17.x (Caves & Cliffs I) — same plugin, same features.

Adapting to the 1.17 API

- First JDK change in the whole roadmap: now compiled with Java 17 (Java 16 minimum required by Minecraft 1.17, unavailable on Homebrew as a non-LTS version — Java 17 LTS used instead) - No business-logic code changes were needed — 1.17 mainly added new content (copper, amethyst, deepslate) without touching blocks/sounds already used by Waystones - Tested and validated under real conditions on a test server (Falix) - No feature added or changed, hence why the version number stays 5.2

Naming

Generated jar: `Waystone-5.2-1.17.x.jar` (coexists with the 1.12.x → 1.16.x jars)

Version 5.2 — 1.16.x port

Waystones now also runs on Minecraft 1.16.x (Nether Update) — same plugin, same features.

Adapting to the 1.16 API

- No code changes were needed — the Nether Update mainly added new blocks (netherite, blackstone, basalt, crimson/warped wood) without renaming anything Waystones already used - Tested and validated under real conditions on a test server (Falix) - No feature added or changed, hence why the version number stays 5.2

Naming

Generated jar: `Waystone-5.2-1.16.x.jar` (coexists with the 1.12.x, 1.13.x, 1.14.x, and 1.15.x jars)

Last roadmap version buildable with Java 8 — 1.17.x will require the first JDK change of the whole roadmap.

Version 5.2 — 1.15.x port

Waystones now also runs on Minecraft 1.15.x (Buzzy Bees) — same plugin, same features.

Adapting to the 1.15 API

- No code changes were needed — since 1.15 was mainly a performance/stability release, every Material/Sound/Effect used by Waystones remained valid from 1.14 - Tested and validated under real conditions on a test server (Falix) - No feature added or changed, hence why the version number stays 5.2

Naming

Generated jar: `Waystone-5.2-1.15.x.jar` (coexists with the 1.12.x, 1.13.x, and 1.14.x jars)

Version 5.2 — 1.14.x port

Waystones now also runs on Minecraft 1.14.x (Village & Pillage) — same plugin, same features.

Adapting to the 1.14 API

| Old (1.13.x) | New (1.14.x) | |---|---| | Material.SIGN | Material.OAK_SIGN (signs get wood-type variants starting this version) | - Tested and validated under real conditions on a test server (Falix) - No feature added or changed — purely a technical compatibility update, hence why the version number stays 5.2

Naming

Generated jar: `Waystone-5.2-1.14.x.jar` (coexists with Waystone-5.2-1.12.x.jar and Waystone-5.2-1.13.x.jar)

Version 5.2 — 1.13.x port

Waystones now also runs on Minecraft 1.13.x — same plugin, same features.

Adapting to the 1.13 API (the "Flattening")

| Old (1.12.x) | New (1.13.x) | |---|---| | Material.STAINED_GLASS + color data | Material.LIME_STAINED_GLASS / RED_STAINED_GLASS / PURPLE_STAINED_GLASS | | Material.GRASS (block) | Material.GRASS_BLOCK | | Material.ENDER_STONE | Material.END_STONE | | Sound.ENTITY_ENDERMEN_TELEPORT | Sound.ENTITY_ENDERMAN_TELEPORT (typo fixed by Mojang) | - Tested and validated under real conditions on a test server (Falix) - No feature added or changed — purely a technical compatibility update, hence why the version number stays 5.2

Naming

Generated jar: `Waystone-5.2-1.13.x.jar` (coexists with Waystone-5.2-1.12.x.jar for servers still on 1.12.2)

Version 5.2

The plugin can now let you know on its own when a new version is out.

Update checker

| Detail | Value | |---|---| | Source | Official Modrinth API | | Frequency | Asynchronous check on server startup | | Notification | Red line added to the main menu's info icon (on hover) | | On failure | No impact — a quiet console warning, the plugin keeps running normally | | Can be disabled | Yes, via update-checker-enabled: false in config.yml | - No blocking requests: the check runs entirely in the background, never slowing down the server - Available in all 4 plugin languages

Naming

Generated jar: `Waystone-5.2-1.12.x.jar`

Version 5.1

A small finishing touch in the main menu: an info icon about the plugin.

Info icon

| Detail | Value | |---|---| | Location | Top-left corner of the main menu | | Icon | Redstone block | | Content on hover | Plugin version + credits (Zyldros & Claude AI) | | Interaction | None — purely informational | - Available in all 4 plugin languages, with a Québécois touch on the fr-ca version ("Fait par Zyldros pis Claude AI")

Naming

Generated jar: `Waystone-5.1-1.12.x.jar`

Version 5.0

The plugin now supports two new languages and ships with anonymous usage statistics.

Two new languages

| Language | Code | Note | |:---:|:---:|---| | Portuguese (Brazil) | pt-br | New | | French (Québec) | fr-ca | Genuinely distinctive vocabulary and phrasing, not just a variant of standard French | Updated command: /waystone setlang <fr|en|pt-br|fr-ca>

bStats statistics

What's collected - Only global, anonymous trends: server count, versions, language usage breakdown (fr / en / pt-br / fr-ca) - No personal or identifiable data How it's integrated - The bStats code is compiled and bundled into the jar, like the rest of the plugin — not editable, no external file specific to Waystones - Can be globally disabled by the admin via plugins/bStats/config.yml (mechanism shared by all bStats plugins on the server)

Naming

Generated jar: `Waystone-5.0-1.12.x.jar`

Version 4.0

The plugin now speaks two languages — French and English, admin's choice.

Language system

- Added French / English support, with English as the default language on a fresh install - New `/waystone setlang <fr|en>` command (admin) to change the language on the fly, without restarting the server - Without an argument, /waystone setlang shows the currently active language - Automatic fallback to English if a text is missing in a language

Text reliability

- Plugin texts are now built into the jar and not editable — no more message files that could be broken by accidental edits - Only behavior settings (language, teleport-cooldown-seconds, effects-enabled) remain configurable in config.yml

Updating from a previous version

- An existing config.yml (v1 to v3) is migrated automatically and smoothly: the language key is added without touching the rest of the file — no comment or custom setting is lost - The old messages.* block, if present, stays in place but is no longer used; a console message notifies the admin on startup

Naming

- New plugin naming convention: `Waystone-<version>-<Minecraft version>.jar` (e.g. Waystone-4.0-1.12.x.jar)

Version 3.0

Visual overhaul of the menu — player heads are gone, replaced by colored glass.

Changes

- Teleportation points are now represented by colored glass in the menu, instead of a custom player head - Light green for the Overworld - Red for the Nether - Purple for the End

Technical cleanup

- Removed the external authlib dependency, no longer needed - The plugin now relies on a single dependency: spigot-api - Removed the skull-texture option from config.yml, no longer necessary

Version 2.0

Complete overhaul of how the plugin works — block placement gives way to a fully command/menu-based system.

New features

- Command-based creation: /waystone create <name> instantly creates a point at the player's position, no item to place - Menu sorted by world: pick a category — Overworld, Nether, End — before the list of matching points is shown - Added `/waystone tp <name>` for direct teleportation via command

Management & permissions

- Creating, renaming, and removing points is now restricted to admins (waystones.admin) - All players (waystones.use) can browse the menu and teleport freely - Admins are no longer subject to the teleport cooldown