CustomModelData

CustomModelData - серверный плагин для Minecraft, который решает одну конкретную, но очень частую задачу: назначить предмету своё значение Custom Model Data. Звучит сухо, но по факту это ключ к кастомным моделям. Без этой привязки любой ресурспак с новыми моделями остаётся просто картинками в папке.

Зачем это вообще нужно

В ванильном Майнкрафте у предметов есть система моделей: игра смотрит на компоненту Custom Model Data и по её значению выбирает, какую модель рисовать. Ресурспак может содержать десятки вариантов одной и той же палочки или алмаза, но по умолчанию игрок их никак не получит. Раньше приходилось лезть в NBT через редакторы или писать свои костыли на командных блоках. CustomModelData закрывает эту дыру: администратор берёт предмет в руку, вводит команду или пишет тег прямо в наковальне - и предмет уже выглядит иначе. Зайдёт тем, кто собирает кастомные предметы для сервера: квестовые награды, декоративные мечи, валюту, уникальный лут из данжей.

Как это работает на практике

Всё вертится вокруг двух вещей: тега предмета и значения, которое этот тег хранит. Плагин умеет и то, и другое, причём без лишних телодвижений.

Наковальня

Самый быстрый способ. Кладёте предмет в наковальню и дописываете параметры в квадратных скобках прямо к названию. Разделять можно пробелами или запятыми.

• Item name [TAG] - строковый тег
• Item name [1111] - числовое значение
• Item name [TAG, 1333] - сразу оба параметра

Удобно, когда нужно быстро переименовать десяток предметов подряд без команд. Правда, тут есть нюанс: наковальня съедает опыт и сбрасывает некоторые свойства предмета, так что для массовой работы лучше команда.

Команды

/customModelData <tags> - держите предмет в руке, команда навесит на него указанные теги. Значения перечисляются через пробел или запятую.

/customModelInfo - показывает в чате всё, что сейчас записано в Custom Model Data у предмета в руке. Полезно, когда разбираете чужой ресурспак или проверяете, не слетели ли теги после крафта.

Права доступа

Плагин раздаёт права по частям, что удобно на больших серверах, где не хочется давать модераторам лишнего:

• customModelData.info - доступ к /customModelInfo
• customModelData.command - доступ к /customModelData
• customModelData.cmd - установка Custom Model Data через наковальню
• customModelData.color - смена цвета предмета через наковальню

По умолчанию ничего из этого у обычных игроков нет, так что случайно сломать баланс они не смогут.

Совместимость и версии

Плагин рассчитан на Minecraft 1.21.4-1.21.8 и серверные платформы Paper, Purpur и Spigot. Клиенту ничего ставить не нужно: это чисто серверная штука, отдельный загрузчик вроде Fabric или Forge не требуется. Игроки заходят на сервер с ванильным клиентом и видят результат, если у них загружен ресурспак с нужными моделями.

Первый релиз 1.0 вышел 17 апреля 2025 года и заявлял совместимость с 1.21.4-1.21.5, позже диапазон расширили до 1.21.8. Проект распространяется под лицензией MIT, на Modrinth у него около 1,2 тыс. загрузок.

Важные нюансы

Плагин сам по себе не создаёт модели. Он только записывает значение в предмет, а как оно отобразится, решает ресурспак. Если модель не появилась - почти всегда виноват не плагин, а неправильно собранный пак: не совпало пространство имён, не тот путь к текстуре или забыли прописать условие в item-файле.

Ещё один момент: Custom Model Data работает как условие выбора модели, и если ресурспак не содержит варианта под конкретное значение, предмет выглядит как обычный. Так что сначала проверьте пак, потом лезьте в настройки сервера.

Для администраторов, которые держат сервер на BungeeHost, установка занимает буквально один клик - плагин просто кладётся в папку plugins, перезапуск и готово. Никаких зависимостей тянуть не нужно.

Кому подойдёт

Если вы делаете на сервере кастомные предметы, квесты, магазины или просто хотите разнообразить внешний вид инвентаря игроков - CustomModelData станет тем самым недостающим звеном между вашей идеей и ресурспаком. Скачать плагин CustomModelData стоит и тем, кто только начинает собирать свои наборы моделей: команда /customModelInfo быстро объяснит, как устроены теги на чужих примерах.

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