Главная / Документация / Фотографии

Фотографии игроков

Подробная документация по системе загрузки, хранения и отображения фотографий игроков в оверлее.

Содержание
Загрузка фотографий

Фотографии загружаются через административную панель:

  1. Перейдите в Admin → Фотографии
  2. Выберите платформу (Polemica, Gomafia, MafiaUniverse) и турнир
  3. Найдите игрока в списке участников турнира
  4. Загрузите фотографию, выбрав её тип (MAIN, DON, BLACK, RED, SHER)
Совет: При загрузке фото для турнира можно отметить «Сохранить как основное» — тогда фото будет использоваться и для других турниров, где у игрока нет специфического снимка.
Типы фотографий

Каждая фотография имеет один из пяти типов. Тип определяет, при какой роли игрока она будет отображаться:

MAIN DON BLACK RED SHER
Тип Роль Описание
MAIN Любая / по умолчанию Основная фотография. Используется, если нет специфического фото для текущей роли.
DON Дон мафии Отображается, когда игроку назначена роль «Дон».
BLACK Мафия Отображается для рядовых членов мафии.
RED Мирный житель Отображается для мирных жителей.
SHER Шериф Отображается, когда игроку назначена роль «Шериф».
Приоритет отображения

При отображении фотографии в оверлее система выбирает наиболее подходящий снимок по следующему приоритету (от высшего к низшему):

  1. Турнирная фотография по роли
    Фото загружено для конкретного турнира и совпадает с текущей ролью игрока (например, DON-фото для этого турнира, когда игрок — дон).
  2. Турнирная фотография MAIN
    Основное фото, загруженное для данного турнира (тип MAIN), но без привязки к конкретной роли.
  3. Глобальная фотография по роли
    Фото без привязки к турниру, но совпадающее с текущей ролью игрока.
  4. Глобальная фотография MAIN
    Основное глобальное фото (тип MAIN, без привязки к турниру).
Привязка к игрокам и турнирам

Каждая фотография в системе связана с:

  • Игроком — через внутренний UUID игрока в базе данных
  • Типом фото — MAIN, DON, BLACK, RED или SHER
  • Турниром (опционально) — пара tournamentType + tournamentId

Если турнир не указан (tournamentType = null, tournamentId = null), фотография считается глобальной и доступна для всех турниров данного игрока.

Игроки идентифицируются по ID на соответствующей платформе:

Платформа Поле идентификации
Polemica polemicaId
Gomafia gomafiaId
MafiaUniverse mafiaUniverseId
Вернуться на главную