
?️ Waystones
在世界间瞬间穿梭
一款轻量级、完全服务端运行的传送插件,适用于 Paper/Spigot 和 Purpur
在你的服务器任何地方——主世界、下界、末地——创建命名的传送点,让玩家通过清晰直观的菜单一键传送。无需客户端模组,也无需资源包。
受 Minecraft 社区中著名的 Waystones 模组启发,本插件复用了其核心概念——可命名、可重复使用的传送点——但仅作为服务端插件运行。客户端无需安装任何东西,也无需分发资源包:一切都在服务器上直接运行,通过简单的游戏内菜单实现。这是无法使用或不希望使用客户端模组的 Paper/Spigot 服务器的轻量级替代方案。
✨ 功能特性
- ?️ 按世界排序的菜单 — 传送点自动按维度分组:主世界、下界、末地 (参见画廊图片 #1)
- ?️ 可重命名的分类 — 自定义菜单分类名称(例如将“Nether”改为“Underworld”)以契合你的服务器主题
- ? 彩色图标 — 根据传送点的来源世界显示绿色、红色或紫色玻璃 (参见画廊图片 #4)
- ? 支持 30 种语言 — 从主要欧洲语言到乌克兰语、格鲁吉亚语、斯瓦希里语、日语和韩语,可通过管理员命令随时更改(见下方完整列表)
- ⚡ 免费、瞬发的传送 — 配备可配置的防刷屏冷却时间
- ? 仅限管理员管理 — 只有 OP 可以创建、重命名或删除传送点
- ?️ 自定义名称 — 每个传送点都可以随时命名和重命名
- ?️ 可自定义图标 — 为每个 Waystone 和每个菜单分类选择显示的方块/物品 (参见画廊图片 #6)
- ? 定期更新检查 — 菜单图标会发光,并提示你是否已是最新版本或有新版本可用 (参见画廊图片 #2)
- ? Discord 快捷方式 — 主菜单中的 lectern 图标向玩家发送一个可点击链接,直达官方支持 Discord (参见画廊图片 #3)
- ? 可靠存储 — 持久化的 YAML 存储,重启无数据丢失
- ? 自定义维度 — 将分类链接到其他插件创建的维度,详见下文专用部分 (参见画廊图片 #5)
- ?️ 可选的网络地图支持 — 每个 Waystone 均可出现在 Dynmap、BlueMap 和/或 Squaremap 上,各自拥有独立的图层;如果你不使用这些插件,则无需任何设置
- ? 携带同伴同行 — 驯服动物、拴绳宠物以及你当前的坐骑会自动随你一起传送
- ?️ 战斗安全 — 受到伤害后的一段时间内禁止传送,持续时间可配置
- ? ItemsAdder / Oraxen 图标 — 除原版材质外,可使用自定义物品作为 Waystone 或分类图标
? 工作原理
- 管理员前往目标位置并输入
/waystone create <name> → 传送点立即创建
- 玩家输入
/waystone → 打开世界选择菜单
- 选择一个世界 → 显示该维度下的传送点列表
- 点击传送点 → 立即进行免费传送
无需复杂的配置,也无需合成方块:一切通过命令和菜单完成。
?️ 选择自定义图标
在创建时于名称末尾添加 @<material>,或使用 /waystone seticon 稍后设置:
/waystone create Village Spawn @DIAMOND_BLOCK
/waystone seticon Village Spawn @NETHER_BRICK
/waystone seticon Village Spawn @reset
材质必须是精确的 Bukkit API 名称(例如 DIAMOND_BLOCK、NETHER_BRICK、EMERALD_ORE)。无效的材质将被拒绝且不会改变任何内容。
如果你使用 ItemsAdder 或 Oraxen,seticon/setcategoryicon 也接受自定义物品而非原版材质:
/waystone seticon Village Spawn itemsadder:mynamespace:custom_totem
/waystone setcategoryicon nether oraxen:custom_portal_icon
如果对应的插件未安装或物品不再存在,则回退到默认图标——绝不会破坏菜单。
? 添加描述
/waystone setdescription Village Spawn &7The starting point &e|&7Watch out for zombies at night
/waystone setcategorydescription nether &cDangerous zone
| 字符用于分隔行,& 颜色代码在插件的其他部分同样适用。reset(或不提供文本)将移除描述。
? 命令
玩家命令 — 所有拥有 waystones.use 权限的玩家可用
| 命令 |
描述 |
/waystone |
打开传送菜单 |
/waystone list |
列出所有现有传送点 (可由管理员禁用) |
/waystone tp <name> |
通过命令直接传送 (可由管理员禁用) |
进入某个分类后,导航非常简单:后退按钮返回世界菜单(画廊图片 #7),关闭按钮让你立即退出(画廊图片 #8)。
管理员命令 — 需要 waystones.admin 权限
| 命令 |
描述 |
/waystone create <name> [@material] |
在玩家当前位置创建一个传送点 |
/waystone remove <name> |
删除一个传送点 |
/waystone rename <old> <new> |
重命名一个传送点 |
/waystone setlang <code> |
更改插件语言(支持 30 种语言) |
/waystone setcategoryname <overworld|nether|end> <name|reset> |
重命名一个菜单分类 |
/waystone seticon <name> @<material|reset> |
更改传送点的图标 |
/waystone setcategoryicon <overworld|nether|end> <material|reset> |
更改分类的图标 |
/waystone setdescription <name> <text|reset> |
为传送点添加描述 |
/waystone setcategorydescription <overworld|nether|end> <text|reset> |
为分类添加描述 |
/waystone setcommand <list|tp> <enabled|disabled> |
启用/禁用 list 或 tp 命令 |
/waystone createcategory <key> <world> |
将分类链接到自定义维度 |
/waystone removecategory <key> |
移除自定义维度分类 |
/waystone setcategory <name> <key|reset> |
验证/确认传送石的分类 |
/waystone setglint <enabled|disabled> |
切换自定义维度的发光效果 |
/waystone setmapvisible <name> <enabled|disabled> |
在网页地图(Dynmap/BlueMap/Squaremap)上显示/隐藏特定的传送石 |
/waystone reload |
重新加载配置 |
? 权限
| 权限 |
效果 |
默认值 |
waystones.use |
使用菜单和传送 |
所有玩家 |
waystones.admin |
创建/重命名/删除,重新加载配置 |
仅限 OP |
⚙️ 配置
config.yml 文件允许您自定义:
language — 插件语言(提供 30 种语言,详见下文专用章节),可通过游戏内命令 /waystone setlang 更改
teleport-cooldown-seconds — 两次传送之间的防刷屏延迟时间
effects-enabled | 启用/禁用声音和粒子效果
update-checker-enabled | 启用/禁用更新检查
update-check-interval-hours | 自动检查的间隔时间(默认为 12 小时)
面向玩家的文本不可编辑:它们内置于插件中,支持全部 4 种语言,以确保可靠且一致的行为。不过,分类名称可以通过 /waystone setcategoryname 命令进行自定义。
? 支持的语言
共 30 种语言,每行两种排列以保持紧凑。
| 语言 |
代码 |
语言 |
代码 |
| ?? 法语 |
fr |
?? 乌克兰语 |
uk |
| ???? 英语 |
en |
?? 白俄罗斯语 |
be |
| ?? 葡萄牙语(巴西) |
pt-br |
?? 爱沙尼亚语 |
et |
| ?? 葡萄牙语(葡萄牙) |
pt-pt |
?? 拉脱维亚语 |
lv |
| ?? 法语(魁北克) |
fr-ca |
?? 立陶宛语 |
lt |
| ?? 西班牙语 |
es |
?? 塞尔维亚语(拉丁字母) |
sr-latn |
| ?? 挪威语(书面语) |
nb |
?? 保加利亚语 |
bg |
| ?? 瑞典语 |
sv |
?? 格鲁吉亚语 |
ka |
| ?? 芬兰语 |
fi |
???? 斯瓦希里语 |
sw |
| ?? 意大利语 |
it |
?? 印度尼西亚语 |
id |
| ?? 荷兰语 |
nl |
?? 日语 |
ja |
| ?? 德语 |
de |
?? 韩语 |
ko |
| ?? 冰岛语 |
is |
|
|
| ?? 匈牙利语 |
hu |
|
|
| ?? 罗马尼亚语 |
ro |
|
|
| ?? 捷克语 |
cs |
|
|
| ?? 斯洛伐克语 |
sk |
|
|
| ?? 波兰语 |
pl |
|
|
语言由服务器管理员全局设置(无自动按玩家检测功能),如果缺少文本则自动回退到英语。可以随时通过 /waystone setlang <code> 更改语言,无需重启服务器。
? 兼容性
| 插件版本 |
支持的 Minecraft 版本线 |
| v7.8(当前,最新功能) |
26.2.x |
| v5.2 |
1.12.2 · 1.13.x · 1.14.x · 1.15.x · 1.16.x · 1.17.x · 1.18.x · 1.19.x · 1.20.x · 1.21.x · 26.1.x |
✅ 完整兼容性路线图 — Waystones 覆盖每个官方支持的 Minecraft 版本,从 1.12.2 到当前版本。新功能(v6.0 至 v7.8,细分如下)仅在 26.2.x 版本线上提供;早期版本有意保持在 v5.2 功能集上,暂无向后移植计划。每条版本线对应的确切 jar 文件见下方的安装部分。
? 哪些功能在哪个版本?
下面列出的每个版本仅适用于 26.2.x jar(唯一接收新功能的版本)。其他 11 个 jar 文件(1.12.x → 26.1.x)均停留在 v5.2 功能集上,该功能集已包括:按世界划分的菜单、免费传送、可配置的冷却时间、自定义名称、YAML 存储、基础更新检查器以及 4 种语言(fr/en/pt-br/fr-ca)。
| 版本 |
Minecraft 版本 |
新增功能 |
| v5.2 |
1.12.2 → 26.1.x(11 条版本线) |
所有 Minecraft 版本线的通用基线(见上文) |
| v6.0 |
仅限 26.2.x |
可重命名的菜单分类 (setcategoryname) · 改进的更新检查器(定期检查,绿色“已是最新”/红色“有可用更新”提示行) |
| v6.1 |
仅限 26.2.x |
可自定义的节点和分类图标 (@material, seticon, setcategoryicon) |
| v6.2 |
仅限 26.2.x |
新增 8 种语言(es, pt-pt, nb, sv, fi, it, nl, de),共计 12 种语言 |
| v6.3 |
仅限 26.2.x |
可自定义的节点和分类描述 (setdescription, setcategorydescription),支持通过 | 实现多行 |
| v6.4 |
仅限 26.2.x |
新增 18 种语言(总计 30 种) |
| v6.5 |
仅限 26.2.x |
可切换的 list 和 tp 命令 (setcommand) |
| v6.6 |
仅限 26.2.x |
Discord 快捷方式 — 主菜单中的 lectern 图标链接到官方支持服务器 |
| v6.7 |
仅限 26.2.x |
信息图标在有可用更新时会发光 |
| v7.0 |
仅限 26.2.x |
自定义维度支持 — createcategory, removecategory, setcategory, setglint(详见上方专用章节) |
| v7.1 |
仅限 26.2.x |
14 个匿名 bStats 图表跟踪功能使用情况(隐私安全,仅聚合数据)· 更新后显示的关于 bStats 统计数据重要性的单次管理员通知 |
| v7.2 |
仅限 26.2.x |
翻译完整性修复 — 12 种语言缺少菜单和命令文本,现已在所有 30 种语言中完全同步 |
| v7.3 |
仅限 26.2.x |
自定义维度支持从 Alpha 阶段升级为稳定版 · 在 bStats 旁添加 FastStats 以提供更丰富的分析和错误追踪 |
| v7.4 |
仅限 26.2.x |
内部重构 — 无功能性变更。仅提高代码质量和可维护性(共享配置写入逻辑、更快的传送石查找、少量内存清理) |
| v7.5 |
仅限 26.2.x |
可选的 Dynmap 支持 — 传送石显示在专用的网页地图层上 · 新增 setmapvisible 命令以从地图中隐藏特定传送石 |
| v7.6 |
仅限 26.2.x |
同伴传送(宠物、坐骑)· 战斗安全延迟 · 在 Dynmap 旁支持 BlueMap 和 Squaremap · ItemsAdder/Oraxen 自定义图标 |
| v7.7 |
仅限 26.2.x |
内部重构 — 无功能性变更。三个地图集成之间的共享代码,以及修复了错误的“有可用更新”通知 |
| v7.8 | 仅适用于 26.2.x | Bug 修复——解决了某些服务器上同伴传送导致的崩溃问题,并修正了 jar 文件名(参见上方的命名说明) |
简而言之:如果你使用的是 26.2.x 版本线,则可以获得上述所有内容(v7.8 包含了之前的所有更新)。如果你使用的是更早的版本线(1.12.x → 26.1.x),则只能使用 v5.2 基础版本。
?️ 理解版本号
每个插件文件都遵循一个简单的命名格式:<Waystone(s)>-<插件版本>-<Minecraft 版本>.jar,并可选地加上 Alpha/Beta/Release 前缀以标明其稳定性状态。例如,Waystones-Release-7.8-26.2.x.jar 表示:插件版本为 7.8,状态为 Release(稳定版),兼容当前 Minecraft 26.2.x 版本。同一个插件在 1.12.x 系列中也可用 Waystone-5.2-1.12.x.jar —— 版本号不同,因为 1.12.x 尚未获得 v6.x/v7.x 的功能。
好的,请提供需要翻译的内容。
ℹ️ 一次性命名修正(v7.8): 26.2.x 版本的 jar 文件现在命名为 Waystones-...(带有 "s"),与该插件其他地方的实际名称一致。其余所有行(1.12.x 至 26.1.x)仍冻结在 v5.2 版本,并保留其原始的 Waystone-...(不带 "s")文件名,因为这些分支已不再重新构建。两者是同一个插件——仅文件名约定因各个 jar 最后构建的时间不同而有所差异。
需要知道的两点重要事项:
- 插件版本与 Minecraft 版本独立演进。 在不进行任何功能变更的情况下将 Waystones 移植到新的 Minecraft 版本,不会改变插件的版本号——仅 Minecraft 后缀会发生变化。
- 插件版本号遵循主版本.次版本的逻辑(例如 5.0 → 5.1):
- 次要变更(5.0 → 5.1)是对现有功能的微小调整或新增。
- 主要变更(5.1 → 6.0)是重大的新功能或对插件的重大重构。
? 自定义维度 —— “自定义维度的涌现”
将 Waystones 分类链接到由第三方插件创建的维度(如 DimensionControl、Multiverse-Core 或任何添加世界的插件)——由管理员明确声明,绝不自动猜测。
/waystone createcategory royaume myrealm_world
/waystone create Entrance to the Realm #royaume
- 分类只有在实际包含传送石后才会出现在菜单中
- 服务器自身的主主世界/下界/末地绝不会被劫持到自定义分类中
- 自定义分类在菜单中会发出微弱的发光效果(可通过
/waystone setglint 切换),即使链接的世界随后消失也不会丢失数据——它们会变灰并变为仅限管理员使用,直到世界重新出现 (发光效果见画廊图片 #5)
有关 createcategory、removecategory、setcategory 和 setglint 的完整命令列表请参阅下文。
?️ Web 地图支持(Dynmap、BlueMap、Squaremap)
如果您的服务器上已安装并启用了 Dynmap、BlueMap 和/或 Squaremap,Waystones 会自动为每个插件添加一个专用的 “Waystones” 图层,无需任何配置。您可以同时运行多个此类插件;每项集成完全独立。
- 每个传送石都会显示为一个标记点,颜色与游戏内一致(主世界为绿色,下界为红色,末地为紫色)
- 点击标记点会显示该传送石的名称和描述(如果已设置)
- 每当创建、移除或重命名传送石时,标记点会立即同步更新
- 如果您不使用其中任何一个插件?这完全不会产生影响——没有错误提示,不需要额外设置,也没有需要禁用的选项
想将某个特定的传送石从地图中隐藏(例如秘密基地),但不想删除它或在游戏菜单中将其隐藏吗?请使用
/waystone setmapvisible <name> disabled。默认情况下所有传送石都在地图上可见;使用 enabled 可恢复显示。
在 config.yml 中设置 dynmap-enabled: false、bluemap-enabled: false 和/或 squaremap-enabled: false,可以单独关闭这三种集成中的任何一种,即使对应插件已安装。
? 伙伴跟随你
驯服的动物、拴绳的宠物以及你当前的坐骑会随你自动传送——再也不用把狼群留在身后了。
- 你当前的坐骑(马、驴、骡子、炽足兽、骆驼……)会先被传送,然后你才会被重新放置到其背上
- 在你周围
pet-teleport-radius 格范围内的驯服动物和拴绳宠物也会一同前往,落在你的目的地附近
- 在
config.yml 中设置 pet-teleport-radius: 0 可完全禁用此功能
?️ 战斗安全
最近受到伤害的玩家无法进行传送——不能通过传送石逃避战斗。
- 在最后一次受到伤害后的
combat-protection-seconds 秒内(默认为 10 秒),无论是通过菜单还是 /waystone tp 命令都会被阻止
- 会显示剩余秒数的提示信息
- 服务器管理员(拥有
waystones.admin 权限)永远不会受影响,这与普通冷却机制相同
- 在
config.yml 中设置 combat-protection-seconds: 0 可完全禁用此功能
? 统计数据
Waystones 使用 bStats 收集匿名使用统计数据(服务器数量、版本、使用的语言等)。不收集任何个人数据。这些数据公开可查看,并且可以通过 plugins/bStats/config.yml 在服务器端随时禁用。
除了 bStats 之外,Waystones 还使用 FastStats 进行匿名错误追踪,帮助在问题演变成支持工单之前捕获 bug。与 bStats 一样,可通过 plugins/faststats/config.properties(设置 enabled=false)在服务器端选择退出。
? 安装
- 下载与您 Minecraft 版本匹配的 jar 文件:
Waystone-5.2-1.12.x.jar 适用于 1.12.2
Waystone-5.2-1.13.x.jar 适用于 1.13.x 系列
- 将其放入服务器的
plugins/ 文件夹中
- 重启服务器
- 向你的团队授予
waystones.admin 权限以开始放置传送点
? 发现了一个错误或有什么建议?请留下评论或提交工单——欢迎所有反馈。

?️ 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
- 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.
?️ 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
| Command |
Description |
/waystone |
Opens the teleportation menu |
/waystone list |
Lists all existing points (can be disabled by an admin) |
/waystone tp <name> |
Direct teleportation via command (can be disabled by an admin) |
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
| Command |
Description |
/waystone create <name> [@material] |
Creates a point at the player's position |
/waystone remove <name> |
Removes a point |
/waystone rename <old> <new> |
Renames a point |
/waystone setlang <code> |
Changes the plugin's language (30 languages) |
/waystone setcategoryname <overworld|nether|end> <name|reset> |
Renames a menu category |
/waystone seticon <name> @<material|reset> |
Changes a point's icon |
/waystone setcategoryicon <overworld|nether|end> <material|reset> |
Changes a category's icon |
/waystone setdescription <name> <text|reset> |
Adds a description to a point |
/waystone setcategorydescription <overworld|nether|end> <text|reset> |
Adds a description to a category |
/waystone setcommand <list|tp> <enabled|disabled> |
Enables/disables the list or tp command |
/waystone createcategory <key> <world> |
Links a category to a custom dimension |
/waystone removecategory <key> |
Removes a custom dimension category |
/waystone setcategory <name> <key|reset> |
Verifies/confirms a waystone's category |
/waystone setglint <enabled|disabled> |
Toggles the custom dimension glow effect |
/waystone setmapvisible <name> <enabled|disabled> |
Shows/hides a specific waystone on web maps (Dynmap/BlueMap/Squaremap) |
/waystone reload |
Reloads the configuration |
? 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 (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.
| Language |
Code |
Language |
Code |
| ?? French |
fr |
?? Ukrainian |
uk |
| ???? English |
en |
?? Belarusian |
be |
| ?? Portuguese (Brazil) |
pt-br |
?? Estonian |
et |
| ?? Portuguese (Portugal) |
pt-pt |
?? Latvian |
lv |
| ?? French (Québec) |
fr-ca |
?? Lithuanian |
lt |
| ?? Spanish |
es |
?? Serbian (Latin) |
sr-latn |
| ?? Norwegian (Bokmål) |
nb |
?? Bulgarian |
bg |
| ?? Swedish |
sv |
?? Georgian |
ka |
| ?? Finnish |
fi |
???? Swahili |
sw |
| ?? Italian |
it |
?? Indonesian |
id |
| ?? Dutch |
nl |
?? Japanese |
ja |
| ?? German |
de |
?? Korean |
ko |
| ?? Icelandic |
is |
|
|
| ?? Hungarian |
hu |
|
|
| ?? Romanian |
ro |
|
|
| ?? Czech |
cs |
|
|
| ?? Slovak |
sk |
|
|
| ?? Polish |
pl |
|
|
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
| Plugin version |
Minecraft lines covered |
| v7.8 (current, latest features) |
26.2.x |
| v5.2 |
1.12.2 · 1.13.x · 1.14.x · 1.15.x · 1.16.x · 1.17.x · 1.18.x · 1.19.x · 1.20.x · 1.21.x · 26.1.x |
✅ 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).
| Version |
Minecraft version(s) |
Feature added |
| v5.2 |
1.12.2 → 26.1.x (11 lines) |
Common baseline for every Minecraft line (see above) |
| v6.0 |
26.2.x only |
Renamable menu categories (setcategoryname) · improved update checker (periodic checks, green "up to date"/red "update available" line) |
| v6.1 |
26.2.x only |
Customizable icons for points and categories (@material, seticon, setcategoryicon) |
| v6.2 |
26.2.x only |
8 additional languages (es, pt-pt, nb, sv, fi, it, nl, de), 12 languages total |
| v6.3 |
26.2.x only |
Customizable descriptions for points and categories (setdescription, setcategorydescription), multi-line via | |
| v6.4 |
26.2.x only |
18 more languages (30 total) |
| v6.5 |
26.2.x only |
Togglable list and tp commands (setcommand) |
| v6.6 |
26.2.x only |
Discord shortcut — a lectern icon in the main menu links to the official support server |
| v6.7 |
26.2.x only |
The info icon now glows when an update is available |
| v7.0 |
26.2.x only |
Custom dimensions support — createcategory, removecategory, setcategory, setglint (see dedicated section above) |
| v7.1 |
26.2.x only |
14 anonymous bStats charts tracking feature usage (privacy-safe, aggregate only) · one-time admin notice about the importance of bStats statistics, shown after updates |
| v7.2 |
26.2.x only |
Translation completeness fix — 12 languages were missing menu and command text, now fully synced across all 30 |
| v7.3 |
26.2.x only |
Custom dimensions support graduates from Alpha to stable · FastStats added alongside bStats for richer analytics and error tracking |
| v7.4 |
26.2.x only |
Internal refactor — no functional changes. Code quality and maintainability improvements only (shared config-writing logic, faster waystone lookups, small memory cleanup) |
| v7.5 |
26.2.x only |
Optional Dynmap support — waystones shown on a dedicated web map layer · new setmapvisible command to hide a specific waystone from the map |
| v7.6 |
26.2.x only |
Companion teleportation (pets, mounts) · combat safety delay · BlueMap and Squaremap support alongside Dynmap · ItemsAdder/Oraxen custom icons |
| v7.7 |
26.2.x only |
Internal refactor — no functional changes. Shared code between the three map integrations, plus a fix for a false "update available" notice |
| v7.8 |
26.2.x only |
Bug fix — a crash affecting companion teleportation on some servers, plus a corrected jar filename (see naming note above) |
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
- 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)
- Drop it into your server's
plugins/ folder
- Restart the server
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧