Hearty

Hearty

Мод для NeoForge, который добавляет несколько функций, меняющих отображение здоровья в Minecraft.

Для моддеров

Добавление в существующий проект Gradle

Вставьте следующий блок внутрь блока repositories в вашем build.gradle или build.gradle.kts.

maven {
    name = "GPR for Hearty"
    url = uri("https://maven.pkg.github.com/zygzaggaming/hearty")
    credentials {
        username = project.findProperty("gpr.user") ?: System.getenv("GITHUB_ACTOR")
        password = project.findProperty("gpr.key") ?: System.getenv("GITHUB_TOKEN")
    }
}

Затем настройте свойства Gradle gpr.user и gpr.key — укажите ваше имя пользователя GitHub и персональный токен доступа с правом read:packages. КРАЙНЕ рекомендуется хранить эти свойства в глобальном файле gradle.properties (`.gradle\gradle.properties), а не в gradle.properties` вашего проекта.

Если вы используете GitHub Actions для сборки мода, переменные окружения GITHUB_ACTOR и GITHUB_TOKEN уже заданы, так что не беспокойтесь о том, что удалённые сборки упадут из-за отсутствия аутентификации.

Затем в том же build.gradle(.kts) добавьте следующую строку в блок dependencies:

localRuntime(variantOf(libs.hearty) { classifier("all") })

А в ваш gradle\libs.versions.toml:

[versions]
hearty = { strictly = "[<min-version>,<max-version>)", prefer = "latest.release" }

[libraries]
hearty = { id = "io.github.zygzaggaming.hearty.mod", name = "hearty", version.ref = "hearty" }

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

Импорт мода Hearty напрямую также импортирует API по расширению. Однако если вы хотите, чтобы ваш мод взаимодействовал с Hearty, не упаковывая его как зависимость, вам нужно импортировать API напрямую.

Чтобы импортировать API, добавьте этот блок в то же место, что и выше:

maven {
    name = "GPR for Hearty"
    url = uri("https://maven.pkg.github.com/zygzaggaming/hearty")
    credentials {
        username = project.findProperty("gpr.user") ?: System.getenv("GITHUB_ACTOR")
        password = project.findProperty("gpr.key") ?: System.getenv("GITHUB_TOKEN")
    }
}

В любом месте верхнего уровня вашего build.gradle(.kts) добавьте строку jarJar.enable(), чтобы включить Jar-in-Jar и упаковать API в ваш мод при сборке. build.gradle(.kts) dependencies:

jarJar(group: 'io.github.zygzaggaming.hearty.api', name: 'hearty-api', version: '[<min-version>, <max-version>)') {
    jarJar.pin(it, '<chosen-version>')
}
implementation libs.hearty.api

gradle\libs.versions.toml:

[versions]
hearty-api = { strictly = "[<min-version>,<max-version>)", prefer = "latest.release" }

[libraries]
hearty-api = { id = "io.github.zygzaggaming.hearty.api", name = "hearty-api", version.ref = "hearty-api" }