真实面部表情

伴侣应用（用于游戏可选，面部表情必需）

真实面部表情使用一个伴侣应用来实时追踪你的面部表情。

伴侣应用现在可以接收来自 VTube Studio 的追踪数据！

使用伴侣应用： 面部表情会通过网络摄像头实时映射到你的角色上。

不使用伴侣应用： 你仍然可以正常游玩游戏，但面部动画不会被映射。相反，将播放默认的 Hytale 空闲动画。

在此下载伴侣应用：真实面部表情伴侣应用

注意：伴侣应用仅传输面部混合形状数据以及推导出的眼睛注视方向。没有任何其他视频或图像数据会离开你的电脑。

免责声明

• 真实面部表情使用一个伴侣应用向服务器发送数据。连接字段应保持私密。尽量不要泄露它们，否则你至少需要使用 /rfe resetFaceId 重置你的 faceId。
• 极有可能与其他玩家动画插件存在冲突，特别是那些修改 Server/Models/Human/Player.json 的插件。

许可证

该项目当前采用“保留所有权利”许可证。我计划在进一步研究更多许可证选项后重新审视这一点。

安装指南

普通用户

快速教程在此：安装教程 + 技巧与窍门

1. 如果是单人游戏，将模组安装并激活到你的世界文件夹中。
2. 使用安装程序安装伴侣应用：真实面部表情伴侣应用。
3. 在 Hytale 中连接到目标服务器。
4. 在游戏中运行 /rfe faceId，并将生成的 ID 复制到伴侣应用中。
5. 在伴侣应用中输入服务器 IP 和端口。默认端口是 25590。注意：你的 faceId 不应改变，所以只需执行一次此操作。
6. 一旦切回游戏，你的表情就应该会被映射到你的角色上。

VTube Studio 用户

1. 遵循普通用户指南。
2. 遵循此设置教程：教程

服务器所有者

1. 安装插件。
2. 向你的玩家开放已配置的 UDP 端口。

当前开发路线图（可能变更）

• 为伴侣应用添加多个服务器的配置文件，以及一些通用的 UI 改进。
• 添加通过按键绑定切换表情的功能。
• 更多视频教程。

长期目标与当前阻碍

• 更多动画。更多动画。主要阻碍是 Hytale 动画系统的当前状态。据我所知，Hytale 不支持在同一动画槽中同时播放多个动画。为了解决这个问题，9 个注视方向动画、5 个眉毛动画、6 个眼睑动画（每只眼睛 3 个）和 5 个嘴巴动画通过脚本组合成代表每种可能状态的独特动画。这产生了 2,025 个生成的动画。由于每增加一个动画都会大幅增加这个数量，因此在动画系统得到彻底改进之前，没有计划添加更多动画。
• 让玩家能够定义自定义动画触发器。目标是允许有趣的映射，例如当玩家眨眼时触发角抖动动画。