Мод для Майнкрафт на Fabric, который отслеживает выражение лица через веб-камеру и показывает его на лице персонажа. Для работы нужен отдельный Java-клиент: он обрабатывает видео локально и передаёт в игру только данные о выражении.
Возможности
- Распознаёт нейтральное выражение, радость, грусть, удивление, разговор, моргание, подмигивание и сосредоточенность.
- Показывает наложение на лице игрока и синхронизирует выражение с другими игроками на сервере с модом.
- Поддерживает собственные текстуры лица размером 8×8 в формате PNG.
- Может показывать локальный предпросмотр лица в интерфейсе.
- Видео с веб-камеры не отправляется на сервер: по сети передаются состояние выражения и небольшие PNG-текстуры.
Как пользоваться
Установите мод на клиент и сервер, затем запустите входящий в комплект клиент из корня проекта командой ./gradlew -p client run; в Windows используйте .\gradlew.bat -p client run. В приложении включите камеру.
На обычном сервере без мода наложение лица видно только вам. Чтобы другие игроки видели выражение и ваши текстуры, мод должен быть у сервера и у клиентов.
Настройки
Текстуры выражений находятся в run/expressions/. Поддерживаются файлы base.png, neutral.png, happy.png, sad.png, surprised.png, talking.png, blinking.png, winking.png и focused.png; каждый должен иметь размер 8×8. Прозрачные пиксели в текстуре выражения показывают слой base.png, а прозрачность в base.png — лицо исходного скина.
Для отдельных слоёв рта, глаз и бровей создайте папку run/expressions/parts/.
Предпросмотр в интерфейсе включается командами:
/facetrack hud onи/facetrack hud off/facetrack hud status/facetrack hud corner top_right/facetrack hud corner top_left/facetrack hud corner bottom_right/facetrack hud corner bottom_left/facetrack hud offset 8 8/facetrack hud scale 6
Положение, отступ и масштаб предпросмотра сохраняются в run/config/facetrackermod-client.properties. Команда /facetrack status показывает состояние синхронизации с сервером.
Требования и совместимость
Нужны Fabric Loader, Fabric API, Java 21, веб-камера и входящее в комплект приложение из папки ./client. Точность распознавания зависит от освещения, положения камеры и калибровки; для калибровки держите лицо хорошо видимым и сохраняйте нейтральное выражение.
