Техническое устройство

Как устроен поток от PNG на сайте до применения textureValue в FlwSkins.


Эта страница описывает, как система скинов устроена внутри со стороны сайта и плагина.

Общая схема

Игрок -> https://flowerymc.space/wardrobe -> backend сайта -> texture data -> FlwSkins webhook -> игрок в игре

Пошаговый поток

  1. Игрок загружает PNG на страницу гардероба https://flowerymc.space/wardrobe.
  2. Backend сайта валидирует файл: размер, формат и разрешение.
  3. Сайт определяет модель classic или slim.
  4. PNG превращается в готовые данные Minecraft-текстуры.
  5. Сайт сохраняет запись в личный гардероб игрока.
  6. Backend отправляет данные в FlwSkins webhook.
  7. Плагин сохраняет скин и применяет его сразу онлайн или на следующем входе.

Что сайт отправляет в плагин

Во FlwSkins уходит JSON с уже готовыми полями:

  • nickname
  • textureValue
  • textureSignature

Сырой PNG не отправляется как финальный формат установки.

Почему это важно

Minecraft-клиенту для нормальной установки нужен не сам файл PNG, а итоговый textures payload. Именно поэтому сайт берёт на себя подготовку texture data и не заставляет плагин работать с исходной картинкой напрямую.

Где хранится гардероб

Гардероб и связанные с ним файлы лежат в постоянной директории сайта, а не только во временной сборке runtime. За счёт этого история скинов сохраняется после рестартов и билдов.

Как сайт получает актуальные головы

Для головы и бюстов сайт использует свои внутренние routes: https://flowerymc.space/api/users/head/Player123 и https://flowerymc.space/api/users/bust/Player123. Они сначала смотрят текущее назначение скина в FlwSkins, а уже потом, если нужно, переходят к запасным источникам.

Это нужно, чтобы:

  • не показывать Steve вместо реального активного скина;
  • обновлять голову и рендер ближе к реальному времени;
  • учитывать актуальную slim/classic модель.

На этой странице