🌈 PacketGlowAPI

PacketGlowAPI es una API ligera para Spigot/Paper 1.21.4 que permite aplicar efectos de Glow (brillo) en colores personalizados sin usar equipos visibles.
Funciona directamente usando el sistema de scoreboards internos y teams client-side de Minecraft para mostrar brillos a todos o a jugadores específicos.

---

✨ Características

• 🎨 Soporte para los 16 colores vanilla de Minecraft.
• 👁️ Aplicar glow a jugadores y entidades.
• 🧠 Mostrar glow por tiempo determinado.
• ⚡ API simple y estática, fácil de integrar.
• 🧩 Compatible con Spigot, Paper, Purpur y forks modernos.
• Fácil integración con Gradle y Maven.

Importante:
Esta API está dirigida para plugins principiantes para una manera de añadir glows de colores de una manera más fácil.
Si eres avanzado, recomendamos encarecidamente hacer un sistema propio que se adapte a tu propio manejo de scoreboard.
Ya que usamos el sistema de scoreboard vanilla y no un sistema con packets, pronto estaremos desarrollando un sistema a base de packets.

---

🛠️ Instalación / Dependencia

Maven (pom.xml)

<repositories>
  <repository>
    <id>github</id>
    <url>https://maven.pkg.github.com/NicoHaxz/PacketGlowAPI</url>
  </repository>
</repositories>

<dependencies>
  <dependency>
    <groupId>io.github.nicohaxz</groupId>
    <artifactId>packetglowapi</artifactId>
    <version>1.0.9</version>
  </dependency>
</dependencies>

Gradle (Groovy DSL)

repositories {
    mavenCentral()
    maven { url = uri("https://maven.pkg.github.com/NicoHaxz/PacketGlowAPI") }
}

dependencies {
    implementation("io.github.nicohaxz:packetglowapi:1.0.9")
}

Gradle (Kotlin DSL)

repositories {
    mavenCentral()
    maven { url = uri("https://maven.pkg.github.com/NicoHaxz/PacketGlowAPI") }
}

dependencies {
    implementation("io.github.nicohaxz:packetglowapi:1.0.9")
}

💡 Ejemplos de uso

Hacer que un jugador brille en rojo por 10 segundos:

GlowAPI.setCustomPlayerGlow(player, org.bukkit.ChatColor.RED, 200);
Hacer que una entidad brille en verde para todos:

GlowAPI.setCustomEntityGlow(entity, org.bukkit.ChatColor.GREEN);
Hacer que una entidad brille azul por 5 segundos:

GlowAPI.setCustomEntityGlow(entity, org.bukkit.ChatColor.BLUE, 100);
Aplicar glow a un jugador al entrar al servidor por 30 segundos:

@EventHandler
public void onJoin(PlayerJoinEvent event) {
    Player player = event.getPlayer();
    GlowAPI.setCustomPlayerGlow(player, org.bukkit.ChatColor.GREEN, 600);
}

📦 Requisitos

Spigot / Paper / Purpur 1.21.4+

No requiere ProtocolLib

🧑‍💻 Autor / Créditos

Desarrollado por NicoHaxz y xxditoxx27 GitHub: https://github.com/NicoHaxz GitHub: https://github.com/xxditoxx27

⚠️ Notas

Esta API es para uso de programadores amateur, facilitando la implementación de efectos glow sin preocuparse por teams ni scoreboards visibles.

Todos los métodos son estáticos, lo que la hace muy fácil de usar en cualquier parte de tu plugin.

🌍 PacketGlowAPI - English Version

PacketGlowAPI is a lightweight API for Spigot/Paper 1.21.4 that allows applying Glow effects in custom colors without visible teams. It works directly using Minecraft’s internal scoreboard/team system to show glow to everyone or specific players.

✨ Features

🎨 Supports all 16 vanilla glow colors.

👁️ Apply glow to players and entities.

🧠 Show glow for a set amount of time.

⚡ Easy-to-use static API.

🧩 Compatible with Spigot, Paper, Purpur, and modern forks.

Easy integration with Gradle and Maven.

Important:

This API is intended for beginner plugin developers to easily add colored glow effects. If you are an advanced user, we strongly recommend creating your own system that fits your scoreboard management. Currently, it uses the vanilla scoreboard system and not a packet-based system; a packet-based version is coming soon.

🛠️ Installation / Dependency

Maven (pom.xml)

<repositories>
  <repository>
    <id>github</id>
    <url>https://maven.pkg.github.com/NicoHaxz/PacketGlowAPI</url>
  </repository>
</repositories>

<dependencies>
  <dependency>
    <groupId>io.github.nicohaxz</groupId>
    <artifactId>packetglowapi</artifactId>
    <version>1.0.9</version>
  </dependency>
</dependencies>

Gradle (Groovy DSL)

repositories {
    mavenCentral()
    maven { url = uri("https://maven.pkg.github.com/NicoHaxz/PacketGlowAPI") }
}

dependencies {
    implementation("io.github.nicohaxz:packetglowapi:1.0.9")
}

Gradle (Kotlin DSL)

repositories {
    mavenCentral()
    maven { url = uri("https://maven.pkg.github.com/NicoHaxz/PacketGlowAPI") }
}

dependencies {
    implementation("io.github.nicohaxz:packetglowapi:1.0.9")
}

💡 Usage Examples

Make a player glow red for 10 seconds:

GlowAPI.setCustomPlayerGlow(player, org.bukkit.ChatColor.RED, 200);
Make an entity glow green for all players:

GlowAPI.setCustomEntityGlow(entity, org.bukkit.ChatColor.GREEN);
Make an entity glow blue for 5 seconds:

GlowAPI.setCustomEntityGlow(entity, org.bukkit.ChatColor.BLUE, 100);
Give players green glow for 30 seconds on join:

@EventHandler
public void onJoin(PlayerJoinEvent event) {
    Player player = event.getPlayer();
    GlowAPI.setCustomPlayerGlow(player, org.bukkit.ChatColor.GREEN, 600);
}

📦 Requirements

Spigot / Paper / Purpur 1.21.4+

No ProtocolLib required

🧑‍💻 Author / Credits Developed by NicoHaxz and xxditoxx27 GitHub: https://github.com/NicoHaxz GitHub: https://github.com/xxditoxx27

⚠️ Notes

This API is intended for amateur programmers, simplifying the implementation of glow effects without worrying about teams or visible scoreboards.

All methods are static, making it very easy to use anywhere in your plugin.