Fzzy Core

Добро пожаловать в Fzzy Core! Это базовый API, который поддерживает некоторые моды Kotlin, созданные fzzyhmstrs (это я!). Помимо некоторых базовых служебных функций, которые пригодятся для множества различных типов модов, Fzzy Core включает в себя базовую структуру системы модификаторов, гибкую и мощную систему для модификации... практически всего!

В исходный код Fzzy Core интегрирован KDoc для руководства по использованию. Я также работаю над созданием вики!

Fzzy Core в настоящее время предназначен для Fabric. В настоящее время порт в Forge не планируется.

Fzzy Core — это часть моего проекта по разделению Amethyst Core на более функциональные составные части. Этот мод является основой этих частей, другие API в моем каталоге основаны на этой базе (например, Amethyst Core для магических модов)

Утилиты кодирования

Fzzy core содержит несколько утилит, которые немного упрощают кодирование модов! Эти утилиты включают в себя:

• Базовый класс чар, который можно легко интегрировать с системой конфигурации для отключения/включения отдельных чар.
• Обертка для текста, которая позволяет избежать головной боли, связанной с многоверсионными модами и необходимости постоянно бороться с конфликтами слияния при изменении текста.
• Система постоянных эффектов, которая позволяет создавать отложенные, повторяющиеся (или неповторяющиеся) события, которые не привязаны к определенному тику объекта или другой беспорядочной реализации.
• Система создания частиц, которая позволяет размещать частицы на стороне клиента в определенном месте точки зрения игрока. Это позволяет использовать предметы, с которых капают частицы, факел, испускающий дым, и т. д.

Синхронизированная система конфигурации

Создайте простую в управлении систему конфигурации, которая позволяет контролировать версии с течением времени и автоматически синхронизировать конфигурации сервера с присоединяющимися клиентами!

• Использует некоторые уникальные функции Kotlin для простой и понятной реализации.
• Вспомогательные методы для автоматического обновления файлов конфигурации до новых версий, захвата информации из старой версии перед заменой ее обновлением.
• Простая реализация функций автосинхронизации.

Предметы со специальным вкусом

Добавляйте базовые предметы или инструменты с помощью ароматного текста!

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

Предметы маны

Добавляет простую основу для создания предметов, которые используют ману, а не повреждаются обычным способом.

Платформа модификаторов

Modifier Framework — это гибкая и расширяемая система, созданная параллельно стандартной системе Enchanting. Модификаторы призваны решить две самые большие проблемы, которые я обнаружил при наложении чар: их легко удалить, и они не усваивают свою функциональность (за исключением пары методов нанесения урона). Чары также более скучны, чем могли бы быть, поскольку их уровень отображается простым числом. Модификаторы призваны исправить все эти проблемы!

• Модификаторы предназначены для постоянного действия и больше похожи на аффиксы. Например, точильные камни не могут их удалить.
• Модификаторы разработаны с учетом их функциональности и могут называться как единое целое, а не по частям.
• Модификаторы действуют через «генеалогическое древо», что позволяет создавать разнообразные уровни. Представьте себе, что меч меняется от «Ржавого» к «Блестящему», затем к «Сверкающему» и т. д.

Библиотека поставляется со встроенным вспомогательным методом для отображения модификаторов. Пример подсказки, демонстрирующей модификаторы золотым текстом

Более подробную информацию об этих функциях можно найти по ссылке на вики выше. После внедрения система модификаторов может делать практически все, что угодно. Например, Amethyst Core имеет встроенный модификатор AugmentModifier, который влияет на стоимость маны и время восстановления, изменяет урон или дальность заклинания и запускает расширенные эффекты, такие как поражение каждого моба в радиусе 12 блоков вокруг заклинателя с помощью Wither при любом успешном применении заклинания.

Модификаторы могут быть такими же простыми, как контейнер для передачи обычных AttributeModifiers, или гораздо более сложными, чем описанный выше AugmentModifier. При желании их можно даже использовать просто для вкуса!

НБТ Утилита

Fzzy Core включает в себя простую утилиту для выполнения некоторых полезных действий с NBT.

• читать и записывать BlockPos с помощью одного вспомогательного метода вместо сохранения координат X, Y, Z вручную или выполнения длинного преобразования.
• Несколько утилит NbtList для чтения, добавления и удаления из NbtLists.
• Система ItemStackId для присвоения уникального идентификатора определенным стопкам предметов. Это позволяет, например, связать ItemStack с конкретным объектом блока... или многое другое!
• Вспомогательный метод для переноса незачарованных НБТ из одного стека в другой.

Утилита Raycaster

Простой набор вспомогательных методов для поиска объектов.

• Серверное рейкастинг для обнаружения игровых объектов без необходимости использования сложной сети.
• Вспомогательные методы для сущностей, блоков и определения местоположения объектов в областях вокруг точки (например, игрока).
• Возможность проверки объектов с произвольно повернутыми кубоидами. Все системы обнаружения Minecraft по умолчанию используют поля, выровненные по сетке XYZ. Это полезно, например, для проверки того, каких врагов поражает заклинание, даже если игрок смотрит по диагонали и вверх по холму.

Реестр событий

Реестр для добавления и отслеживания основных объектов тикания, не связанных с конкретными объектами, такими как сущности.

• Полезно для создания периодических часов, которые срабатывают только через каждые X тактов, что позволяет создавать методы тактов, которые не срабатывают каждый такт. Фактически, в реестр встроены таймеры с интервалом в 1 секунду, 1,5 секунды и 2 секунды.
• Добавляет интерфейс TickUppable и класс Ticker для регистрации объектов в реестре.

Реестр моделей предметов

Хотите сделать собственный трезубец, но не можете понять, как, черт возьми, сделать так, чтобы трезубец в руке выглядел так же, как у MC? Этот реестр для вас!

• Регистрация пользовательских моделей предметов для определенных режимов рендеринга (в руках, на земле и т. д.)
• Интегрируется со стандартным Fabric InternalItemRendererRegistry.DynamicItemRenderer.

###Очередь эффектов

Ненавижу, как добавление пассивных эффектов статуса иногда приводит к тому, что статусы «дерутся» в графическом интерфейсе, причем статусы быстро меняются взад и вперед?

• Эта простая утилита объединяет добавление всех переданных в нее статусных эффектов в предсказуемом порядке.
• Использует всю стандартную информацию о статусных эффектах, которую вы ожидаете от addStatusEffect.

Утилиты для брелоков

Fzzy Core опционально интегрируется с Trinkets, добавляя некоторые служебные функции, которые можно использовать с ними.

• getTrinketStacks предоставляет список всех тирнкетов, экипированных прошедшему живому существу.
• Интерфейс AugmentTasks позволяет создавать безделушки, которые взаимодействуют со специальными чарами, называемыми дополнениями. Эти улучшения позволяют использовать аксессуары с настраиваемыми пассивными и активными способностями.