MmdSkin - MMD-модели в Майнкрафт

MmdSkin - это мод для Майнкрафт, который позволяет заменить стандартный скин игрока на MMD-модели (MikuMikuDance) с полноценной симуляцией физики для волос, одежды и аксессуаров. Теперь ты можешь выглядеть как любимый персонаж из Vocaloid или любая другая 3D-модель, при этом одежда будет развеваться на бегу, а волосы - колыхаться при прыжке.

Возможности

• Поддержка PMX/PMD моделей - загружай и отображай MMD-модели прямо в игре
• Воспроизведение VMD-анимаций - проигрывай скелетные анимации и морфинг
• Физика в реальном времени - волосы, юбки и аксессуары естественно реагируют на движение
• GPU-скиннинг - высокопроизводительное вертексное скиннинг через Compute Shader
• Тонированная отрисовка (Toon) - эффект cel-shading с настраиваемыми параметрами
• Многослойная анимация - смешивание нескольких анимаций одновременно
• Интеграция с TouhouLittleMaid - можно применить MMD-модели к горничным

Установка

1. Установи Fabric Loader или Forge для Minecraft 1.20.1
2. Скачай мод (файл .jar) положи его в папку .minecraft/mods/
3. Запусти игру - мод автоматически создаст директорию ресурсов 3d-skin
4. Добавь свои модели и анимации в соответствующие папки

Структура папок

Мод использует .minecraft/3d-skin/ как корень ресурсов:

.minecraft/
└── 3d-skin/
    ├── EntityPlayer/      # Модели игрока
    │   ├── ModelA/        # Каждая подпапка = одна модель
    │   │   ├── model.pmx  # Файл модели (.pmx/.pmd)
    │   │   ├── *.png      # Текстуры
    │   │   ├── dance.vmd  # Анимация для этой модели (опционально)
    │   │   └── smile.vpd  # Морф для этой модели (опционально)
    │   └── ModelB/
    │       └── ...
    ├── DefaultAnim/       # Системные анимации
    ├── CustomAnim/        # Пользовательские анимации
    ├── DefaultMorph/      # Системные морфы
    └── CustomMorph/       # Пользовательские морфы

EntityPlayer/ - Модели игрока

Сюда складывай свои MMD-модели. Каждая модель должна быть в своей подпапке.

Тип файла	Расширение	Описание
Модель	.pmx / .pmd	Обязательно, PMX имеет приоритет
Текстура	.png / .jpg / .bmp / .tga	Ссылается на модель
Анимация	.vmd	Опционально, для конкретной модели
Морф	.vpd	Опционально, для конкретной модели

Правила обнаружения модели:

• Сканируется каждая подпапка на наличие .pmx или .pmd файлов
• Если найдено несколько моделей, приоритет у model.pmx или model.pmd
• Иначе выбирается первый файл по алфавиту

DefaultAnim/ - Системные анимации

Встроенные анимации для состояний игрока:

Анимация	Условие
idle.vmd	Стоит на месте
walk.vmd	Идёт
sprint.vmd	Бежит
sneak.vmd	Крадётся
swim.vmd	Плывёт
crawl.vmd	Ползёт
sleep.vmd	Спит
die.vmd	Умирает
elytraFly.vmd	Летит на элитрах
onClimbable.vmd	Карабкается (стоя)
onClimbableUp.vmd	Карабкается вверх
onClimbableDown.vmd	Карабкается вниз
onHorse.vmd	Едет верхом
swingLeft.vmd	Замах левой рукой
swingRight.vmd	Замах правой рукой

Эти файлы можно заменить для кастомизации базовых анимаций.

CustomAnim/ - Пользовательские анимации

Сюда клади свои .vmd анимации. Их можно активировать вручную через колёсико действий.

Приоритет анимаций

При загрузке анимаций мод ищет в порядке:

1. Папка модели (EntityPlayer/ModelName/*.vmd) - наивысший приоритет
2. Папка пользовательских анимаций (CustomAnim/*.vmd)
3. Папка системных анимаций (DefaultAnim/*.vmd) - низший приоритет

Это позволяет делать анимации для конкретных моделей, переопределяя общие.

Управление

Главное колёсико конфигурации (зажми Alt)

Зажми Alt, чтобы открыть главное меню:

Опция	Действие
Модели	Открыть выбор модели для игрока
Действия	Открыть колёсико для проигрывания анимаций
Морфы	Открыть колёсико для изменения выражения лица
Материалы	Включить/выключить части модели
Настройки	Открыть экран конфигурации мода

Колёсико для горничных (нажми B на горничной)

Если установлен TouhouLittleMaid, наведись на горничную и нажми B, чтобы открыть её настройки.

Совет: Клавиши можно переназначить в Настройки -> Управление -> категория MMD Skin.

Настройки

Открываются через колёсико или Mod Menu.

Отрисовка

• Освещение OpenGL - включить/выключить освещение
• MMD Shader - использовать затенение в стиле MMD

Производительность

• Лимит кэша моделей - макс. количество закэшированных моделей (10-500)
• GPU-скиннинг - использовать Compute Shader для вертексного скиннинга (требуется OpenGL 4.3+)
• GPU-морф - использовать Compute Shader для морфов
• Макс. костей - макс. количество костей (512-4096)

Тонированная отрисовка (Toon)

• Включить Toon - включить cel-shading
• Уровни тона - количество уровней тени (2-5)
• Контурный свет - подсветка краёв
• Цвет теней - настраиваемый цвет теней
• Блики - настройки бликов
• Контур - обводка модели (ширина и цвет)

Важно: Toon и GPU-скиннинг сейчас несовместимы с шейдерами (Iris/Optifine). Отключай эти опции в настройках, если используешь шейдерпаки.

Советы

1. Модель не отображается? Проверь, что в папке модели есть валидный .pmx или .pmd файл.
2. Текстуры пропали? Убедись, что файлы текстур лежат в той же папке, что и модель.
3. Анимация не работает? Проверь, что .vmd файл совместим со структурой костей модели.
4. Тормозит? Попробуй включить GPU-функции, даже на старом железе они часто помогают.

Поддерживаемые форматы

Формат	Расширение	Описание
PMX	.pmx	MMD модель (рекомендуется)
PMD	.pmd	Устаревший формат
VMD	.vmd	Данные анимации MMD
VPD	.vpd	Данные поз Vocaloid (морфы)

Важно знать

В: Можно ли использовать любую MMD-модель?
О: Большинство PMX/PMD моделей подойдут. Очень высокополигональные могут снизить производительность.

В: Физика работает на всех моделях?
О: Симуляция физики зависит от того, есть ли у модели правильно настроенные твёрдые тела и соединения.

В: Увидят ли другие игроки мою модель?
О: Да, если у них тоже установлен этот мод и такие же файлы моделей.

В: Совместим ли мод с шейдерами?
О: Базовая отрисовка работает с Iris/Optifine, но Toon-рендеринг и GPU-скиннинг пока не совместимы. Их нужно отключать в настройках при использовании шейдеров.

Наслаждайся MMD-моделями в Майнкрафте!