Emote

Emote

Спасибо Popular Vibe за разрешение использовать их анимацию! ▶ Смотреть полную демонстрацию эмоций на YouTube Присоединяйтесь к серверу Discord, чтобы делиться созданными эмоциями.

Возможности

Emote — серверный мод на эмоции, который проигрывает анимации с помощью сущностей отображения Minecraft. Все серверные функции работают, если мод установлен только на сервере. Установка на клиент необязательна и добавляет колесо эмоций и автоматический вид от третьего лица во время проигрывания. Веб-конвертер импортирует проекты BD Engine, GeckoLib и Animated Java, с экспериментальной поддержкой Bedrock и Emotecraft. Настраивайте части скина, метаданные, параметры проигрывания и события перед экспортом. На сервере права LuckPerms позволяют назначать эмоции и эмоции бездействия каждому игроку. Последовательности могут связывать несколько анимаций, при этом скин игрока применяется к совместимым анимациям. Также доступен серверный API, позволяющий другим модам регистрировать эмоции, управлять проигрыванием и получать события.

Команды

Игрок

Команда	Описание
/emote	Открывает меню эмоций.
`/emote play `	Проигрывает эмоцию по ID.
V	Открывает клиентское колесо эмоций.

Используйте кнопку «Редактировать колесо» в колесе, чтобы добавлять, удалять или менять порядок записей. Порядок хранится на клиенте отдельно для каждого сервера. Меню эмоций и редактор колеса поддерживают поиск по названию, ID, описанию или #тегам, указанным в описании. Несколько #тегов соответствуют эмоциям, содержащим все указанные теги.

Администрирование

Команда	Описание
/emote list	Показывает загруженные эмоции с их ID, длительностью и доступностью.
/emote info	Показывает текущее проигрывание, вместимость сущностей отображения, очередь обработки скинов и статус загруженных эмоций.
/emote reload	Перезагружает конфигурацию и анимации.
`/emote enable/disable `	Включает или отключает эмоцию.
`/emote stop , /emote stop @a`	Останавливает эмоции выбранных игроков; используйте @a для всех игроков.
`/emote stress-test [load]`	Измеряет производительность сервера и обработки эмоций при одновременных эмоциях (по умолчанию 50 экземпляров). 50 или 50i запрашивает 50 экземпляров; 768d запрашивает до 768 сущностей отображения.
/emote account	Показывает зарегистрированные аккаунты для запекания и выбранный провайдер скинов.
/emote account login	Подключает аккаунт Minecraft через вход Microsoft по устройству.
`/emote account remove `	Удаляет аккаунт для запекания по имени или UUID.

Административные команды используют право emote.manage и по умолчанию доступны операторам уровня game master.

Управление сервером

config/emote/
├── config.json
├── emotes.json
├── emote/
└── resource-pack/

Каталог и файлы конфигурации создаются автоматически при первом запуске, а в emote/ включены более 20 примеров эмоций. Помещайте JSON, экспортированный конвертером, в emote/. Подкаталоги также загружаются, а эмоции используют id из JSON, а не имя файла. Некорректные файлы пропускаются по отдельности, а все файлы с повторяющимся ID отклоняются.

config.json

{
  "schema_version": 1,
  "menu_page_size": 6,
  "mineskin_api_key": "",
  "mineskin_poll_interval_seconds": 3,
  "mineskin_cache_retention_days": 30,
  "mineskin_cache_max_mib": 256,
  "max_active_display_entities": 768,
  "default_skin": ""
}

Укажите mineskin_api_key, чтобы генерировать текстуры скинов игроков, когда не зарегистрировано ни одного bake-аккаунта. Готовые кэшированные текстуры остаются доступными и без этих учётных данных.

emotes.json

{
  "schema_version": 3,
  "disabled": ["emote:anvil"],
  "permissions": [
    {
      "permission": "emote.default",
      "emotes": ["emote:hello", "emote:backflip"]
    },
    {
      "permission": "emote.vip",
      "emotes": ["emote:vip\\..*"],
      "idle": {"delay": "300s", "emote": ["sit:idle.sit", 70, "music:idle.piano", 30]},
      "cooldown": "x0.8"
    },
    {
      "permission": "emote.admin",
      "emotes": ["*"]
    }
  ]
}

disabled отключает эмоции, а permissions определяет, какие эмоции и эмоции бездействия доступны каждому игроку. Допустимые ID эмоций в emotes сопоставляются буквально; остальные записи — это регулярные выражения Java, сопоставляемые с полным ID эмоции. * — специальное значение, дающее доступ ко всем включённым одиночным эмоциям. Обратные слэши в регулярных выражениях также нужно экранировать для JSON. emote.default разрешено, если явно не запрещено. emote.bypass — административное и отладочное переопределение, игнорирующее standalone, отключённые ID, разрешения и перезарядки.

Веб-конвертер

Emote Converter конвертирует и настраивает проекты без необходимости напрямую редактировать Animation JSON. Вся обработка происходит локально в браузере. Пошаговое руководство по конвертации и установке собственных эмоций см. в разделе Добавление пользовательских эмоций. Используйте 3D-предпросмотр, чтобы назначить части скина, затем настройте метаданные, поведение воспроизведения, условия остановки и события.

Конвертация анимации

Веб-конвертер поддерживает кривые анимации, включая Bézier, Catmull-Rom, bounce и elastic. Предпросмотр в браузере помогает проверить назначение частей скина и может отличаться от воспроизведения в игре. Каждая анимация может задавать перезарядку, видимость игрока, условия остановки, такие как движение, прыжок, атака и получение урона, а также события.

• Формат анимации

Последовательность

Соединяйте короткие анимационные клипы по порядку и комбинируйте ожидания, взвешенный случайный выбор и повторы, чтобы создать одну эмоцию. Устанавливайте Sequence и каждую упоминаемую Animation вместе. Следующий фрагмент показывает её шаги:

{
  "steps": [
    {"emote": "sit:sit_down"},
    {"wait": "10t"},
    {
      "emote": [
        "sit:idle_sky", 45,
        "sit:idle_butterfly", 45,
        "emote:break", 10
      ],
      "repeat": 3
    },
    {"emote": "sit:stand_up1"}
  ]
}

• Формат последовательности

Mod API

EmoteApi.getInstance() предоставляет управление воспроизведением, регистрацию во время выполнения, запросы состояния, отменяемые слушатели запуска, слушатели жизненного цикла воспроизведения и именованные колбэки жизненного цикла. Регистрируйте колбэки через EmoteApi.registerCallbacks и выбирайте их в корневом массиве callbacks анимации или последовательности. Изменения состояния должны выполняться в потоке сервера, а регистрации во время выполнения сохраняются после перезагрузок.

• Mod API

Устранение неполадок

Если проблема здесь не описана, сообщите о ней в Discord или GitHub Issues.

Лицензия

Этот проект распространяется под Apache License 2.0.