Better Player Model

Better Player Model

Better Player Model — это мощный мод для Fabric, созданный для анимированных кастомных моделей игрока. Он отличается высокой производительностью рендеринга, локальным просмотром и бесшовной синхронизацией в мультиплеере.

Ключевые особенности

• Универсальная поддержка моделей: Легко загружайте любые модели .ysm или Blockbench .json.
• Анимации уровня Bedrock: Полная поддержка MoLang для плавных, сложных и скриптовых анимаций.
• Встроенный браузер: Управляйте моделями, категориями и текстурами прямо из меню.
• Бесшовная синхронизация: Работает как клиентский мод, но обеспечивает полную синхронизацию в мультиплеере при установке на сервере.

Мультиплеер

• Только клиент: Вы по-прежнему можете видеть свои модели и просматривать библиотеку на любом сервере.
• Полная синхронизация: Если сервер также использует мод или плагин, каждый игрок увидит ваши кастомные анимации и модели!

Совместимость и настройка

• Формат: Поддерживает .json (Blockbench) и .ysm (зашифрованные).
• Расположение: Поместите модели в config/better_player_model/custom.
• Производительность: Полностью совместим с Sodium, Iris и другими оптимизационными модами.

Зависимости

• Architectury API
• Fabric API

Где найти модели?

Ищете качественные модели игрока? Вы можете просмотреть и скачать сотни моделей, созданных сообществом, из репозитория Yes-steve-model: Скачать модели здесь

Для администраторов серверов

Вы можете найти наш официальный плагин Paper/Purpur для синхронизации моделей без серверных модов прямо во вкладке Versions!

Демонстрация

Контакты

Посетите наш официальный Discord-сервер мода. Получайте ранний доступ к будущим обновлениям, предлагайте новые функции, сообщайте об ошибках и общайтесь с разработчиком и сообществом.

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

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

• OpenYSM & YSMParser (конвейер парсинга моделей)
• Fox-model-loader от Micaftic (базовая архитектура)
• Yes Steve Model от Elfmcys (оригинальные концепции)

Руководство по устранению проблем с сетью: тайм-ауты и отключения при синхронизации моделей

Если игроки с медленным или нестабильным интернетом (например, Wi-Fi, мобильные данные или спутниковые каналы вроде Starlink) постоянно отключаются при подключении к вашему серверу или во время синхронизации моделей, это руководство объясняет, как исправить проблему.

Почему это происходит?

1. Насыщение пропускной способности (Bufferbloat): Когда игрок подключается, сервер передаёт недостающие кастомные модели игрока. Если сервер пытается отправить эти данные быстрее, чем соединение игрока может их скачать, сетевые буферы на роутере или в операционной системе игрока переполняются.
2. Задержка пакетов Ping/Keep-Alive: Поскольку соединение насыщено, критически важные игровые пакеты (например, пакеты KeepAlive в Minecraft, которые проверяют, что игрок всё ещё подключён) стоят в очереди за файлами моделей. Если клиент не может ответить на эти пакеты в течение 15–30 секунд, сервер отключает его по тайм-ауту.
3. Большие файлы моделей: Если на вашем сервере много моделей или некоторые модели особенно большие (например, по несколько мегабайт каждая), начальный размер загрузки может быть значительным (десятки мегабайт), что удлиняет критическое окно синхронизации.

Решение 1: Настройка ограничений пропускной способности на сервере (рекомендуется)

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

1. Откройте каталог конфигурации вашего сервера: config/better_player_model-server.toml.

2. Найдите категорию [server_scheduler] и настройте лимиты:

   [server_scheduler]
      # Global bandwidth limit for model distribution across all active players (in Mbps)
      # Default: 100
      BandwidthLimit = 25
   
      # Bandwidth limit per individual player (in Mbps)
      # This prevents slow connections from getting overwhelmed.
      # Default: 5 (Recommended: 3 to 10)
      PlayerBandwidthLimit = 5

   Установка PlayerBandwidthLimit в 5 Мбит/с (~625 КБ/с) позволяет моделям скачиваться стабильно, не забивая канал, оставляя достаточно места для игрового процесса и трафика Keep-Alive.

Решение 2: Увеличение тайм-аутов сетевого соединения

По умолчанию Minecraft кикает игрока, если не получает сетевой ответ в течение 30 секунд. Вы можете увеличить этот тайм-аут чтения до 120 секунд.

Для выделенных серверов:

Добавьте следующее системное свойство Java в стартовый скрипт или командную строку вашего сервера:

-Dnet.minecraft.network.readTimeout=120

Для клиентов (в Prism Launcher или других параметрах запуска):

1. Откройте настройки лаунчера для экземпляра Minecraft.

2. В разделе Java -> Java Arguments добавьте:

   -Dnet.minecraft.network.readTimeout=120

Решение 3: Использование модов для увеличения тайм-аутов

В качестве альтернативы вы можете установить один из следующих серверных и клиентских модов для автоматической обработки тайм-аутов:

• Connectivity
• Timeouts

Встроенные модели и благодарности за ресурсы

Этот мод включает модель "Wine Fox" (酒狐), встроенную по умолчанию, чтобы обеспечить высокое качество из коробки.

• Название модели: Wine Fox (酒狐)
• Лицензия: CC BY-NC-SA 4.0

• Оригинальные авторы:

  • 完美冻结 (модель и ядро)
  • 星屑海螺 (анимации)
  • 哥斯拉 / 映素团队 (доработки)
  • 白帆小喵, 蓝玫瑰, 墨染逝羽, Maks怜悯, 浅陌菌, 祸御神, 羊毛 (текстуры, UI, звук и отдельные дополнения)

Огромное спасибо этим создателям за их невероятную работу над моделью! Если вы хотите использовать эту модель где-то ещё, пожалуйста, убедитесь, что соблюдаете оригинальную лицензию CC BY-NC-SA 4.0.

Лицензия

Лицензировано под MIT. Все оригинальные лицензии и уведомления об авторских правах сохранены. MIT License