Пользовательский предмет состоит из серверного описания и клиентских ресурсов. Если конфигурация загрузилась, но игрок видит обычный материал, проверьте доставку ресурспака и соответствие модели. Рабочая локальная текстура в редакторе ещё не подтверждает правильную сборку пакета.
Гайды
ItemsAdder: добавить свой 3D-предмет на сервер
Путь 3D-предмета в ItemsAdder: namespace, модель и текстура, конфигурация, сборка ресурспака, выдача и проверка обычным клиентом.
На странице 10 разделов
Коротко
Главное — дальше подробности
Выберите ItemsAdder, ядро и Minecraft по таблице совместимости автора. Формат моделей новых веток Minecraft отличается от старых схем CustomModelData. До изменений сохраните папку contents, конфигурацию и рабочий pack. Не переносите старые числовые настройки модели в новый выпуск без руководства миграции.
Создайте уникальный namespace, например myproject, и короткий внутренний id предмета. Имена файлов пишите строчными латинскими буквами без пробелов. Экспортируйте Java-модель из Blockbench и проверьте путь каждой текстуры. Текстура должна быть доступна в итоговом namespace, а не только по абсолютному пути редактора. Проверьте положение в руке и на земле через display-настройки модели.
В contents создайте отдельный пакет со структурой и YAML по документации вашей версии ItemsAdder. Укажите info.namespace, id, отображаемое имя, базовый материал и путь модели. При готовой 3D-модели используйте предусмотренный режим внешней модели вместо генерации плоской текстуры. Сначала добавляйте один предмет: ошибка отступа или пути не должна затеряться среди сотни новых записей.
Перечитайте данные и соберите pack документированными командами выпуска; в распространённых ветках используются /iareload и /iazip. Изучите журнал ошибок до выдачи. Убедитесь, что выбранный способ хостинга доступен клиенту извне и что сервер отдаёт новую версию пака. Не публикуйте локальный адрес или временный токен вместо доступной ссылки. Клиент должен принять пакет и завершить загрузку.
| Где | Что проверить |
|---|---|
| Инвентарь | Имя, иконка и отсутствие missing texture |
| Рука | Масштаб и поворот с двух сторон |
| Земля и рамка | Ориентация и читаемость |
| Другой клиент | Ресурсы действительно доставляются |
| Повторный вход | Предмет сохраняется и не превращается в базовый материал |
Выдавайте через документированный id namespace:item, обычно командой /iaget. Для торговли отдельно проверьте, что магазин различает ваш предмет и обычный базовый материал.
Чёрно-розовая текстура указывает на ресурсную проблему; обычный ванильный предмет — на привязку модели, версию формата или отсутствие пака. Невидимость только в одной позиции проверяйте через display и геометрию. Удаление предмета из конфигурации не удаляет автоматически все уже выданные экземпляры: планируйте миграцию id заранее.
Нужен ли мод клиенту?
Обычная задача решается ресурспаком и серверной интеграцией, но поддерживаемый клиент и версия пакета обязательны.
Можно ли использовать модель для другой редакции?
Сначала нужен корректный формат Java-модели и поддержка возможностей выбранным ItemsAdder.
Почему вижу модель только я?
Проверьте доставку pack на чистом втором клиенте: локальная установка у автора не доказывает серверную выдачу.
Справка сверена 2 ноября 2026 года. Версии проектов и условия примеров указаны в тексте.
Читайте дальше
Техно
Pterodactyl
Pterodactyl: панель, Wings и первый Minecraft-сервер
Архитектура Pterodactyl и путь установки: панель, база, очереди, Wings, Docker, allocations и проверка первого Minecraft-контейнера.
Техно
Экономика сервера
Экономика сервера: Vault, магазины и аукцион
Связка валюты, Vault, QuickShop или ChestShop и AuctionHouse: выбор провайдера, права, комиссии, возврат товара и проверка торговых обходов.
15
плагинов
Плагины для сервера Майнкрафт: 15 обязательных на Paper
LuckPerms, EssentialsX, WorldGuard, CoreProtect, AuthMe, Grim, TAB и ещё восемь плагинов, без которых не обходится почти ни один сервер без модов. Что делает каждый, что ему нужно рядом и в каком порядке ставить.