Minecraft Story Mod

--- <summary>🇷🇺 Описание на русском</summary> # 🎭 Minecraft Story Mod by ErrorGhostX **Minecraft Story Mod by ErrorGhostX** — это мод, вдохновленный Minecraft Story Mode S1/2, который пытается перенести неповторимую атмосферу той самой игры в оригинальный Майнкрафт! > ⚠️ **ВНИМАНИЕ (БЕТА):** Мод находится на стадии ранней беты. Многие функции всё ещё находятся в активной разработке! --- <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/sp-ooQI_iNI" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/7K-sBUp0SmY" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> ## ✨ Возможности ### 🗣️ Лицевые анимации и микрофон (PlasmoVoice & Simple Voice Chat) Мод полностью преображает лица игроков, добавляя анимированные 3D-головы. Но мы не ограничились базовыми эмоциями! - **Как это работает:** Мод глубоко интегрируется с **PlasmoVoice** (а также SVC). Интерцепторы захватывают звук из вашего микрофона напрямую (PCM-семплы) в реальном времени. Мод анализирует звук и генерирует правильную форму рта (визему). В итоге ваш персонаж физически открывает рот точно под вашу речь! ### 🌐 Передача данных "ProxLib" на ванильных серверах Играете на ванильном сервере, куда нельзя поставить этот мод? Не беда. - **Как это работает:** Мы попытались внедрить протокол передачи данных на основе **ProxLib**. Если мода нет на сервере, клиенты используют "проксимити" каналы ProxLib для обмена данными напрямую. Если у вас и ваших друзей установлен мод на клиенте, вы всё равно будете видеть мимику и синхронизацию губ друг друга даже на обычных ванильных серверах! ### 🧩 Меню кастомизации Вы больше не привязаны к одному стандартному образу! - **Как использовать:** Нажмите **`C`** в игре, чтобы открыть экран кастомизации. - Там вас ждет интерфейс в стиле MCSM. Вы можете независимо выбирать форму головы, прическу, шапку, цвет кожи и одежду. Соберите своего уникального аватара, и сервер мгновенно синхронизирует его для остальных игроков. !(https://cdn.modrinth.com/data/cached_images/3c75cf3d9cf8045b3f3058b98d563e8b2cc554ef_0.webp) ** ### 🧠 Меню эмоций Выражайте чувства без слов! - **Как использовать:** Нажмите **`O`** в игре, чтобы открыть круговое меню эмоций. - Вам доступны 12 уникальных эмоций (Радость, Грусть, Злость, Удивление, Смех, Боль и т.д.). В центре меню также есть кнопка-переключатель, с помощью которой можно быстро включить или выключить отображение вашей 3D-головы. !(https://cdn.modrinth.com/data/cached_images/93775a6eecf245e89b6b2ce133dcc2a056a3184a_0.webp) *Круговое меню эмоций на 12 кнопок с переключателем в центре]* ### 🤖 Мобы из Story Mode (В разработке) В игре появятся мобы из Story Mode (Джесси, Петра), которые бродят по миру. - **Текущее состояние:** Мобы спавнятся с динамическим **настроением** и **эмоциями**, реагируют на урон и друзей. Добавлена базовая система **репутации** (если ударить моба — репутация упадет). - *Примечание:* Продвинутые механики, такие как подбор предметов с земли, надевание брони и поедание еды, запланированы, **но еще вообще не реализованы в текущей бете**. !(https://cdn.modrinth.com/data/cached_images/2364dd76f88bf30e87771fa023647736b956f164.png) ** --- ## ⚙️ Техническая часть - **OBJ Модели:** Мод использует кастомные 3D-модели в формате **OBJ** для рендера голов. Это позволяет плавно интерполировать и изменять геометрию лица (mesh) под разные выражения без жесткой покадровой анимации. - **Анализ голоса:** Мы перехватываем сырые аудио-фреймы (PCM 16-bit 48kHz) из микрофона через PlasmoVoice/SVC и вычисляем громкость и частоты «на лету», чтобы сгенерировать точные виземы (формы губ). - **P2P Сеть:** Использование библиотеки `ProxLib` позволяет упаковывать виземы и эмоции в компактные байты-пайлоады и передавать их между клиентами напрямую в радиусе видимости (proximity). Это работает даже на серверах без плагина! ## 🎭 Таблица эмоций | Эмоция | Что делает | |--------|------------| | **Нейтрал** | Стандартное лицо | | **Радость** | Улыбка, приподнятые брови | | **Грусть** | Опущенные брови, печальный вид | | **Злость** | Хмурый вид, агрессивный взгляд | | **Удивление**| Открытый рот, широкие глаза | | **Страх** | Дрожащий взгляд (трясущиеся глаза) | | **Боль** | Персонаж морщится | | **Решимость**| Сосредоточенный, серьезный взгляд | | **Говорит** | Анимация движения губ под голос | | *А также: Смех, Замешательство, Ухмылка!* | ## 🗺️ Планы на будущее (Roadmap) | Фича | Статус | Приоритет | |---------|--------|----------| | 3D Лицевые анимации | ✅ Готово | В