---

🇷🇺 Описание на русском

🎭 Minecraft Story Mod by ErrorGhostX

Minecraft Story Mod by ErrorGhostX — это мод, вдохновленный Minecraft Story Mode S1/2, который пытается перенести неповторимую атмосферу той самой игры в оригинальный Майнкрафт!

⚠️ ВНИМАНИЕ (БЕТА): Мод находится на стадии ранней беты. Многие функции всё ещё находятся в активной разработке!

---

✨ Возможности

🗣️ Лицевые анимации и микрофон (PlasmoVoice & Simple Voice Chat)

Мод полностью преображает лица игроков, добавляя анимированные 3D-головы. Но мы не ограничились базовыми эмоциями!

• Как это работает: Мод глубоко интегрируется с PlasmoVoice (а также SVC). Интерцепторы захватывают звук из вашего микрофона напрямую (PCM-семплы) в реальном времени. Мод анализирует звук и генерирует правильную форму рта (визему). В итоге ваш персонаж физически открывает рот точно под вашу речь!

🌐 Передача данных "ProxLib" на ванильных серверах

Играете на ванильном сервере, куда нельзя поставить этот мод? Не беда.

• Как это работает: Мы попытались внедрить протокол передачи данных на основе ProxLib. Если мода нет на сервере, клиенты используют "проксимити" каналы ProxLib для обмена данными напрямую. Если у вас и ваших друзей установлен мод на клиенте, вы всё равно будете видеть мимику и синхронизацию губ друг друга даже на обычных ванильных серверах!

🧩 Меню кастомизации

Вы больше не привязаны к одному стандартному образу!

• Как использовать: Нажмите C в игре, чтобы открыть экран кастомизации.
• Там вас ждет интерфейс в стиле MCSM. Вы можете независимо выбирать форму головы, прическу, шапку, цвет кожи и одежду. Соберите своего уникального аватара, и сервер мгновенно синхронизирует его для остальных игроков.

[Интерфейс меню кастомизации игрока с выбором причесок/лиц]

🧠 Меню эмоций

Выражайте чувства без слов!

• Как использовать: Нажмите O в игре, чтобы открыть круговое меню эмоций.
• Вам доступны 12 уникальных эмоций (Радость, Грусть, Злость, Удивление, Смех, Боль и т.д.). В центре меню также есть кнопка-переключатель, с помощью которой можно быстро включить или выключить отображение вашей 3D-головы.

Круговое меню эмоций на 12 кнопок с переключателем в центре]

🤖 Мобы из Story Mode (В разработке)

В игре появятся мобы из Story Mode (Джесси, Петра), которые бродят по миру.

• Текущее состояние: Мобы спавнятся с динамическим настроением и эмоциями, реагируют на урон и друзей. Добавлена базовая система репутации (если ударить моба — репутация упадет).
• Примечание: Продвинутые механики, такие как подбор предметов с земли, надевание брони и поедание еды, запланированы, но еще вообще не реализованы в текущей бете.

[NPC Петра и Джесси стоят вместе с эмоциями на лицах]

---

⚙️ Техническая часть

• OBJ Модели: Мод использует кастомные 3D-модели в формате OBJ для рендера голов. Это позволяет плавно интерполировать и изменять геометрию лица (mesh) под разные выражения без жесткой покадровой анимации.
• Анализ голоса: Мы перехватываем сырые аудио-фреймы (PCM 16-bit 48kHz) из микрофона через PlasmoVoice/SVC и вычисляем громкость и частоты «на лету», чтобы сгенерировать точные виземы (формы губ).
• P2P Сеть: Использование библиотеки ProxLib позволяет упаковывать виземы и эмоции в компактные байты-пайлоады и передавать их между клиентами напрямую в радиусе видимости (proximity). Это работает даже на серверах без плагина!

🎭 Таблица эмоций

Эмоция	Что делает
Нейтрал	Стандартное лицо
Радость	Улыбка, приподнятые брови
Грусть	Опущенные брови, печальный вид
Злость	Хмурый вид, агрессивный взгляд
Удивление	Открытый рот, широкие глаза
Страх	Дрожащий взгляд (трясущиеся глаза)
Боль	Персонаж морщится
Решимость	Сосредоточенный, серьезный взгляд
Говорит	Анимация движения губ под голос
А также: Смех, Замешательство, Ухмылка!

🗺️ Планы на будущее (Roadmap)

Фича	Статус	Приоритет
3D Лицевые анимации	✅ Готово	Высокий
Интеграция PlasmoVoice	✅ Готово	Высокий
P2P-сеть через ProxLib	⚠️ Бета	Средний
Базовые эмоции NPC	✅ Готово	Средний
Инвентарь и поедание еды (NPC)	❌ Запланировано	Высокий
UI диалогов из Story Mode	❌ Запланировано	Средний

---

📜 Авторы

• Автор: ErrorGhostX
• Проект вдохновлен Minecraft Story Mode.

---

⚠️ Дисклеймер: Это фанатский проект, никак не связанный с Mojang, Microsoft или Telltale Games. Все права принадлежат их владельцам.

🎭 Minecraft Story Mod by ErrorGhostX

Minecraft Story Mod by ErrorGhostX is a mod inspired by Minecraft Story Mode S1/2, attempting to bring the unique atmosphere of the game into vanilla Minecraft!

⚠️ BETA WARNING: This mod is currently in early Beta. Many features are still actively being worked on!

---

✨ Features

🗣️ Voice-Activated Lip Sync (PlasmoVoice & Simple Voice Chat)

The mod completely overhauls player faces by adding animated 3D heads. But it doesn't stop at predefined emotions!

• How it works: We deeply integrate with PlasmoVoice (and SimpleVoiceChat). The mod analyzes your microphone's live audio frames (PCM samples) in real-time, calculates the volume and phonetic shape of your voice, and generates realistic mouth shapes (visemes) instantly. Your character physically opens their mouth perfectly in sync with what you're saying!

🌐 "ProxLib" Vanilla Networking

Playing on a vanilla server where you can't install the mod? No problem.

• How it works: We attempted to implement seamless vanilla data transfer using the ProxLib library. If the mod isn't installed on the server, the client will use ProxLib to bounce animation data and localized proximity data directly between players. As long as you and your friends have the mod on your clients, you will see each other's facial animations and lip-sync even on regular vanilla servers!

🧩 Customization Menu

You are no longer limited to just one look! Mix and match character parts.

• How to use: Press C in-game to open the Customization Screen.
• Our MCSM-style grid UI allows you to independently change your model's Head, Hair, Hat, Skin, and Clothing. Assemble your unique Story Mode avatar, and the server will instantly sync it to everyone else.

[Customization menu UI showing the grid of character parts]

🧠 Emotion Menu

Express yourself without saying a word!

• How to use: Press O in-game to open the Emotion Wheel.
• Choose from 12 distinct emotions (Happy, Sad, Angry, Surprised, Scared, Smug, Laughing, Confused, Pain, Determined, Talking, Neutral). The menu also features a toggle button in the center to instantly turn your 3D head on or off.

[Emotion menu wheel showing the 12 emotion buttons and the center toggle]

🤖 Story Mode NPCs (Work in Progress)

Meet fully functional Story Mode NPCs (like Jesse and Petra) wandering your world.

• Current state: Mobs spawn with dynamic moods and emotions that react to damage or being near friends. A basic reputation system exists (hitting them lowers it, talking to them can change it).
• Note: Advanced behaviors like NPCs dynamically picking up items, equipping armor, and eating food are planned but not yet implemented in the current beta.

[Petra and Jesse NPCs standing together with expressions on their faces]

---

⚙️ Technical Details

• OBJ Models: The mod natively parses and renders OBJ format 3D models, allowing continuous and smooth transitions between character expressions using customized meshes.
• Voice Analysis: We intercept live 16-bit 48kHz PCM audio streams, analyzing frequencies to instantly translate your real voice into accurate, rendered visemes.
• P2P Networking: Utilizing ProxLib, the mod passes compact byte payloads containing viseme and mood data via proximity channels without needing dedicated server-side handling.

🎭 Emotion Table

Emotion	Description
Neutral	Default face
Happy	Smiling face with raised eyebrows
Sad	Frown and lowered eyebrows
Angry	Aggressive look and furrowed brow
Surprised	Open mouth and wide eyes
Scared	Trembling look with wide eyes
Pain	Wincing expression
Determined	Focused, serious look
Talking	Dynamic lip-sync animation
Plus: Smug, Laughing, Confused!

🗺️ Roadmap & Plans

Feature	Status	Priority
3D Facial Animations	✅ Done	High
PlasmoVoice Integration	✅ Done	High
ProxLib P2P Sync	⚠️ Beta	Medium
Basic NPC Emotions	✅ Done	Medium
NPC Inventory & Eating	❌ Planned	High
Story Mode Dialog UI	❌ Planned	Medium

---

📦 Requirements

Dependency	Version
Minecraft	1.21.11
Fabric Loader	≥ 0.18.4
Fabric API	Required
Fabric Language Kotlin	≥ 1.13.9
PlasmoVoice (Optional)	Supported
Simple Voice Chat (Optional)	Supported

---

📜 Credits

• Author: ErrorGhostX
• Inspired by: Minecraft Story Mode seasons 1 & 2 by Telltale Games.

---

⚠️ Disclaimer

This is a fan-made project and is not affiliated with, endorsed by, or connected to Mojang Studios, Microsoft, or the now-defunct Telltale Games. All trademarks are the property of their respective owners.