远古路石

远古路石

可制作且易于使用的传送石，可传送至任何地方！附带可制作的消耗品！新增：用于配置限制和传送价格（可选）的命令

家具

远古路石预览查看大图

🏛️ 远古传送石

为 Hytale 服务器打造的完整传送石传送系统。创建互联的传送网络，管理可见性，与朋友分享，并瞬间穿梭于你的世界！

如有功能请求/BUG 报告请在评论区提出

🚀 快速入门

放置你的第一块传送石

  1. 获得一个传送石物品
  2. 将其放置在世界中
  3. 会弹出一个设置对话框 - 输入一个唯一名称并配置可见性
  4. 你的传送石现已激活！

 

使用传送石

  1. 使用任意传送石打开传送菜单
  2. 从列表中选择目的地
  3. 你会被立即传送！

提示： 你只能看到公开的、属于你自己的、或由朋友分享的传送石。

✨ 功能特性

🌐 传送网络

创建任意数量的传送石（除非受服务器设置限制），并在它们之间瞬间传送。传送石可以放置在任何世界的任何位置。

示例： 在你的基地、村庄、地牢入口和朋友家各放置一块传送石。现在你就可以在这些地点之间快速旅行了！

🌍 跨世界支持

在不同世界之间无缝传送。在主世界放置一个传送石，再在另一个世界放置一个——你就可以在它们之间旅行（前提是它们不是实例化世界）。

🗺️ 地图标记

在世界地图上直接查看你的传送石！

  • 可见性： 标记遵循与传送石列表相同的可见性规则。
  • 交互： 右键点击标记以“传送石传送”。
  • 传送浆果： 使用“使用传送浆果”右键菜单选项来消耗一颗传送浆果并立即传送。

🧭 玩家朝向控制

控制玩家传送后面对的方向：

  1. 使用你的传送石
  2. 点击编辑按钮
  3. 从下拉菜单中选择朝向（北、东、南或西）

提示： 非常适合让玩家面对你的建筑或重要地标！

📍 自定义传送位置（可选）

使用精确坐标覆盖默认传送位置。适用于精确定位或避免安全传送调整。

启用该功能：

/waystone customtp

使用方法：

  1. 打开传送石设置
  2. 在“自定义传送位置”部分输入 X、Y、Z 坐标
  3. 保存 - 玩家现在将被传送到这些精确坐标
  4. 留空字段以恢复默认行为

注意： 自定义位置会绕过安全传送逻辑。请确保你的坐标是安全的！

🔒 公开与私人传送石

控制谁可以查看和使用你的传送石：

  • 公开传送石 - 每个人都可以查看并传送到它们
  • 私人传送石 - 只有你和你的朋友可以查看它们

切换可见性：

  1. 使用你的传送石
  2. 点击编辑按钮
  3. 从下拉菜单中选择“公开”或“私人”

 

👥 好友系统

与朋友分享你的私人传送石：

  • /waystone friend add (玩家名) - 玩家现在可以看到你的私人传送石
  • /waystone friend remove (玩家名) - 移除玩家的访问权限
  • /waystone friend list - 查看所有好友

示例： 你建造了一个秘密基地，只想让朋友 Alex 访问。将传送石设为私人，然后运行 /waystone friend add Alex。

🔍 探索系统（可选）

服务器管理员可以启用探索模式，要求玩家必须先物理访问传送石，之后才能传送到该传送石。

工作原理：

  1. OP 执行：/waystone discovery
  2. 玩家必须先走到传送石跟前
  3. 一旦被探索发现，该传送石就会出现在他们的传送菜单中
  4. 未被发现的传送石会被隐藏

示例： 非常适合冒险服务器，让玩家先探索世界，而不是立刻传送到任何地方。

🔗 网络系统（可选）

将传送石分组到不同的网络中。

使用场景：

  • 创建具有不同设置的独立“城镇”和“地牢”网络
  • 为每位玩家提供他们自己的私人网络
  • 为不同的游戏模式隔离传送石组

网络命令：

  • /waystone network toggle - 开启/关闭网络功能（仅限 OP）
  • /waystone network create (名称) - 创建一个新网络
  • /waystone network delete (名称) - 删除一个网络
  • /waystone network list - 列出所有网络
  • /waystone network info (名称) - 显示网络设置

每个网络的设置：

每个网络可以拥有自己的探索、冷却和价格设置，这些设置会覆盖全局设置。重要： 这些设置在你使用属于此网络的传送石（源传送石）时生效。

秘密网络与成员： 默认情况下，自定义网络是秘密的（只有所有者、OP 和成员可以看到）。

  • /waystone network settings secret (网络名) true/false - 切换秘密模式（false = 公开）
  • /waystone network member add (网络名) (玩家名) - 添加成员
  • /waystone network member remove (网络名) (玩家名) - 移除成员
  • /waystone network member list (网络名) - 列出成员

设置：

  • /waystone network settings discovery (网络名) (true/false/inherit) - 覆盖全局探索设置
    • true：强制启用（即使全局关闭）
    • false：强制禁用（即使全局开启）
    • inherit：使用全局设置（默认）
  • /waystone network settings cooldown (网络名) (秒数) - 设置冷却时间（0 = 使用全局设置）
  • /waystone network settings seeglobal (网络名) true/false - 是否可查看全局传送石
  • /waystone network settings priceadd (网络名) (数量) - 添加费用（手持物品）
  • /waystone network settings pricedelete (网络名) - 移除费用（手持物品）
  • /waystone network settings priceclear (网络名) - 清除所有费用
  • /waystone network settings pricelist (网络名) - 列出费用

示例：

/waystone network create dungeons
/waystone network settings discovery dungeons true
/waystone network settings cooldown dungeons 120

注意： 网络默认处于禁用状态。所有传送石共享一个全局网络。

💰 传送费用

服务器管理员可以要求物品来进行传送：

命令 描述
/waystone price add (数量) 手持物品，运行命令以添加为费用
/waystone price delete 手持要移除的物品以从费用中移除
/waystone price list 查看所有需要的物品
/waystone price clear 移除所有费用

示例： 想让传送花费 1 个金锭和 2 个铜锭？手持金锭，运行 /waystone price add 1。手持铜锭，运行 /waystone price add 2。

💵 货币费用（VaultUnlocked）

如果安装了 VaultUnlocked，你可以使用货币而不是物品：

命令 描述
/waystone currency set (金额) [类型] 设置货币费用（例如，100 金币）
/waystone currency remove 移除货币费用
/waystone currency info 查看当前定价

注意： 货币和物品费用是互斥的。当设置了货币费用时，物品价格命令将被禁用。使用 /waystone currency remove 切换回物品费用。

示例： /waystone currency set 50 - 传送花费 50 货币。

⏱️ 冷却时间

使用冷却时间防止传送滥用：

/waystone cooldown 30 - 玩家在两次传送之间必须等待 30 秒

示例： 设置 /waystone cooldown 60 以获得 1 分钟的冷却时间。

📊 服务器与玩家限制

控制可以存在的传送石数量：

命令 描述
/waystone limit 100 整个服务器最多 100 块传送石
/waystone limit -1 全服务器无限制
/waystone playerlimit 5 每位玩家最多拥有 5 块传送石
/waystone playerlimit -1 每位玩家无限制

示例： 运行 /waystone playerlimit 3 以便每位玩家只能放置 3 块传送石。

📖 命令参考

玩家命令

命令 描述
/waystone friend add (玩家名) 添加好友
/waystone friend remove (玩家名) 移除好友
/waystone friend list 列出所有好友
   

OP 命令

命令 描述
/waystone limit (限制数) 设置全服务器传送石限制
/waystone playerlimit (限制数) 设置每位玩家传送石限制
/waystone cooldown (秒数) 设置传送冷却时间
/waystone discovery 切换探索系统
/waystone permission 切换权限系统
/waystone price add (数量) 将手持物品添加为传送费用
/waystone price delete 从费用中移除手持物品
/waystone price list 显示所有传送费用
/waystone price clear 移除所有传送费用
/waystone currency set (金额) [类型] 设置货币费用（VaultUnlocked）
/waystone currency remove 移除货币费用
/waystone currency info 查看当前定价
/waystone cleanup 移除已删除世界中的传送石
/waystone network toggle 切换网络系统
/waystone network create (名称) 创建一个新网络
/waystone network delete (名称) 删除一个网络
/waystone network list 列出所有网络
/waystone network info (名称) 显示网络详情
/waystone mapMarker [enable/disable] 切换地图标记可见性
/waystone customtp 切换自定义传送位置 UI

📁 数据文件

所有数据以 JSON 格式存储在插件的 data 文件夹中：

文件 用途
config.json 服务器设置（限制、冷却、探索）
waystones/waystones.json 所有传送石数据（名称、位置、所有者、可见性）
cooldowns.json 玩家传送冷却计时器
friends.json 好友关系
discoveries.json 哪些玩家发现了哪些传送石
networks/networks.json 网络定义和设置

🔐 权限系统（高级）

权限系统默认是禁用的。 每个人都可以自由使用传送石。

要启用权限，必须由 OP 运行：

/waystone permission

启用后，玩家需要特定的权限才能使用传送石功能。权限通过 Hytale 内置的 /perm 命令进行管理。

权限字符串

权限 描述
hytale.command.waystone.place 放置传送石
hytale.command.waystone.break 破坏传送石
hytale.command.waystone.use 使用传送石（传送）
hytale.command.waystone.friends 添加/移除好友
hytale.command.waystone.cmd.limit 使用 /waystone limit 命令
hytale.command.waystone.cmd.playerlimit 使用 /waystone playerlimit 命令
hytale.command.waystone.cmd.price 使用 /waystone price 命令
hytale.command.waystone.cmd.cooldown 使用 /waystone cooldown 命令
hytale.command.waystone.cmd.discovery 使用 /waystone discovery 命令
hytale.command.waystone.cmd.cleanup 使用 /waystone cleanup 命令
hytale.command.waystone.network.create 创建网络
hytale.command.waystone.network.manage 编辑/删除任何网络
hytale.command.waystone.network.assign 将传送石分配到网络
hytale.command.waystone.cmd.customtp 使用 /waystone customtp 命令

注意： 重命名和可见性设置是在传送石 UI 中处理的，并且只有所有者或 OP 可用。

通配符

权限 描述
hytale.command.waystone.* 所有传送石权限
hytale.command.waystone.cmd.* 所有 OP 命令

示例

 

给予玩家放置传送石的权限：

/perm user add (玩家UUID) hytale.command.waystone.place

给予 OP 组所有传送石权限：

/perm group add OP hytale.command.waystone.*

给予版主所有 OP 命令：

/perm group add moderator hytale.command.waystone.cmd.*

移除玩家的传送权限：

/perm user remove (玩家UUID) hytale.command.waystone.use

🎮 传送浆果

制作传送浆果即可在不使用传送石的情况下传送！一旦消耗，传送浆果可以从任何地方打开传送石菜单。

你也可以直接从世界地图使用传送浆果：

  1. 右键点击一个传送石标记。
  2. 选择“使用传送浆果”。
  3. 消耗 1 颗传送浆果并立即将你传送（绕过费用）。

配方： 10 颗红浆果 + 1 虚空精华 = 传送浆果（在生存工作台制作）

💡 提示与最佳实践

  • 给你传送石起一个描述性的名字 - “村庄市场”比“传送石1”更好
  • 使用网络进行组织 - 分隔城镇、地牢和玩家基地
  • 为冒险启用探索 - 让探索更有回报
  • 设置合理的冷却时间 - 在防止滥用的同时保持旅行便利
  • 使用好友功能保护隐私 - 仅与信任的玩家分享秘密基地

 

鸣谢：

San：传送石模型/纹理 + 传送浆果模型/纹理

Kappajaponais：橡木版本模型/纹理