Waystones

插件

· 作者 Zyldros

适用于 Paper/Spigot/Purpur 的轻量级传送插件,作为服务器端替代 Waystones 模组

0 本站下载 0 关注 更新于 3 个月前

最新 Release-7.8-26.2.x · 26.2 · Paper / Purpur

一键开服(送7天)

Waystones banner

?️ 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 或分类图标

? 工作原理

  1. 管理员前往目标位置并输入 /waystone create <name> → 传送点立即创建
  2. 玩家输入 /waystone → 打开世界选择菜单
  3. 选择一个世界 → 显示该维度下的传送点列表
  4. 点击传送点 → 立即进行免费传送 无需复杂的配置,也无需合成方块:一切通过命令和菜单完成。

?️ 选择自定义图标

在创建时于名称末尾添加 @<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)在服务器端选择退出。


? 安装

  1. 下载与您 Minecraft 版本匹配的 jar 文件:
    • Waystone-5.2-1.12.x.jar 适用于 1.12.2
    • Waystone-5.2-1.13.x.jar 适用于 1.13.x 系列
  • Waystone-5.2-1.14.x.jar 适用于 1.14.x 版本

    • Waystone-5.2-1.15.x.jar 适用于 1.15.x 版本
    • Waystone-5.2-1.16.x.jar 适用于 1.16.x 版本
  • Waystone-5.2-1.17.x.jar 适用于 1.17.x 版本线

    • Waystone-5.2-1.18.x.jar 适用于 1.18.x 版本线
    • Waystone-5.2-1.19.x.jar 适用于 1.19.x 版本线
    • Waystone-5.2-1.20.x.jar 适用于 1.20.x 版本线
    • Waystone-5.2-1.21.x.jar 适用于 1.21.x 版本线
    • Waystone-5.2-26.1.x.jar 适用于 26.1.x 版本线
    • Waystones-Release-7.8-26.2.x.jar 适用于 26.2.x(当前版本,最新功能——包括伙伴传送、战斗安全以及 BlueMap/Squaremap 支持)
  1. 将其放入服务器的 plugins/ 文件夹中
  2. 重启服务器
  3. 向你的团队授予 waystones.admin 权限以开始放置传送点

? 发现了一个错误或有什么建议?请留下评论或提交工单——欢迎所有反馈。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源