Ping

Ping - Hytale 定位标记插件

Ping 是一款 Hytale 服务器插件，允许玩家标记和突出显示世界中的位置，通过向队友展示你正在查看的精确位置来简化团队沟通。

为什么选择 Ping？

该插件旨在简化 Hytale 多人服务器中的协调与通信。它通过视觉和音频反馈来标记位置，帮助团队更高效地协作。在我从 Arc Raiders 转过来后，我怀念了鼠标中键的标记功能，因此决定创建这个插件，将这一功能带到 Hytale。

功能

• 视觉标记系统：在你所看向的任意位置创建视觉标记
• 粒子效果：在标记位置显示可自定义的粒子效果
• 声音反馈：创建标记时播放音频提示
• 射线检测：智能射线检测以定位目标位置（最远可达 x 格）
• 可配置设置：完全控制标记外观、声音和行为
• 调试模式：内置调试工具，便于开发和排查问题
• 智能距离检测：最小距离要求确保正常的拾取交互正常工作

使用方法

要创建标记，只需看向目标位置并执行“拾取”交互（默认按键：鼠标中键）。

注意：插件有最小距离要求。近距离的拾取交互不会创建标记，允许正常的方块/物品拾取按游戏原本设计运行。

安装

1. 从 CurseForge 或 GitHub Releases 下载最新的 .jar 文件
2. 将 jar 文件放入 Hytale 服务器的 mods/ 目录
3. 重新启动服务器
4. 插件将在首次运行时自动生成 PingConfig.json 文件

配置

插件会创建一个包含可自定义选项的 PingConfig.json 文件：

关键设置

• ParticleEffect：更改视觉效果（默认：Shield_Block）
• SoundEvent：自定义标记声音（默认：SFX_Crystal_Break）
• DurationSeconds：标记保持可见的时间（默认：10 秒）
• MaxDistance：最大检测范围（默认：500 格）
• DebugMode：启用详细日志记录以进行故障排除

有关完整的配置选项列表，请访问 GitHub 仓库。

支持与源代码

• GitHub：https://github.com/zbejas/Ping
• 问题反馈：https://github.com/zbejas/Ping/issues

故障排除

如果标记不显示或声音不播放，请尝试：

1. 在配置文件中启用 DebugMode
2. 验证粒子和声音效果名称是否有效
3. 确保你处于粒子范围内且超出最小距离（游戏不显示远处的粒子）
4. 检查服务器日志中的错误信息

如需更多帮助，请在 GitHub 上提交问题或查看仓库中的完整 README。