AcornLib

AcornLib представляет собой мощную библиотеку для разработчиков модов Minecraft, предлагающую широкий набор инструментов и компонентов для упрощения процесса создания модификаций.

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

Утилиты для моддинга

• Эффекты уничтожения: Предметы с эффектами при убийстве (стандартные и без смерти - эффект срабатывает, но сущность остается живой, как при использовании тотема)
• Система событий:
  • Событие возможности потребления (запрещает сущностям есть при false)
  • Событие возможности лечения (запрещает сущностям лечиться при false)
  • Кастомное событие риптайда (возвращает опциональный идентификатор)
  • Событие рендера наложения на экран (отображает оверлей поверх экрана игрока)
• Класс настроек предметов: Упрощенное применение компонентов
• Усовершенствованный горящий предмет: Применяет огонь перед нанесением урона, что позволяет получать приготовленную еду при одном ударе
• Базовые предметы со скинами
• Предмет ломающий щиты: Возвращает количество секунд для отключения щита
• Вспомогательные классы: ItemUtils, MiscUtils, ParticleUtils, PortingUtils, VelocityUtils

Совместимость с ModMenu

• Изменение цвета названия мода в ModMenu
• Добавление до двух иконок для вашего мода

Дополнительные компоненты предметов

• Двуручный компонент
• Компонент следования за камерой (предмет направляется в сторону взгляда держателя)
• Компонент показа руки при удержании предмета
• Компонент невозможности выброса
• Компонент скина предмета
• Компонент кастомных частиц при ударе
• Компонент кастомного звука при ударе
• Компонент частиц размаха
• Компонент вторичной модели (отображает кастомный предмет с идентичными компонентами)
• Компонент третичной модели

Дополнительные команды

• Команда скорости (точная и направленная)
• Команда AcornLib (только для разработки, проверяет является ли игрок поддержавшим)

Система поддержки

• Возможность сделать моды доступными только для поддержавших
• Кастомные привилегии для поддержавших и друзей в других модах

Примеры использования

Компонент кастомных частиц при ударе

give @s acornlib:gnarp_plush[acornlib:hit_particle={particle:"acornlib:green_sweep"}]

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

Компонент кастомного звука при ударе

give @s acornlib:gnarp_plush[acornlib:hit_sound={soundEvent:"acornlib:block.gnarp_plush.honk"}]

Компонент вторичной/третичной модели

give @s acornlib:gnarp_plush[acornlib:secondary_model="carrot"]

Инструкция по внедрению

Добавьте в репозитории:

repositories {
    // Modrinth
    exclusiveContent {
        forRepository {
            maven {
                name = "Modrinth"
                url = "https://api.modrinth.com/maven"
            }
        }
        filter {
            includeGroup "maven.modrinth"
        }
    }

    // Mod Menu
    maven {
        name = "Terraformers"
        url = "https://maven.terraformersmc.com/"
    }
}

Добавьте в зависимости:

dependencies {
    // AcornLib
    modImplementation "maven.modrinth:acornlib:${project.acornlib_version}"

    // Config
    modApi ("com.terraformersmc:modmenu:${project.modmenu_version}")
    modImplementation ("maven.modrinth:midnightlib:${project.midnightlib_version}+1.21.4-fabric")
}

Благодарности

Текстура желудя создана пользователем ShinyEmerald в ресурспакете, доступном по ссылке.