Custom Paintings

Custom Paintings - мод для Minecraft (Fabric), который позволяет добавлять в игру свои собственные картины. В ванильном Майнкрафте набор картин фиксирован, а при размещении игра выбирает их случайно. Этот мод полностью меняет подход: вы можете добавить любое количество собственных изображений, задать им размер, имя и автора, а при установке - выбрать конкретную картину из удобного меню.

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

Как добавить пакет картин в мир

Самый простой способ - положить пакет в папку custompaintings внутри сохранения мира, например .minecraft/saves/My Awesome World/custompaintings/FamousPaintings-1.0.zip. Пакет может быть zip-архивом или обычной папкой.

└── .minecraft/
    ├── config/
    ├── logs/
    ├── resourcepacks/
    ├── saves/
    │   └── My Awesome World/
    │       ├── advancements/
    │       ├── custompaintings/
    │       │   └── FamousPaintings-1.0.zip  ᐊ
    │       ├── data/
    │       ├── datapacks/
    │       ├── DIM1/
    │       ├── DIM-1/
    │       ├── entities/
    │       ├── playerdata/
    │       ├── poi/
    │       ├── region/
    │       ├── stats/
    │       └── level.dat
    ├── options.txt
    └── servers.dat

Также можно добавить пакет через главное меню мода (см. ниже), перейдя в экран 'Manage Packs', и перетащить zip-архив или папку в окно игры, как это делается с ресурспаками. Мод сам скопирует файлы и обновит список.

Творческий инвентарь

Как и ванильные картины, все ваши кастомные картины будут появляться в креативе в разделе функциональных блоков. Модели предметов генерируются динамически на основе вашей текстуры и размеров, так что вы сразу видите, что за картина перед вами. Эта функция работает и для ванильных вариантов, что очень удобно. Настройка отображения иконок находится в клиентском конфиге.

Рецепты камнереза

Вдохновлено датапаком Vanilla Tweaks "Painting Picker". Все уникальные предметы для ваших кастомных картин доступны как рецепты камнереза. Просто вставьте обычный предмет картины и получите конкретный вариант, пропуская меню выбора. То же самое работает с ванильными картинами: из базовой можно сделать Kebab, Aztec и другие, включая скрытые стихии. Рецепты для кастомных и ванильных картин настраиваются отдельно в конфиге мира или сервера.

Как добавить пакет картин на сервер

Добавление пака на сервер должен выполнять администратор с доступом к файловой системе. Скопируйте пакет в папку custompaintings внутри папки мира на сервере.

└── <server root> /
    ├── config/
    ├── logs/
    ├── world/
    │   ├── advancements/
    │   ├── custompaintings/
    │   │   └── FamousPaintings-1.0.zip  ᐊ
    │   ├── data/
    │   ├── datapacks/
    │   ├── DIM1/
    │   ├── DIM-1/
    │   ├── entities/
    │   ├── playerdata/
    │   ├── poi/
    │   ├── region/
    │   ├── stats/
    │   └── level.dat
    ├── banned-ips.json
    ├── banned-players.json
    ├── eula.txt
    ├── ops.json
    ├── server.properties
    ├── usercache.json
    └── whitelist.json

Миграция со старых версий (до 3.0.0)

Если вы раньше использовали мод, когда пакеты были ресурспаками, миграция занимает пару кликов. Установите новую версию и войдите в мир. Откройте главное меню мода (через Mod Menu или по клавише) и перейдите в экран 'Convert Legacy Packs'. Там будут перечислены старые пакеты - просто нажмите кнопку для каждого, чтобы сконвертировать. Если нужно сконвертировать несколько миров сразу или подготовить пакеты для сервера, отключите переключатель вверху, чтобы сохранить их в отдельную папку, и потом перенесите на сервер.

Создание собственного пакета картин

Формат пакета

Создайте папку, например My Custom Paintings, внутри - папку images и положите туда PNG-файлы ваших картин. Затем создайте файл custompaintings.json в корне пакета.

.
└── My Custom Paintings/
    ├── images/
    │   ├── castlescape.png
    │   ├── sunsetbeach.png
    │   ├── worldmap.png
    │   └── spookyforest.png
    └── custompaintings.json

Пример содержимого custompaintings.json:

{
  "id": "mycustompaintings",
  "name": "My Custom Paintings",
  "description": "My Custom Paintings",
  "paintings": [
    {
      "id": "castlescape",
      "name": "Castle in the Mountains",
      "artist": "Scott Lang",
      "width": 2,
      "height": 3
    },
    {
      "id": "sunsetbeach",
      "name": "Sunset at the Beach",
      "artist": "Claude Monet",
      "width": 2,
      "height": 2
    },
    {
      "id": "worldmap",
      "name": "World Map",
      "artist": "Scott Lang",
      "width": 4,
      "height": 3
    },
    {
      "id": "spookyforest",
      "name": "Nighttime Forest",
      "artist": "Scott Lang",
      "width": 3,
      "height": 1
    }
  ]
}

Свойства пакета

• id: текст, только латиница, цифры, подчёркивания и дефисы. Уникальный идентификатор пакета, должен отличаться от других пакетов и модов.
• name: необязательный текст, отображается в меню выбора.
• description: необязательное описание.
• paintings: список картин, каждая ссылается на файл в images (без расширения).
• migrations: автоматические миграции для разбиения больших пакетов. Обычно создаются редактором, вручную не нужны.

Свойства картины

• id: уникальный идентификатор, соответствует имени файла PNG.
• name: название картины.
• artist: автор.
• width, height: размер в блоках. Например, ванильная картина с обезьянкой занимает 4x3 блока.

Главное меню мода

В меню мода есть кнопки для настройки, управления паками и кэшем. Если установлен Mod Menu, доступ открывается через кнопку конфигурации в списке модов. Иначе используйте клавишу U по умолчанию в настройках управления.

Конфигурация

Мод имеет несколько конфигурационных файлов: клиентский глобальный и per-world. Для сервера настройки в папке мира.

Клиентская глобальная конфигурация (config/custompaintings.toml)

• Override vanilla render distance (overrideRenderDistance): true/false - переопределяет стандартную дистанцию рендера картин. false по умолчанию.
• Render distance scale (renderDistanceScale): целое от 1 до 64 - множитель дальности рендера. Работает при включённом overrideRenderDistance. По умолчанию 16.
• Cache images from the server locally (cacheImages): true/false - кэшировать изображения с сервера на диск. Ускоряет загрузку, но занимает место. По умолчанию true.
• Number of days to retain cached images (cacheTtl): целое от 1 до 1000 - срок хранения кэша. По умолчанию 14.
• Silence all legacy pack conversion prompts (silenceAllConvertPrompts): true/false - отключить напоминания о конвертации старых пакетов. false по умолчанию.
• Render the artwork on custom painting items (renderArtworkOnItems): true/false - показывать миниатюру на предмете. По умолчанию true.
• Render the artwork on vanilla painting items (renderVanillaArtworkOnItems): true/false - показывать миниатюру для ванильных картин. По умолчанию true.

Конфигурация для одного мира (saves/<мир>/config/custompaintings.toml)

• Silence legacy pack conversion prompts for this world (silenceConvertPrompt): true/false - отключить напоминания для этого мира.
• Use the stone cutter to choose specific paintings (pickPaintingWithStoneCutter): true/false - добавлять рецепты камнереза для кастомных картин. true по умолчанию.
• Use the stone cutter to choose specific vanilla paintings (pickVanillaPaintingWithStoneCutter): true/false - то же для ванильных картин. true по умолчанию.

Серверная конфигурация (world/config/custompaintings.toml)

• Throttle image transfers to clients (throttleImageDownloads): true/false - ограничивать скорость передачи изображений клиентам. Рекомендуется включать на серверах с 10+ игроками. По умолчанию true.
• Maximum number of image packets per second (maxImagePacketsPerSecond): целое - лимит пакетов в секунду. 0 отключает. По умолчанию 40.
• Maximum number of image packets per second per client (maxPerClientImagePacketsPerSecond): целое - лимит на каждого клиента.
• Maximum size for each image packet in KB (maxImagePacketSize): целое - максимальный размер пакета. По умолчанию 256.

Управление паками

В меню 'Manage Packs' отображаются все доступные паки. В одиночной игре или с правами оператора на сервере можно включать/выключать паки прямо из списка. В одиночной игре также работает drag-and-drop для добавления пакетов.

Конвертация старых паков

Если у вас есть паки для версий до 3.0.0, их можно конвертировать через соответствующую кнопку в главном меню.

Удаление мода и целостность данных

Начиная с v3.0.0, все данные картин хранятся в отдельных файлах внутри сохранения мира. Это значит, что можно загрузить игру без мода (например, после обновления Minecraft) без риска потерять картины. При повторной установке мода всё восстановится.

Версии до 3.0.0 (на ресурспаках)

До версии 3.0.0 мод работал иначе:

• Паки были ресурспаками. Их нужно было класть в resourcepacks/ и включать как обычный ресурспак. Не было встроенного менеджера паков и загрузки с сервера. На мультиплеере каждый игрок должен был иметь мод и одинаковые паки, иначе картины не отображались.
• Текстуры лежали в assets. custompaintings.json находился в корне ресурспака, а текстуры - в assets/<id пакета>/textures/painting/<id>.png.
• JSON был чуть другим. ID позволял только буквы и подчёркивания, не было поля description, текстуры без записи считались 1x1. Поля name и artist появились в v2.0.0.
• Управление через команды. Не было главного меню. Экраны очистки открывались через /custompaintings manage, а другие команды (identify, count, fix, move, reassign, remove) работали из чата.