MmdSkin

MMD Skin — добавь модели MMD в Minecraft

MMD Skin — это мод для Minecraft, который позволяет заменить скин игрока моделями MMD (MikuMikuDance), с симуляцией физики волос, одежды и аксессуаров в реальном времени.

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

• Поддержка моделей PMX/PMD — загрузка и отрисовка моделей MMD в Minecraft
• Воспроизведение анимаций 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
• Если файлов модели несколько, приоритет у model.pmx или model.pmd
• Иначе выбирается первый файл по алфавиту

DefaultAnim/ — системные предустановленные анимации

Содержит встроенные анимации, привязанные к состояниям игрока:

Ты можешь заменить эти файлы, чтобы настроить базовые анимации.

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

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

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

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

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

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

🎮 Управление

Главное колесо конфигурации (Удерживайте Alt)

Удерживайте Alt, чтобы открыть главное колесо конфигурации:

Колесо конфигурации горничной (Нажмите B на горничной)

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

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

⚙ Настройки

Доступ к настройкам мода через колесо конфигурации или Mod Menu. Доступные опции:

Рендеринг

• OpenGL Lighting - Включить/выключить освещение
• MMD Shader - Использовать шейдинг в стиле MMD

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

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

Toon-рендеринг

• Enable Toon - Включить cel-shading
• Toon Levels - Количество уровней тени (2-5)
• Rim Light - Подсветка краёв
• Shadow Color - Пользовательский оттенок тени
• Specular - Настройки бликов
• Outline - Обводка модели (ширина и цвет)

⚠️ Примечание: Toon-рендеринг и GPU Skinning в настоящее время несовместимы с модами на шейдеры (Iris/Optifine). Отключите эти функции при использовании шейдеров.

🔧 Советы

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

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

💡 FAQ

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

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

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

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

🙏 Благодарности

Этот мод основан на следующих проектах:

• KAIMyEntity от kjkjkAIStudio - оригинальный MMD-мод для Minecraft
• KAIMyEntity-C от Gengorou-C - непосредственный предшественник этого проекта

Спасибо оригинальным авторам за их вклад в открытый исходный код!

🎨 Где взять модели

Вы можете найти модели MMD на этих сайтах (пожалуйста, уважайте условия использования авторов моделей):

• Aplaybox (模之屋)
• Bowlroll
• DeviantArt
• Niconi 3D

Наслаждайтесь MMD в Minecraft!