Waystones-X (Unofficial Waystones Fork)

Teleport back to activated waystones. For Survival, Adventure or Servers. (Waystones mod fork.)

Fixes:
- Nether portals aren't generated when teleporting to the Nether (@kuzuanpa)
- Fixed some rendering bugs (@kuzuanpa)
New features:
- New textures by DarkBum.
- Clicking an activated Waystone will open the teleport menu, instead of needing to shift-click it (much more intuitive)
- If configured, Waystones show nametags with their name.
- Duplicate Waystone names are disallowed.
- If a player exits the Waystone creation menu without properly naming it, the creation/naming menu will be shown upon next interaction (instead of creating an empty-named Waystone).
- GUI Configuration.
- Configurable worldgen.
- Automatic activation upon naming.
- Configurable Village Names mod compatibility.
- Configurable teleportation XP level cost. Flat cost, distance cost, flat cross-dim cost.
- Configurable global teleportation cooldown. Cooldown status indicator.
- Waystone list sorting by Name and Distance.
- Waystone list filtering.
- "Undiscovering/Forgetting" Waystones.
- Waystone renaming.
- Pinned Waystones which appear at the top of the list.
- Global Waystones are stored in the save NBT, no more conflicts.
- Sandstone, Mossy, (Mossy) Stonebrick, Netherbrick, Endstone Waystone variants.
- Journeymap and Xaero's Minimap integration: adding waypoints upon interaction with Waystones
Worldgen configuration system:
You can define a list of rules under the structureWaystoneRules key in the config. Each rule can have the following properties:
structure: Vanilla or modded structure id this rule applies to (for example village, temple_desert).chance: Spawn probability from0to1(0= never,1= always).type: Waystone variant override:auto,stone,sandy, ormossy.autokeeps structure/default logic.name: Optional fixed name override. If duplicates exist, a number suffix is appended automatically. Makes the most sense for unique structures.forceGlobal:true/false. Iftrue, the Waystone is forced to become global. Requires name to be set.autoActivateGlobal:true/false. Only relevant whenforceGlobal=true.trueimmediately registers as global, false waits until player activation.dimensionWhitelist: Allowed dimension IDs, comma-separated (for example0,-1,1) or*for all.biomeWhitelist: Allowed biome IDs, comma-separated (for example2,17,21) or*for all.
Example: structure=village;chance=0.35;type=auto;dimensionWhitelist=0;biomeWhitelist=2,17,35
Currently supported structure ids:
villagetemple_deserttemple_junglestrongholdfortressend_spikeworld_spawn
Dependencies

Building
./gradlew build.
Credits
- BlayTheNinth for the original mod.
- New textures by DarkBum.
- kuzuanpa for some bugfixes.
- Textures and ideas from BetterWaystonesMenu.
- brandyyn for some fixes.
- Omgise for Chinese translation.
- GT:NH buildscript.
License
This project is a fork of Waystones by BlayTheNinth.
- Original Waystones code: MIT License (Copyright 2016 BlayTheNinth) (archive)
- New contributions: LGPLv3 (Copyright 2025 jack)
The combined work is distributed under LGPLv3 terms. The original MIT-licensed portions remain available under MIT terms.
Buy me a coffee
- ko-fi.com
- Monero:
893tQ56jWt7czBsqAGPq8J5BDnYVCg2tvKpvwTcMY1LS79iDabopdxoUzNLEZtRTH4ewAcKLJ4DM4V41fvrJGHgeKArxwmJ

All Versions
+ Add Version- Fixed client/server clock differences adding extra teleport cooldown
- Fixed zero cooldown handling and cooldown progress displays
- Added independent
waystoneCooldownfor placed waystones - Fixed inventory teleport menus and tooltips using the warp stone cooldown
- Fixed XP checks incorrectly blocking free inventory teleports
- Structures are now registered regardless of worldgen setting to prevent crashes when this config is toggled
- Nether fortress mixin now correctly bails out if worldgen is disabled
- Fixed activation & teleport sound not playing with Sound Physics installed
- Waystone variant no longer stored in nbt, inferred from block type
- Fix dedicated server crash (loading net/minecraft/client/resources/I18n) by @Vonbraunz
- Using
DimensionManager.getStaticDimensionIDs()to get a list of dimension names, more accurate for mods that don't conflate dimensions with providers - Added proper localization for vanilla and warpdrive dimension names
- Option to make waystones indestructible, except their for owner by @DrParadox7
- Added 67 publishing
- Fixed
globalNoCooldownoption having no effect - Hardened server-side validation of warps
- Added client-side option to disable the teleport sound
- Updated Chinese translations
- Fixed Nether and End Waystone rendering with Angelica
- Fix variant bug upon TE creation
- Explicitly load target chunk before teleporting for compatibility with Alternative Chunkloading and Hodgepodge
- Journeymap compat (add waypoint upon waystone interaction)
- Xaero's minimap compat, idem
- Catalogue Vintage integration
- Fixed Gui config crash with latest gtnhlib
- Added new waystone variants: sandy, mossy, stonebrick, mossy stonebrick, nether and end.
- Village waystones now generate on village path/surface blocks.
- Added configurable structure worldgen rules (
structureWaystoneRules). - Added structure rule filters for dimensions and biomes.
- Added structure waystone spawning in desert temple, jungle temple, stronghold, fortress, end spike and world spawn.
- Fixed structure rules ignoring
enableWorldgen. - Renamed config keys to variable-style names (camelCase).
- Improved teleport placement to avoid spawning inside waystones/walls.
- Global waystones are no longer free by default.
- Creative warps no longer count toward survival cooldown.
- Reworked waystone overlay charging animation and clipping.
- Fixed end/nether overlay rendering issues.
- Fixed end worldgen decorating crash.
- Added waystone item icons for all variants and flat inventory icon support.
- Added end portal-like particles for end waystones.
- Moved dimension warp command to FentLib.
- Added new waystone textures + modernity textures (as virtual resource pack) (by DarkBum).
When upgrading, regenerate your config!
- New textures and logo by DarkBum.
- Added cancel button to name/rename Waystone GUI.
I have backported and integrated several features from the [BetterWaystonesMenu](https://modrinth.com/mod/betterwaystonesmenu/gallery) mod:
- Two different sorting modes (when you click it, the button list gets rebuilt)
- Filtering by name
- Deletion ("Unlearning") of waystones
- Config button
- General GUI facelift
- Pinning and unpinning
- Filtering cross-dim waystones if cross-dim teleport is disabled in the config
- Global waystones are not stored in the config anymore, but in save nbt. Singleplayer global waystones don't impede on server waystones and vice versa.
+ Bugfixes








Trailer

