ColoredGlowLib

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

Использование

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

Команды

Все команды начинаются с /cgl (сокращение от ColoredGlowLib) или полной версии /coloredglowlib.

Основная команда для установки цвета:

/cgl setglowcolor <сущность/тип/по_умолчанию> <цвет>

Параметр сущность/тип/по_умолчанию определяет цель: конкретное существо (@p, имя игрока, UUID) или тип (например, minecraft:sheep). Значение default задаёт цвет по умолчанию для всех существ без индивидуальных настроек.

Параметр цвет принимает шестнадцатеричный код (например, ff85ab, 750711) без символа #. Также доступны ключевые слова:

• rainbow — радужная анимация
• random — случайная смена цвета каждые полсекунды
• название кастомной анимации из датапака

Настройки

Переопределение стандартных командных цветов Minecraft:

/cgl settings set overrideTeamColors <true/false>

Просмотр текущих настроек:

/cgl settings get overrideTeamColors

Удаление цвета:

/cgl clear <сущность/тип/по_умолчанию> [useDefault]

Опциональный параметр useDefault (true/false) определяет, использовать ли цвет по умолчанию вместо белого свечения.

Кастомные анимации

Создавайте собственные цветовые анимации через датапаки. После создания используйте название анимации как параметр цвета в командах:

/cgl setglowcolor @p marine

Установка

Для игроков

Просто поместите файл мода в папку mods (убедитесь, что выбрали версию для правильного загрузчика).

Для разработчиков

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

репозитории {
    maven {
        name = "Modrinth"
        url = "https://api.modrinth.com/maven"
        content {
            includeGroup "maven.modrinth"
        }
    }
}

зависимости {
    modImplementation "maven.modrinth:coloredglowlib:<версия>"
}

ВАЖНО: Из-за текущей ошибки требуется дополнительно добавить CardinalComponentsAPI:

репозитории {
    maven {
        name = "Ladysnake Mods"
        url = 'https://maven.ladysnake.org/releases'
    }
}

зависимости {
    modImplementation("dev.onyxstudios.cardinal-components-api:cardinal-components-base:5.4.0")
    modImplementation("dev.onyxstudios.cardinal-components-api:cardinal-components-entity:5.4.0")
    modImplementation("dev.onyxstudios.cardinal-components-api:cardinal-components-scoreboard:5.4.0")
}

Актуальные версии доступны на странице мода. Для Forge-версии добавьте +forge к номеру версии (недоступно для 3.0.0). Если CardinalComponentsAPI уже используется в вашем моде, скачайте версию с суффиксом +nocca.

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

Библиотека используется в моих модах FoxGlow и LightWithin.

Лицензия

Мод распространяется под лицензией GNU LGPL3.