艾莉的路径石

奥术传送石 0.4.3 版

适用于 Hytale 服务器的快速旅行系统。

默认情况下，玩家可以制作并放置传送石雕像于世界各处，为其命名，并瞬间在它们之间传送。我们提供了多种配置供您自由调整。

热修复 - 1月24日修复 LuckPerms 导致玩家被踢出/崩溃的问题

---

问答

1. 玩家需要发现传送石吗？

默认不需要，所有公开传送石均可从其他传送石访问。但通过配置文件或服务器指令 /waystones config requireDiscover true，您可以要求玩家必须先与传送石互动一次。

2. 如何配置我的传送石？

玩家/传送石所有者可以编辑他们的传送石。此外，还有多种命令可用于设置管理权限。我们主要使用 Hytale 自带的权限系统，采用 /perm user add ... 结构。请参阅下方关于我们权限设置的文档。

3. 我可以限制玩家创建的传送石数量吗？

是的！使用权限 hytale.command.waystones.maxWaystones.X，其中 X 代表数量。例如，/perm user add <uuid> hytale.command.waystones.maxWaystones.3 将该玩家限制为 3 个传送石。如果玩家拥有多个限制值，将采用最高值。OP 管理员完全不受此限制。

4. 什么是服务器拥有的传送石？

管理员可以在设置中将任何传送石标记为"服务器拥有"。这些传送石在列表中不会显示所有者名称，并且只能由 OP 管理员破坏。非常适合出生点或公共地标。

---

安装

1. 从发布区下载最新的 .jar 文件
2. 将其放入服务器（或 Hytale）的 mods 文件夹中
3. 重启服务器
4. 插件将自动创建其数据文件

---

权限快速参考

（详细信息请参阅权限部分）

权限	描述
hytale.command.waystones.allowListMenu	访问 /waystones list 命令
hytale.command.waystones.allowEditAll	编辑任何传送石的设置
hytale.command.waystones.allowSeeAllPrivate	查看并传送到所有私有传送石
hytale.command.waystones.allowPrivateWaystoneRemoval	破坏他人拥有的私有传送石
hytale.command.waystones.allowShowUndiscovered	无需发现即可查看所有传送石
hytale.command.waystones.blockWaystonePlacement	阻止放置传送石
hytale.command.waystones.blockWaystoneRemoval	阻止破坏传送石
hytale.command.waystones.blockPublicWaystoneCreation	强制新传送石设为私有
hytale.command.waystones.maxWaystones.X	将玩家限制为 X 个传送石

注意： OP 管理员无视所有限制。

---

默认体验

开箱即用，玩家可以执行以下操作：

制作传送石

传送石在精细工作台使用以下材料制作：

• 10x 岩石
• 1x 虚空之心

放置与命名

1. 将传送石块放置在世界任意位置
2. 右键点击打开命名对话框
3. 输入传送石名称并确认
4. 您的传送石现已注册并可以使用！

使用传送石

1. 右键点击任意传送石以打开传送菜单
2. 您将看到两个列表 - 公共传送石（对所有玩家可见）和 私有传送石（仅自己可见）
3. 点击一个目标即可瞬间传送到达
4. 横幅会宣布您已到达目的地

破坏传送石

• 玩家可以随时破坏自己的传送石
• 破坏会将其从传送网络中移除
• 服务器拥有的传送石只能由 OP 管理员破坏

---

传送石设置

所有者可以使用以下选项自定义他们的传送石：

设置	描述
名称	在传送列表中显示的显示名称
可见性	公共（所有人可见）或私有（仅自己可见）
传送方向	玩家出现在雕像的哪一侧（北/南/东/西）
玩家朝向	传送后玩家的面朝方向（远离雕像或朝向雕像）
颜色	传送石的视觉风格（蓝色、红色或绿色）

---

传送石颜色

传送石有三种视觉风格：

颜色	描述
默认（蓝色）	标准青色发光并带有蓝色火焰粒子
红色	温暖的红色发光并带有火焰粒子
绿色	自然主题的绿色发光并带有绿色火焰粒子

玩家可以在设置菜单中更改其传送石的颜色。颜色纯粹是装饰性的，不影响功能。

---

命令

命令	描述
/waystones list	无需站在传送石旁即可打开传送石列表（需要 allowListMenu 权限）
/waystones edit "<名称>" <属性> <值>	编辑传送石属性（需要 allowEditAll 权限）
/waystones config <属性> <值>	编辑插件配置（仅限 OP 管理员）

编辑命令示例

/waystones edit "Spawn" name "Server Spawn"
/waystones edit "My Base" isPublic true
/waystones edit "Hub" color red
/waystones edit "Tower" teleportDirection north
/waystones edit "Market" serverOwned true
/waystones edit "Spawn" defaultDiscovered true

可编辑属性： name, isPublic, priority, textColor, teleportDirection, playerOrientation, serverOwned, ownerName, ownerUuid, defaultDiscovered, color

---

配置选项

插件将配置存储在您世界的 waystones.json 文件中。您可以通过命令修改设置：

命令	描述
/waystones config debugLogs true	启用调试日志（有助于排查问题）
/waystones config debugLogs false	禁用调试日志
/waystones config requireDiscover true	启用发现系统
/waystones config requireDiscover false	禁用发现系统

---

发现系统

当发现功能启用时：

• 玩家必须亲自到访一个传送石后，才能在列表中看到它
• 这鼓励探索——玩家必须先找到传送石才能传送到那里
• 服务器管理员可以将特定传送石标记为"默认已发现"，这样即使未到访，所有玩家也能看到
• 使用 /waystones edit "Spawn" defaultDiscovered true 使一个传送石始终可见

---

常见服务器设置

公共服务器（侧重探索）

启用发现功能并将出生点标记为始终可见：

/waystones config requireDiscover true
/waystones edit "Spawn" defaultDiscovered true
/waystones edit "Spawn" serverOwned true

生存服务器（限制传送石）

将玩家限制为少量个人传送石：

/perm group add Survivors hytale.command.waystones.maxWaystones.3

VIP 玩家可以获得更多：

/perm group add VIP hytale.command.waystones.maxWaystones.10

私人服务器（完全访问）

无需配置——默认设置非常适合所有人互相信任的私人服务器。

角色扮演服务器（无公共传送石）

强制所有玩家传送石设为私有：

/perm group add Players hytale.command.waystones.blockPublicWaystoneCreation

只有管理员可以为重要地点创建公共传送石。

---

数据存储

所有传送石数据都存储在您的世界文件夹中：

• waystones.json - 所有传送石数据和配置
• waystones-players.json - 玩家发现数据（当发现功能启用时）

这些文件在发生更改时会自动保存。

---

故障排除

传送石未出现在列表中

• 检查是否启用了发现功能——您可能需要先去访问它
• 检查它是否属于其他人的私有传送石
• 确认您有权限查看它

无法破坏传送石

• 服务器拥有的传送石需要 OP 管理员权限才能破坏
• 检查您是否拥有 blockWaystoneRemoval 权限
• 破坏他人拥有的私有传送石需要 allowPrivateWaystoneRemoval 权限

颜色未改变

• 确保您在更改颜色后保存了设置
• 服务器可能需要一些时间来更新世界中的方块
• 尝试离开传送石再返回

调试日志

启用调试日志以查看详细信息：

/waystones config debugLogs true

检查您的服务器控制台，查找前缀为 [Waystone] 的消息。

---

致谢

由 AllieF 创建，材质和测试由 TheRogueLady 完成。