Default Components

Default Components - серверный мод для Minecraft (Fabric и Quilt), который даёт возможность менять базовые характеристики предметов через обычные датапаки. Без правки кода, без сложных скриптов - всё на чистых данных.

Зачем это нужно

Начиная с версии 1.20.5 и далее в 1.21, Майнкрафт перешёл на новую систему item components - это замена старым NBT-тегам. Компоненты определяют, является ли предмет едой, инструментом, какой у него урон, прочность, зачарования и так далее. Default Components позволяет вам брать любой предмет - ванильный или из мода - и добавлять, убирать или менять эти компоненты через датапак.

По факту, это даёт огромную власть над балансом. Хотите сделать землю съедобной? Легко. Превратить палку в меч? Без проблем. Убрать прочность у алмазной кирки? Тоже можно. Всё через простой data-driven подход, который не требует знания Java.

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

• Релоад на лету - изменения подхватываются мгновенно, без перезапуска сервера. Поправили датапак - сразу видите результат.
• Полностью на данных - всё работает через датапаки, никаких конфигов в коде. Просто и понятно.
• Серверная сторона - мод работает на сервере, ванильным клиентам ничего ставить не нужно. Они просто подключаются и играют.
• Поддержка модовых предметов - работает не только с ванильными шмотками, но и с предметами из других модов.
• Поддержка модовых компонентов - если какой-то мод добавил свой компонент, Default Components умеет с ним работать.
• Клиентский код для расширения - если поставить мод ещё и на клиент, можно выйти за рамки серверных ограничений. Например, корректно отображать изменённые предметы в REI и других интерфейсах.

Для сборок модов - это находка

Если вы собираете модпак (или сборку модов, как вам удобнее), Default Components решает классическую проблему: вам нужно подправить баланс предметов, но вы не хотите форкать каждый мод и ковыряться в исходниках. Просто пишете датапак, указываете какие компоненты у какого предмета должны быть - и готово.

Примеры из практики:

• Сделать любой предмет едой (добавить minecraft:food компонент)
• Превратить предмет в инструмент с нужными характеристиками
• Убрать компонент, который делает предмет слишком мощным - отличная функция для балансировки
• Переопределить существующие свойства, не удаляя их полностью

Серверный моддинг с ванильной совместимостью

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

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

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

• Minecraft: 1.21 - 1.21.10 (актуальные сборки - alpha для 1.21 и 1.21.4)
• Загрузчики: Fabric, Quilt
• Режимы: сервер-only и клиент+сервер

Проект сейчас на стадии alpha - это нормально для инструмента, который активно дорабатывается. В последних обновлениях пофикшены проблемы с тегами, wildcard-целями (когда можно применить компоненты сразу ко всем предметам через маску) и сетевыми проверками.

Совет: Перед использованием в продакшене обязательно протестируйте на тестовом мире. Alpha-версии могут иметь неожиданные баги, особенно при работе с предметами из других модов. Проверяйте каждый компонент по отдельности, а не всё сразу.

Технические детали

Мод работает с обоими типами компонентов - ванильными (food, tool, damage, max_stack_size, enchantments и другие) и модовыми. Это значит, что если какой-то мод добавил свой кастомный компонент, вы можете манипулировать и им через датапак.

Wildcard-таргеты позволяют применить изменения сразу ко всем предметам или к группе по тегу. Например, можно добавить компонент еды всем предметам с тегом minecraft:tools - и каждый инструмент станет съедобным. Звучит абсурдно, но для весёлых сборок - самое то.

Скачайте Default Components, если вам нужен мощный data-driven инструмент для тонкой настройки предметов в Майнкрафт без единой строчки кода. Особенно полезно для авторов модпаков и админов серверов, которым нужна гибкая балансировка.