🇷🇺 Описание на русском
🎭 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
Cin-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
Oin-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.
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21.11
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as [MCSM] Minecraft Story Mode-v3.0.1-1.21.11-beta.jar — drop this file into the mods folder
- Download size: 694 KB
- Download link checked 6 Sept 2026 — working
These come from our own check of the pack file, not from the source page.