MmdSkin

MMD Skin — переносите модели MMD в Minecraft

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

✨ Особенности

• Поддержка моделей PMX/PMD — Загрузка и рендеринг моделей MMD в Minecraft.
• Воспроизведение анимации VMD - Воспроизведение анимации скелета и морфинга.
• Физика в реальном времени. Волосы, юбки и аксессуары естественным образом реагируют на движение.
• Скинирование графического процессора - Высокопроизводительное скинирование вершин с помощью вычислительного шейдера.
• Toon Rendering - Эффекты Cel-шейдинга с настраиваемыми параметрами.
• Многослойная анимация — одновременное смешивание нескольких анимаций.
• Интеграция 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/      # Player models
    │   ├── ModelA/        # Each subfolder = one model
    │   │   ├── model.pmx  # Model file (.pmx/.pmd)
    │   │   ├── *.png      # Textures
    │   │   ├── dance.vmd  # Model-specific animation (optional)
    │   │   └── smile.vpd  # Model-specific morph (optional)
    │   └── ModelB/
    │       └── ...
    ├── DefaultAnim/       # System preset animations
    ├── CustomAnim/        # User custom animations
    ├── DefaultMorph/      # System preset morphs
    └── CustomMorph/       # User custom morphs

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».

⚙ Настройки

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

Рендеринг

• OpenGL Lighting - Включение/выключение освещения.
• Шейдер MMD — используйте затенение в стиле MMD.

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

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

Рендеринг мультяшек

• Включить Toon - Включить сел-шейдинг
• Уровни мультяшек - Количество уровней затемнения (2–5)
• Rim Light - Подсветка краев
• Цвет тени - Пользовательский оттенок тени
• Зеркальное - Настройки подсветки.
• Контур - Контур модели (ширина и цвет)

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

🔧 Советы

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

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

| Формат | Расширение | Описание | |--------|-----------|-------------| | ПМХ | .pmx | Модель MikuMikuDance (рекомендуется) | | ПМД | .pmd | Устаревшая модель MMD | | ВМД | .vmd | Данные движения MikuMikuDance | | ВПД | .vpd | Данные позы вокалоида (морфы) |

💡 Часто задаваемые вопросы

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

Вопрос: Физика работает со всеми моделями?
О: Физическое моделирование зависит от наличия в модели правильно настроенных твердых тел и соединений.

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

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

🙏 Кредиты

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

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

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

🎨 Где брать модели

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

• Aplaybox (模之屋)
• DeviantArt
• Никони 3D

Наслаждайтесь опытом MMD в Minecraft!