Package dev.oumaimaa.kawaiiapi.region

Class RegionSelector

java.lang.Object

dev.oumaimaa.kawaiiapi.region.RegionSelector

public final class RegionSelector
extends Object

Modern utility class for visualizing regions using glowing slime entities. Provides methods to create, remove, and manage visual region selectors without deprecated APIs.

Features:

• Uses Adventure API NamedTextColor for modern color support
• Automatic team management for glow effects
• Tag-based entity tracking for cleanup
• Thread-safe team numbering
• Efficient entity spawning

Version:

1.0

Author:

KawaiiDevelopment (Updated by milo)

Method Summary

Modifier and Type	Method	Description
static int	countSelectors(@NotNull String id)	Counts the number of selector entities with a specific tag.
static void	drawSelector(@NotNull Region region, @NotNull String id)	Draws a selector with default white glow color.
static void	drawSelector(@NotNull Region region, @NotNull String id, @Nullable net.kyori.adventure.text.format.NamedTextColor glowColor)	Draws a visual selector for the specified region using glowing slime entities.
static List<org.bukkit.entity.Entity>	getSelectorEntities(@NotNull String id)	Gets all entities belonging to a specific selector.
static int	getTeamCounter()	Gets the current team counter value.
static void	killAllSelectors()	Removes all region selector entities across all worlds.
static void	killSelectorsWithTag(@NotNull String tag)	Removes all selector entities with a specific tag.
static void	removeTempTeams()	Removes all temporary scoreboard teams created for region selectors.
static void	resetTeamCounter()	Resets the team counter.
static boolean	selectorExists(@NotNull String id)	Checks if a selector with the given ID exists.
static void	updateSelectorColor(@NotNull String id, @NotNull net.kyori.adventure.text.format.NamedTextColor newColor)	Updates the glow color of an existing selector.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

killSelectorsWithTag

public static void killSelectorsWithTag(@NotNull
 @NotNull String tag)

Removes all selector entities with a specific tag.

Parameters:

tag - The identifier tag to remove selectors for

killAllSelectors

public static void killAllSelectors()

Removes all region selector entities across all worlds.

removeTempTeams

public static void removeTempTeams()

Removes all temporary scoreboard teams created for region selectors.

drawSelector

public static void drawSelector(@NotNull
 @NotNull Region region,
 @NotNull
 @NotNull String id,
 @Nullable
 @Nullable net.kyori.adventure.text.format.NamedTextColor glowColor)

Draws a visual selector for the specified region using glowing slime entities.

Parameters:

region - The region to visualize

id - Unique identifier for this selector

glowColor - The color for the glowing effect (null for white)

Throws:

IllegalStateException - if the region is not fully set

drawSelector

public static void drawSelector(@NotNull
 @NotNull Region region,
 @NotNull
 @NotNull String id)

Draws a selector with default white glow color.

Parameters:

region - The region to visualize

id - Unique identifier for this selector

updateSelectorColor

public static void updateSelectorColor(@NotNull
 @NotNull String id,
 @NotNull
 @NotNull net.kyori.adventure.text.format.NamedTextColor newColor)

Updates the glow color of an existing selector.

Parameters:

id - The selector identifier

newColor - The new glow color

countSelectors

public static int countSelectors(@NotNull
 @NotNull String id)

Counts the number of selector entities with a specific tag.

Parameters:

id - The selector identifier

Returns:

The number of selector entities found

selectorExists

public static boolean selectorExists(@NotNull
 @NotNull String id)

Checks if a selector with the given ID exists.

Parameters:

id - The selector identifier

Returns:

true if at least one selector entity exists

getSelectorEntities

@NotNull
public static List<org.bukkit.entity.Entity> getSelectorEntities(@NotNull
 @NotNull String id)

Gets all entities belonging to a specific selector.

Parameters:

id - The selector identifier

Returns:

List of selector entities

resetTeamCounter

public static void resetTeamCounter()

Resets the team counter. Useful for testing or when cleaning up all selectors.

getTeamCounter

public static int getTeamCounter()

Gets the current team counter value.

Returns:

The current team counter