FiguraSVC

FiguraSVC - это неофициальный аддон для мода Figura, который связывает его с Simple Voice Chat. Благодаря этому скрипты на Lua могут в реальном времени отслеживать, когда игрок говорит в микрофон, и запускать соответствующие анимации, звуковые эффекты или другие реакции.

Зачем это нужно? В Майнкрафте с Simple Voice Chat голосовой чат стал почти стандартом на серверах. Figura позволяет создавать кастомные модели и анимации для игроков. Но без FiguraSVC модель никак не реагирует на то, что персонаж говорит. С этим аддоном ты можешь сделать так, чтобы рот модели открывался в такт голосу, или показывать иконку "говорит" над головой. Всё это происходит автоматически, когда игрок говорит в микрофон.

Как это работает

Аддон передаёт состояние микрофона в Lua-скрипты через специальные события и пинги. Скрипт может узнать, говорил ли игрок в последние пару тиков, и реагировать соответственно. Всё безопасно для сервера - данные о микрофоне не передаются другим игрокам, если не использовать соответствующие пинги.

Пример скрипта

Вот простой пример, который заставляет модель открывать рот, когда игрок говорит:

-- Пример анимации разговора
local microphoneOffTime = 0
local isMicrophoneOn = false

function pings.talking(state)
    -- (безопасно на серверах) (видно всем)
    animations.model.talk:setPlaying(state)
end

function events.tick()
    local previousMicState = isMicrophoneOn

    microphoneOffTime = microphoneOffTime + 1
    isMicrophoneOn = microphoneOffTime <= 2 -- svc.microphone вызывался в последние 2 тика?

    if previousMicState ~= isMicrophoneOn then
        pings.talking(isMicrophoneOn)
    end
end

if client:isModLoaded("figurasvc") and host:isHost() then
    function events.HOST_MICROPHONE(pcm)
        microph
    end
end

Комментарии в коде переведены для удобства. Обрати внимание: событие HOST_MICROPHONE срабатывает только у хост-игрока (в одиночке или на LAN), а пинг talking отправляется всем, кто видит модель. Это позволяет создать анимацию, которую будут видеть другие игроки.

Совместимость и установка

• Требует установленные Figura и Simple Voice Chat.
• Работает на Fabric и Forge (зависит от версий Figura и SVC).
• Просто положи .jar в папку mods.

Важно знать

• Аддон не добавляет графического интерфейса - всё настраивается через Lua-скрипты.
• Документация пока в разработке, но пример выше даёт понимание.
• Если ты создаёшь кастомные модели для Майнкрафта и хочешь добавить им реалистичную анимацию рта под голос - FiguraSVC то, что нужно.

Скачайте FiguraSVC и сделайте своих персонажей живыми!