BLOCKTOP GAMES 2.0 — КАК ДОБАВИТЬ СВОЮ КОЛОДУ ДЛЯ ДУРАКА
========================================================

1. Откройте папку:
   config/blocktop-games/decks/

2. Скопируйте файл ШАБЛОН_КОЛОДЫ.png в отдельную папку колоды, например:
   config/blocktop-games/decks/my_deck/deck.png

   Имя папки является внутренним ID колоды. Разрешены только:
   строчные латинские буквы a-z, цифры 0-9, точка, дефис и подчёркивание.
   Максимальная длина — 64 символа. ID default и anime зарезервированы встроенными колодами.

3. Нарисуйте карты поверх ячеек шаблона, не меняя размер и расположение ячеек.

   Требования к deck.png:
   - формат PNG;
   - размер строго 256 x 128 пикселей;
   - размер файла не более 512 КиБ;
   - четыре строки высотой по 32 пикселя:
       0-31   — трефы;
       32-63  — бубны;
       64-95  — червы;
       96-127 — пики;
   - первые 13 столбцов — карты размером 18 x 32 пикселя:
       2, 3, 4, 5, 6, 7, 8, 9, 10, валет, дама, король, туз;
   - рубашка находится в столбце 14: x=234..251;
   - последние четыре пикселя x=252..255 не используются.

4. При желании создайте рядом файл deck.json в кодировке UTF-8:

   {
     "name": "Название колоды",
     "author": "Автор или название сервера"
   }

   Готовый пример находится в файле deck.json.example.
   Размер deck.json не должен превышать 8 КиБ.

5. Перезапустите сервер после добавления, замены или удаления колоды.

Сервер проверит атлас и добавит корректную колоду в меню «Blocktop Games → Косметика».
Клиенты автоматически получат проверенный PNG и сохранят его в кэш по SHA-256.
Обновлять мод или устанавливать отдельный ресурспак игрокам не требуется.

Ограничения и безопасность:
- максимум 64 серверные колоды;
- максимум 16 МиБ на все серверные колоды;
- символические ссылки и файлы неправильного формата не загружаются;
- причина отклонения колоды записывается в журнал сервера;
- используйте только изображения, на которые у вас есть права.

Готовая структура:

config/blocktop-games/decks/
├─ КАК_ДОБАВИТЬ_КОЛОДУ.txt
├─ ШАБЛОН_КОЛОДЫ.png
├─ deck.json.example
└─ my_deck/
   ├─ deck.png
   └─ deck.json
