Amethyst Core

Amethyst Core: библиотека для создания магических модов

Amethyst Core — это библиотека-фреймворк, созданная для упрощения разработки модов на магическую тематику. Она предоставляет готовые инструменты для реализации систем модификаторов (альтернатива заклинаниям), артефактов в стиле схептеров, модульных тринкетов и предметов, работающих на мана-базе. Проект уже используется для создания модов серии Amethyst Imbuement.

Цель и возможности библиотеки

Amethyst Core позиционируется как мощный инструмент для разработчиков, желающих создать свой уникальный мод на магию. Она не включает в себя готовых рецептов крафта или прогрессии, предоставляя лишь фундаментальные механизмы. С её помощью можно реализовать систему имбуинга (насыщения) в духе Amethyst Imbuement, создать собственные уникальные системы магии или просто обеспечить совместимость между разными магическими проектами.

Система модификаторов (Modifiers)

Одной из ключевых функций библиотеки является фреймворк модификаторов, который работает как параллельная альтернатива системе заклинаний (Enchantments) из ванильного Minecraft. Автор отмечает, что стандартные заклинания слишком легко удаляются точильными камнями и лишены внутренней логики. Модификаторы решают эти проблемы: они являются постоянными (как префиксы), их функционал инкапсулирован, а уровни качества представлены через вкусную иерархию (например, от «Ржавый» до «Блестящий»). Библиотека включает встроенный помощник AugmentModifier, способный менять стоимость маны, перезарядку, урон заклинаний или вызывать эффекты вроде Безумия (Wither) вокруг игрока.

Артефакты и схемы (Scepters & Augments)

Для создания артефактов библиотека предлагает два основных класса: AbstractScepterItem для полного контроля над логикой предмета и DefaultScepterItem для быстрого создания совместимых схептеров. Также реализована система улучшений (Augments), которые можно добавлять к схептерам, тринкетам или снаряжению. Эти улучшения работают как расширенные заклинания, поддерживая сложные функции, такие как пассивные эффекты при тиковании или срабатывание при экипировке предмета.

Модульные тринкеты и управление мана-базой

Библиотека упрощает создание модульных тринкетов, позволяя комбинировать различные улучшения без жесткой привязки к заранее определенным эффектам. Для предметов, использующих мана вместо прочности, предоставляются интерфейсы и утилиты. Такие предметы не ломаются при достижении минимальной прочности, их можно легко восстанавливать, а также существует помощник для автоматического регенерирования маны. Это позволяет создавать магов, способных использовать заклинания длительное время без риска сломать оружие.

Дополнительные инструменты разработки

Amethyst Core предоставляет ряд вспомогательных функций для ускорения разработки: регистрация кастомных моделей предметов (по аналогии с Трезубцем), доступ к регистру событий тикования, простое добавление лута в таблицы дропа и создание частиц, которые следуют за игроком. Также можно регистрировать постоянные эффекты, которые будут срабатывать со временем, не требуя отслеживания их внутри кастомного кода. Для отображения модификаторов в интерфейсе есть встроенные методы, создающие подсказки с золотым текстом.

Связанные материалы

• YetAnotherConfigLib (YACL) — похожий мод
• Just Enough Items (JEI) — похожий мод
• Geckolib — похожий мод
• More Culling — похожий мод

Автор: fzzyhmstrs · Лицензия: MIT