Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/skytasul/glowingentities

An API to easily make Minecraft entities glow. No dependencies, compatible 1.17 -> 1.21.
https://github.com/skytasul/glowingentities

api bukkit glow glowing java minecraft spigot

Last synced: about 1 month ago
JSON representation

An API to easily make Minecraft entities glow. No dependencies, compatible 1.17 -> 1.21.

Awesome Lists containing this project

README

        

# GlowingEntities

![Maven Central](https://img.shields.io/maven-central/v/fr.skytasul/glowingentities)

An util to easily set glowing entities (or blocks) per-player on a Spigot server.

No ProtocolLib, no dependency, compatible from Minecraft 1.17 to 1.21!

![Glowing entities animation](demo.gif)

![Glowing blocks animation](demo-blocks.gif)

## How to install?
### 1st method: copying the class
Copy the [GlowingEntities.java class](src/main/java/fr/skytasul/glowingentities/GlowingEntities.java) to your project
(and the [GlowingBlocks.java class](src/main/java/fr/skytasul/glowingentities/GlowingBlocks.java) if required).

### 2nd method: using maven
Add this requirement to your maven `pom.xml` file:

```xml

fr.skytasul
glowingentities
{VERSION}
compile

```
Additionnally, you can use the maven shade plugin to relocate the classes location.

> [!NOTE]
> Until 1.3.4, the util was under the groupId `io.github.skytasul`.
> After 1.3.5, it has changed to `fr.skytasul`.

## How to use?
### Make entities glow
1. Initialize the `GlowingEntities` object somewhere where you can easily get it, using `new GlowingEntities(plugin)`.
It is not recommended to create multiple `GlowingEntities` instances!

2. Use `GlowingEntities#setGlowing(Entity entity, Player receiver, ChatColor color)` to make an entity glow a color for a player!

3. You can change its glowing color by reusing the same method but changing the `color` parameter.

4. If you no longer wants your entity to glow, use `GlowingEntities#unsetGlowing(Entity entity, Player receiver)`.

5. When you are completely done with the glowing API (for instance, when your plugin is shutting down), remember to use `GlowingEntities#disable()`.

### Make blocks glow
The same as before but with the `GlowingBlocks` class :)

> **Warning**
> The `GlowingBlocks` util can only be used on Paper-based servers, not Bukkit or Spigot ones!