Scar Voice Phones

ScarVoicePhones — 适用于 Hytale 的功能性电话、手机和群组通话

放置电话。携带手机。呼叫任何人。通过它们进行 3D 通话。 一个完整的 Hytale 游戏内电话系统，具备真实语音聊天、3D 定位音频、响铃动画、联系人、群组通话、手机和精致的游戏内 UI。

ScarVoicePhones 3.1.0

📱 新功能

🎒 物品轮盘支持

手机现在可以存放在 Z 物品轮盘 中，使其更容易访问，也更难丢失。

💬 私信

私信功能终于来了！

• 聊天现在与你的 角色 相关联，而不是你的手机。
• 即使你更换设备，你的对话也会保留。
• 包含消息和通知音效。

我们也在探索未来将通话转移到基于角色的系统上。

---

⚠️ 已知问题

📜 消息顺序

由于 Hytale 当前滚动系统的限制，消息目前以相反顺序显示。

我们预计在 更新 6 中改进此问题。

🔕 更多功能即将推出

我们仍在努力开发：

• 更好的“请勿打扰”选项。
• 用户屏蔽。
• 改进的通知管理。

---

🛠️ 改进

• 修复了各种 Bug。
• 整体稳定性提升。
• 持续的优化和完善。

---

🚀 下一步计划？

未来的更新可能包含：

• 📲 应用程序（Apps）。
• 📢 公告板。
• ❤️ 社交和交友功能。
• 更多社区请求的增添内容。

感谢支持 ScarVoicePhones！❤️

---

📞 什么是 ScarVoicePhones？

ScarVoicePhones 将 Hytale 的近距离语音聊天转变为一个完整的 电话网络。你可以：

• 🏠 放置电话方块（“座机”），用诸如 Home 或 Shop 之类的名字注册它们，然后从服务器任何地方呼叫它们。
• 📱 制作一部手机，它存在于你的物品栏中，拥有自己的号码、联系人和铃声，让你可以随时随地接听电话。
• 👥 发起群组通话，最多支持 8 部电话（可以混合搭配方块和手机），让整个团队可以同时通话。

当通话连接后，引擎会 从目标电话以 3D 形式 播放你的声音：任何站在附近的人都能听到你、加入或偷听。你的手机 响铃，你走向它，接起，然后通话。无需聊天命令，无需虚假的电话系统。

---

🎬 视频展示

📺 原版 v2 预告片：

📺 原版 v1 演示（西班牙语）：

---

✨ 功能特性

🔊 通过电话进行真实语音聊天

• 3D 定位音频 — 声音从目标电话（方块或手机支架）发出。走得更近听得更清楚，走远则声音逐渐消失。
• 免提设计 — 附近的任何人都能听到对话，就像真正的免提电话一样。
• 可配置范围 — 每部电话的语音拾取范围（默认 8 格）和音频广播范围（默认 16 格）。
• 引擎级路由 — 该模组接入 Hytale 的语音管道并重写语音包的发声者位置，让引擎本身处理所有 3D 衰减和声像定位。

🏠 电话方块（座机）

• 可制作和放置，带有自定义 3D 模型。
• 注册 一个唯一的名字（你的电话号码）并选择 公开、私人 或 仅联系人 模式。
• 电话目录 — 清晰、可滚动的所有电话列表，支持 搜索、A-Z / Z-A 排序，以及 全部 / 收藏 ⭐ / 最近 标签页。
• 状态指示器 — 空闲 🟢、通话中 🔴、响铃中 🟡、请勿打扰 🟠。
• 智能清理 — 破坏方块会自动挂断通话、停止铃声并注销电话。

📱 手机（新功能）

• 可制作的物品，拥有自己的模型、手持动画和铃声。
• 每件物品独立标识 — 名称、所有者 UUID 和所有者姓名存储在物品元数据中，因此手机在死亡、交易和重启后仍能保持其身份。
• 注册 / 重命名 / 注销 / 转移所有权 而不会丢失你的联系人。
• 个人联系人列表 和 静音列表 存储在手机上（每项最多 50 个）。
• 最近通话 每位玩家均有记录。
• 动态提示框，直接在物品栏中显示手机名称和所有者（由 DynamicTooltipsLib 提供支持，可选依赖）。
• 断开连接时清理 — 当持有者登出时，通话和响铃会自动停止。

👥 群组通话（新功能）

• 从 手机 或 电话方块 发起多方通话。
• 每部已连接的电话都成为一个中继节点——在任一部电话附近说话，所有已连接的人都会从他们自己的电话中听到。
• 可配置参与人数（默认 8 人）。
• 混合搭配：方块对方块、手机对手机，或任意组合。
• 每位参与者可以独立离开 / 挂断。

📞 通话系统

• 带动画的响铃 — 目标电话方块播放响铃动画和 3D 铃声；手机播放自己的铃声。
• 呼叫音 — 呼叫者在等待时，从自己电话听到 3D “呼叫”音。
• 接听或拒绝 — 接听方看到来电界面，包含接听 / 拒绝按钮。
• 取消 — 呼叫者可以随时取消外拨电话。
• 挂断 — 从 UI 结束活跃通话，或直接破坏方块。
• 响铃超时 — 未接听的电话会在可配置的超时时间（默认 30 秒）后自动取消，并记录为未接来电。
• 通话冷却 — 防止骚扰电话（默认通话间隔 5 秒）。

🔒 隐私与安全

• 公开 / 私人 / 仅联系人 模式。
• 联系人白名单（最多 50 个）每部电话。
• 静音 / 屏蔽玩家（最多 50 个）每部电话。
• 请勿打扰（DND） — 静音所有来电；呼叫者会看到 DND 警告。
• 仅所有者设置 — 只有电话所有者才能访问设置、联系人和历史记录（可配置）。

📋 通话历史与未接来电

• 持久化通话历史 — 每部电话最近 20 次通话，包含方向（呼入/呼出）、状态、持续时间和时间戳。
• 未接来电通知 — 打开手机时显示带计数器的红色横幅。
• 颜色编码状态 — 已完成 ✅、未接 ❌、已取消 ⚪。

⭐ 收藏与最近通话

• 加星 任何电话以将其添加到收藏标签页，以便快速访问。
• 最近通话 自动追踪你最近呼叫过的电话（最多 10 个）。
• 两者均为 每位玩家独立，并在会话间持续存在。

🔨 合成

• 电话方块和手机都有 默认合成配方，在工作台合成。
• 完全可自定义 — 服务器所有者可以通过 RecipeConfig.json 覆盖材料、制作时间、工作台类型和输出数量。
• 如果你只想放置管理员放置的电话，配方也可以 完全禁用。

🧹 智能清理无处不在

• 破坏电话方块会挂断其通话、停止铃声并注销它。
• 重命名或注销电话会自动清理所有玩家的收藏和最近通话。
• 玩家在通话中断开连接会干净地结束双方的通话。

---

⚙️ 服务器配置

所有设置位于 VoicePhones.json（首次运行时自动生成）：

设置	默认值	描述
DefaultPhoneMode	PUBLIC	新电话的默认可见性模式
MaxPhoneNameLength	20	电话名称的最大字符数
MaxContactsPerPhone	50	每部电话最大的白名单条目数
MaxMutedPerPhone	50	每部电话最大的已屏蔽玩家数
MaxRecentsPerPlayer	10	每位玩家存储的最大最近通话数
VoiceRange	8	电话附近语音拾取半径（方块）
PhoneAudioRange	16	电话语音广播半径（方块）
RingTimeoutSeconds	30	未接听电话在 X 秒后自动取消
MaxPhonesPerPlayer	-1	每位玩家最大电话数（-1 = 无限制）
AllowRenaming	true	玩家可以重命名其电话
AllowUnregister	true	玩家可以注销其电话
RequireOwnerForSettings	true	限制设置/联系人/通话历史仅限电话所有者操作
CallCooldownSeconds	5	同一部电话两次通话之间的最小间隔秒数
MaxGroupCallSize	8	群组通话中最大同时通话电话数
Debug	false	详细的日志输出

合成配方有自己的配置文件（RecipeConfig.json）。

---

🛠️ 管理员命令

命令	描述
/phone list	列出所有已注册的电话、位置和活跃通话
/phone status	系统状态：电话数量、活跃通话、语音拦截器状态
/phone hangup	强制挂断服务器上所有活跃通话
/phone clearall	注销所有电话并结束所有通话（完全重置）

---

📦 安装

1. 下载 .jar 文件。
2. 将其放置在你的服务器的 mods/ 文件夹中。
3. （可选） 为了获得更丰富的手机工具提示，也请安装 ** DynamicTooltipsLib **。
4. 启动服务器 — VoicePhones.json 会在首次运行时自动生成。
5. 根据需要调整配置，然后重启。
6. 制作一个电话方块或手机，注册它，然后开始打电话吧！

要求

• Hytale
• 可选： DynamicTooltipsLib

---

🌐 测试地点

ScarVoicePhones 正在 Hub Social 服务器上积极开发和测试：

🔗 ** https://www.elhubsocial.net/ **  •  📡 IP: elhubsocial.net

我的许多模组在公开发布前都在那里经过了实战测试。欢迎来玩！

---

💡 计划功能

• 电话皮肤 / 颜色变体
• 方块上显示来电 ID
• SMS / 文本消息
• 带应用（Apps）的智能手机
• 答录机 / 语音邮件

有建议？请在评论区提出！

---

🙏 鸣谢

模组作者： ScarForges 测试于： El Hub Social

可选集成： DynamicTooltipsLib 作者 Herolias

如果你喜欢这个模组，点个赞或收藏会很有帮助。❤️

---

ScarVoicePhones v2.1.0 — 为 Hytale 构建