ItemsAdder vs Oraxen: какой плагин кастомных предметов выбрать в 2026

Кастомные предметы и блоки давно перестали быть фичей крупных RPG-серверов. Сегодня даже маленький SMP добавляет уникальный кирпич, мебель или меч с особой моделью, чтобы выделиться среди сотен типовых проектов. В этом гайде разбираю ItemsAdder и Oraxen по делу: что общего, где они расходятся, и какой выбрать под ваш сценарий.

Зачем серверу кастомные предметы

Стандартный Minecraft даёт около 1300 предметов. Этого хватает для ванильного выживания, но как только начинается RP, экономика, квесты или RPG, ванильных текстур не хватает. Игроки видят 50 одинаковых железных мечей и быстро теряют интерес.

Кастомные предметы решают сразу несколько задач:

• уникальный лут, который нельзя получить в обычном Minecraft
• кастомные блоки для декора и иммерсии (мебель, фонари, ящики)
• кастомные мобы и оружие для RPG-механик
• визуальный брендинг проекта, который запоминается

Под капотом оба плагина опираются на один и тот же ванильный механизм: CustomModelData в текстурном паке. Сервер посылает предмет с нужным NBT-тегом, клиент видит другую модель из подгруженного ресурс-пака. Никакой модификации клиента не нужно, всё работает на чистом Vanilla launcher.

# Упрощённая логика
item:
  material: PAPER
  custom_model_data: 100001
  display_name: "<gold>Древняя карта"

Дальше ресурс-пак содержит модель assets/myserver/models/item/ancient_map.json, привязанную к custom_model_data: 100001. Клиент рендерит её вместо листа бумаги.

Оба плагина автоматизируют этот процесс: вы пишете конфиг, плагин собирает финальный ресурс-пак и подсовывает его игрокам.

ItemsAdder: что это и за что просят $25

ItemsAdder это премиум-плагин на SpigotMC от автора LoneDev. Цена около 24.99 евро за один сервер, обновления и поддержка пожизненно. Плагин платный, и это ключевой барьер для маленьких проектов, но за деньги получаешь много.

Что входит:

• огромная библиотека готовых паков в комьюнити: мебель, оружие, броня, мобы, целые тематические наборы
• автохостинг ресурс-пака через встроенный сервер плагина или через внешний CDN
• визуальный GUI Builder для создания меню с инвентарными слотами без YAML
• интеграция с MythicMobs, ModelEngine, WorldGuard, Vault
• поддержка кастомных мобов с собственными моделями, AI-настройками и анимациями через ModelEngine
• кастомные блоки на основе Note Block, String Block, Tripwire, Bonemeal hack для разнообразия

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

# config/items_adder/contents/myserver/configs/items.yml
info:
  namespace: myserver
items:
  golden_sword:
    display_name: "<gold>Меч короля"
    permission: myserver.items.golden_sword
    resource:
      material: GOLDEN_SWORD
      generate: true
      textures:
        - item/golden_sword.png
    behaviours:
      basic_durability:
        max_custom_durability: 2500

После сохранения файла команда /iazip собирает ресурс-пак, плагин кладёт его на встроенный HTTP-сервер и при заходе игрока отдаёт ссылку.

Oraxen: open-source альтернатива

Oraxen долго был полностью бесплатным open-source плагином, но в 2023 году ядро перешло в премиум-модель на Polymart (около 14.99 евро). Тем не менее старые версии остались open-source, форки активно развиваются, а основная философия проекта осталась прежней: простота и YAML-first подход.

Сильные стороны Oraxen:

• активное комьюнити с десятками бесплатных паков на GitHub
• простая структура конфигов: один YAML на категорию предметов
• встроенные глифы для эмодзи в чате через Unicode
• кастомные блоки через NoteBlock и StringBlock механики
• легко интегрируется с MythicMobs, ModelEngine, WorldGuard
• собирает ресурс-пак, но хостить его нужно отдельно, например на S3, Cloudflare R2 или собственном HTTP-сервере

Oraxen меньше по объёму готового контента, но это плюс для тех, кто рисует свои текстуры. Ничего лишнего, минимум магии под капотом, конфиги читаются за пять минут.

# plugins/Oraxen/items/weapons.yml
king_sword:
  displayname: "<gold>Меч короля"
  material: GOLDEN_SWORD
  Pack:
    generate_model: true
    textures:
      - default/items/king_sword.png
  Mechanics:
    durability:
      value: 2500

Что общее у обоих плагинов

Несмотря на разную бизнес-модель, технически они близки:

1. CustomModelData как основа подмены моделей.
2. Поддержка Paper, Purpur, Pufferfish версий 1.19 - 1.21.x. Folia поддерживается частично, тяжёлые механики типа кастомных блоков на NoteBlock могут ломаться в region-threading.
3. Автогенерация JSON-моделей на основе PNG-текстур.
4. Хуки в MythicMobs, ModelEngine, WorldGuard, Vault, PlaceholderAPI.
5. Собственные Furniture API: можно ставить столы, стулья, лампы как entity-based блоки.
6. Поддержка кастомной брони через trim или окрашивание leather armor в hex-цвет с привязкой к шейдеру.

В обоих случаях вы получаете рабочий ресурс-пак на выходе, который раздаётся игрокам через server-resource-pack в server.properties либо через сам плагин.

Где плагины расходятся

Здесь начинается главное. Я разбил различия по практическим категориям, как они влияют на админа.

Custom blocks и Furniture

ItemsAdder дальше зашёл в эксперименты: помимо классических NoteBlock и StringBlock есть REAL_NOTE механика с использованием каждой ноты для уникального блока, плюс Bonemeal hack для увеличения количества доступных ID. На сервере с 500+ кастомных блоков это критично.

Oraxen ограничивается NoteBlock и StringBlock, но этого хватит для большинства проектов. До 800 уникальных блоков на NoteBlock + столько же на StringBlock. Если вы не делаете огромный RPG-сервер с тысячами блоков, разницы не почувствуете.

Resource pack hosting

Главное практическое отличие. ItemsAdder поднимает встроенный HTTP/HTTPS сервер или загружает пак на свой CDN. Игрок зашёл, плагин отдал ссылку, всё работает.

Oraxen собирает финальный пак в plugins/Oraxen/pack/pack.zip, но раздачей не занимается. Варианты:

• свой nginx с раздачей статики
• Cloudflare R2 + публичный bucket
• бесплатный Self-hosted hosting на VPS
• внешний сервис типа resource-pack-host.com

Это плюс одна задача в чеклист установки, но не критично.

GUI и меню

ItemsAdder имеет встроенный GUI Builder: рисуете меню в текстурном редакторе, привязываете кнопки в YAML, получаете полностью кастомный интерфейс. Удобно для аукционов, банков, квестовых журналов.

Oraxen GUI делается через сторонние плагины типа DeluxeMenus или TrMenu. Это гибче, но требует ещё один плагин в стек.

Документация и комьюнити

ItemsAdder имеет официальную wiki и большой Discord. Oraxen более компактный, но GitHub Issues и Discord активны. По моему опыту, на узкие вопросы в Oraxen отвечают быстрее, потому что комьюнити меньше и плотнее.

Производительность и совместимость

И тот и другой плагин при правильной настройке не дают заметной просадки TPS. На сервере с 200 кастомных предметов и 50 кастомных блоков оба съедают около 5-10% дополнительной CPU при пиковой нагрузке. Память: примерно +150-300 MB на хип в зависимости от размера ресурс-пака.

Что влияет на производительность:

• количество кастомных блоков на NoteBlock: каждый требует обработки физики ноты при placement
• furniture entities: много мебели = много пассивных entity, держите в пределах 10-20 на чанк
• размер ресурс-пака: пак больше 100 MB снижает retention, игроки бросают подключение на загрузке

# Проверка пинга на ресурс-пак с сервера
curl --connect-timeout 3 -I https://your-cdn.com/pack.zip
# Целимся в Content-Length меньше 80MB

Folia: ItemsAdder в 2026 имеет частичную поддержку, Oraxen тоже работает, но с оговорками по NoteBlock-механикам. Если у вас Folia, тестируйте на стейджинге перед продом.

Цены и лицензирование

Параметр	ItemsAdder	Oraxen
Цена	~$25 один раз	~$15 один раз (Premium)
Бесплатная версия	нет	старые форки + community fork
Лицензия	один сервер	один сервер
Обновления	пожизненно	пожизненно
Поддержка	Discord + wiki	Discord + GitHub

ItemsAdder часто бывает в скидках на SpigotMC и Polymart, можно поймать за 18-20$. Oraxen Premium держит фиксированную цену.

Когда что выбрать

Если коротко:

Берите Oraxen, если:

• маленький RP/SMP сервер, бюджет ограничен
• рисуете свои текстуры и не нужны готовые паки
• комфортно с YAML, не нужен визуальный GUI builder
• готовы поднять свой хостинг для ресурс-пака

Берите ItemsAdder, если:

• коммерческий или контент-heavy проект
• нужна готовая мебель, оружие, мобы из коробки
• нет времени и желания рисовать всё самостоятельно
• важен встроенный хостинг ресурс-пака без головной боли
• планируете кастомные GUI без сторонних плагинов

На своих серверах я держу Oraxen на маленьких SMP и ItemsAdder на крупных RPG-проектах. Оба плагина рабочие, выбор скорее про экономику и контент-стратегию, чем про техническое превосходство.

Доставка ресурс-пака игрокам

Независимо от выбора плагина, конечная цель одна: игрок получает пак автоматически при заходе. Два рабочих способа:

1. Через server.properties:

resource-pack=https://your-cdn.com/pack.zip
resource-pack-sha1=ABC123DEF456...
require-resource-pack=true
resource-pack-prompt=Загрузите пак для уникального контента

2. Через сам плагин: ItemsAdder и Oraxen умеют отдавать ссылку на пак при join, перекрывая server.properties. Это удобнее, потому что хеш SHA1 обновляется автоматически при перегенерации.

Если игрок отказался от пака, кастомные предметы будут отображаться как ванильные (бумага, лист, тыква) с правильным именем и лором, но без модели. Серверы с обязательным паком блокируют отказ через require-resource-pack=true.

FAQ

Можно ли использовать ItemsAdder и Oraxen одновременно

Технически да, но не нужно. Оба используют CustomModelData и могут конфликтовать на одинаковых ID. Если очень хочется, разнесите namespace и custom_model_data диапазоны: например, ItemsAdder использует 100000-199999, Oraxen 200000-299999. Это создаёт сложности при апдейтах, на проде такая связка ломается.

Видны ли кастомные предметы на Bedrock через Geyser

Только если используете GeyserMC + Floodgate + Hydraulic или GeyserOptionalPack. Geyser сам по себе не транслирует CustomModelData в Bedrock-формат. Hydraulic конвертирует Java ресурс-пак в Bedrock pack, который раздаётся Bedrock игрокам. Работает, но не все механики поддерживаются (мебель часто отображается некорректно).

Что делать, если игрок не хочет качать resource pack

Два варианта. Первый: require-resource-pack=true в server.properties, без пака на сервер не пустят. Второй: оставить опциональным, тогда у игрока без пака предметы будут выглядеть как ванильные базовые материалы. Для RP-серверов первый вариант стандарт, для PvP/выживания второй приемлем.

Можно ли купить ItemsAdder дешевле

На SpigotMC и Polymart бывают сезонные скидки 20-30%, особенно на Black Friday и летние акции. Цена опускается до 17-19$. Покупайте только через официальные платформы, никаких null-репозиториев и cracked версий: они часто содержат бекдоры или майнеры.

Что лучше для Folia в 2026

Oraxen в текущих версиях работает чуть стабильнее на Folia за счёт меньшего количества асинхронных операций с NoteBlock. ItemsAdder тоже работает, но требует тщательного тестирования. Если строите Folia-сервер с нуля, начните с Oraxen.

Сколько весит средний ресурс-пак

Маленький проект с 50-100 предметами: 5-15 MB. Средний RP-сервер с мебелью и бронёй: 30-60 MB. Большой RPG с тысячей предметов и кастомными мобами: 100-300 MB. После 100 MB заметно растёт процент игроков, бросающих загрузку, режьте пак или используйте текстуры меньшего разрешения.

Поддерживают ли плагины Minecraft 1.21.4 и выше

Оба активно обновляются. ItemsAdder обычно отстаёт от релиза Minecraft на 1-2 недели, Oraxen быстрее за счёт меньшей кодовой базы. На 1.21.x работают оба, проверяйте changelog перед обновлением сервера.

Что дальше

Если вы только начинаете с кастомным контентом, не пытайтесь сразу собрать свой пак с нуля. Возьмите Oraxen, скачайте пару готовых паков с GitHub и поиграйте с конфигами. Через неделю станет понятно, какие ограничения мешают, и тогда уже принимайте решение про переход на ItemsAdder.

Параллельно подумайте про защиту сервера: чем уникальнее контент, тем больше DDoS-атак от завистливых конкурентов. MineGuard фильтрует L4/L7 атаки на Minecraft-серверы и не даёт положить ваш проект в самый горячий момент после релиза нового пака. Перед публичным запуском кастомного контента проверьте, что фильтрация настроена и резервный канал доступен.

И последнее: всегда держите бекап pack.zip и YAML-конфигов в отдельном репозитории. Восстанавливать пак с нуля после краха диска занимает дни.