Highlight API

Highlight API

⚠️ Это библиотека для разработчиков, а не отдельный мод. Сама по себе она ничего не делает — предполагается, что её будут использовать как зависимость другие моды. Библиотечный мод для Minecraft Forge 1.20.1, добавляющий поддержку пользовательских подсветок и контуров для блоков, сущностей и областей.

Возможности

• Отрисовка контуров и заливки для блоков, сущностей и областей AABB
• Подсветка области между двумя точками BlockPos
• Встроенные анимации (Pulse, Blink, Fade In)
• Поддержка пользовательских анимаций через интерфейс ICustomAnimation
• Режимы глубины (HIDE — скрыто за блоками, IGNORE — видно сквозь блоки)
• Поддержка вечного и отложенного времени жизни
• Поддержка AnimationScope (ALPHA или COLOR)
• Настройка толщины линий

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

Добавление в качестве зависимости

JitPack:

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies { implementation fg.deobf("com.github.NOIST1611:HighlightAPI:v1.0.0") }

**Modrinth Maven:**
```gradle
repositories {
    maven { url "https://api.modrinth.com/maven" }
}

dependencies {
    implementation fg.deobf("maven.modrinth:highlight-api:1.0.0")
}

Быстрый старт

HighlightHandle handle = HighlightAPI.create(Lifetime.ETERNAL)
    .setTarget(blockPos)
    .setOutlineColor(1.0f, 0.0f, 0.0f, 1.0f)
    .setFillColor(1.0f, 0.0f, 0.0f, 0.3f)
    .register();

// Удалить по завершении
handle.remove();

Подсветка области

HighlightAPI.create(Lifetime.ETERNAL)
    .setRenderMode(RenderMode.REGION)
    .setTarget(new BlockPos(0, 64, 0))
    .setTargetEnd(new BlockPos(10, 70, 10))
    .setOutlineColor(0.0f, 1.0f, 0.0f, 1.0f)
    .setFillColor(0.0f, 1.0f, 0.0f, 0.2f)
    .register();

Область анимации

// Анимация прозрачности (alpha)
HighlightAPI.create(Lifetime.ETERNAL)
    .setTarget(blockPos)
    .setAnimation(AnimationType.PULSE)
    .setAnimationScope(AnimationScope.ALPHA)
    .register();

// Анимация цвета (чёрный → исходный цвет)
HighlightAPI.create(Lifetime.ETERNAL)
    .setTarget(blockPos)
    .setAnimation(AnimationType.PULSE)
    .setAnimationScope(AnimationScope.COLOR)
    .register();

// Пользовательская анимация

HighlightAPI.create(Lifetime.ETERNAL)
    .setTarget(blockPos)
    .setAnimation(new ICustomAnimation() {
        private float time = 0.0f;

        @Override
        public float tick(float partialTick) {
            time += partialTick * 0.05f;
            return (float)(Math.sin(time) * 0.5 + 0.5);
        }
    })
    .register();

Режим глубины

// Видно сквозь блоки
HighlightAPI.create(Lifetime.ETERNAL)
    .setTarget(blockPos)
    .setDepthMode(DepthMode.IGNORE)
    .register();

Ссылки

• GitHub
• Сообщить о проблемах