Player Doll

Player Doll

Многофункциональный мод на кукол игроков, который поддерживает создание и размещение сущностей кукол с кастомными скинами. Мод добавляет кукол Steve и Alex по умолчанию, а также поддерживает динамическую загрузку кукол с кастомными текстурами скинов из папки игры. Кроме того, в моде есть мощная система поз и действий, позволяющая задавать куклам различные статичные позы и динамичные анимации.

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

Основные возможности

• Куклы по умолчанию: добавляет кукол Steve (широкие руки) и Alex (тонкие руки)
• Динамическая загрузка: автоматически сканирует и регистрирует кукол с кастомными текстурами скинов из папки игры
• Размещение по ПКМ: используйте предмет-куклу, чтобы поставить блок и разместить рядом соответствующую сущность куклы
• Система поз: поддерживает настройку статичных поз (стоя, сидя, лёжа и т.д.)
• Система действий: поддерживает создание динамичных анимаций (машет рукой, танцует и т.д.) с зацикленным воспроизведением и интерполяцией ключевых кадров
• Типы моделей: поддерживает как широкоплечие (Steve), так и тонкорукие (Alex) модели

📋 Требования

• Версия Minecraft: 1.21.1
• Версия NeoForge: 21.1.217 или выше
• Версия Java: 21 или выше

Установка

1. Убедитесь, что установлен NeoForge 21.1.217 или выше
2. Поместите файл мода (.jar) в папку mods
3. Запустите игру — мод автоматически создаст нужные папки конфигурации

🎮 Руководство игрока

Базовое использование

1. Войдите в творческий режим и откройте инвентарь
2. Найдите предметы-куклы во вкладке "Player Doll"
3. Возьмите предмет-куклу и нажмите ПКМ по блоку, чтобы разместить рядом соответствующую сущность куклы

Добавление кукол с кастомными скинами

Мод поддерживает автоматическую загрузку кастомных текстур скинов из папки игры, что позволяет добавлять новых кукол без изменения кода.

📁 Расположение папки

Файлы кастомных скинов нужно помещать в следующую папку:

Корневая папка игры/
└── player_doll/
    └── png/              # Папка кастомных текстур скинов (создаётся автоматически при первом запуске)
        ├── SMy_Character.png
        └── A123_ABC__qwe.png

📝 Правила именования файлов

• Имя файла должно начинаться с S или A, что указывает на тип модели:

  • S = широкоплечая модель (модель Steve)
  • A = тонкорукая модель (модель Alex)
• Часть после первого символа будет использоваться как отображаемое имя куклы

• Правила обработки имени:

  • Одинарное подчёркивание _ заменяется на пробел
  • Двойное подчёркивание __ заменяется на одинарное подчёркивание _

📊 Примеры именования

🔄 Порядок работы

1. Поместите PNG-файлы текстур скинов в папку player_doll/png/
2. Запустите игру или нажмите F3+T, чтобы перезагрузить ресурспаки
3. Мод автоматически просканирует папку и зарегистрирует все PNG-файлы, соответствующие правилам
4. Найдите новые зарегистрированные предметы-куклы во вкладке "Player Doll" в инвентаре творческого режима
5. Используйте предметы-куклы, чтобы разместить соответствующие сущности кукол

⚠️ Важные замечания

• Первый символ имени файла должен быть S или A, иначе файл будет проигнорирован
• Имя файла должно быть длиной не менее 2 символов (первый символ + минимум 1 символ)
• Поддерживаются только изображения в формате PNG
• Файлы текстур скинов должны соответствовать стандартному формату скинов Minecraft (64x64 или 64x32 пикселя)
• Файлы, не соответствующие правилам, будут пропущены, а в лог запишется предупреждение
• Папка автоматически сканируется при запуске мода

Настройка поз и действий кукол

Мод поддерживает настройку поз и действий кукол через файлы конфигурации JSON. Файлы конфигурации находятся в директории player_doll/.

📂 Структура директории файлов конфигурации

Корневая директория игры/
└── player_doll/
    ├── png/              # Директория пользовательских текстур скинов
    ├── poses/            # Директория файлов конфигурации поз
    │   ├── standing.json
    │   ├── sitting.json
    │   └── ...
    ├── actions/          # Директория файлов конфигурации действий
    │   ├── wave.json
    │   ├── dance.json
    │   └── ...
    └── README.md         # Подробная документация по конфигурации

Подробные инструкции по настройке смотрите в файле player_doll/README.md, который включает:

• Формат файла поз и описание полей
• Формат файла действий и настройку ключевых кадров
• Справочные значения углов и примеры распространённых поз
• Полные обучающие материалы и примеры использования

🔄 Перезагрузка конфигурации

После изменения файлов конфигурации нажмите F3+T, чтобы перезагрузить ресурспаки и применить изменения без перезапуска игры.

Параметры конфигурации

Файл конфигурации мода находится по адресу config/player_doll_addon-common.toml:

• testMode (Режим тестирования):

  • Тип: Boolean
  • По умолчанию: true
  • Описание: При включении выводит подробные отладочные логи, помогающие анализировать проблемы загрузки скинов и распознавания моделей

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

В: Пользовательский скин не отображается?

О: Проверьте:

1. Начинается ли имя файла с S или A
2. Является ли файл допустимым форматом PNG
3. Помещён ли файл в директорию player_doll/png/
4. Нажали ли вы F3+T для перезагрузки ресурспаков
5. Проверьте файлы логов на наличие сообщений об ошибках

В: Как изменить позы куклы?

О: Отредактируйте JSON-файлы в директории player_doll/poses/ или создайте новые файлы поз. Подробные инструкции смотрите в player_doll/README.md.

В: Как создать пользовательские действия?

О: Создайте JSON-файлы в директории player_doll/actions/ и определите последовательности ключевых кадров. Подробные инструкции смотрите в player_doll/README.md.

В: Что делать, если мод вылетает?

О:

1. Проверьте соответствие версий Minecraft, NeoForge и Java
2. Проверьте логи ошибок в директории logs/
3. Включите режим тестирования (testMode = true) для просмотра подробных логов
4. Проверьте правильность форматов файлов конфигурации

📄 Лицензия

Этот проект распространяется под лицензией MIT.

Лицензия MIT — это разрешительная лицензия с открытым исходным кодом, которая позволяет:

• ✅ Коммерческое использование
• ✅ Модификацию
• ✅ Распространение
• ✅ Частное использование

Единственное требование — сохранить уведомление об авторских правах и текст лицензии.

Полный текст лицензии смотрите в файле LICENSE.

👤 Автор

Автор: 蓝也（lan_ye）

🇨🇳 中文说明

简介

Player Doll 是一个功能丰富的玩家玩偶模组，支持创建和放置自定义玩家玩偶实体。模组提供了 Steve 和 Alex 的默认玩偶，并支持从游戏目录动态加载自定义皮肤材质玩偶。此外，模组还提供了强大的姿态（Poses）和动作（Actions）系统，让您可以为玩偶设置各种静态姿势和动态动画。

核心功能

• 默认玩偶：提供 Steve（粗手臂）和 Alex（细手臂）的默认玩偶
• 动态加载：从游戏目录自动扫描并注册自定义皮肤材质玩偶
• 右键放置：使用玩偶物品右键方块可以在指定位置放置玩偶实体
• 姿态系统：支持自定义静态姿势配置（如站立、坐下、趴下等）
• 动作系统：支持创建动态动画序列（如挥手、跳舞等），支持循环播放和关键帧插值
• 模型类型：支持粗手臂（Steve）和细手臂（Alex）两种模型类型

快速使用

1. 安装要求：Minecraft 1.21.1，NeoForge 21.1.217+，Java 21+
2. 基础使用：创造模式 → 物品栏"玩家玩偶"标签 → 右键方块放置
3. 自定义皮肤：将 PNG 文件放入 player_doll/png/ 目录，文件名以 S（粗手臂）或 A（细手臂）开头，按 F3+T 重载
4. 配置姿态和动作：在 player_doll/poses/ 和 player_doll/actions/ 目录下创建 JSON 配置文件，详细说明请查看 player_doll/README.md

常见问题

• 皮肤不显示：检查文件名是否以 S/A 开头、格式是否正确、是否重载资源包
• 修改姿势：编辑 player_doll/poses/ 目录下的 JSON 文件
• 创建动作：在 player_doll/actions/ 目录下创建 JSON 文件定义关键帧
• 模组崩溃：检查版本匹配、查看错误日志、启用测试模式

Лицензия

Этот проект распространяется под открытой лицензией MIT License, которая разрешает коммерческое использование, изменение, распространение и частное использование.

Последнее обновление: 2025-01-XX