Gear Core

Мод Gear Core для Minecraft — библиотека модификаторов предметов

Gear Core — это библиотека-помощник для создания модификаторов экипировки в Minecraft. Она позволяет привязывать стандартные атрибуты сущностей к предметам, а также отслеживать различные игровые события: получение урона, убийство мобов, разрушение блоков и использование предметов. Мод работает в связке с Fzzy Core и поддерживает как нативные типы экипировки, так и кастомные предметы через систему Gearifiers. С версии 0.3.0 добавлена поддержка создания бонусов наборов экипировки через datapack.

Gear Core предоставляет мощный фреймворк для добавления к предметам эффектов, которые не зависят от стандартных механик Minecraft, таких как точильные камни или алтари enchanting. Вместо простого сложения значений, модификаторы можно организовывать в цепочки (lineages), где эффекты передаются от одного предмета к другому. Это открывает возможности для создания RPG-систем, где бонусы накапливаются или трансформируются при смене экипировки.

С версии 0.3.0 проект получил возможность создания бонусов наборов экипировки (Gear Sets) через datapack. Авторы могут определять комбинации предметов, которые дают специфические атрибуты или эффекты. Поддерживаются уровни наград (tiers), кастомное форматирование подсказок и интеграция с EMI для отображения всех наборов и описаний бонусов. Бонусы могут привязываться к любым атрибутам, включая кастомные, и работать в связке с Equipment Modifiers. Пока что атрибуты можно добавлять только через datapack, тогда как модификаторы требуют написания кода.

Библиотека поддерживает широкий спектр предметов из коробки: броню (ArmorItem), инструменты (ToolItem), луки (BowItem, CrossBowItem), щиты (ShieldItem), триденты (TridentItem) и предметы Trinkets. Однако благодаря интеграции с Fzzy Core, фреймворк позволяет сделать модифицируемыми практически любые другие типы предметов, если в них будет добавлена соответствующая логика. Пример работы модификаторов демонстрирует, как они накладываются на предметы, создавая уникальные эффекты.

Основной функционал модификаторов экипировки включает несколько ключевых аспектов:

• Модификация атрибутов: К предметам можно привязывать стандартные атрибуты Minecraft. Они суммируются с врождёнными характеристиками предмета и другими модификациями.
• Износ: Можно изменять прочность предмета с помощью PerLvlI из Fzzy Core, применяя фиксированные изменения или процентные скидки.
• Событие после удара: Реализация может реагировать на метод postHit, выполняя действия после того, как игрок ударил что-либо.
• Событие после добычи: Аналогично ударам, существуют потребители для postMine, срабатывающие после успешного разрушения блока.
• Событие использования: Позволяет добавлять активные способности к предметам. Событие срабатывает при нажатии правой кнопки мыши, если стандартное действие use не было успешным.
• Урон и события получения урона: Можно модифицировать входящий урон (например, снижать магию на 10%) и запускать код при получении урона.
• Убийство мобов: Срабатывает событие при убийстве моба игроком, передавая данные для обработки реализации.
• Другие модификаторы: Поддерживаются произвольные типы модификаторов через ModifierProcessor, позволяя автору решать, что делать с ними.

Для генерации случайных свойств предметов реализована система роллов (Modifier Rolling System). Она работает по следующему принципу:

1. Цели (Targets): Введены классы EquipmentModifierTarget, похожие на EnchantmentTarget, но расширяемые. Выбор модификаторов происходит только из целей, соответствующих предмету.
2. Вес (Weight): Как и в луте, каждому модификатору можно задать вес. Модификаторы добавляются в пул пропорционально этому весу.
3. Редкость (Rarity): Определяет форматирование подсказки предмета (цвет и жирность). Доступны уровни: Legendary (золото, жирный), Epic (светло-фиолетовый), Rare (голубой), Uncommon (тёмно-зелёный), Common (серый), Bad и Really Bad (тёмно-красный).
4. Плата (Toll): Каждый модификатор «стоит» очков из общего пула. По умолчанию плата 5, а средний размер пула около 5.75. Изменяя плату, можно тонко настроить вероятность выпадения.
5. Сохранность и доступность: Модификаторы могут быть помечены как persistent (не удаляются при перероле, например, врождённые или проклятые) или недоступными для случайного выбора.

Примеры использования библиотеки включают создание предметов с уникальными свойствами, которые меняются в зависимости от ситуации или комбинации с другими предметами. Авторы могут использовать JSON-конфигурации для описания наборов экипировки, где указываются атрибуты, их значения и операции (сложение, умножение). Поддержка таких систем позволяет создавать глубокие RPG-механики без необходимости писать сложную логику с нуля, делегируя часть работы фреймворку Gear Core и Fzzy Core.