Client Paintings

Client Paintings — это легковесный мод, работающий исключительно на стороне клиента, который позволяет добавлять новые картины через ресурспаки, не затрагивая стандартные варианты из ванильной игры. Мод использует уникальный идентификатор сущности картины и применяет к нему специальный алгоритм для определения того, какое изображение должно быть отображено.

Для добавления пользовательских картин используется особая структура ресурспаков. Вы можете воспользоваться онлайн-генератором на сайте разработчика для быстрого создания такого пакета или ознакомиться с техническими деталями формата ниже.

Основные возможности

• Добавление нескольких наборов новых картин через ресурспаки
• Сохранение всех оригинальных картин из ванильной версии игры
• Полное соответствие отображения стандартных картин между игроками с модом и без него
• Синхронизация пользовательских картин между всеми игроками, у которых установлен мод
• Сохранение пользовательских картин между перезапусками игры и сервера

Особенности работы

• Пользовательские картины будут одинаково отображаться только у игроков с идентичными наборами картин
• Для добавления наборов картин требуется использовать специальный формат ресурспаков

Пример работы

С использованием стандартного ресурспака, входящего в состав мода:

Как видят ту же картину игроки без мода:

Формат ресурспаков

Формат ресурспаков очень простой. В корне пространства имен вашего ресурспака необходимо создать папку client_paintings (например, assets/<namespace>/client_paintings). В этой папке можно разместить любое количество JSON-файлов, каждый из которых представляет отдельную пользовательскую картину.

Каждый JSON-файл должен иметь следующую структуру:

{
  "texture": "<namespace>:client_paintings/painting_texture",
  "back": "<namespace>:client_paintings/painting_back_texture", 
  "size": [2, 1]
}

• texture — текстура картины в формате PNG с соотношением сторон, соответствующим полю size, где ширина и высота должны быть кратны 16. Текстура должна находиться в папке assets/<namespace>/textures/client_paintings
• back — текстура обратной стороны картины в формате PNG квадратной формы, где ширина и высота также кратны 16
• size — размер картины в блоках, где первое значение — ширина, второе — высота. Поддерживаются только размеры 1x1, 1x2, 2x1, 2x2, 4x2, 4x4 и 4x3 из-за необходимости замены стандартных картин

Пример структуры ресурспака:

pack.mcmeta
assets
└── namespace
    ├── textures
    │   └── client_paintings
    │       ├── painting1.png
    │       ├── painting2.png
    │       ├── painting3.png
    │       └── backs
    │           ├── back1.png
    │           └── back2.png
    └── client_paintings
        ├── painting1.json
        ├── painting2.json
        └── painting3.json