HologramLib | Доски лидеров и пользовательские голограммы ⚡

🚀 Совместимость с FOLIA, PAPER, PURPUR для версий Minecraft 1.19.4 - 1.21

Простой в использовании API для создания текстовых, предметных и блочных голограмм на основе пакетов с поддержкой MiniMessage и эмодзи.

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

• Создание текстовых, предметных и блочных голограмм
• Анимированные текстовые эффекты
• Поддержка формата MiniMessage
• Основано на пакетной системе
• Персональные голограммы для каждого игрока
• Генераторы таблиц лидеров
• Гибкая настройка внешнего вида голограмм
• Возможность прикрепления к объектам
• Различные режимы визуализации

🔧 Настройка сервера

Для работы необходимы:

• Скачать файл .jar плагина
• Установить Packet Events API
• Поместить файлы в папку плагинов сервера
• Добавить зависимость к вашему плагину

📋 Подключение к проекту

Gradle

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

dependencies {
  compileOnly 'com.github.max1mde:HologramLib:1.6.2.1'
}

Maven

<repository>
  <id>jitpack.io</id>
  <url>https://jitpack.io&lt;/url&gt;
</repository>

<dependency>
  <groupId>com.github.max1mde</groupId>
  <artifactId>HologramLib</artifactId>
  <version>1.6.2.1</version>
  <scope>provided</scope>
</dependency>

Добавьте в файл plugin.yml вашего плагина:

depend:
  - HologramLib

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

Получение экземпляра менеджера

private HologramManager hologramManager;

@Override
public void onEnable() {
    hologramManager = HologramLib.getManager().orElse(null);
    if (hologramManager == null) {
        getLogger().severe("Не удалось инициализировать менеджер HologramLib.");
        return;
    }
}

Создание голограммы

TextHologram hologram = new TextHologram("unique_id")
    .setMiniMessageText("<aqua>Hello world!")
    .setSeeThroughBlocks(false)
    .setBillboard(Display.Billboard.VERTICAL)
    .setShadow(true)
    .setScale(1.5F, 1.5F, 1.5F)
    .setTextOpacity((byte) 200)
    .setBackgroundColor(Color.fromARGB(60, 255, 236, 222).asARGB())
    .setAlignment(TextDisplay.TextAlignment.CENTER)
    .setViewRange(1.0)
    .setMaxLineWidth(200);

Отображение и удаление

hologramManager.spawn(hologram, <location>);
hologramManager.remove(hologram);

Анимация текста

TextAnimation animation = new TextAnimation()
        .addFrame( "<red>First frame")
        .addFrame("<green>Second frame")
        .addFrame("Third frame\n" +
                "Second line in third frame")
        .addFrame("Last frame");
animation.setDelay(20L); // 1 секунда
animation.setDelay(20L * 2);
hologramManager.applyAnimation(this.hologram, animation);

Таблица лидеров

Map<Integer, String> leaderboardData = new LinkedHashMap<>() {{
    put(1, "MaximDe:1000");
    put(2, "dream:950");
    put(3, "BastiGHG:500");
    put(4, "Wichtiger:400");
    // ... дополнительные записи
}};

LeaderboardHologram leaderboard = hologramManager.generateLeaderboard(
        location,
        leaderboardData,
        LeaderboardHologram.LeaderboardOptions.builder()
                .title("Лучшие игроки - Убийства")
                .showEmptyPlaces(true)
                .scale(1.2f)
                .maxDisplayEntries(10)
                .suffix("убийств")
                .topPlayerHead(true)
                .build()
);

⚠ Важная информация

• API работает только на версиях Minecraft 1.19.4+
• Голограммы не видны игрокам на Bedrock Edition
• Рекомендуется использовать Paper или его форки
• Это Java API и не работает как самостоятельный плагин