2.3.3.7

修复旧版颜色相关问题

README.md

@@ -1,21 +1,79 @@
-# This project is currently under recoding
+# Custom-Nameplates
 
-### Custom-Nameplates
-A unique way to customize nametags
+![CodeFactor Grade](https://img.shields.io/codefactor/grade/github/Xiao-MoMi/Custom-Nameplates)
+![bStats Servers](https://img.shields.io/bstats/servers/16649)
+![bStats Players](https://img.shields.io/bstats/players/16649)
+![GitHub](https://img.shields.io/github/license/Xiao-MoMi/Custom-Nameplates)
+[![](https://jitpack.io/v/Xiao-MoMi/Custom-Nameplates.svg)](https://jitpack.io/#Xiao-MoMi/Custom-Nameplates)
+<a href="https://mo-mi.gitbook.io/xiaomomi-plugins/plugin-wiki/customnameplates" alt="GitBook">
+<img src="https://img.shields.io/badge/docs-gitbook-brightgreen" alt="Gitbook"/>
+</a>
 
-### How to support the developer
+CustomNameplates is a Paper plugin that provides unlimited customization for nametags, bossbars, actionbars and chat bubbles.
 
-https://afdian.net/@xiaomomi
+## How to build
 
-https://polymart.org/resource/customnameplates.2543
+### Windows
 
-### How to compile
-Open the project with your IDE and execute gradle build. Finally you will get the jar at /project/build/libs/CustomNameplates-xxx-all.jar. 
-
-### I don't know how to build with IDE
+#### Command Line
 Install JDK 17 and set the JDK installation path to JAVA_HOME as an environment variable.\
 Start powershell and change directory to the project folder.\
-Execute ".\gradlew build" and get the jar at /project/build/libs/CustomNameplates-xxx-all.jar. 
+Execute ".\gradlew build" and get the jar at /target/CustomNameplates-universe-version.jar.
 
-### API
-Plugin is scheduled to be recoded on December. At that time API would be available. For the moment you can use the jar as local library.
+#### IDE
+Import the project and execute gradle build action.
+
+##### About Proxy
+If you are using a proxy, configurate the proxy in gradle.properties. Otherwise comment the lines in gradle.properties.
+
+## Support the developer
+
+Polymart: https://polymart.org/resource/customnameplates.2543 \
+Afdian: https://afdian.net/@xiaomomi
+
+## Use CustomNameplates API
+
+### Maven
+
+```
+<repositories>
+  <repository>
+    <id>jitpack</id>
+    <url>https://jitpack.io/</url>
+  </repository>
+</repositories>
+```
+```
+<dependencies>
+  <dependency>
+    <groupId>com.github.Xiao-MoMi</groupId>
+    <artifactId>Custom-Nameplates</artifactId>
+    <version>{LATEST}</version>
+    <scope>provided</scope>
+  </dependency>
+</dependencies>
+```
+### Gradle (Groovy)
+
+```
+repositories {
+    maven { url 'https://jitpack.io' }
+}
+```
+```
+dependencies {
+    compileOnly 'com.github.Xiao-MoMi:Custom-Nameplates:{LATEST}'
+}
+```
+### Gradle (Kotlin)
+
+```
+repositories {
+    maven("https://jitpack.io/")
+}
+```
+```
+dependencies {
+    compileOnly("com.github.Xiao-MoMi:Custom-Nameplates:{LATEST}")
+}
+```

api/build.gradle.kts

@@ -1,5 +1,12 @@
 dependencies {
-    implementation(project(":common"))
     compileOnly("dev.folia:folia-api:1.20.1-R0.1-SNAPSHOT")
     compileOnly("me.clip:placeholderapi:2.11.5")
+    implementation(project(":common"))
+    implementation("net.kyori:adventure-api:4.15.0")
+}
+
+tasks {
+    shadowJar {
+        relocate ("net.kyori", "net.momirealms.customnameplates.libraries")
+    }
 }

api/src/main/java/net/momirealms/customnameplates/api/data/DataStorageInterface.java

@@ -41,6 +41,13 @@ public interface DataStorageInterface {
      */
     StorageType getStorageType();
 
+    /**
+     * Get a player's data by uuid
+     * This player can be an offline one
+     *
+     * @param uuid uuid
+     * @return player data
+     */
     CompletableFuture<Optional<PlayerData>> getPlayerData(UUID uuid);
 
     CompletableFuture<Boolean> updatePlayerData(UUID uuid, PlayerData playerData);

api/src/main/java/net/momirealms/customnameplates/api/data/OnlineUser.java

@@ -82,6 +82,10 @@ public class OnlineUser {
         return CustomNameplatesPlugin.get().getNameplateManager().getNameplate(temp);
     }
 
+    /**
+     * This value might be inconsistent with the key get by "getBubbleKey()"
+     * Because if a player doesn't have a bubble, his bubble would be the default one
+     */
     @Nullable
     public Bubble getBubble() {
         String temp = nameplate;

api/src/main/java/net/momirealms/customnameplates/api/event/BubblesSpawnEvent.java

@@ -23,6 +23,9 @@ import org.bukkit.event.HandlerList;
 import org.bukkit.event.player.PlayerEvent;
 import org.jetbrains.annotations.NotNull;
 
+/**
+ * An event triggered when player sends a message
+ */
 public class BubblesSpawnEvent extends PlayerEvent implements Cancellable {
 
     private boolean cancelled;
@@ -57,18 +60,34 @@ public class BubblesSpawnEvent extends PlayerEvent implements Cancellable {
         return getHandlerList();
     }
 
+    /**
+     * Get the bubble's key
+     */
     public String getBubble() {
         return bubble;
     }
 
+    /**
+     * Set the bubble
+     *
+     * @param bubble bubble's key
+     */
     public void setBubble(String bubble) {
         this.bubble = bubble;
     }
 
+    /**
+     * Get the bubble text content
+     */
     public String getText() {
         return text;
     }
 
+    /**
+     * Set the bubble text content
+     *
+     * @param text text
+     */
     public void setText(String text) {
         this.text = text;
     }

api/src/main/java/net/momirealms/customnameplates/api/event/CustomNameplatesReloadEvent.java

@@ -22,6 +22,9 @@ import org.bukkit.event.Event;
 import org.bukkit.event.HandlerList;
 import org.jetbrains.annotations.NotNull;
 
+/**
+ * Plugin reload event
+ */
 public class CustomNameplatesReloadEvent extends Event {
 
     private static final HandlerList handlerList = new HandlerList();

api/src/main/java/net/momirealms/customnameplates/api/event/NameplateDataLoadEvent.java

@@ -24,6 +24,9 @@ import org.jetbrains.annotations.NotNull;
 
 import java.util.UUID;
 
+/**
+ * Player data loaded event
+ */
 public class NameplateDataLoadEvent extends Event {
 
     private static final HandlerList handlerList = new HandlerList();
@@ -36,10 +39,20 @@ public class NameplateDataLoadEvent extends Event {
         this.onlineUser = onlineUser;
     }
 
+    /**
+     * Get the UUID
+     *
+     * @return uuid
+     */
     public UUID getUUID() {
         return uuid;
     }
 
+    /**
+     * Get the online user
+     *
+     * @return online user
+     */
     public OnlineUser getOnlineUser() {
         return onlineUser;
     }

api/src/main/java/net/momirealms/customnameplates/api/manager/AdventureManager.java

@@ -149,6 +149,12 @@ public interface AdventureManager {
     @SuppressWarnings("BooleanMethodIsAlwaysInverted")
     boolean isColorCode(char c);
 
+    /**
+     * Convert a color into decimal
+     *
+     * @param color color
+     * @return decimal
+     */
     int colorToDecimal(ChatColor color);
 
     /**
@@ -175,5 +181,11 @@ public interface AdventureManager {
      */
     String getMiniMessageFormat(Component component);
 
+    /**
+     * Get IChatComponent from Json
+     *
+     * @param json json
+     * @return component
+     */
     Object getIChatComponent(String json);
 }

api/src/main/java/net/momirealms/customnameplates/api/manager/BackGroundManager.java

@@ -34,6 +34,11 @@ public interface BackGroundManager {
     @Nullable
     BackGround getBackGround(@NotNull String key);
 
+    /**
+     * Get all the backgrounds
+     *
+     * @return backgrounds
+     */
     Collection<BackGround> getBackGrounds();
 
     /**

api/src/main/java/net/momirealms/customnameplates/api/manager/BubbleManager.java

@@ -18,6 +18,7 @@
 package net.momirealms.customnameplates.api.manager;
 
 import net.momirealms.customnameplates.api.mechanic.bubble.Bubble;
+import net.momirealms.customnameplates.api.mechanic.bubble.provider.AbstractChatProvider;
 import org.bukkit.entity.Player;
 import org.jetbrains.annotations.Nullable;
 
@@ -26,29 +27,127 @@ import java.util.List;
 
 public interface BubbleManager {
 
+    /**
+     * Set a custom chat provider
+     *
+     * @param provider provider
+     * @return success or not
+     */
+    boolean setCustomChatProvider(AbstractChatProvider provider);
+
+    /**
+     * Remove a custom chat provider
+     *
+     * @return success or not
+     */
+    boolean removeCustomChatProvider();
+
+    /**
+     * Register a bubble into map
+     *
+     * @param key key
+     * @param bubble bubble
+     * @return success or not
+     */
     boolean registerBubble(String key, Bubble bubble);
 
+    /**
+     * Unregister a bubble from map
+     *
+     * @param key key
+     * @return success or not
+     */
     boolean unregisterBubble(String key);
 
+    /**
+     * Get a bubble from map
+     *
+     * @param bubble key
+     * @return bubble
+     */
     @Nullable Bubble getBubble(String bubble);
 
+    /**
+     * If a player has a certain bubble
+     *
+     * @param player player
+     * @param bubble key
+     * @return
+     */
     boolean hasBubble(Player player, String bubble);
 
+    /**
+     * Get a list of the bubbles that a player has
+     *
+     * @param player player
+     * @return bubbles' keys
+     */
     List<String> getAvailableBubbles(Player player);
 
+    /**
+     * Get a list of the bubbles' display names that a player has
+     *
+     * @param player player
+     * @return bubbles' display names
+     */
     List<String> getAvailableBubblesDisplayNames(Player player);
 
+    /**
+     * Get blacklist chat channels
+     *
+     * @return channels
+     */
     String[] getBlacklistChannels();
 
+    /**
+     * Get all the bubbles
+     *
+     * @return bubbles
+     */
     Collection<Bubble> getBubbles();
 
+    /**
+     * Whether a bubble exists
+     */
     boolean containsBubble(String key);
 
+    /**
+     * Equip a bubble for a player
+     *
+     * @param player player
+     * @param bubble bubble
+     * @return success or not
+     */
     boolean equipBubble(Player player, String bubble);
 
+    /**
+     * Unequip a bubble for a player
+     *
+     * @param player player
+     */
     void unEquipBubble(Player player);
 
+    /**
+     * Get the default bubble key
+     *
+     * @return bubble key
+     */
     String getDefaultBubble();
 
+    void onChat(Player player, String text, String channel);
+
+    /**
+     * Get all the bubbles' keys
+     *
+     * @return keys
+     */
     Collection<String> getBubbleKeys();
+
+    /**
+     * Trigger chat
+     *
+     * @param player player
+     * @param text text
+     */
+    void onChat(Player player, String text);
 }

api/src/main/java/net/momirealms/customnameplates/api/manager/ImageManager.java

@@ -34,6 +34,11 @@ public interface ImageManager {
     @Nullable
     ConfiguredChar getImage(@NotNull String key);
 
+    /**
+     * Get all the images
+     *
+     * @return images
+     */
     Collection<ConfiguredChar> getImages();
 
     /**

api/src/main/java/net/momirealms/customnameplates/api/manager/NameplateManager.java

@@ -39,6 +39,10 @@ public interface NameplateManager {
     @NotNull
     String getDefaultNameplate();
 
+    void handlePlayerJoin(Player player);
+
+    void handlePlayerQuit(Player player);
+
     /**
      * Put an entity's ID to map
      * This map is used for quickly getting the entity instance
@@ -48,7 +52,7 @@ public interface NameplateManager {
      * @param entityID entityID
      * @param entity entity
      */
-    boolean putEntityIDToMap(int entityID, Entity entity);
+    boolean putEntityIDToMap(int entityID, @NotNull Entity entity);
 
     /**
      * Remove the entity from map
@@ -66,7 +70,7 @@ public interface NameplateManager {
      * @param uuid player uuid
      * @param nameplate cached nameplate
      */
-    boolean putCachedNameplateToMap(UUID uuid, CachedNameplate nameplate);
+    boolean putCachedNameplateToMap(@NotNull UUID uuid, @NotNull CachedNameplate nameplate);
 
     /**
      * Remove CachedNameplate from map
@@ -75,7 +79,7 @@ public interface NameplateManager {
      * @return removed CachedNameplate
      */
     @Nullable
-    CachedNameplate removeCachedNameplateFromMap(UUID uuid);
+    CachedNameplate removeCachedNameplateFromMap(@NotNull UUID uuid);
 
     /**
      * Get player by entityID from the cache
@@ -102,7 +106,7 @@ public interface NameplateManager {
      * @param player player
      * @return if the nameplate is updated
      */
-    boolean updateCachedNameplate(Player player);
+    boolean updateCachedNameplate(@NotNull Player player);
 
     /**
      * Update a player's cached nameplate
@@ -111,7 +115,7 @@ public interface NameplateManager {
      * @param player player
      * @return if the nameplate is updated
      */
-    boolean updateCachedNameplate(Player player, Nameplate nameplate);
+    boolean updateCachedNameplate(@NotNull Player player, @Nullable Nameplate nameplate);
 
     /**
      * This should not be null when player's data is loaded (async process)
@@ -120,61 +124,192 @@ public interface NameplateManager {
      * @return cached nameplate
      */
     @Nullable
-    CachedNameplate getCacheNameplate(Player player);
+    CachedNameplate getCacheNameplate(@NotNull Player player);
 
     /**
      * Create a name tag for a player, the tag type is decided by the mode in nameplate.yml
+     * If mode is DISABLE, this method would return null
+     * The tag would be put into map automatically and you can get it by getNameplatePlayer(uuid)
      *
      * @param player player
      */
-    void createNameTag(Player player);
+    @Nullable
+    NameplatePlayer createNameTag(@NotNull Player player);
 
-    void putNameplatePlayerToMap(NameplatePlayer player);
+    /**
+     * Put a nameplater player to map
+     *
+     * @param player player
+     */
+    void putNameplatePlayerToMap(@NotNull NameplatePlayer player);
 
-    NameplatePlayer getNameplatePlayer(UUID uuid);
+    /**
+     * Get a nameplate player from map
+     *
+     * @param uuid uuid
+     * @return nameplate player
+     */
+    @Nullable
+    NameplatePlayer getNameplatePlayer(@NotNull UUID uuid);
 
-    NameplatePlayer removeNameplatePlayerFromMap(UUID uuid);
+    /**
+     * Remove nameplate player from map
+     *
+     * @param uuid uuid
+     * @return removed nameplate player
+     */
+    @Nullable
+    NameplatePlayer removeNameplatePlayerFromMap(@NotNull UUID uuid);
 
-    String getNameplatePrefix(Player player);
+    /**
+     * Get the nameplate's prefix with text tags
+     *
+     * @param player player
+     * @return prefix with text tags
+     */
+    @NotNull
+    String getNameplatePrefix(@NotNull Player player);
 
-    String getNameplateSuffix(Player player);
+    /**
+     * Get the nameplate's suffix with text tags
+     *
+     * @param player player
+     * @return suffix with text tags
+     */
+    @NotNull
+    String getNameplateSuffix(@NotNull Player player);
 
-    String getFullNameTag(Player player);
+    /**
+     * Get the full nameplate tag
+     *
+     * @param player player
+     * @return nameplate tag
+     */
+    @NotNull
+    String getFullNameTag(@NotNull Player player);
 
-    boolean registerNameplate(String key, Nameplate nameplate);
+    /**
+     * Register a custom nameplate into map
+     *
+     * @param key key
+     * @param nameplate nameplate
+     * @return success or not
+     */
+    boolean registerNameplate(@NotNull String key, @NotNull Nameplate nameplate);
 
-    boolean equipNameplate(Player player, String nameplateKey, boolean temp);
+    /**
+     * Unregister a nameplate from map
+     *
+     * @param key key
+     * @return success or not
+     */
+    boolean unregisterNameplate(@NotNull String key);
 
+    /**
+     * Equip a nameplate for a player
+     *
+     * @param player player
+     * @param nameplateKey key
+     * @param temp whether save to storage
+     * @return success or not
+     */
+    boolean equipNameplate(@NotNull Player player, @NotNull String nameplateKey, boolean temp);
+
+    /**
+     * Remove a nameplate for a player
+     *
+     * @param player player
+     * @param temp whether save to storage
+     */
     void unEquipNameplate(Player player, boolean temp);
 
-    boolean unregisterNameplate(String key);
-
+    /**
+     * Is team managed on proxy side
+     */
     boolean isProxyMode();
 
+    /**
+     * Get preview duration
+     */
     int getPreviewDuration();
 
+    /**
+     * Get the tag mode
+     */
+    @NotNull
     TagMode getTagMode();
 
-    Nameplate getNameplate(String key);
+    /**
+     * Get a nameplate by key
+     *
+     * @param key key
+     * @return nameplate
+     */
+    @Nullable
+    Nameplate getNameplate(@NotNull String key);
 
+    /**
+     * Get all the nameplates
+     *
+     * @return nameplates
+     */
+    @NotNull
     Collection<Nameplate> getNameplates();
 
+    /**
+     * Get all the nameplates' keys
+     *
+     * @return keys
+     */
+    @NotNull
     Collection<String> getNameplateKeys();
 
-    boolean containsNameplate(String key);
+    /**
+     * Whether a nameplate key exists
+     */
+    boolean containsNameplate(@NotNull String key);
 
-    List<String> getAvailableNameplates(Player player);
+    /**
+     * Get all the nameplates that the player has
+     *
+     * @param player player
+     * @return nameplates' keys
+     */
+    @NotNull
+    List<String> getAvailableNameplates(@NotNull Player player);
 
     /**
      * If player has permission for a certain nameplate
      */
-    boolean hasNameplate(Player player, String nameplate);
+    boolean hasNameplate(@NotNull Player player, @NotNull String nameplate);
 
-    List<String> getAvailableNameplateDisplayNames(Player player);
+    /**
+     * Get all the nameplates' display names that the player has
+     *
+     * @param player player
+     * @return nameplates' display names
+     */
+    @NotNull
+    List<String> getAvailableNameplateDisplayNames(@NotNull Player player);
 
-    TeamColor getTeamColor(Player player);
+    /**
+     * Get the nameplate's team color
+     *
+     * @param player player
+     * @return team color
+     */
+    @NotNull
+    TeamColor getTeamColor(@NotNull Player player);
 
+    /**
+     * Get team tag manager
+     */
+    @NotNull
     TeamTagManager getTeamTagManager();
 
+    /**
+     * Get unlimited tag manager
+     */
+    @NotNull
     UnlimitedTagManager getUnlimitedTagManager();
 }

api/src/main/java/net/momirealms/customnameplates/api/manager/PlaceholderManager.java

@@ -44,6 +44,11 @@ public interface PlaceholderManager {
     @Nullable
     StaticText getStaticText(String key);
 
+    /**
+     * Get all the static texts
+     *
+     * @return static texts
+     */
     Collection<StaticText> getStaticTexts();
 
     /**
@@ -55,6 +60,11 @@ public interface PlaceholderManager {
     @Nullable
     SwitchText getSwitchText(String key);
 
+    /**
+     * Get all the switch texts
+     *
+     * @return switch texts
+     */
     Collection<SwitchText> getSwitchTexts();
 
     /**
@@ -66,6 +76,11 @@ public interface PlaceholderManager {
     @Nullable
     DescentText getDescentText(String key);
 
+    /**
+     * Get all the descent texts
+     *
+     * @return descent texts
+     */
     Collection<DescentText> getDescentTexts();
 
     /**
@@ -77,6 +92,11 @@ public interface PlaceholderManager {
     @Nullable
     ConditionalText getConditionalText(String key);
 
+    /**
+     * Get all the conditional texts
+     *
+     * @return conditional texts
+     */
     Collection<ConditionalText> getConditionalTexts();
 
     /**
@@ -88,6 +108,11 @@ public interface PlaceholderManager {
     @Nullable
     NameplateText getNameplateText(String key);
 
+    /**
+     * Get all the nameplate texts
+     *
+     * @return nameplate texts
+     */
     Collection<NameplateText> getNameplateTexts();
 
     /**
@@ -99,9 +124,25 @@ public interface PlaceholderManager {
     @Nullable
     BackGroundText getBackGroundText(String key);
 
+    /**
+     * Get all the background texts
+     *
+     * @return background texts
+     */
     Collection<BackGroundText> getBackGroundTexts();
 
+    /**
+     * Get a vanilla hud
+     *
+     * @param key key
+     * @return vanilla hud
+     */
     VanillaHud getVanillaHud(String key);
 
+    /**
+     * Get all the vanilla huds
+     *
+     * @return vanilla huds
+     */
     Collection<VanillaHud> getVanillaHuds();
 }

api/src/main/java/net/momirealms/customnameplates/api/manager/ResourcePackManager.java

@@ -26,5 +26,10 @@ public interface ResourcePackManager {
      */
     void generateResourcePack();
 
+    /**
+     * Delete a directory
+     *
+     * @param file file
+     */
     void deleteDirectory(File file);
 }

api/src/main/java/net/momirealms/customnameplates/api/manager/TeamManager.java

@@ -46,7 +46,8 @@ public interface TeamManager {
      * Get the team player in
      *
      * @param player player
+     * @param viewer viewer
      * @return team name
      */
-    String getTeamName(Player player);
+    String getTeamName(Player player, Player viewer);
 }

api/src/main/java/net/momirealms/customnameplates/api/manager/TeamTagManager.java

@@ -19,6 +19,7 @@ package net.momirealms.customnameplates.api.manager;
 
 import net.momirealms.customnameplates.api.mechanic.tag.team.TeamTagPlayer;
 import org.bukkit.entity.Player;
+import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 import java.util.UUID;
@@ -32,7 +33,7 @@ public interface TeamTagManager {
      *
      * @return team tag
      */
-    @Nullable
+    @NotNull
     TeamTagPlayer createTagForPlayer(Player player, String prefix, String suffix);
 
     /**

api/src/main/java/net/momirealms/customnameplates/api/manager/UnlimitedTagManager.java

@@ -24,6 +24,14 @@ import org.jetbrains.annotations.NotNull;
 
 public interface UnlimitedTagManager {
 
+    /**
+     * Create a named entity (ArmorStand) for an entity
+     * To apply the changes, you should add it to the EntityTagEntity
+     *
+     * @param entity entity
+     * @param setting setting
+     * @return named entity
+     */
     @NotNull StaticTextEntity createNamedEntity(EntityTagEntity entity, StaticTextTagSetting setting);
 
     /**
@@ -37,9 +45,19 @@ public interface UnlimitedTagManager {
     @NotNull
     DynamicTextEntity createNamedEntity(EntityTagPlayer player, DynamicTextTagSetting setting);
 
+    /**
+     * Create or get a tag instance
+     *
+     * @param entity entity
+     * @return entity tag instance
+     */
     EntityTagEntity createOrGetTagForEntity(Entity entity);
 
+    /**
+     * Create or get a tag instance
+     *
+     * @param player player
+     * @return entity tag instance
+     */
     EntityTagPlayer createOrGetTagForPlayer(Player player);
-
-    EntityTagPlayer createOrGetTagForPlayer(Player player, boolean manageTeam);
 }

api/src/main/java/net/momirealms/customnameplates/api/manager/VersionManager.java

@@ -17,16 +17,53 @@
 
 package net.momirealms.customnameplates.api.manager;
 
+import org.jetbrains.annotations.NotNull;
+
 import java.util.concurrent.CompletionStage;
 
 public interface VersionManager {
 
+    /**
+     * Is folia scheduler implemented
+     */
     boolean isFolia();
 
+    /**
+     * Get bukkit version
+     *
+     * @return version
+     */
     String getServerVersion();
 
+    /**
+     * Check update
+     *
+     * @return return true if plugin needs update
+     */
     CompletionStage<Boolean> checkUpdate();
 
+    /**
+     * Get plugin version
+     *
+     * @return version
+     */
+    @NotNull
+    String getPluginVersion();
+
+    /**
+     * Is the plugin the latest version
+     *
+     * @return latest or not
+     */
+    boolean isLatest();
+
+    /**
+     * Get pack format
+     *
+     * @return pack format
+     */
+    int getPackFormat();
+
     boolean isVersionNewerThan1_19();
 
     boolean isVersionNewerThan1_19_R2();
@@ -36,11 +73,4 @@ public interface VersionManager {
     boolean isVersionNewerThan1_20();
 
     boolean isVersionNewerThan1_20_R2();
-
-    String getPluginVersion();
-
-    boolean isLatest();
-
-    int getPackFormat();
-
 }

api/src/main/java/net/momirealms/customnameplates/api/manager/WidthManager.java

@@ -19,15 +19,43 @@ package net.momirealms.customnameplates.api.manager;
 
 import net.momirealms.customnameplates.api.mechanic.font.FontData;
 import net.momirealms.customnameplates.common.Key;
+import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 public interface WidthManager {
 
-    boolean registerFontData(Key key, FontData fontData);
+    /**
+     * Register a font data into the plugin
+     * If there already exists one, it would fail
+     *
+     * @param key key
+     * @param fontData data
+     * @return success or not
+     */
+    boolean registerFontData(@NotNull Key key, @NotNull FontData fontData);
 
-    boolean unregisterFontData(Key key);
+    /**
+     * Unregister a font data from map
+     *
+     * @param key key
+     * @return success or not
+     */
+    boolean unregisterFontData(@NotNull Key key);
 
-    @Nullable FontData getFontData(Key key);
+    /**
+     * Get font data by key
+     *
+     * @param key key
+     * @return font data
+     */
+    @Nullable
+    FontData getFontData(@NotNull Key key);
 
-    int getTextWidth(String textWithTags);
+    /**
+     * Get text's width (MiniMessage format text)
+     *
+     * @param textWithTags text
+     * @return width
+     */
+    int getTextWidth(@NotNull String textWithTags);
 }

api/src/main/java/net/momirealms/customnameplates/api/mechanic/bubble/ChannelMode.java

@@ -15,9 +15,11 @@
  *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package net.momirealms.customnameplates.paper.mechanic.team;
-
-public interface Team {
+package net.momirealms.customnameplates.api.mechanic.bubble;
 
+public enum ChannelMode {
 
+    ALL,
+    JOINED,
+    CAN_JOIN
 }

api/src/main/java/net/momirealms/customnameplates/api/mechanic/bubble/provider/AbstractChatProvider.java

@@ -0,0 +1,39 @@
+/*
+ *  Copyright (C) <2022> <XiaoMoMi>
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package net.momirealms.customnameplates.api.mechanic.bubble.provider;
+
+import net.momirealms.customnameplates.api.manager.BubbleManager;
+import org.bukkit.entity.Player;
+import org.bukkit.event.Listener;
+
+public abstract class AbstractChatProvider implements Listener {
+
+    protected BubbleManager chatBubblesManager;
+
+    public AbstractChatProvider(BubbleManager chatBubblesManager) {
+        this.chatBubblesManager = chatBubblesManager;
+    }
+
+    public abstract void register();
+
+    public abstract void unregister();
+
+    public abstract boolean hasJoinedChannel(Player player, String channelID);
+
+    public abstract boolean canJoinChannel(Player player, String channelID);
+}

api/src/main/java/net/momirealms/customnameplates/api/mechanic/character/CharacterArranger.java

@@ -25,17 +25,32 @@ public class CharacterArranger {
         currentChar = (char) (currentChar + '\u0001');
     }
 
+    /**
+     * Get and increase the char arranged automatically by the plugin
+     *
+     * @return char
+     */
     public static char getAndIncrease() {
         char temp = currentChar;
         increase();
         return temp;
     }
 
+    /**
+     * Increase and get the char arranged automatically by the plugin
+     *
+     * @return char
+     */
     public static char increaseAndGet() {
         increase();
         return currentChar;
     }
 
+    /**
+     * Reset the initial char
+     *
+     * @param c char
+     */
     public static void reset(char c) {
         currentChar = c;
     }

api/src/main/java/net/momirealms/customnameplates/api/mechanic/font/FontData.java

@@ -29,18 +29,40 @@ public class FontData {
         this.defaultWidth = defaultWidth;
     }
 
+    /**
+     * Register a char's width
+     *
+     * @param codePoint code point
+     * @param width width
+     */
     public void registerCharWidth(int codePoint, int width) {
         widthData.put(codePoint, width);
     }
 
+    /**
+     * Get a character's width
+     *
+     * @param codePoint code point
+     * @return width
+     */
     public int getWidth(int codePoint) {
         return widthData.getOrDefault(codePoint, defaultWidth);
     }
 
+    /**
+     * Get the data map
+     *
+     * @return map
+     */
     public HashMap<Integer, Integer> getWidthData() {
         return widthData;
     }
 
+    /**
+     * Override the data with another one
+     *
+     * @param fontData font data
+     */
     public void overrideWith(FontData fontData) {
         if (fontData == null) return;
         widthData.putAll(fontData.getWidthData());

api/src/main/java/net/momirealms/customnameplates/api/mechanic/font/OffsetFont.java

@@ -66,6 +66,12 @@ public enum OffsetFont {
         return this.height;
     }
 
+    /**
+     * Get offset characters
+     *
+     * @param offset offset
+     * @return chars
+     */
     public static String getOffsetChars(int offset) {
         if (offset >= 0) {
             return getShortestPosChars(offset);
@@ -74,6 +80,12 @@ public enum OffsetFont {
         }
     }
 
+    /**
+     * get negative characters
+     *
+     * @param n n > 0
+     * @return chars
+     */
     public static String getShortestNegChars(int n) {
         StringBuilder stringBuilder = new StringBuilder();
         while (n >= 128) {
@@ -126,6 +138,12 @@ public enum OffsetFont {
         return stringBuilder.toString();
     }
 
+    /**
+     * get positive characters
+     *
+     * @param n n > 0
+     * @return chars
+     */
     public static String getShortestPosChars(int n) {
         StringBuilder stringBuilder = new StringBuilder();
         while (n >= 128) {

api/src/main/java/net/momirealms/customnameplates/api/mechanic/misc/ViewerText.java

@@ -44,9 +44,11 @@ public class ViewerText {
         for (String placeholder : placeholders) {
             processedText = processedText.replace(placeholder, "%s");
             if (placeholder.startsWith("%viewer_")) {
-                this.placeholders[i] = new ClaimedText(null, "%" + placeholder.substring("%viewer_".length()));
+                this.placeholders[i] = new ClaimedText(null, "%" + placeholder.substring("%viewer_".length()), false);
+            } else if (placeholder.startsWith("%rel_")) {
+                this.placeholders[i] = new ClaimedText(owner, placeholder, true);
             } else {
-                this.placeholders[i] = new ClaimedText(owner, placeholder);
+                this.placeholders[i] = new ClaimedText(owner, placeholder, false);
             }
             i++;
         }
@@ -109,23 +111,31 @@ public class ViewerText {
         private final String placeholder;
         private final Player owner;
         private String latestValue;
+        private final boolean relational;
 
-        public ClaimedText(Player owner, String placeholder) {
+        public ClaimedText(Player owner, String placeholder, boolean relational) {
             this.placeholder = placeholder;
             this.owner = owner;
             this.latestValue = null;
+            this.relational = relational;
             this.update();
         }
 
         public void update() {
-            if (owner == null) return;
+            if (owner == null || relational) return;
             this.latestValue = PlaceholderAPI.setPlaceholders(owner, placeholder);
         }
 
         public String getValue(Player viewer) {
             return Objects.requireNonNullElseGet(
                     latestValue,
-                    () -> PlaceholderAPI.setPlaceholders(owner == null ? viewer : owner, placeholder)
+                    () -> {
+                        if (relational) {
+                            return PlaceholderAPI.setRelationalPlaceholders(viewer, owner, placeholder);
+                        } else {
+                            return PlaceholderAPI.setPlaceholders(owner == null ? viewer : owner, placeholder);
+                        }
+                    }
             );
         }
     }

api/src/main/java/net/momirealms/customnameplates/api/mechanic/placeholder/SwitchText.java

@@ -18,7 +18,7 @@
 package net.momirealms.customnameplates.api.mechanic.placeholder;
 
 import me.clip.placeholderapi.PlaceholderAPI;
-import org.bukkit.entity.Player;
+import org.bukkit.OfflinePlayer;
 
 import java.util.HashMap;
 
@@ -41,9 +41,9 @@ public class SwitchText {
         this.toParse = toParse;
     }
 
-    public String getValue(Player player) {
+    public String getValue(OfflinePlayer player) {
         String parsed = PlaceholderAPI.setPlaceholders(player, toParse);
-        return valueMap.getOrDefault(parsed, defaultValue);
+        return PlaceholderAPI.setPlaceholders(player, valueMap.getOrDefault(parsed, defaultValue));
     }
 
     public static class Builder {

api/src/main/java/net/momirealms/customnameplates/api/mechanic/placeholder/VanillaHud.java

@@ -18,12 +18,10 @@
 package net.momirealms.customnameplates.api.mechanic.placeholder;
 
 import me.clip.placeholderapi.PlaceholderAPI;
-import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
 import net.momirealms.customnameplates.api.mechanic.font.OffsetFont;
 import net.momirealms.customnameplates.api.util.FontUtils;
 import net.momirealms.customnameplates.api.util.LogUtils;
 import org.bukkit.OfflinePlayer;
-import org.bukkit.entity.Player;
 
 public class VanillaHud {
 

api/src/main/java/net/momirealms/customnameplates/api/mechanic/tag/team/TeamTagPlayer.java

@@ -21,13 +21,37 @@ import net.momirealms.customnameplates.api.mechanic.misc.ViewerText;
 import net.momirealms.customnameplates.api.mechanic.tag.NameplatePlayer;
 
 public interface TeamTagPlayer extends NameplatePlayer {
+
+    /**
+     * Set a player's prefix
+     *
+     * @param prefix prefix
+     */
     void setPrefix(String prefix);
 
+    /**
+     * Set a player's suffix
+     *
+     * @param suffix suffix
+     */
     void setSuffix(String suffix);
 
+    /**
+     * Get a player's prefix
+     *
+     * @return prefix
+     */
     ViewerText getPrefix();
 
+    /**
+     * Get a player's suffix
+     *
+     * @return suffix
+     */
     ViewerText getSuffix();
 
+    /**
+     * Destroy the tag
+     */
     void destroy();
 }

api/src/main/java/net/momirealms/customnameplates/api/mechanic/tag/unlimited/DynamicTextEntity.java

@@ -49,6 +49,8 @@ public interface DynamicTextEntity {
 
     void setSneak(boolean sneaking, boolean respawn);
 
+    void updateVisibility();
+
     void removePlayerFromViewers(Player player);
 
     void addPlayerToViewers(Player player);

api/src/main/java/net/momirealms/customnameplates/api/mechanic/tag/unlimited/EntityTagEntity.java

@@ -20,7 +20,7 @@ package net.momirealms.customnameplates.api.mechanic.tag.unlimited;
 import org.bukkit.entity.Entity;
 import org.bukkit.entity.Player;
 
-import java.util.Vector;
+import java.util.Collection;
 
 public interface EntityTagEntity {
 
@@ -30,7 +30,7 @@ public interface EntityTagEntity {
 
     void removeTag(StaticTextEntity tag);
 
-    Vector<StaticTextEntity> getStaticTags();
+    Collection<StaticTextEntity> getStaticTags();
 
     void forceAddNearbyPlayer(Player player);
 

api/src/main/java/net/momirealms/customnameplates/api/mechanic/tag/unlimited/EntityTagPlayer.java

@@ -19,7 +19,7 @@ package net.momirealms.customnameplates.api.mechanic.tag.unlimited;
 
 import net.momirealms.customnameplates.api.mechanic.tag.NameplatePlayer;
 
-import java.util.Vector;
+import java.util.Collection;
 
 public interface EntityTagPlayer extends NameplatePlayer {
 
@@ -35,14 +35,12 @@ public interface EntityTagPlayer extends NameplatePlayer {
 
     void removeTag(StaticTextEntity tag);
 
-    Vector<DynamicTextEntity> getDynamicTags();
+    Collection<DynamicTextEntity> getDynamicTags();
 
-    Vector<StaticTextEntity> getStaticTags();
+    Collection<StaticTextEntity> getStaticTags();
 
     void setHatOffset(double hatOffset);
 
-    void setManageTeams(boolean manageTeams);
-
     double getHatOffset();
 
     void destroy();

api/src/main/java/net/momirealms/customnameplates/api/mechanic/tag/unlimited/StaticTextEntity.java

@@ -24,7 +24,7 @@ import java.util.UUID;
 
 public interface StaticTextEntity {
 
-    String getPlugin();
+    String getID();
 
     boolean isShownTo(Player viewer);
 
@@ -73,4 +73,6 @@ public interface StaticTextEntity {
     UUID getUUID();
 
     void handlePose(Pose previous, Pose pose);
+
+    void setSneak(boolean sneaking, boolean onGround);
 }

api/src/main/java/net/momirealms/customnameplates/api/mechanic/tag/unlimited/StaticTextTagSetting.java

@@ -24,14 +24,14 @@ public class StaticTextTagSetting {
     private NearbyRule comeRule;
     private NearbyRule leaveRule;
     private String defaultText;
-    private String plugin;
+    private String id;
 
-    public StaticTextTagSetting(double verticalOffset, NearbyRule comeRule, NearbyRule leaveRule, String defaultText, String plugin) {
+    public StaticTextTagSetting(double verticalOffset, NearbyRule comeRule, NearbyRule leaveRule, String defaultText, String id) {
         this.verticalOffset = verticalOffset;
         this.comeRule = comeRule;
         this.leaveRule = leaveRule;
         this.defaultText = defaultText;
-        this.plugin = plugin;
+        this.id = id;
     }
 
     private StaticTextTagSetting() {
@@ -39,7 +39,7 @@ public class StaticTextTagSetting {
         comeRule = (player, entity) -> true;
         leaveRule = (player, entity) -> true;
         defaultText = "";
-        plugin = "";
+        id = "";
     }
 
     public static Builder builder() {
@@ -78,8 +78,8 @@ public class StaticTextTagSetting {
             return this;
         }
 
-        public Builder plugin(String type) {
-            this.setting.plugin = type;
+        public Builder id(String id) {
+            this.setting.id = id;
             return this;
         }
 
@@ -100,8 +100,8 @@ public class StaticTextTagSetting {
         return defaultText;
     }
 
-    public String getPlugin() {
-        return plugin;
+    public String getID() {
+        return id;
     }
 
     public NearbyRule getLeaveRule() {

api/src/main/java/net/momirealms/customnameplates/api/requirement/Condition.java

@@ -21,7 +21,11 @@ import org.bukkit.OfflinePlayer;
 
 public class Condition {
 
-    private final OfflinePlayer player;
+    private OfflinePlayer player;
+
+    public Condition() {
+        this.player = null;
+    }
 
     public Condition(OfflinePlayer player) {
         this.player = player;
@@ -30,4 +34,26 @@ public class Condition {
     public OfflinePlayer getOfflinePlayer() {
         return player;
     }
+
+    public static Builder builder() {
+        return new Builder();
+    }
+
+    public static class Builder {
+
+        private final Condition condition;
+
+        public Builder() {
+            this.condition = new Condition();
+        }
+
+        public Builder player(OfflinePlayer player) {
+            condition.player = player;
+            return this;
+        }
+
+        public Condition build() {
+            return condition;
+        }
+    }
 }

api/src/main/java/net/momirealms/customnameplates/api/util/LocationUtils.java

@@ -22,6 +22,13 @@ import org.bukkit.entity.Entity;
 
 public class LocationUtils {
 
+    /**
+     * Get distance by two entities
+     *
+     * @param e1 entity
+     * @param e2 entity
+     * @return distance
+     */
     public static double getDistance(Entity e1, Entity e2) {
         Location loc1 = e1.getLocation();
         Location loc2 = e2.getLocation();

build.gradle.kts

@@ -7,7 +7,7 @@ plugins {
 
 allprojects {
 
-    version = "2.3.0.0"
+    version = "2.3.3.7"
 
     apply<JavaPlugin>()
     apply(plugin = "java")
@@ -43,6 +43,8 @@ allprojects {
         maven("https://repo.kryptonmc.org/releases")
         maven("https://repo.oraxen.com/releases/")
         maven("https://nexus.codecrafter47.de/content/repositories/public/")
+        maven("https://repo.opencollab.dev/main/")
+        maven("https://repo.md-5.net/content/groups/public/")
     }
 }
 

bungeecord/src/main/java/net/momirealms/customnameplates/bungeecord/CustomNameplatesBungeeCord.java

@@ -30,7 +30,6 @@ public class CustomNameplatesBungeeCord extends Plugin implements Listener {
         instance = this;
         this.getProxy().registerChannel(CHANNEL);
         this.getProxy().getPluginManager().registerListener(this, this);
-        this.getLogger().warning("It's not necessary to install the plugin on BungeeCord now!");
     }
 
     @Override

bungeecord/src/main/java/net/momirealms/customnameplates/bungeecord/team/TABProvider.java

@@ -0,0 +1,47 @@
+/*
+ *  Copyright (C) <2022> <XiaoMoMi>
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package net.momirealms.customnameplates.bungeecord.team;
+
+import me.neznamy.tab.api.TabAPI;
+import me.neznamy.tab.api.TabPlayer;
+import me.neznamy.tab.api.tablist.SortingManager;
+import net.md_5.bungee.api.connection.ProxiedPlayer;
+
+public class TABProvider implements TeamProvider {
+
+    private final TabAPI api;
+    private final SortingManager sortingManager;
+
+    public TABProvider() {
+        this.api = TabAPI.getInstance();
+        this.sortingManager = api.getSortingManager();
+    }
+
+    @Override
+    public String getTeam(ProxiedPlayer player, ProxiedPlayer ignore) {
+        TabPlayer tabPlayer = api.getPlayer(player.getUniqueId());
+        if (tabPlayer == null) {
+            return null;
+        }
+        String forced = sortingManager.getForcedTeamName(tabPlayer);
+        if (forced != null) {
+            return forced;
+        }
+        return sortingManager.getOriginalTeamName(tabPlayer);
+    }
+}

bungeecord/src/main/java/net/momirealms/customnameplates/bungeecord/team/TeamProvider.java

@@ -15,21 +15,11 @@
  *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package net.momirealms.customnameplates.paper.mechanic.bubble.listener;
+package net.momirealms.customnameplates.bungeecord.team;
 
-import net.momirealms.customnameplates.paper.mechanic.bubble.BubbleManagerImpl;
-import org.bukkit.event.EventHandler;
-import org.bukkit.event.player.AsyncPlayerChatEvent;
+import net.md_5.bungee.api.connection.ProxiedPlayer;
 
-public class AsyncChatListener extends AbstractChatListener {
+public interface TeamProvider {
 
-    public AsyncChatListener(BubbleManagerImpl chatBubblesManager) {
-        super(chatBubblesManager);
-    }
-
-    @EventHandler
-    public void onChat(AsyncPlayerChatEvent event) {
-        if (event.isCancelled()) return;
-        chatBubblesManager.onChat(event.getPlayer(), event.getMessage());
-    }
-}
+    String getTeam(ProxiedPlayer player, ProxiedPlayer viewer);
+}

bungeecord/src/main/java/net/momirealms/customnameplates/bungeecord/team/UnknownProvider.java

@@ -0,0 +1,115 @@
+package net.momirealms.customnameplates.bungeecord.team;
+
+import net.md_5.bungee.api.connection.ProxiedPlayer;
+import net.md_5.bungee.api.event.PlayerDisconnectEvent;
+import net.md_5.bungee.api.event.PostLoginEvent;
+import net.md_5.bungee.api.plugin.Listener;
+import net.md_5.bungee.event.EventHandler;
+import net.md_5.bungee.netty.PacketHandler;
+import net.md_5.bungee.protocol.packet.Team;
+
+import java.util.*;
+import java.util.concurrent.ConcurrentHashMap;
+
+public class UnknownProvider extends PacketHandler implements Listener, TeamProvider {
+
+    private final ConcurrentHashMap<UUID, PlayerTeamView> teamViewMap;
+
+    public UnknownProvider() {
+        this.teamViewMap = new ConcurrentHashMap<>();
+    }
+
+    @Override
+    public void handle(Team team) {
+        switch (team.getMode()) {
+            case 0, 3 -> {
+            }
+            case 1 -> {
+
+            }
+        }
+    }
+
+    @Override
+    public String toString() {
+        return null;
+    }
+
+    @EventHandler
+    public void onPostLogin(PostLoginEvent event) {
+        teamViewMap.put(event.getPlayer().getUniqueId(), new PlayerTeamView());
+    }
+
+    @EventHandler
+    public void onDisConnect(PlayerDisconnectEvent event) {
+        teamViewMap.remove(event.getPlayer().getUniqueId());
+    }
+
+    @Override
+    public String getTeam(ProxiedPlayer player, ProxiedPlayer viewer) {
+
+
+        return null;
+    }
+
+    public static class PlayerTeamView {
+
+        private final HashMap<String, String> playerToTeamMap;
+        private final HashMap<String, String[]> teamToPlayerMap;
+
+        public PlayerTeamView() {
+            this.playerToTeamMap = new HashMap<>();
+            this.teamToPlayerMap = new HashMap<>();
+        }
+
+        public String getTeam(ProxiedPlayer player) {
+            return playerToTeamMap.get(player.getName());
+        }
+
+        public void removeTeam(String team) {
+            String[] removedMembers = teamToPlayerMap.remove(team);
+            if (removedMembers != null) {
+                for (String member : removedMembers) {
+                    playerToTeamMap.remove(member);
+                }
+            }
+        }
+
+        public void addMembers(String team, Collection<String> members) {
+            String[] oldMembers = teamToPlayerMap.remove(team);
+            if (oldMembers != null) {
+                String[] newMembers = new String[members.size() + oldMembers.length];
+                int i = 0;
+                for (String m : oldMembers) {
+                    newMembers[i] = m;
+                    i++;
+                }
+                for (String m : members) {
+                    newMembers[i] = m;
+                    i++;
+                }
+                teamToPlayerMap.put(team, newMembers);
+                for (String member : newMembers) {
+                    playerToTeamMap.put(member, team);
+                }
+            } else {
+                teamToPlayerMap.put(team, members.toArray(new String[0]));
+                for (String member : members) {
+                    playerToTeamMap.put(member, team);
+                }
+            }
+        }
+
+        public void removeMembers(String team, Collection<String> members) {
+            String[] oldMembers = teamToPlayerMap.remove(team);
+            if (oldMembers != null) {
+                ArrayList<String> newMembers = new ArrayList<>(Arrays.asList(oldMembers));
+                for (String member : members) {
+                    playerToTeamMap.remove(member);
+                    newMembers.remove(member);
+                }
+                teamToPlayerMap.put(team, newMembers.toArray(new String[0]));
+            }
+        }
+    }
+}

gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.6-bin.zip
 networkTimeout=10000
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists

paper/build.gradle.kts

@@ -12,7 +12,10 @@ dependencies {
     compileOnly("me.clip:placeholderapi:2.11.5")
 
     // config
-    compileOnly("dev.dejvokep:boosted-yaml:1.3.1")
+    compileOnly("dev.dejvokep:boosted-yaml:1.3.2")
+
+    // bStats
+    compileOnly("org.bstats:bstats-bukkit:3.0.2")
 
     // team
     compileOnly("me.neznamy:tab-api:4.0.2")
@@ -33,11 +36,15 @@ dependencies {
     compileOnly("io.th0rgal:oraxen:1.165.0")
     compileOnly("com.github.FrancoBM12:API-MagicCosmetics:2.2.5")
     compileOnly("commons-io:commons-io:2.15.1")
-
+    compileOnly("org.geysermc.geyser:api:2.2.0-SNAPSHOT")
+    compileOnly("LibsDisguises:LibsDisguises:10.0.42")
+    implementation("com.github.Xiao-MoMi:BiomeAPI:0.3")
 
     // chat channels
     compileOnly(files("libs/VentureChat-3.7.1.jar"))
     compileOnly(files("libs/TrChat-2.0.11.jar"))
+    compileOnly(files("libs/carbonchat-paper-3.0.0-beta.26.jar"))
+    compileOnly("net.william278:huskchat:2.7.1")
 
     // api module
     implementation(project(":api"))
@@ -46,14 +53,6 @@ dependencies {
     // adventure
     implementation("net.kyori:adventure-api:4.15.0")
     implementation("net.kyori:adventure-platform-bukkit:4.3.2")
-    implementation("net.kyori:adventure-text-minimessage:4.15.0")
-    implementation("net.kyori:adventure-text-serializer-legacy:4.15.0")
-	
-    // bStats
-    implementation("org.bstats:bstats-bukkit:3.0.2")
-
-    // local lib
-    implementation(files("libs/BiomeAPI.jar"))
 }
 
 tasks {
@@ -61,5 +60,14 @@ tasks {
         relocate ("net.kyori", "net.momirealms.customnameplates.libraries")
         relocate ("org.bstats", "net.momirealms.customnameplates.libraries.bstats")
         relocate ("net.momirealms.biomeapi", "net.momirealms.customnameplates.libraries.biomeapi")
+        relocate ("org.apache.commons.pool2", "net.momirealms.customnameplates.libraries.commonspool2")
+        relocate ("com.mysql", "net.momirealms.customnameplates.libraries.mysql")
+        relocate ("org.mariadb", "net.momirealms.customnameplates.libraries.mariadb")
+        relocate ("com.zaxxer.hikari", "net.momirealms.customnameplates.libraries.hikari")
+        relocate ("redis.clients.jedis", "net.momirealms.customnameplates.libraries.jedis")
+        relocate ("com.mongodb", "net.momirealms.customnameplates.libraries.mongodb")
+        relocate ("org.bson", "net.momirealms.customnameplates.libraries.bson")
+        relocate ("dev.jorel.commandapi", "net.momirealms.customnameplates.libraries.commandapi")
+        relocate ("dev.dejvokep.boostedyaml", "net.momirealms.customnameplates.libraries.boostedyaml")
     }
 }

paper/src/main/java/net/momirealms/customnameplates/paper/CustomNameplatesPluginImpl.java

@@ -22,7 +22,10 @@ import net.momirealms.customnameplates.api.event.CustomNameplatesReloadEvent;
 import net.momirealms.customnameplates.api.util.LogUtils;
 import net.momirealms.customnameplates.paper.adventure.AdventureManagerImpl;
 import net.momirealms.customnameplates.paper.command.CommandManager;
-import net.momirealms.customnameplates.paper.helper.LibraryLoader;
+import net.momirealms.customnameplates.paper.libraries.classpath.ReflectionClassPathAppender;
+import net.momirealms.customnameplates.paper.libraries.dependencies.Dependency;
+import net.momirealms.customnameplates.paper.libraries.dependencies.DependencyManager;
+import net.momirealms.customnameplates.paper.libraries.dependencies.DependencyManagerImpl;
 import net.momirealms.customnameplates.paper.mechanic.actionbar.ActionBarManagerImpl;
 import net.momirealms.customnameplates.paper.mechanic.background.BackGroundManagerImpl;
 import net.momirealms.customnameplates.paper.mechanic.bossbar.BossBarManagerImpl;
@@ -43,22 +46,48 @@ import net.momirealms.customnameplates.paper.setting.CNLocale;
 import net.momirealms.customnameplates.paper.storage.StorageManagerImpl;
 import net.momirealms.customnameplates.paper.util.Migration;
 import net.momirealms.customnameplates.paper.util.ReflectionUtils;
+import org.bstats.bukkit.Metrics;
 import org.bukkit.Bukkit;
 import org.bukkit.configuration.file.YamlConfiguration;
 import org.bukkit.event.HandlerList;
 import org.bukkit.event.Listener;
 
 import java.io.File;
-import java.util.TimeZone;
+import java.util.ArrayList;
+import java.util.List;
 
 public class CustomNameplatesPluginImpl extends CustomNameplatesPlugin implements Listener {
 
     private CoolDownManager coolDownManager;
     private PacketManager packetManager;
+    private DependencyManager dependencyManager;
 
     @Override
     public void onLoad() {
-        this.loadLibraries();
+        this.dependencyManager = new DependencyManagerImpl(this, new ReflectionClassPathAppender(this.getClassLoader()));
+        this.dependencyManager.loadDependencies(new ArrayList<>(
+                List.of(
+                        Dependency.GSON,
+                        Dependency.SLF4J_API,
+                        Dependency.SLF4J_SIMPLE,
+                        Dependency.COMMAND_API,
+                        Dependency.BOOSTED_YAML,
+                        Dependency.ADVENTURE_TEXT_MINIMESSAGE,
+                        Dependency.ADVENTURE_LEGACY_SERIALIZER,
+                        Dependency.MYSQL_DRIVER,
+                        Dependency.MARIADB_DRIVER,
+                        Dependency.MONGODB_DRIVER_SYNC,
+                        Dependency.MONGODB_DRIVER_CORE,
+                        Dependency.MONGODB_DRIVER_BSON,
+                        Dependency.JEDIS,
+                        Dependency.COMMONS_POOL_2,
+                        Dependency.H2_DRIVER,
+                        Dependency.SQLITE_DRIVER,
+                        Dependency.BSTATS_BASE,
+                        Dependency.HIKARI,
+                        Dependency.BSTATS_BUKKIT
+                )
+        ));
         ReflectionUtils.load();
     }
 
@@ -93,6 +122,10 @@ public class CustomNameplatesPluginImpl extends CustomNameplatesPlugin implement
             else this.getAdventure().sendConsoleMessage("[CustomNameplates] Update is available: <u>https://polymart.org/resource/2543<!u>");
         });
         this.getServer().getPluginManager().registerEvents((VersionManagerImpl) versionManager, this);
+        if (CNConfig.generatePackOnStart)
+            this.resourcePackManager.generateResourcePack();
+        if (CNConfig.metrics)
+            new Metrics(this, 16649);
     }
 
     @Override
@@ -100,7 +133,7 @@ public class CustomNameplatesPluginImpl extends CustomNameplatesPlugin implement
         if (scheduler != null) ((SchedulerImpl) this.scheduler).shutdown();
         if (actionBarManager != null) ((ActionBarManagerImpl) actionBarManager).unload();
         if (nameplateManager != null) ((NameplateManagerImpl) this.nameplateManager).disable();
-        if (teamManager != null) ((TeamManagerImpl) this.teamManager).unload();
+        if (teamManager != null) ((TeamManagerImpl) this.teamManager).disable();
         if (bossBarManager != null)  ((BossBarManagerImpl) this.bossBarManager).unload();
         if (imageManager != null) ((ImageManagerImpl) this.imageManager).unload();
         if (backGroundManager != null) ((BackGroundManagerImpl) this.backGroundManager).unload();
@@ -150,27 +183,6 @@ public class CustomNameplatesPluginImpl extends CustomNameplatesPlugin implement
         }
     }
 
-    private void loadLibraries() {
-        String mavenRepo = TimeZone.getDefault().getID().startsWith("Asia") ?
-                "https://maven.aliyun.com/repository/public/" : "https://repo.maven.apache.org/maven2/";
-        LibraryLoader.loadDependencies(
-                "org.apache.commons:commons-pool2:2.12.0", mavenRepo,
-                "redis.clients:jedis:5.1.0", mavenRepo,
-                "dev.dejvokep:boosted-yaml:1.3.1", mavenRepo,
-                "com.zaxxer:HikariCP:5.0.1", mavenRepo,
-                "org.mariadb.jdbc:mariadb-java-client:3.3.0", mavenRepo,
-                "com.mysql:mysql-connector-j:8.2.0", mavenRepo,
-                "commons-io:commons-io:2.15.1", mavenRepo,
-                "com.google.code.gson:gson:2.10.1", mavenRepo,
-                "com.h2database:h2:2.2.224", mavenRepo,
-                "org.mongodb:mongodb-driver-sync:4.11.1", mavenRepo,
-                "org.mongodb:mongodb-driver-core:4.11.1", mavenRepo,
-                "org.mongodb:bson:4.11.1", mavenRepo,
-                "org.xerial:sqlite-jdbc:3.43.2.2", mavenRepo,
-                "dev.jorel:commandapi-bukkit-shade:9.3.0", mavenRepo
-        );
-    }
-
     public CoolDownManager getCoolDownManager() {
         return coolDownManager;
     }
@@ -178,4 +190,8 @@ public class CustomNameplatesPluginImpl extends CustomNameplatesPlugin implement
     public PacketManager getPacketManager() {
         return packetManager;
     }
+
+    public DependencyManager getDependencyManager() {
+        return dependencyManager;
+    }
 }

paper/src/main/java/net/momirealms/customnameplates/paper/adventure/AdventureManagerImpl.java

@@ -195,12 +195,12 @@ public class AdventureManagerImpl implements AdventureManager {
                 case 'd' -> stringBuilder.append("<light_purple>");
                 case 'e' -> stringBuilder.append("<yellow>");
                 case 'f' -> stringBuilder.append("<white>");
-                case 'r' -> stringBuilder.append("<r><!i>");
+                case 'r' -> stringBuilder.append("<reset>");
                 case 'l' -> stringBuilder.append("<b>");
-                case 'm' -> stringBuilder.append("<s>");
+                case 'm' -> stringBuilder.append("<st>");
                 case 'o' -> stringBuilder.append("<i>");
                 case 'n' -> stringBuilder.append("<u>");
-                case 'k' -> stringBuilder.append("<o>");
+                case 'k' -> stringBuilder.append("<obf>");
                 case 'x' -> {
                     if (i + 13 >= chars.length
                             || !isColorCode(chars[i+2])

paper/src/main/java/net/momirealms/customnameplates/paper/command/CommandManager.java

@@ -107,7 +107,7 @@ public class CommandManager {
 
         public static CommandAPICommand getListCommand() {
             return new CommandAPICommand("list")
-                    .withPermission("bubbles.list")
+                    .withPermission("bubbles.command.list")
                     .executesPlayer((player, args) -> {
                         if (!CNConfig.bubbleModule) return;
                         List<String> bubbles = CustomNameplatesPlugin.get().getBubbleManager().getAvailableBubblesDisplayNames(player);
@@ -116,7 +116,7 @@ public class CommandManager {
                             for (String availableBubble : bubbles) {
                                 stringJoiner.add(availableBubble);
                             }
-                            AdventureManagerImpl.getInstance().sendMessageWithPrefix(player, CNLocale.MSG_AVAILABLE_BUBBLE.replace("{Bubble}", stringJoiner.toString()));
+                            AdventureManagerImpl.getInstance().sendMessageWithPrefix(player, CNLocale.MSG_AVAILABLE_BUBBLE.replace("{Bubble}", stringJoiner.toString()).replace("{Bubbles}", stringJoiner.toString()));
                         } else {
                             AdventureManagerImpl.getInstance().sendMessageWithPrefix(player, CNLocale.MSG_HAVE_NO_BUBBLE);
                         }
@@ -125,15 +125,22 @@ public class CommandManager {
 
         public static CommandAPICommand getEquipCommand() {
             return new CommandAPICommand("equip")
-                    .withPermission("bubbles.equip")
+                    .withPermission("bubbles.command.equip")
                     .withArguments(new StringArgument("bubble").replaceSuggestions(ArgumentSuggestions.strings(commandSenderSuggestionInfo -> CustomNameplatesPlugin.get().getBubbleManager().getAvailableBubbles((Player) commandSenderSuggestionInfo.sender()).toArray(new String[0]))))
                     .executesPlayer((player, args) -> {
                         if (!CNConfig.bubbleModule) return;
                         String bubble = (String) args.get("bubble");
-                        if (!CustomNameplatesPlugin.get().getBubbleManager().equipBubble(player, bubble)) {
+                        if (!CustomNameplatesPlugin.get().getBubbleManager().containsBubble(bubble)) {
                             AdventureManagerImpl.getInstance().sendMessageWithPrefix(player, CNLocale.MSG_BUBBLE_NOT_EXIST);
                             return;
                         }
+
+                        if (!CustomNameplatesPlugin.get().getBubbleManager().hasBubble(player, bubble)) {
+                            AdventureManagerImpl.getInstance().sendMessageWithPrefix(player, CNLocale.MSG_BUBBLE_NOT_AVAILABLE);
+                            return;
+                        }
+
+                        CustomNameplatesPlugin.get().getBubbleManager().equipBubble(player, bubble);
                         Bubble bubbleInstance = CustomNameplatesPlugin.get().getBubbleManager().getBubble(bubble);
                         AdventureManagerImpl.getInstance().sendMessageWithPrefix(player, CNLocale.MSG_EQUIP_BUBBLE.replace("{Bubble}", bubbleInstance.getDisplayName()));
                     });
@@ -141,7 +148,7 @@ public class CommandManager {
 
         public static CommandAPICommand getUnEquipCommand() {
             return new CommandAPICommand("unequip")
-                    .withPermission("bubbles.unequip")
+                    .withPermission("bubbles.command.unequip")
                     .executesPlayer((player, args) -> {
                         if (!CNConfig.bubbleModule) return;
                         CustomNameplatesPlugin.get().getBubbleManager().unEquipBubble(player);
@@ -218,7 +225,7 @@ public class CommandManager {
 
         public static CommandAPICommand getPreviewCommand() {
             return new CommandAPICommand("preview")
-                    .withPermission("nameplates.preview")
+                    .withPermission("nameplates.command.preview")
                     .executesPlayer((player, args) -> {
                         if (!CNConfig.nameplateModule) return;
                         NameplatePlayer nameplatePlayer = CustomNameplatesPlugin.get().getNameplateManager().getNameplatePlayer(player.getUniqueId());
@@ -290,15 +297,23 @@ public class CommandManager {
 
         public static CommandAPICommand getEquipCommand() {
             return new CommandAPICommand("equip")
-                    .withPermission("nameplates.equip")
+                    .withPermission("nameplates.command.equip")
                     .withArguments(new StringArgument("nameplate").replaceSuggestions(ArgumentSuggestions.strings(commandSenderSuggestionInfo -> CustomNameplatesPlugin.get().getNameplateManager().getAvailableNameplates((Player) commandSenderSuggestionInfo.sender()).toArray(new String[0]))))
                     .executesPlayer((player, args) -> {
                         if (!CNConfig.nameplateModule) return;
                         String nameplate = (String) args.get("nameplate");
-                        if (!CustomNameplatesPlugin.get().getNameplateManager().equipNameplate(player, nameplate, false)) {
+
+                        if (!CustomNameplatesPlugin.get().getNameplateManager().containsNameplate(nameplate)) {
                             AdventureManagerImpl.getInstance().sendMessageWithPrefix(player, CNLocale.MSG_NAMEPLATE_NOT_EXISTS);
                             return;
                         }
+
+                        if (!CustomNameplatesPlugin.get().getNameplateManager().hasNameplate(player, nameplate)) {
+                            AdventureManagerImpl.getInstance().sendMessageWithPrefix(player, CNLocale.MSG_NAMEPLATE_NOT_AVAILABLE);
+                            return;
+                        }
+
+                        CustomNameplatesPlugin.get().getNameplateManager().equipNameplate(player, nameplate, false);
                         Nameplate nameplateInstance = CustomNameplatesPlugin.get().getNameplateManager().getNameplate(nameplate);
                         AdventureManagerImpl.getInstance().sendMessageWithPrefix(player, CNLocale.MSG_EQUIP_NAMEPLATE.replace("{Nameplate}", nameplateInstance.getDisplayName()));
                     });
@@ -306,7 +321,7 @@ public class CommandManager {
 
         public static CommandAPICommand getUnEquipCommand() {
             return new CommandAPICommand("unequip")
-                    .withPermission("nameplates.unequip")
+                    .withPermission("nameplates.command.unequip")
                     .executesPlayer((player, args) -> {
                         if (!CNConfig.nameplateModule) return;
                         CustomNameplatesPlugin.get().getNameplateManager().unEquipNameplate(player, false);
@@ -316,7 +331,7 @@ public class CommandManager {
 
         public static CommandAPICommand getListCommand() {
             return new CommandAPICommand("list")
-                    .withPermission("nameplates.list")
+                    .withPermission("nameplates.command.list")
                     .executesPlayer((player, args) -> {
                         if (!CNConfig.nameplateModule) return;
                         List<String> nameplates = CustomNameplatesPlugin.get().getNameplateManager().getAvailableNameplateDisplayNames(player);
@@ -325,7 +340,7 @@ public class CommandManager {
                             for (String availableNameplate : nameplates) {
                                 stringJoiner.add(availableNameplate);
                             }
-                            AdventureManagerImpl.getInstance().sendMessageWithPrefix(player, CNLocale.MSG_AVAILABLE_NAMEPLATE.replace("{Nameplates}", stringJoiner.toString()));
+                            AdventureManagerImpl.getInstance().sendMessageWithPrefix(player, CNLocale.MSG_AVAILABLE_NAMEPLATE.replace("{Nameplates}", stringJoiner.toString()).replace("{Nameplate}", stringJoiner.toString()));
                         } else {
                             AdventureManagerImpl.getInstance().sendMessageWithPrefix(player, CNLocale.MSG_HAVE_NO_NAMEPLATE);
                         }
@@ -383,7 +398,7 @@ public class CommandManager {
 
         public static CommandAPICommand getAboutCommand() {
             return new CommandAPICommand("about")
-                    .withPermission("customnameplates.about")
+                    .withPermission("customnameplates.admin")
                     .executes((sender, args) -> {
                         AdventureManagerImpl.getInstance().sendMessage(sender, "<#3CB371>⚓ CustomNameplates <gray>- <#98FB98>" + CustomNameplatesPlugin.getInstance().getVersionManager().getPluginVersion());
                         AdventureManagerImpl.getInstance().sendMessage(sender, "<#7FFFAA>A plugin that provides adjustable images for texts");

paper/src/main/java/net/momirealms/customnameplates/paper/helper/LibraryLoader.java

@@ -1,182 +0,0 @@
-/*
- * This file is part of helper, licensed under the MIT License.
- *
- *  Copyright (c) lucko (Luck) <luck@lucko.me>
- *  Copyright (c) contributors
- *
- *  Permission is hereby granted, free of charge, to any person obtaining a copy
- *  of this software and associated documentation files (the "Software"), to deal
- *  in the Software without restriction, including without limitation the rights
- *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- *  copies of the Software, and to permit persons to whom the Software is
- *  furnished to do so, subject to the following conditions:
- *
- *  The above copyright notice and this permission notice shall be included in all
- *  copies or substantial portions of the Software.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- *  SOFTWARE.
- */
-
-package net.momirealms.customnameplates.paper.helper;
-
-import com.google.common.base.Supplier;
-import com.google.common.base.Suppliers;
-import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
-import net.momirealms.customnameplates.api.util.LogUtils;
-import net.momirealms.customnameplates.paper.CustomNameplatesPluginImpl;
-
-import java.io.File;
-import java.io.InputStream;
-import java.net.MalformedURLException;
-import java.net.URL;
-import java.net.URLClassLoader;
-import java.nio.file.Files;
-import java.util.Objects;
-import java.util.StringJoiner;
-
-/**
- * Resolves {@link MavenLibrary} annotations for a class, and loads the dependency
- * into the classloader.
- */
-public final class LibraryLoader {
-
-    @SuppressWarnings("Guava")
-    private static final Supplier<URLClassLoaderAccess> URL_INJECTOR = Suppliers.memoize(() -> URLClassLoaderAccess.create((URLClassLoader) CustomNameplatesPluginImpl.getInstance().getClass().getClassLoader()));
-
-    /**
-     * Resolves all {@link MavenLibrary} annotations on the given object.
-     *
-     * @param object the object to load libraries for.
-     */
-    public static void loadAll(Object object) {
-        loadAll(object.getClass());
-    }
-
-    /**
-     * Resolves all {@link MavenLibrary} annotations on the given class.
-     *
-     * @param clazz the class to load libraries for.
-     */
-    public static void loadAll(Class<?> clazz) {
-        MavenLibrary[] libs = clazz.getDeclaredAnnotationsByType(MavenLibrary.class);
-        for (MavenLibrary lib : libs) {
-            load(lib.groupId(), lib.artifactId(), lib.version(), lib.repo().url());
-        }
-    }
-
-    public static void load(String groupId, String artifactId, String version, String repoUrl) {
-        load(new Dependency(groupId, artifactId, version, repoUrl));
-    }
-
-    public static void loadDependencies(String... libs) {
-        if (libs == null || libs.length % 2 != 0)
-            return;
-        for (int i = 0; i < libs.length; i+=2) {
-            String[] split = libs[i].split(":");
-            load(new Dependency(
-                    split[0],
-                    split[1],
-                    split[2],
-                    libs[i+1]
-            ));
-        }
-    }
-
-    public static void load(Dependency d) {
-//        LogUtils.info(String.format("Loading dependency %s:%s:%s", d.groupId, d.artifactId, d.version));
-        String name = d.artifactId() + "-" + d.version();
-        File saveLocation = new File(getLibFolder(d), name + ".jar");
-        if (!saveLocation.exists()) {
-            try {
-                LogUtils.info("Dependency '" + name + "' is not already in the libraries folder. Attempting to download...");
-                URL url = d.getUrl();
-                try (InputStream is = url.openStream()) {
-                    Files.copy(is, saveLocation.toPath());
-                    LogUtils.info("Dependency '" + name + "' successfully downloaded.");
-                }
-            } catch (Exception e) {
-                e.printStackTrace();
-            }
-        }
-        if (!saveLocation.exists())
-            throw new RuntimeException("Unable to download dependency: " + d);
-        try {
-            URL_INJECTOR.get().addURL(saveLocation.toURI().toURL());
-        } catch (Exception e) {
-            throw new RuntimeException("Unable to load dependency: " + saveLocation, e);
-        }
-    }
-
-    @SuppressWarnings("all")
-    private static File getLibFolder(Dependency dependency) {
-        File pluginDataFolder = CustomNameplatesPlugin.getInstance().getDataFolder();
-        File serverDir = pluginDataFolder.getParentFile().getParentFile();
-
-        File helperDir = new File(serverDir, "libraries");
-        String[] split = dependency.groupId().split("\\.");
-        File jarDir;
-        StringJoiner stringJoiner = new StringJoiner(File.separator);
-        for (String str : split) {
-            stringJoiner.add(str);
-        }
-        jarDir = new File(helperDir, stringJoiner + File.separator + dependency.artifactId + File.separator + dependency.version);
-        jarDir.mkdirs();
-        return jarDir;
-    }
-
-    public record Dependency(String groupId, String artifactId, String version, String repoUrl) {
-            public Dependency(String groupId, String artifactId, String version, String repoUrl) {
-                this.groupId = Objects.requireNonNull(groupId, "groupId");
-                this.artifactId = Objects.requireNonNull(artifactId, "artifactId");
-                this.version = Objects.requireNonNull(version, "version");
-                this.repoUrl = Objects.requireNonNull(repoUrl, "repoUrl");
-            }
-
-            public URL getUrl() throws MalformedURLException {
-                String repo = this.repoUrl;
-                if (!repo.endsWith("/")) {
-                    repo += "/";
-                }
-                repo += "%s/%s/%s/%s-%s.jar";
-
-                String url = String.format(repo, this.groupId.replace(".", "/"), this.artifactId, this.version, this.artifactId, this.version);
-                return new URL(url);
-            }
-
-            @Override
-            public boolean equals(Object o) {
-                if (o == this) return true;
-                if (!(o instanceof Dependency other)) return false;
-                return this.groupId().equals(other.groupId()) &&
-                        this.artifactId().equals(other.artifactId()) &&
-                        this.version().equals(other.version()) &&
-                        this.repoUrl().equals(other.repoUrl());
-            }
-
-            @Override
-            public int hashCode() {
-                final int PRIME = 59;
-                int result = 1;
-                result = result * PRIME + this.groupId().hashCode();
-                result = result * PRIME + this.artifactId().hashCode();
-                result = result * PRIME + this.version().hashCode();
-                result = result * PRIME + this.repoUrl().hashCode();
-                return result;
-            }
-
-            @Override
-            public String toString() {
-                return "LibraryLoader.Dependency(" +
-                        "groupId=" + this.groupId() + ", " +
-                        "artifactId=" + this.artifactId() + ", " +
-                        "version=" + this.version() + ", " +
-                        "repoUrl=" + this.repoUrl() + ")";
-            }
-        }
-}

paper/src/main/java/net/momirealms/customnameplates/paper/libraries/classpath/ClassPathAppender.java

@@ -1,5 +1,5 @@
 /*
- * This file is part of helper, licensed under the MIT License.
+ * This file is part of LuckPerms, licensed under the MIT License.
  *
  *  Copyright (c) lucko (Luck) <luck@lucko.me>
  *  Copyright (c) contributors
@@ -23,21 +23,19 @@
  *  SOFTWARE.
  */
 
-package net.momirealms.customnameplates.paper.helper;
+package net.momirealms.customnameplates.paper.libraries.classpath;
 
-import org.jetbrains.annotations.NotNull;
-
-import java.lang.annotation.*;
+import java.nio.file.Path;
 
 /**
- * Annotation to indicate the required libraries for a class.
+ * Interface which allows access to add URLs to the plugin classpath at runtime.
  */
-@Documented
-@Target(ElementType.TYPE)
-@Retention(RetentionPolicy.RUNTIME)
-public @interface MavenLibraries {
+public interface ClassPathAppender extends AutoCloseable {
 
-    @NotNull
-    MavenLibrary[] value() default {};
+    void addJarToClasspath(Path file);
 
+    @Override
+    default void close() {
+
+    }
 }

paper/src/main/java/net/momirealms/customnameplates/paper/libraries/classpath/JarInJarClassPathAppender.java

@@ -0,0 +1,62 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.momirealms.customnameplates.paper.libraries.classpath;
+
+import net.momirealms.customnameplates.paper.libraries.loader.JarInJarClassLoader;
+
+import java.io.IOException;
+import java.net.MalformedURLException;
+import java.nio.file.Path;
+
+public class JarInJarClassPathAppender implements ClassPathAppender {
+    private final JarInJarClassLoader classLoader;
+
+    public JarInJarClassPathAppender(ClassLoader classLoader) {
+        if (!(classLoader instanceof JarInJarClassLoader)) {
+            throw new IllegalArgumentException("Loader is not a JarInJarClassLoader: " + classLoader.getClass().getName());
+        }
+        this.classLoader = (JarInJarClassLoader) classLoader;
+    }
+
+    @Override
+    public void addJarToClasspath(Path file) {
+        try {
+            this.classLoader.addJarToClasspath(file.toUri().toURL());
+        } catch (MalformedURLException e) {
+            throw new RuntimeException(e);
+        }
+    }
+
+    @Override
+    public void close() {
+        this.classLoader.deleteJarResource();
+        try {
+            this.classLoader.close();
+        } catch (IOException e) {
+            e.printStackTrace();
+        }
+    }
+}

paper/src/main/java/net/momirealms/customnameplates/paper/libraries/classpath/ReflectionClassPathAppender.java

@@ -0,0 +1,52 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.momirealms.customnameplates.paper.libraries.classpath;
+
+import java.net.MalformedURLException;
+import java.net.URLClassLoader;
+import java.nio.file.Path;
+
+public class ReflectionClassPathAppender implements ClassPathAppender {
+    private final URLClassLoaderAccess classLoaderAccess;
+
+    public ReflectionClassPathAppender(ClassLoader classLoader) throws IllegalStateException {
+        if (classLoader instanceof URLClassLoader) {
+            this.classLoaderAccess = URLClassLoaderAccess.create((URLClassLoader) classLoader);
+        } else {
+            throw new IllegalStateException("ClassLoader is not instance of URLClassLoader");
+        }
+    }
+
+    @Override
+    public void addJarToClasspath(Path file) {
+        try {
+            this.classLoaderAccess.addURL(file.toUri().toURL());
+        } catch (MalformedURLException e) {
+            throw new RuntimeException(e);
+        }
+    }
+
+}

paper/src/main/java/net/momirealms/customnameplates/paper/libraries/classpath/URLClassLoaderAccess.java

@@ -1,5 +1,5 @@
 /*
- * This file is part of helper, licensed under the MIT License.
+ * This file is part of LuckPerms, licensed under the MIT License.
  *
  *  Copyright (c) lucko (Luck) <luck@lucko.me>
  *  Copyright (c) contributors
@@ -23,11 +23,12 @@
  *  SOFTWARE.
  */
 
-package net.momirealms.customnameplates.paper.helper;
+package net.momirealms.customnameplates.paper.libraries.classpath;
 
-import org.jetbrains.annotations.NotNull;
+import org.checkerframework.checker.nullness.qual.NonNull;
 
 import java.lang.reflect.Field;
+import java.lang.reflect.Method;
 import java.net.URL;
 import java.net.URLClassLoader;
 import java.util.Collection;
@@ -43,8 +44,10 @@ public abstract class URLClassLoaderAccess {
      * @param classLoader the class loader
      * @return the access object
      */
-    static URLClassLoaderAccess create(URLClassLoader classLoader) {
-        if (Unsafe.isSupported()) {
+    public static URLClassLoaderAccess create(URLClassLoader classLoader) {
+        if (Reflection.isSupported()) {
+            return new Reflection(classLoader);
+        } else if (Unsafe.isSupported()) {
             return new Unsafe(classLoader);
         } else {
             return Noop.INSTANCE;
@@ -63,7 +66,48 @@ public abstract class URLClassLoaderAccess {
      *
      * @param url the URL to add
      */
-    public abstract void addURL(@NotNull URL url);
+    public abstract void addURL(@NonNull URL url);
+
+    private static void throwError(Throwable cause) throws UnsupportedOperationException {
+        throw new UnsupportedOperationException("CustomNameplates is unable to inject into the plugin URLClassLoader.\n" +
+                "You may be able to fix this problem by adding the following command-line argument " +
+                "directly after the 'java' command in your start script: \n'--add-opens java.base/java.lang=ALL-UNNAMED'", cause);
+    }
+
+    /**
+     * Accesses using reflection, not supported on Java 9+.
+     */
+    private static class Reflection extends URLClassLoaderAccess {
+        private static final Method ADD_URL_METHOD;
+
+        static {
+            Method addUrlMethod;
+            try {
+                addUrlMethod = URLClassLoader.class.getDeclaredMethod("addURL", URL.class);
+                addUrlMethod.setAccessible(true);
+            } catch (Exception e) {
+                addUrlMethod = null;
+            }
+            ADD_URL_METHOD = addUrlMethod;
+        }
+
+        private static boolean isSupported() {
+            return ADD_URL_METHOD != null;
+        }
+
+        Reflection(URLClassLoader classLoader) {
+            super(classLoader);
+        }
+
+        @Override
+        public void addURL(@NonNull URL url) {
+            try {
+                ADD_URL_METHOD.invoke(super.classLoader, url);
+            } catch (ReflectiveOperationException e) {
+                URLClassLoaderAccess.throwError(e);
+            }
+        }
+    }
 
     /**
      * Accesses using sun.misc.Unsafe, supported on Java 9+.
@@ -106,6 +150,7 @@ public abstract class URLClassLoaderAccess {
                 unopenedURLs = null;
                 pathURLs = null;
             }
+
             this.unopenedURLs = unopenedURLs;
             this.pathURLs = pathURLs;
         }
@@ -117,9 +162,15 @@ public abstract class URLClassLoaderAccess {
         }
 
         @Override
-        public void addURL(@NotNull URL url) {
-            this.unopenedURLs.add(url);
-            this.pathURLs.add(url);
+        public void addURL(@NonNull URL url) {
+            if (this.unopenedURLs == null || this.pathURLs == null) {
+                URLClassLoaderAccess.throwError(new NullPointerException("unopenedURLs or pathURLs"));
+            }
+
+            synchronized (this.unopenedURLs)  {
+                this.unopenedURLs.add(url);
+                this.pathURLs.add(url);
+            }
         }
     }
 
@@ -131,8 +182,8 @@ public abstract class URLClassLoaderAccess {
         }
 
         @Override
-        public void addURL(@NotNull URL url) {
-            throw new UnsupportedOperationException();
+        public void addURL(@NonNull URL url) {
+            URLClassLoaderAccess.throwError(null);
         }
     }
 

paper/src/main/java/net/momirealms/customnameplates/paper/libraries/dependencies/Dependency.java

@@ -0,0 +1,368 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.momirealms.customnameplates.paper.libraries.dependencies;
+
+import com.google.common.collect.ImmutableList;
+import net.momirealms.customnameplates.paper.libraries.dependencies.relocation.Relocation;
+import org.jetbrains.annotations.Nullable;
+
+import java.security.MessageDigest;
+import java.security.NoSuchAlgorithmException;
+import java.util.List;
+import java.util.Locale;
+
+/**
+ * The dependencies used by LuckPerms.
+ */
+public enum Dependency {
+
+    ASM(
+            "org.ow2.asm",
+            "asm",
+            "9.1",
+            null,
+            "asm"
+    ),
+    ASM_COMMONS(
+            "org.ow2.asm",
+            "asm-commons",
+            "9.1",
+            null,
+            "asm-commons"
+    ),
+    JAR_RELOCATOR(
+            "me.lucko",
+            "jar-relocator",
+            "1.7",
+            null,
+            "jar-relocator"
+    ),
+    KYORI_OPTION(
+            "net{}kyori",
+            "option",
+            "1.0.0",
+            null,
+            "kyori-option",
+            Relocation.of("option", "net{}kyori{}option")
+    ),
+    ADVENTURE_API(
+            "net{}kyori",
+            "adventure-api",
+            "4.15.0",
+            null,
+            "adventure-api",
+            Relocation.of("adventure", "net{}kyori{}adventure")
+    ),
+    ADVENTURE_KEY(
+            "net{}kyori",
+            "adventure-key",
+            "4.15.0",
+            null,
+            "adventure-key",
+            Relocation.of("adventure", "net{}kyori{}adventure")
+    ),
+    ADVENTURE_NBT(
+            "net{}kyori",
+            "adventure-nbt",
+            "4.15.0",
+            null,
+            "adventure-nbt",
+            Relocation.of("adventure", "net{}kyori{}adventure")
+    ),
+    ADVENTURE_LEGACY_SERIALIZER(
+            "net{}kyori",
+            "adventure-text-serializer-legacy",
+            "4.15.0",
+            null,
+            "adventure-text-serializer-legacy",
+            Relocation.of("adventure", "net{}kyori{}adventure")
+    ),
+    ADVENTURE_TEXT_LOGGER(
+            "net{}kyori",
+            "adventure-text-logger-slf4j",
+            "4.15.0",
+            null,
+            "adventure-text-logger-slf4j",
+            Relocation.of("adventure", "net{}kyori{}adventure")
+    ),
+    ADVENTURE_GSON(
+            "net{}kyori",
+            "adventure-text-serializer-gson",
+            "4.15.0",
+            null,
+            "adventure-text-serializer-gson",
+            Relocation.of("adventure", "net{}kyori{}adventure")
+    ),
+    ADVENTURE_GSON_LEGACY(
+            "net{}kyori",
+            "adventure-text-serializer-gson-legacy-impl",
+            "4.15.0",
+            null,
+            "adventure-text-serializer-gson-legacy-impl",
+            Relocation.of("adventure", "net{}kyori{}adventure")
+    ),
+    ADVENTURE_PLATFORM(
+            "net{}kyori",
+            "adventure-platform-api",
+            "4.3.2",
+            null,
+            "adventure-platform-api",
+            Relocation.of("adventure", "net{}kyori{}adventure")
+    ),
+    ADVENTURE_PLATFORM_BUKKIT(
+            "net{}kyori",
+            "adventure-platform-bukkit",
+            "4.3.2",
+            null,
+            "adventure-platform-bukkit",
+            Relocation.of("adventure", "net{}kyori{}adventure")
+    ),
+    ADVENTURE_PLATFORM_FACET(
+            "net{}kyori",
+            "adventure-platform-facet",
+            "4.3.2",
+            null,
+            "adventure-platform-facet",
+            Relocation.of("adventure", "net{}kyori{}adventure")
+    ),
+    ADVENTURE_TEXT_MINIMESSAGE(
+            "net{}kyori",
+            "adventure-text-minimessage",
+            "4.15.0",
+            null,
+            "adventure-text-minimessage",
+            Relocation.of("adventure", "net{}kyori{}adventure")
+    ),
+    COMMAND_API(
+            "dev{}jorel",
+            "commandapi-bukkit-shade",
+            "9.3.0",
+            null,
+            "commandapi-bukkit",
+            Relocation.of("commandapi", "dev{}jorel{}commandapi")
+    ),
+    MARIADB_DRIVER(
+            "org{}mariadb{}jdbc",
+            "mariadb-java-client",
+            "3.3.2",
+            null,
+            "mariadb-java-client",
+            Relocation.of("mariadb", "org{}mariadb")
+    ),
+    BOOSTED_YAML(
+            "dev{}dejvokep",
+            "boosted-yaml",
+            "1.3.2",
+            null,
+            "boosted-yaml",
+            Relocation.of("boostedyaml", "dev{}dejvokep{}boostedyaml")
+    ),
+    MYSQL_DRIVER(
+            "com{}mysql",
+            "mysql-connector-j",
+            "8.3.0",
+            null,
+            "mysql-connector-j",
+            Relocation.of("mysql", "com{}mysql")
+    ),
+    H2_DRIVER(
+            "com.h2database",
+            "h2",
+            "2.2.224",
+            null,
+            "h2database"
+    ),
+    SQLITE_DRIVER(
+            "org.xerial",
+            "sqlite-jdbc",
+            "3.45.1.0",
+            null,
+            "sqlite-jdbc"
+    ),
+    HIKARI(
+            "com{}zaxxer",
+            "HikariCP",
+            "5.0.1",
+            null,
+            "HikariCP",
+            Relocation.of("hikari", "com{}zaxxer{}hikari")
+    ),
+    SLF4J_SIMPLE(
+            "org.slf4j",
+            "slf4j-simple",
+            "2.0.12",
+            null,
+            "slf4j-simple"
+    ),
+    SLF4J_API(
+            "org.slf4j",
+            "slf4j-api",
+            "2.0.12",
+            null,
+            "slf4j-api"
+    ),
+    MONGODB_DRIVER_CORE(
+            "org{}mongodb",
+            "mongodb-driver-core",
+            "4.11.1",
+            null,
+            "mongodb-driver-core",
+            Relocation.of("mongodb", "com{}mongodb"),
+            Relocation.of("bson", "org{}bson")
+    ),
+    MONGODB_DRIVER_SYNC(
+            "org{}mongodb",
+            "mongodb-driver-sync",
+            "4.11.1",
+            null,
+            "mongodb-driver-sync",
+            Relocation.of("mongodb", "com{}mongodb"),
+            Relocation.of("bson", "org{}bson")
+    ),
+    MONGODB_DRIVER_BSON(
+            "org{}mongodb",
+            "bson",
+            "4.11.1",
+            null,
+            "mongodb-bson",
+            Relocation.of("mongodb", "com{}mongodb"),
+            Relocation.of("bson", "org{}bson")
+    ),
+    JEDIS(
+            "redis{}clients",
+            "jedis",
+            "5.1.0",
+            null,
+            "jedis",
+            Relocation.of("jedis", "redis{}clients{}jedis"),
+            Relocation.of("commonspool2", "org{}apache{}commons{}pool2")
+    ),
+    BSTATS_BASE(
+            "org{}bstats",
+            "bstats-base",
+            "3.0.2",
+            null,
+            "bstats-base",
+            Relocation.of("bstats", "org{}bstats")
+    ),
+    BSTATS_BUKKIT(
+            "org{}bstats",
+            "bstats-bukkit",
+            "3.0.2",
+            null,
+            "bstats-bukkit",
+            Relocation.of("bstats", "org{}bstats")
+    ),
+    COMMONS_POOL_2(
+            "org{}apache{}commons",
+            "commons-pool2",
+            "2.12.0",
+            null,
+            "commons-pool2",
+            Relocation.of("commonspool2", "org{}apache{}commons{}pool2")
+    ),
+    GSON(
+            "com.google.code.gson",
+            "gson",
+            "2.10.1",
+            null,
+            "gson"
+    ),
+    BIOME_API(
+            "com{}github{}Xiao-MoMi",
+            "BiomeAPI",
+            "0.3",
+            "jitpack",
+            "biome-api",
+            Relocation.of("biomeapi", "net{}momirealms{}biomeapi")
+    );
+
+    private final String mavenRepoPath;
+    private final String version;
+    private final List<Relocation> relocations;
+    private final String repo;
+    private final String artifact;
+
+    private static final String MAVEN_FORMAT = "%s/%s/%s/%s-%s.jar";
+
+    Dependency(String groupId, String artifactId, String version, String repo, String artifact) {
+        this(groupId, artifactId, version, repo, artifact, new Relocation[0]);
+    }
+
+    Dependency(String groupId, String artifactId, String version, String repo, String artifact, Relocation... relocations) {
+        this.mavenRepoPath = String.format(MAVEN_FORMAT,
+                rewriteEscaping(groupId).replace(".", "/"),
+                rewriteEscaping(artifactId),
+                version,
+                rewriteEscaping(artifactId),
+                version
+        );
+        this.version = version;
+        this.relocations = ImmutableList.copyOf(relocations);
+        this.repo = repo;
+        this.artifact = artifact;
+    }
+
+    private static String rewriteEscaping(String s) {
+        return s.replace("{}", ".");
+    }
+
+    public String getFileName(String classifier) {
+        String name = artifact.toLowerCase(Locale.ROOT).replace('_', '-');
+        String extra = classifier == null || classifier.isEmpty()
+                ? ""
+                : "-" + classifier;
+
+        return name + "-" + this.version + extra + ".jar";
+    }
+
+    String getMavenRepoPath() {
+        return this.mavenRepoPath;
+    }
+
+    public List<Relocation> getRelocations() {
+        return this.relocations;
+    }
+
+    /**
+     * Creates a {@link MessageDigest} suitable for computing the checksums
+     * of dependencies.
+     *
+     * @return the digest
+     */
+    public static MessageDigest createDigest() {
+        try {
+            return MessageDigest.getInstance("SHA-256");
+        } catch (NoSuchAlgorithmException e) {
+            throw new RuntimeException(e);
+        }
+    }
+
+    @Nullable
+    public String getRepo() {
+        return repo;
+    }
+}

paper/src/main/java/net/momirealms/customnameplates/paper/libraries/dependencies/DependencyDownloadException.java

@@ -0,0 +1,48 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.momirealms.customnameplates.paper.libraries.dependencies;
+
+/**
+ * Exception thrown if a dependency cannot be downloaded.
+ */
+public class DependencyDownloadException extends Exception {
+
+    public DependencyDownloadException() {
+
+    }
+
+    public DependencyDownloadException(String message) {
+        super(message);
+    }
+
+    public DependencyDownloadException(String message, Throwable cause) {
+        super(message, cause);
+    }
+
+    public DependencyDownloadException(Throwable cause) {
+        super(cause);
+    }
+}

paper/src/main/java/net/momirealms/customnameplates/paper/libraries/dependencies/DependencyManager.java

@@ -1,5 +1,5 @@
 /*
- * This file is part of helper, licensed under the MIT License.
+ * This file is part of LuckPerms, licensed under the MIT License.
  *
  *  Copyright (c) lucko (Luck) <luck@lucko.me>
  *  Copyright (c) contributors
@@ -23,51 +23,31 @@
  *  SOFTWARE.
  */
 
-package net.momirealms.customnameplates.paper.helper;
+package net.momirealms.customnameplates.paper.libraries.dependencies;
 
-import org.jetbrains.annotations.NotNull;
-
-import java.lang.annotation.*;
+import java.util.Collection;
+import java.util.Set;
 
 /**
- * Annotation to indicate a required library for a class.
+ * Loads and manages runtime dependencies for the plugin.
  */
-@Documented
-@Repeatable(MavenLibraries.class)
-@Target(ElementType.TYPE)
-@Retention(RetentionPolicy.RUNTIME)
-public @interface MavenLibrary {
+public interface DependencyManager extends AutoCloseable {
 
     /**
-     * The group id of the library
+     * Loads dependencies.
      *
-     * @return the group id of the library
+     * @param dependencies the dependencies to load
      */
-    @NotNull
-    String groupId();
+    void loadDependencies(Collection<Dependency> dependencies);
 
     /**
-     * The artifact id of the library
+     * Obtains an isolated classloader containing the given dependencies.
      *
-     * @return the artifact id of the library
+     * @param dependencies the dependencies
+     * @return the classloader
      */
-    @NotNull
-    String artifactId();
-
-    /**
-     * The version of the library
-     *
-     * @return the version of the library
-     */
-    @NotNull
-    String version();
-
-    /**
-     * The repo where the library can be obtained from
-     *
-     * @return the repo where the library can be obtained from
-     */
-    @NotNull
-    Repository repo() default @Repository(url = "https://repo1.maven.org/maven2");
+    ClassLoader obtainClassLoaderWith(Set<Dependency> dependencies);
 
+    @Override
+    void close();
 }

paper/src/main/java/net/momirealms/customnameplates/paper/libraries/dependencies/DependencyManagerImpl.java

@@ -0,0 +1,231 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.momirealms.customnameplates.paper.libraries.dependencies;
+
+import com.google.common.collect.ImmutableSet;
+import net.momirealms.customnameplates.paper.CustomNameplatesPluginImpl;
+import net.momirealms.customnameplates.paper.libraries.classpath.ClassPathAppender;
+import net.momirealms.customnameplates.paper.libraries.dependencies.classloader.IsolatedClassLoader;
+import net.momirealms.customnameplates.paper.libraries.dependencies.relocation.Relocation;
+import net.momirealms.customnameplates.paper.libraries.dependencies.relocation.RelocationHandler;
+import org.checkerframework.checker.nullness.qual.MonotonicNonNull;
+
+import java.io.File;
+import java.io.IOException;
+import java.net.MalformedURLException;
+import java.net.URL;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.*;
+import java.util.concurrent.CountDownLatch;
+
+/**
+ * Loads and manages runtime dependencies for the plugin.
+ */
+public class DependencyManagerImpl implements DependencyManager {
+
+    /** A registry containing plugin specific behaviour for dependencies. */
+    private final DependencyRegistry registry;
+    /** The path where library jars are cached. */
+    private final Path cacheDirectory;
+    /** The classpath appender to preload dependencies into */
+    private final ClassPathAppender classPathAppender;
+    /** A map of dependencies which have already been loaded. */
+    private final EnumMap<Dependency, Path> loaded = new EnumMap<>(Dependency.class);
+    /** A map of isolated classloaders which have been created. */
+    private final Map<ImmutableSet<Dependency>, IsolatedClassLoader> loaders = new HashMap<>();
+    /** Cached relocation handler instance. */
+    private @MonotonicNonNull RelocationHandler relocationHandler = null;
+
+    public DependencyManagerImpl(CustomNameplatesPluginImpl plugin, ClassPathAppender classPathAppender) {
+        this.registry = new DependencyRegistry();
+        this.cacheDirectory = setupCacheDirectory(plugin);
+        this.classPathAppender = classPathAppender;
+    }
+
+    private synchronized RelocationHandler getRelocationHandler() {
+        if (this.relocationHandler == null) {
+            this.relocationHandler = new RelocationHandler(this);
+        }
+        return this.relocationHandler;
+    }
+
+    @Override
+    public ClassLoader obtainClassLoaderWith(Set<Dependency> dependencies) {
+        ImmutableSet<Dependency> set = ImmutableSet.copyOf(dependencies);
+
+        for (Dependency dependency : dependencies) {
+            if (!this.loaded.containsKey(dependency)) {
+                throw new IllegalStateException("Dependency " + dependency + " is not loaded.");
+            }
+        }
+
+        synchronized (this.loaders) {
+            IsolatedClassLoader classLoader = this.loaders.get(set);
+            if (classLoader != null) {
+                return classLoader;
+            }
+
+            URL[] urls = set.stream()
+                    .map(this.loaded::get)
+                    .map(file -> {
+                        try {
+                            return file.toUri().toURL();
+                        } catch (MalformedURLException e) {
+                            throw new RuntimeException(e);
+                        }
+                    })
+                    .toArray(URL[]::new);
+
+            classLoader = new IsolatedClassLoader(urls);
+            this.loaders.put(set, classLoader);
+            return classLoader;
+        }
+    }
+
+    @Override
+    public void loadDependencies(Collection<Dependency> dependencies) {
+        CountDownLatch latch = new CountDownLatch(dependencies.size());
+
+        for (Dependency dependency : dependencies) {
+            if (this.loaded.containsKey(dependency)) {
+                latch.countDown();
+                continue;
+            }
+
+            try {
+                loadDependency(dependency);
+            } catch (Throwable e) {
+                new RuntimeException("Unable to load dependency " + dependency.name(), e).printStackTrace();
+            } finally {
+                latch.countDown();
+            }
+        }
+
+        try {
+            latch.await();
+        } catch (InterruptedException e) {
+            Thread.currentThread().interrupt();
+        }
+    }
+
+    private void loadDependency(Dependency dependency) throws Exception {
+        if (this.loaded.containsKey(dependency)) {
+            return;
+        }
+
+        Path file = remapDependency(dependency, downloadDependency(dependency));
+
+        this.loaded.put(dependency, file);
+
+        if (this.classPathAppender != null && this.registry.shouldAutoLoad(dependency)) {
+            this.classPathAppender.addJarToClasspath(file);
+        }
+    }
+
+    private Path downloadDependency(Dependency dependency) throws DependencyDownloadException {
+        Path file = this.cacheDirectory.resolve(dependency.getFileName(null));
+
+        // if the file already exists, don't attempt to re-download it.
+        if (Files.exists(file)) {
+            return file;
+        }
+
+        DependencyDownloadException lastError = null;
+
+        String forceRepo = dependency.getRepo();
+        if (forceRepo == null) {
+            // attempt to download the dependency from each repo in order.
+            for (DependencyRepository repo : DependencyRepository.values()) {
+                if (repo.getId().equals("maven") && TimeZone.getDefault().getID().startsWith("Asia")) {
+                    continue;
+                }
+                try {
+                    repo.download(dependency, file);
+                    return file;
+                } catch (DependencyDownloadException e) {
+                    lastError = e;
+                }
+            }
+        } else {
+            DependencyRepository repository = DependencyRepository.getByID(forceRepo);
+            if (repository != null) {
+                try {
+                    repository.download(dependency, file);
+                    return file;
+                } catch (DependencyDownloadException e) {
+                    lastError = e;
+                }
+            }
+        }
+        throw Objects.requireNonNull(lastError);
+    }
+
+    private Path remapDependency(Dependency dependency, Path normalFile) throws Exception {
+        List<Relocation> rules = new ArrayList<>(dependency.getRelocations());
+        if (rules.isEmpty()) {
+            return normalFile;
+        }
+
+        Path remappedFile = this.cacheDirectory.resolve(dependency.getFileName(DependencyRegistry.isGsonRelocated() ? "remapped-legacy" : "remapped"));
+
+        // if the remapped source exists already, just use that.
+        if (Files.exists(remappedFile)) {
+            return remappedFile;
+        }
+
+        getRelocationHandler().remap(normalFile, remappedFile, rules);
+        return remappedFile;
+    }
+
+    private static Path setupCacheDirectory(CustomNameplatesPluginImpl plugin) {
+        File folder = new File(plugin.getDataFolder(), "libs");
+        folder.mkdirs();
+        return folder.toPath();
+    }
+
+    @Override
+    public void close() {
+        IOException firstEx = null;
+
+        for (IsolatedClassLoader loader : this.loaders.values()) {
+            try {
+                loader.close();
+            } catch (IOException ex) {
+                if (firstEx == null) {
+                    firstEx = ex;
+                } else {
+                    firstEx.addSuppressed(ex);
+                }
+            }
+        }
+
+        if (firstEx != null) {
+            firstEx.printStackTrace();
+        }
+    }
+
+}

paper/src/main/java/net/momirealms/customnameplates/paper/libraries/dependencies/DependencyRegistry.java

@@ -0,0 +1,62 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.momirealms.customnameplates.paper.libraries.dependencies;
+
+import com.google.gson.JsonElement;
+
+/**
+ * Applies LuckPerms specific behaviour for {@link Dependency}s.
+ */
+public class DependencyRegistry {
+
+    public boolean shouldAutoLoad(Dependency dependency) {
+        return switch (dependency) {
+            // all used within 'isolated' classloaders, and are therefore not
+            // relocated.
+            case ASM, ASM_COMMONS, JAR_RELOCATOR, H2_DRIVER, SQLITE_DRIVER -> false;
+            default -> true;
+        };
+    }
+
+    @SuppressWarnings("ConstantConditions")
+    public static boolean isGsonRelocated() {
+        return JsonElement.class.getName().startsWith("net.momirealms");
+    }
+
+    private static boolean classExists(String className) {
+        try {
+            Class.forName(className);
+            return true;
+        } catch (ClassNotFoundException e) {
+            return false;
+        }
+    }
+
+    private static boolean slf4jPresent() {
+        return classExists("org.slf4j.Logger") && classExists("org.slf4j.LoggerFactory");
+    }
+
+}

paper/src/main/java/net/momirealms/customnameplates/paper/libraries/dependencies/DependencyRepository.java

@@ -0,0 +1,145 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.momirealms.customnameplates.paper.libraries.dependencies;
+
+import com.google.common.io.ByteStreams;
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.net.URL;
+import java.net.URLConnection;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * Represents a repository which contains {@link Dependency}s.
+ */
+public enum DependencyRepository {
+
+    MAVEN_CENTRAL("maven", "https://repo1.maven.org/maven2/") {
+        @Override
+        protected URLConnection openConnection(Dependency dependency) throws IOException {
+            URLConnection connection = super.openConnection(dependency);
+            connection.setConnectTimeout((int) TimeUnit.SECONDS.toMillis(5));
+            connection.setReadTimeout((int) TimeUnit.SECONDS.toMillis(5));
+            return connection;
+        }
+    },
+
+    /**
+     * Maven Central
+     */
+    MAVEN_CENTRAL_MIRROR("aliyun", "https://maven.aliyun.com/repository/public/"),
+    /**
+     * Code MC
+     */
+    CODE_MC("codemc", "https://repo.codemc.io/repository/maven-public/"),
+    /**
+     * Jitpack
+     */
+    JITPACK("jitpack", "https://jitpack.io/");
+
+    private final String url;
+    private final String id;
+
+    DependencyRepository(String id, String url) {
+        this.url = url;
+        this.id = id;
+    }
+
+    public static DependencyRepository getByID(String id) {
+        for (DependencyRepository repository : values()) {
+            if (id.equals(repository.id)) {
+                return repository;
+            }
+        }
+        return null;
+    }
+
+    /**
+     * Opens a connection to the given {@code dependency}.
+     *
+     * @param dependency the dependency to download
+     * @return the connection
+     * @throws IOException if unable to open a connection
+     */
+    protected URLConnection openConnection(Dependency dependency) throws IOException {
+        URL dependencyUrl = new URL(this.url + dependency.getMavenRepoPath());
+        return dependencyUrl.openConnection();
+    }
+
+    /**
+     * Downloads the raw bytes of the {@code dependency}.
+     *
+     * @param dependency the dependency to download
+     * @return the downloaded bytes
+     * @throws DependencyDownloadException if unable to download
+     */
+    public byte[] downloadRaw(Dependency dependency) throws DependencyDownloadException {
+        try {
+            URLConnection connection = openConnection(dependency);
+            try (InputStream in = connection.getInputStream()) {
+                byte[] bytes = ByteStreams.toByteArray(in);
+                if (bytes.length == 0) {
+                    throw new DependencyDownloadException("Empty stream");
+                }
+                return bytes;
+            }
+        } catch (Exception e) {
+            throw new DependencyDownloadException(e);
+        }
+    }
+
+    /**
+     * @param dependency the dependency to download
+     * @return the downloaded bytes
+     * @throws DependencyDownloadException if unable to download
+     */
+    public byte[] download(Dependency dependency) throws DependencyDownloadException {
+        return downloadRaw(dependency);
+    }
+
+    /**
+     * Downloads the the {@code dependency} to the {@code file}, ensuring the
+     * downloaded bytes match the checksum.
+     *
+     * @param dependency the dependency to download
+     * @param file the file to write to
+     * @throws DependencyDownloadException if unable to download
+     */
+    public void download(Dependency dependency, Path file) throws DependencyDownloadException {
+        try {
+            Files.write(file, download(dependency));
+        } catch (IOException e) {
+            throw new DependencyDownloadException(e);
+        }
+    }
+
+    public String getId() {
+        return id;
+    }
+}

paper/src/main/java/net/momirealms/customnameplates/paper/libraries/dependencies/classloader/IsolatedClassLoader.java

@@ -0,0 +1,54 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.momirealms.customnameplates.paper.libraries.dependencies.classloader;
+
+import java.net.URL;
+import java.net.URLClassLoader;
+
+/**
+ * A classloader "isolated" from the rest of the Minecraft server.
+ *
+ * <p>Used to load specific LuckPerms dependencies without causing conflicts
+ * with other plugins, or libraries provided by the server implementation.</p>
+ */
+public class IsolatedClassLoader extends URLClassLoader {
+    static {
+        ClassLoader.registerAsParallelCapable();
+    }
+
+    public IsolatedClassLoader(URL[] urls) {
+        /*
+         * ClassLoader#getSystemClassLoader returns the AppClassLoader
+         *
+         * Calling #getParent on this returns the ExtClassLoader (Java 8) or
+         * the PlatformClassLoader (Java 9). Since we want this classloader to
+         * be isolated from the Minecraft server (the app), we set the parent
+         * to be the platform class loader.
+         */
+        super(urls, ClassLoader.getSystemClassLoader().getParent());
+    }
+
+}

paper/src/main/java/net/momirealms/customnameplates/paper/libraries/dependencies/relocation/Relocation.java

@@ -0,0 +1,66 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.momirealms.customnameplates.paper.libraries.dependencies.relocation;
+
+import java.util.Objects;
+
+public final class Relocation {
+    private static final String RELOCATION_PREFIX = "net.momirealms.customnameplates.libraries.";
+
+    public static Relocation of(String id, String pattern) {
+        return new Relocation(pattern.replace("{}", "."), RELOCATION_PREFIX + id);
+    }
+
+    private final String pattern;
+    private final String relocatedPattern;
+
+    private Relocation(String pattern, String relocatedPattern) {
+        this.pattern = pattern;
+        this.relocatedPattern = relocatedPattern;
+    }
+
+    public String getPattern() {
+        return this.pattern;
+    }
+
+    public String getRelocatedPattern() {
+        return this.relocatedPattern;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (o == null || getClass() != o.getClass()) return false;
+        Relocation that = (Relocation) o;
+        return Objects.equals(this.pattern, that.pattern) &&
+                Objects.equals(this.relocatedPattern, that.relocatedPattern);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.pattern, this.relocatedPattern);
+    }
+}

paper/src/main/java/net/momirealms/customnameplates/paper/libraries/dependencies/relocation/RelocationHandler.java

@@ -0,0 +1,91 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.momirealms.customnameplates.paper.libraries.dependencies.relocation;
+
+import net.momirealms.customnameplates.paper.libraries.dependencies.Dependency;
+import net.momirealms.customnameplates.paper.libraries.dependencies.DependencyManager;
+import net.momirealms.customnameplates.paper.libraries.dependencies.classloader.IsolatedClassLoader;
+
+import java.io.File;
+import java.io.IOException;
+import java.lang.reflect.Constructor;
+import java.lang.reflect.Method;
+import java.nio.file.Path;
+import java.util.*;
+
+/**
+ * Handles class runtime relocation of packages in downloaded dependencies
+ */
+public class RelocationHandler {
+    public static final Set<Dependency> DEPENDENCIES = EnumSet.of(Dependency.ASM, Dependency.ASM_COMMONS, Dependency.JAR_RELOCATOR);
+    private static final String JAR_RELOCATOR_CLASS = "me.lucko.jarrelocator.JarRelocator";
+    private static final String JAR_RELOCATOR_RUN_METHOD = "run";
+
+    private final Constructor<?> jarRelocatorConstructor;
+    private final Method jarRelocatorRunMethod;
+
+    public RelocationHandler(DependencyManager dependencyManager) {
+        ClassLoader classLoader = null;
+        try {
+            // download the required dependencies for remapping
+            dependencyManager.loadDependencies(DEPENDENCIES);
+            // get a classloader containing the required dependencies as sources
+            classLoader = dependencyManager.obtainClassLoaderWith(DEPENDENCIES);
+
+            // load the relocator class
+            Class<?> jarRelocatorClass = classLoader.loadClass(JAR_RELOCATOR_CLASS);
+
+            // prepare the the reflected constructor & method instances
+            this.jarRelocatorConstructor = jarRelocatorClass.getDeclaredConstructor(File.class, File.class, Map.class);
+            this.jarRelocatorConstructor.setAccessible(true);
+
+            this.jarRelocatorRunMethod = jarRelocatorClass.getDeclaredMethod(JAR_RELOCATOR_RUN_METHOD);
+            this.jarRelocatorRunMethod.setAccessible(true);
+        } catch (Exception e) {
+            try {
+                if (classLoader instanceof IsolatedClassLoader) {
+                    ((IsolatedClassLoader) classLoader).close();
+                }
+            } catch (IOException ex) {
+                e.addSuppressed(ex);
+            }
+
+            throw new RuntimeException(e);
+        }
+    }
+
+    public void remap(Path input, Path output, List<Relocation> relocations) throws Exception {
+        Map<String, String> mappings = new HashMap<>();
+        for (Relocation relocation : relocations) {
+            mappings.put(relocation.getPattern(), relocation.getRelocatedPattern());
+        }
+
+        // create and invoke a new relocator
+        Object relocator = this.jarRelocatorConstructor.newInstance(input.toFile(), output.toFile(), mappings);
+        this.jarRelocatorRunMethod.invoke(relocator);
+    }
+
+}

paper/src/main/java/net/momirealms/customnameplates/paper/libraries/dependencies/relocation/RelocationHelper.java

@@ -0,0 +1,37 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.momirealms.customnameplates.paper.libraries.dependencies.relocation;
+
+public final class RelocationHelper {
+
+    // screw maven shade
+    public static final String OKIO_STRING = String.valueOf(new char[]{'o', 'k', 'i', 'o'});
+    public static final String OKHTTP3_STRING = String.valueOf(new char[]{'o', 'k', 'h', 't', 't', 'p', '3'});
+
+    private RelocationHelper() {
+
+    }
+}

paper/src/main/java/net/momirealms/customnameplates/paper/libraries/loader/JarInJarClassLoader.java

@@ -0,0 +1,155 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.momirealms.customnameplates.paper.libraries.loader;
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.lang.reflect.Constructor;
+import java.net.MalformedURLException;
+import java.net.URL;
+import java.net.URLClassLoader;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import java.nio.file.StandardCopyOption;
+
+/**
+ * Classloader that can load a jar from within another jar file.
+ *
+ * <p>The "loader" jar contains the loading code & public API classes,
+ * and is class-loaded by the platform.</p>
+ *
+ * <p>The inner "plugin" jar contains the plugin itself, and is class-loaded
+ * by the loading code & this classloader.</p>
+ */
+public class JarInJarClassLoader extends URLClassLoader {
+    static {
+        ClassLoader.registerAsParallelCapable();
+    }
+
+    /**
+     * Creates a new jar-in-jar class loader.
+     *
+     * @param loaderClassLoader the loader plugin's classloader (setup and created by the platform)
+     * @param jarResourcePath the path to the jar-in-jar resource within the loader jar
+     * @throws LoadingException if something unexpectedly bad happens
+     */
+    public JarInJarClassLoader(ClassLoader loaderClassLoader, String jarResourcePath) throws LoadingException {
+        super(new URL[]{extractJar(loaderClassLoader, jarResourcePath)}, loaderClassLoader);
+    }
+
+    public void addJarToClasspath(URL url) {
+        addURL(url);
+    }
+
+    public void deleteJarResource() {
+        URL[] urls = getURLs();
+        if (urls.length == 0) {
+            return;
+        }
+
+        try {
+            Path path = Paths.get(urls[0].toURI());
+            Files.deleteIfExists(path);
+        } catch (Exception e) {
+            // ignore
+        }
+    }
+
+    /**
+     * Creates a new plugin instance.
+     *
+     * @param bootstrapClass the name of the bootstrap plugin class
+     * @param loaderPluginType the type of the loader plugin, the only parameter of the bootstrap
+     *                         plugin constructor
+     * @param loaderPlugin the loader plugin instance
+     * @param <T> the type of the loader plugin
+     * @return the instantiated bootstrap plugin
+     */
+    public <T> LoaderBootstrap instantiatePlugin(String bootstrapClass, Class<T> loaderPluginType, T loaderPlugin) throws LoadingException {
+        Class<? extends LoaderBootstrap> plugin;
+        try {
+            plugin = loadClass(bootstrapClass).asSubclass(LoaderBootstrap.class);
+        } catch (ReflectiveOperationException e) {
+            throw new LoadingException("Unable to load bootstrap class", e);
+        }
+
+        Constructor<? extends LoaderBootstrap> constructor;
+        try {
+            constructor = plugin.getConstructor(loaderPluginType);
+        } catch (ReflectiveOperationException e) {
+            throw new LoadingException("Unable to get bootstrap constructor", e);
+        }
+
+        try {
+            return constructor.newInstance(loaderPlugin);
+        } catch (ReflectiveOperationException e) {
+            throw new LoadingException("Unable to create bootstrap plugin instance", e);
+        }
+    }
+
+    /**
+     * Extracts the "jar-in-jar" from the loader plugin into a temporary file,
+     * then returns a URL that can be used by the {@link JarInJarClassLoader}.
+     *
+     * @param loaderClassLoader the classloader for the "host" loader plugin
+     * @param jarResourcePath the inner jar resource path
+     * @return a URL to the extracted file
+     */
+    private static URL extractJar(ClassLoader loaderClassLoader, String jarResourcePath) throws LoadingException {
+        // get the jar-in-jar resource
+        URL jarInJar = loaderClassLoader.getResource(jarResourcePath);
+        if (jarInJar == null) {
+            throw new LoadingException("Could not locate jar-in-jar");
+        }
+
+        // create a temporary file
+        // on posix systems by default this is only read/writable by the process owner
+        Path path;
+        try {
+            path = Files.createTempFile("customnameplates-jarinjar", ".jar.tmp");
+        } catch (IOException e) {
+            throw new LoadingException("Unable to create a temporary file", e);
+        }
+
+        // mark that the file should be deleted on exit
+        path.toFile().deleteOnExit();
+
+        // copy the jar-in-jar to the temporary file path
+        try (InputStream in = jarInJar.openStream()) {
+            Files.copy(in, path, StandardCopyOption.REPLACE_EXISTING);
+        } catch (IOException e) {
+            throw new LoadingException("Unable to copy jar-in-jar to temporary path", e);
+        }
+
+        try {
+            return path.toUri().toURL();
+        } catch (MalformedURLException e) {
+            throw new LoadingException("Unable to get URL from path", e);
+        }
+    }
+
+}

paper/src/main/java/net/momirealms/customnameplates/paper/libraries/loader/LoaderBootstrap.java

@@ -1,5 +1,5 @@
 /*
- * This file is part of helper, licensed under the MIT License.
+ * This file is part of LuckPerms, licensed under the MIT License.
  *
  *  Copyright (c) lucko (Luck) <luck@lucko.me>
  *  Copyright (c) contributors
@@ -23,23 +23,17 @@
  *  SOFTWARE.
  */
 
-package net.momirealms.customnameplates.paper.helper;
-
-import java.lang.annotation.*;
+package net.momirealms.customnameplates.paper.libraries.loader;
 
 /**
- * Represents a maven repository.
+ * Minimal bootstrap plugin, called by the loader plugin.
  */
-@Documented
-@Target(ElementType.LOCAL_VARIABLE)
-@Retention(RetentionPolicy.RUNTIME)
-public @interface Repository {
+public interface LoaderBootstrap {
 
-    /**
-     * Gets the base url of the repository.
-     *
-     * @return the base url of the repository
-     */
-    String url();
+    void onLoad();
+
+    default void onEnable() {}
+
+    default void onDisable() {}
 
 }

paper/src/main/java/net/momirealms/customnameplates/paper/libraries/loader/LoadingException.java

@@ -0,0 +1,41 @@
+/*
+ * This file is part of LuckPerms, licensed under the MIT License.
+ *
+ *  Copyright (c) lucko (Luck) <luck@lucko.me>
+ *  Copyright (c) contributors
+ *
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ */
+
+package net.momirealms.customnameplates.paper.libraries.loader;
+
+/**
+ * Runtime exception used if there is a problem during loading
+ */
+public class LoadingException extends RuntimeException {
+
+    public LoadingException(String message) {
+        super(message);
+    }
+
+    public LoadingException(String message, Throwable cause) {
+        super(message, cause);
+    }
+
+}

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/actionbar/ActionBarManagerImpl.java

@@ -24,6 +24,7 @@ import com.comphenix.protocol.wrappers.EnumWrappers;
 import com.comphenix.protocol.wrappers.WrappedChatComponent;
 import net.kyori.adventure.text.Component;
 import net.kyori.adventure.text.TranslatableComponent;
+import net.kyori.adventure.text.minimessage.MiniMessage;
 import net.kyori.adventure.text.serializer.gson.GsonComponentSerializer;
 import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
 import net.momirealms.customnameplates.api.manager.ActionBarManager;
@@ -35,6 +36,7 @@ import net.momirealms.customnameplates.paper.mechanic.actionbar.listener.SystemC
 import net.momirealms.customnameplates.paper.mechanic.misc.DisplayController;
 import net.momirealms.customnameplates.paper.setting.CNConfig;
 import net.momirealms.customnameplates.paper.util.ConfigUtils;
+import net.momirealms.customnameplates.paper.util.ReflectionUtils;
 import org.bukkit.Bukkit;
 import org.bukkit.configuration.ConfigurationSection;
 import org.bukkit.configuration.file.YamlConfiguration;
@@ -60,11 +62,15 @@ public class ActionBarManagerImpl implements ActionBarManager, Listener {
     private ActionBarConfig config;
     private ChatMessageListener chatMessageListener;
     private SystemChatListener systemChatListener;
+    private final MiniMessage miniMessage;
 
     public ActionBarManagerImpl(CustomNameplatesPlugin plugin) {
         this.receiverMap = new ConcurrentHashMap<>();
         this.plugin = plugin;
         this.actionBarListener = new ActionBarListener(this);
+        this.miniMessage = MiniMessage.builder()
+                .strict(true)
+                .build();
         if (plugin.getVersionManager().isVersionNewerThan1_19()) {
             this.systemChatListener = new SystemChatListener(this);
         } else {
@@ -176,13 +182,23 @@ public class ActionBarManagerImpl implements ActionBarManager, Listener {
             if (receiver != null) {
                 event.setCancelled(true);
                 String json = packet.getStrings().readSafely(0);
-                if (json != null && !json.equals("")) {
+                if (json != null && !json.isEmpty()) {
                     Component component = GsonComponentSerializer.gson().deserialize(json);
                     if (component instanceof TranslatableComponent) {
                         // We can't get TranslatableComponent's width :(
                         return;
                     }
-                    receiver.setOtherPluginText(AdventureManagerImpl.getInstance().getMiniMessageFormat(component), System.currentTimeMillis());
+                    receiver.setOtherPluginText(miniMessage.serialize(component), System.currentTimeMillis());
+                } else {
+                    WrappedChatComponent wrappedChatComponent = packet.getChatComponents().readSafely(0);
+                    if (wrappedChatComponent != null) {
+                        json = wrappedChatComponent.getJson();
+                        Component component = GsonComponentSerializer.gson().deserialize(json);
+                        if (component instanceof TranslatableComponent) {
+                            return;
+                        }
+                        receiver.setOtherPluginText(miniMessage.serialize(component), System.currentTimeMillis());
+                    }
                 }
             }
         }
@@ -204,7 +220,7 @@ public class ActionBarManagerImpl implements ActionBarManager, Listener {
                         // We can't get TranslatableComponent's width :(
                         return;
                     }
-                    receiver.setOtherPluginText(AdventureManagerImpl.getInstance().getMiniMessageFormat(component), System.currentTimeMillis());
+                    receiver.setOtherPluginText(miniMessage.serialize(component), System.currentTimeMillis());
                 }
             }
         }
@@ -212,10 +228,10 @@ public class ActionBarManagerImpl implements ActionBarManager, Listener {
 
     public void onReceiveActionBarPacket(PacketEvent event) {
         PacketContainer packet = event.getPacket();
-        WrappedChatComponent wrappedChatComponent = packet.getChatComponents().read(0);
-        if (wrappedChatComponent != null) {
-            ActionBarReceiver receiver = getReceiver(event.getPlayer().getUniqueId());
-            if (receiver != null) {
+        ActionBarReceiver receiver = getReceiver(event.getPlayer().getUniqueId());
+        if (receiver != null) {
+            WrappedChatComponent wrappedChatComponent = packet.getChatComponents().read(0);
+            if (wrappedChatComponent != null) {
                 String strJson = wrappedChatComponent.getJson();
                 // for better performance
                 if (strJson.contains("\"name\":\"np\",\"objective\":\"ab\"")) {
@@ -223,10 +239,14 @@ public class ActionBarManagerImpl implements ActionBarManager, Listener {
                 }
                 event.setCancelled(true);
                 receiver.setOtherPluginText(
-                        AdventureManagerImpl.getInstance().getMiniMessageFormat(
-                                GsonComponentSerializer.gson().deserialize(strJson)
-                        ), System.currentTimeMillis()
+                        miniMessage.serialize(GsonComponentSerializer.gson().deserialize(strJson)), System.currentTimeMillis()
                 );
+            } else if (ReflectionUtils.isPaper()) {
+                Object adventureComponent = packet.getModifier().readSafely(1);
+                if (adventureComponent != null) {
+                    String other = ReflectionUtils.getMiniMessageTextFromNonShadedComponent(adventureComponent);
+                    receiver.setOtherPluginText(other, System.currentTimeMillis());
+                }
             }
         }
     }

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/actionbar/ActionBarReceiver.java

@@ -62,7 +62,7 @@ public class ActionBarReceiver {
             }
             case UPDATE -> {
                 if (controller.isShown()) {
-                    controller.initialize();
+                    controller.initialize(condition);
                     AdventureManagerImpl.getInstance().sendActionbar(player, controller.getLatestContent());
                 } else {
                     AdventureManagerImpl.getInstance().sendActionbar(player, "");

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/bossbar/BossBarReceiver.java

@@ -98,7 +98,7 @@ public class BossBarReceiver {
                             if (this.bossBars[j].left().isShown())
                                 this.bossBars[j].right().hide();
 
-                        controller.initialize();
+                        controller.initialize(condition);
                         pair.right().setMiniMessageText(pair.left().getLatestContent());
                         pair.right().show();
 

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/bubble/BubbleManagerImpl.java

@@ -19,16 +19,22 @@ package net.momirealms.customnameplates.paper.mechanic.bubble;
 
 import me.clip.placeholderapi.PlaceholderAPI;
 import net.kyori.adventure.text.minimessage.MiniMessage;
+import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
 import net.momirealms.customnameplates.api.data.OnlineUser;
 import net.momirealms.customnameplates.api.event.BubblesSpawnEvent;
 import net.momirealms.customnameplates.api.event.NameplateDataLoadEvent;
 import net.momirealms.customnameplates.api.manager.BubbleManager;
+import net.momirealms.customnameplates.api.manager.RequirementManager;
 import net.momirealms.customnameplates.api.mechanic.bubble.Bubble;
+import net.momirealms.customnameplates.api.mechanic.bubble.ChannelMode;
+import net.momirealms.customnameplates.api.mechanic.bubble.provider.AbstractChatProvider;
 import net.momirealms.customnameplates.api.mechanic.character.CharacterArranger;
 import net.momirealms.customnameplates.api.mechanic.character.ConfiguredChar;
-import net.momirealms.customnameplates.api.mechanic.tag.unlimited.EntityTagPlayer;
+import net.momirealms.customnameplates.api.mechanic.tag.unlimited.EntityTagEntity;
 import net.momirealms.customnameplates.api.mechanic.tag.unlimited.StaticTextEntity;
 import net.momirealms.customnameplates.api.mechanic.tag.unlimited.StaticTextTagSetting;
+import net.momirealms.customnameplates.api.requirement.Condition;
+import net.momirealms.customnameplates.api.requirement.Requirement;
 import net.momirealms.customnameplates.api.util.FontUtils;
 import net.momirealms.customnameplates.api.util.LogUtils;
 import net.momirealms.customnameplates.paper.CustomNameplatesPluginImpl;
@@ -36,29 +42,28 @@ import net.momirealms.customnameplates.paper.adventure.AdventureManagerImpl;
 import net.momirealms.customnameplates.paper.mechanic.bubble.image.ImageParser;
 import net.momirealms.customnameplates.paper.mechanic.bubble.image.ItemsAdderImageImpl;
 import net.momirealms.customnameplates.paper.mechanic.bubble.image.OraxenImageImpl;
-import net.momirealms.customnameplates.paper.mechanic.bubble.listener.AbstractChatListener;
-import net.momirealms.customnameplates.paper.mechanic.bubble.listener.AsyncChatListener;
-import net.momirealms.customnameplates.paper.mechanic.bubble.listener.TrChatListener;
-import net.momirealms.customnameplates.paper.mechanic.bubble.listener.VentureChatListener;
+import net.momirealms.customnameplates.paper.mechanic.bubble.provider.*;
 import net.momirealms.customnameplates.paper.setting.CNConfig;
 import org.bukkit.Bukkit;
-import org.bukkit.GameMode;
+import org.bukkit.configuration.ConfigurationSection;
 import org.bukkit.configuration.file.YamlConfiguration;
 import org.bukkit.entity.Player;
 import org.bukkit.event.EventHandler;
 import org.bukkit.event.EventPriority;
 import org.bukkit.event.HandlerList;
+import org.bukkit.event.Listener;
 import org.bukkit.plugin.PluginManager;
-import org.bukkit.potion.PotionEffectType;
 import org.jetbrains.annotations.Nullable;
 
 import java.io.File;
+import java.io.IOException;
 import java.util.*;
 import java.util.concurrent.TimeUnit;
 
-public class BubbleManagerImpl implements BubbleManager {
+public class BubbleManagerImpl implements BubbleManager, Listener {
 
-    private AbstractChatListener chatListener;
+    private AbstractChatProvider chatProvider;
+    private AbstractChatProvider customProvider;
     private ImageParser imageParser;
     private final HashMap<String, Bubble> bubbleMap;
     private final CustomNameplatesPluginImpl plugin;
@@ -75,6 +80,8 @@ public class BubbleManagerImpl implements BubbleManager {
     private int lengthPerLine;
     private int subStringIndex;
     private String[] blacklistChannels;
+    private ChannelMode channelMode;
+    private Requirement[] requirements;
 
     public BubbleManagerImpl(CustomNameplatesPluginImpl plugin) {
         this.plugin = plugin;
@@ -90,18 +97,21 @@ public class BubbleManagerImpl implements BubbleManager {
         if (!CNConfig.bubbleModule) return;
         this.loadConfig();
         this.loadBubbles();
-        this.registerListener();
+        this.registerChatProvider();
         this.registerImageParser();
+        Bukkit.getPluginManager().registerEvents(this, plugin);
     }
 
     public void unload() {
         this.imageParser = null;
         this.bubbleMap.clear();
-        if (chatListener != null) HandlerList.unregisterAll(chatListener);
+        if (chatProvider != null) chatProvider.unregister();
+        HandlerList.unregisterAll(this);
     }
 
     private void loadConfig() {
         YamlConfiguration config = plugin.getConfig("configs"  + File.separator + "bubble.yml");
+        updateConfigFile(config);
         defaultBubble = config.getString("default-bubbles", "chat");
         prefix = config.getString("text-prefix", "");
         suffix = config.getString("text-suffix", "");
@@ -115,6 +125,23 @@ public class BubbleManagerImpl implements BubbleManager {
         lengthPerLine = config.getInt("characters-per-line", 30);
         startFormat = config.getString("default-format.start", "<gradient:#F5F5F5:#E1FFFF:#F5F5F5><u>");
         endFormat = config.getString("default-format.end", "<!u></gradient>");
+        channelMode = ChannelMode.valueOf(config.getString("channel-mode","all").toUpperCase(Locale.ENGLISH));
+        requirements = plugin.getRequirementManager().getRequirements(config.getConfigurationSection("requirements"));
+    }
+
+    private void updateConfigFile(YamlConfiguration config) {
+        try {
+            if (!config.contains("requirements")) {
+                ConfigurationSection section = config.createSection("requirements");
+                section.set("!gamemode", "spectator");
+                section.set("permission", "bubbles.use");
+                section.set("self-disguised", false);
+                section.set("potion-effect", "INVISIBILITY<0");
+                config.save(new File(plugin.getDataFolder(), "configs"  + File.separator + "bubble.yml"));
+            }
+        } catch (IOException e) {
+            e.printStackTrace();
+        }
     }
 
     private void registerImageParser() {
@@ -126,16 +153,47 @@ public class BubbleManagerImpl implements BubbleManager {
         }
     }
 
-    private void registerListener() {
-        PluginManager pluginManager = Bukkit.getPluginManager();
-        if (CNConfig.trChatChannel) {
-            this.chatListener = new TrChatListener(this);
+    private void registerChatProvider() {
+        if (this.customProvider != null) {
+            this.chatProvider = customProvider;
+        } else if (CNConfig.trChatChannel) {
+            this.chatProvider = new TrChatProvider(this);
         } else if (CNConfig.ventureChatChannel) {
-            this.chatListener = new VentureChatListener(this);
+            this.chatProvider = new VentureChatProvider(this);
+        } else if (CNConfig.huskChatChannel) {
+            this.chatProvider = new HuskChatProvider(this);
+        } else if (CNConfig.carbonChatChannel) {
+            this.chatProvider = new CarbonChatProvider(this);
         } else {
-            this.chatListener = new AsyncChatListener(this);
+            try {
+                Class.forName("io.papermc.paper.event.player.AsyncChatEvent");
+                this.chatProvider = new PaperAsyncChatProvider(this);
+            } catch (ClassNotFoundException e) {
+                this.chatProvider = new AsyncChatProvider(this);
+            }
         }
-        pluginManager.registerEvents(chatListener, plugin);
+        this.chatProvider.register();
+    }
+
+    @Override
+    public boolean setCustomChatProvider(AbstractChatProvider provider) {
+        if (this.customProvider != null)
+            return false;
+        this.customProvider = provider;
+        if (chatProvider != null) chatProvider.unregister();
+        this.registerChatProvider();
+        return true;
+    }
+
+    @Override
+    public boolean removeCustomChatProvider() {
+        if (this.customProvider != null) {
+            this.customProvider.unregister();
+            this.customProvider = null;
+            this.registerChatProvider();
+            return true;
+        }
+        return false;
     }
 
     private void loadBubbles() {
@@ -208,11 +266,22 @@ public class BubbleManagerImpl implements BubbleManager {
         return this.bubbleMap.remove(key) != null;
     }
 
+    @Override
     public void onChat(Player player, String text) {
-        if (        player.getGameMode() == GameMode.SPECTATOR
-                || player.hasPotionEffect(PotionEffectType.INVISIBILITY)
-                || !player.hasPermission("bubbles.use")
-        ) return;
+        onChat(player, text, null);
+    }
+
+    @Override
+    public void onChat(Player player, String text, String channel) {
+        if (!RequirementManager.isRequirementMet(new Condition(player), requirements)) {
+            return;
+        }
+
+        if (Bukkit.isPrimaryThread()) {
+            String finalText = text;
+            CustomNameplatesPlugin.get().getScheduler().runTaskAsync(() -> onChat(player, finalText));
+            return;
+        }
 
         var optionalUser = plugin.getStorageManager().getOnlineUser(player.getUniqueId());
         if (optionalUser.isEmpty()) {
@@ -258,14 +327,14 @@ public class BubbleManagerImpl implements BubbleManager {
             int finalIndex = i;
             String finalBubble = bubble;
             plugin.getScheduler().runTaskAsyncLater(
-                    () -> sendBubble(player, split[finalIndex], bubbleConfig, finalBubble),
+                    () -> sendBubble(player, split[finalIndex], bubbleConfig, finalBubble, channel),
                     (long) i * 250 + 100,
                     TimeUnit.MILLISECONDS
             );
         }
     }
 
-    private void sendBubble(Player player, String text, Bubble bubbleConfig, String key) {
+    private void sendBubble(Player player, String text, Bubble bubbleConfig, String key, @Nullable String channel) {
         if (key.equals("none")) {
             text = startFormat + PlaceholderAPI.setPlaceholders(player, prefix) + text + PlaceholderAPI.setPlaceholders(player, suffix) + endFormat;
         } else {
@@ -273,26 +342,40 @@ public class BubbleManagerImpl implements BubbleManager {
             int width = FontUtils.getTextWidth(text);
             text = bubbleConfig.getPrefixWithFont(width) + text + bubbleConfig.getSuffixWithFont(width);
         }
-        EntityTagPlayer tagPlayer = plugin.getNameplateManager().getUnlimitedTagManager().createOrGetTagForPlayer(player);
-        if (tagPlayer == null)
+
+        EntityTagEntity tagEntity = plugin.getNameplateManager().getUnlimitedTagManager().createOrGetTagForEntity(player);
+        if (tagEntity == null)
             return;
 
-        StaticTextEntity entity = tagPlayer.addTag(StaticTextTagSetting.builder()
+        StaticTextEntity entity = tagEntity.addTag(StaticTextTagSetting.builder()
                 .leaveRule((p, e) -> true)
-                .comeRule((p, e) -> true)
+                .comeRule((p, e) -> {
+                    switch (channelMode) {
+                        case ALL -> {
+                            return true;
+                        }
+                        case JOINED -> {
+                            return channel == null || chatProvider.hasJoinedChannel(p, channel);
+                        }
+                        case CAN_JOIN -> {
+                            return channel == null || chatProvider.canJoinChannel(p, channel);
+                        }
+                    }
+                    return false;
+                })
                 .verticalOffset(yOffset)
                 .defaultText(text)
-                .plugin("bubble")
+                .id("bubble")
                 .build());
 
-        for (StaticTextEntity bubble : tagPlayer.getStaticTags()) {
-            if (bubble.getPlugin().equals("bubble")) {
+        for (StaticTextEntity bubble : tagEntity.getStaticTags()) {
+            if (bubble.getID().equals("bubble")) {
                 bubble.setOffset(bubble.getOffset() + lineSpace);
             }
         }
 
         plugin.getScheduler().runTaskAsyncLater(() -> {
-            tagPlayer.removeTag(entity);
+            tagEntity.removeTag(entity);
         }, stayTime, TimeUnit.SECONDS);
     }
 

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/bubble/listener/TrChatListener.java

@@ -1,43 +0,0 @@
-/*
- *  Copyright (C) <2022> <XiaoMoMi>
- *
- *  This program is free software: you can redistribute it and/or modify
- *  it under the terms of the GNU General Public License as published by
- *  the Free Software Foundation, either version 3 of the License, or
- *  any later version.
- *
- *  This program is distributed in the hope that it will be useful,
- *  but WITHOUT ANY WARRANTY; without even the implied warranty of
- *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- *  GNU General Public License for more details.
- *
- *  You should have received a copy of the GNU General Public License
- *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
- */
-
-package net.momirealms.customnameplates.paper.mechanic.bubble.listener;
-
-import me.arasple.mc.trchat.api.event.TrChatEvent;
-import me.arasple.mc.trchat.module.display.channel.Channel;
-import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
-import net.momirealms.customnameplates.paper.mechanic.bubble.BubbleManagerImpl;
-import org.bukkit.event.EventHandler;
-
-public class TrChatListener extends AbstractChatListener {
-
-    public TrChatListener(BubbleManagerImpl chatBubblesManager) {
-        super(chatBubblesManager);
-    }
-
-    @EventHandler (ignoreCancelled = true)
-    public void onTrChat(TrChatEvent event) {
-        if (!event.getForward()) return;
-        Channel channelName = event.getChannel();
-        for (String channel : chatBubblesManager.getBlacklistChannels()) {
-            if (channelName.equals(channel)) return;
-        }
-        CustomNameplatesPlugin.get().getScheduler().runTaskAsync(() -> {
-            chatBubblesManager.onChat(event.getSession().getPlayer(), event.getMessage());
-        });
-    }
-}

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/bubble/listener/VentureChatListener.java

@@ -1,46 +0,0 @@
-/*
- *  Copyright (C) <2022> <XiaoMoMi>
- *
- *  This program is free software: you can redistribute it and/or modify
- *  it under the terms of the GNU General Public License as published by
- *  the Free Software Foundation, either version 3 of the License, or
- *  any later version.
- *
- *  This program is distributed in the hope that it will be useful,
- *  but WITHOUT ANY WARRANTY; without even the implied warranty of
- *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- *  GNU General Public License for more details.
- *
- *  You should have received a copy of the GNU General Public License
- *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
- */
-
-package net.momirealms.customnameplates.paper.mechanic.bubble.listener;
-
-import mineverse.Aust1n46.chat.api.MineverseChatPlayer;
-import mineverse.Aust1n46.chat.api.events.VentureChatEvent;
-import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
-import net.momirealms.customnameplates.paper.mechanic.bubble.BubbleManagerImpl;
-import org.bukkit.event.EventHandler;
-
-public class VentureChatListener extends AbstractChatListener {
-
-    public VentureChatListener(BubbleManagerImpl chatBubblesManager) {
-        super(chatBubblesManager);
-    }
-
-    @EventHandler
-    public void onVentureChat(VentureChatEvent event) {
-        String channelName = event.getChannel().getName();
-        for (String channel : chatBubblesManager.getBlacklistChannels()) {
-            if (channelName.equals(channel)) return;
-        }
-        final MineverseChatPlayer chatPlayer = event.getMineverseChatPlayer();
-        if (chatPlayer == null) {
-            return;
-        }
-        CustomNameplatesPlugin.get().getScheduler().runTaskAsync(() -> {
-            chatBubblesManager.onChat(chatPlayer.getPlayer(), event.getChat());
-        });
-    }
-}

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/bubble/provider/AsyncChatProvider.java

@@ -0,0 +1,60 @@
+/*
+ *  Copyright (C) <2022> <XiaoMoMi>
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package net.momirealms.customnameplates.paper.mechanic.bubble.provider;
+
+import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
+import net.momirealms.customnameplates.api.manager.BubbleManager;
+import net.momirealms.customnameplates.api.mechanic.bubble.provider.AbstractChatProvider;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Player;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.HandlerList;
+import org.bukkit.event.player.AsyncPlayerChatEvent;
+
+public class AsyncChatProvider extends AbstractChatProvider {
+
+    public AsyncChatProvider(BubbleManager chatBubblesManager) {
+        super(chatBubblesManager);
+    }
+
+    @Override
+    public void register() {
+        Bukkit.getPluginManager().registerEvents(this, CustomNameplatesPlugin.get());
+    }
+
+    @Override
+    public void unregister() {
+        HandlerList.unregisterAll(this);
+    }
+
+    @Override
+    public boolean hasJoinedChannel(Player player, String channelID) {
+        return true;
+    }
+
+    @Override
+    public boolean canJoinChannel(Player player, String channelID) {
+        return true;
+    }
+
+    // This event is not async sometimes
+    @EventHandler (ignoreCancelled = true)
+    public void onChat(AsyncPlayerChatEvent event) {
+        CustomNameplatesPlugin.get().getScheduler().runTaskAsync(() -> chatBubblesManager.onChat(event.getPlayer(), event.getMessage()));
+    }
+}

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/bubble/provider/CarbonChatProvider.java

@@ -0,0 +1,147 @@
+/*
+ *  Copyright (C) <2022> <XiaoMoMi>
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package net.momirealms.customnameplates.paper.mechanic.bubble.provider;
+
+import net.draycia.carbon.api.CarbonChat;
+import net.draycia.carbon.api.channels.ChannelRegistry;
+import net.draycia.carbon.api.channels.ChatChannel;
+import net.draycia.carbon.api.event.CarbonEventSubscription;
+import net.draycia.carbon.api.event.events.CarbonChatEvent;
+import net.draycia.carbon.api.users.CarbonPlayer;
+import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
+import net.momirealms.customnameplates.api.manager.BubbleManager;
+import net.momirealms.customnameplates.api.mechanic.bubble.provider.AbstractChatProvider;
+import net.momirealms.customnameplates.api.util.LogUtils;
+import net.momirealms.customnameplates.paper.util.ReflectionUtils;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Player;
+
+import java.lang.reflect.InvocationTargetException;
+import java.lang.reflect.Method;
+
+public class CarbonChatProvider extends AbstractChatProvider {
+
+    private final CarbonChat api;
+    private CarbonEventSubscription<CarbonChatEvent> subscription;
+    private Method originalMessageMethod;
+    private Method channelKeyMethod;
+    private Method getChannelByKeyMethod;
+
+    public CarbonChatProvider(BubbleManager chatBubblesManager) {
+        super(chatBubblesManager);
+        this.api = net.draycia.carbon.api.CarbonChatProvider.carbonChat();
+        try {
+            this.originalMessageMethod = CarbonChatEvent.class.getMethod("originalMessage");
+            this.channelKeyMethod = ChatChannel.class.getMethod("key");
+            this.getChannelByKeyMethod = ChannelRegistry.class.getMethod("channel", ReflectionUtils.getKeyClass());
+        } catch (Exception e) {
+            e.printStackTrace();
+        }
+    }
+
+    @Override
+    public void register() {
+        subscription = api.eventHandler().subscribe(CarbonChatEvent.class, event -> {
+            if (event.cancelled())
+                return;
+            ChatChannel chatChannel = event.chatChannel();
+            Object key = getChannelKey(chatChannel);
+            if (key == null) return;
+            String channel = ReflectionUtils.getKeyAsString(key);
+            for (String black : chatBubblesManager.getBlacklistChannels()) {
+                if (channel.equals(black)) return;
+            }
+            Player player = Bukkit.getPlayer(event.sender().uuid());
+            if (player == null || !player.isOnline())
+                return;
+            Object component = getComponentFromEvent(event);
+            String message = ReflectionUtils.getMiniMessageTextFromNonShadedComponent(component);
+            CustomNameplatesPlugin.get().getScheduler().runTaskAsync(() -> chatBubblesManager.onChat(player, message, channel));
+        });
+    }
+
+    @Override
+    public void unregister() {
+        if (subscription != null) {
+            subscription.dispose();
+        }
+    }
+
+    @Override
+    public boolean hasJoinedChannel(Player player, String channelID) {
+        CarbonPlayer cPlayer = null;
+        for (CarbonPlayer carbonPlayer : api.server().players()) {
+            if (carbonPlayer.uuid().equals(player.getUniqueId())) {
+                cPlayer = carbonPlayer;
+                break;
+            }
+        }
+        if (cPlayer == null) {
+            return false;
+        }
+        ChatChannel selectedChannel = cPlayer.selectedChannel();
+        if (selectedChannel == null) {
+            return false;
+        }
+        Object key = getChannelKey(selectedChannel);
+        String str = ReflectionUtils.getKeyAsString(key);
+        return str.equals(channelID);
+    }
+
+    @Override
+    public boolean canJoinChannel(Player player, String channelID) {
+        ChannelRegistry registry = api.channelRegistry();
+        Object key = ReflectionUtils.getKerFromString(channelID);
+        if (key == null) {
+            return false;
+        }
+        ChatChannel channel = null;
+        try {
+            channel = (ChatChannel) getChannelByKeyMethod.invoke(registry, key);
+        } catch (IllegalAccessException | InvocationTargetException e) {
+            e.printStackTrace();
+        }
+        if (channel == null) {
+            LogUtils.warn("Channel " + channelID + " doesn't exist.");
+            return false;
+        }
+        String perm = channel.permission();
+        if (perm == null) {
+            return true;
+        }
+        return player.hasPermission(perm);
+    }
+
+    private Object getChannelKey(ChatChannel channel) {
+        try {
+            return this.channelKeyMethod.invoke(channel);
+        } catch (InvocationTargetException | IllegalAccessException e) {
+            e.printStackTrace();
+        }
+        return null;
+    }
+
+    private Object getComponentFromEvent(CarbonChatEvent event) {
+        try {
+            return this.originalMessageMethod.invoke(event);
+        } catch (InvocationTargetException | IllegalAccessException e) {
+            e.printStackTrace();
+        }
+        return ReflectionUtils.getEmptyComponent();
+    }
+}

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/bubble/provider/HuskChatProvider.java

@@ -0,0 +1,85 @@
+/*
+ *  Copyright (C) <2022> <XiaoMoMi>
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package net.momirealms.customnameplates.paper.mechanic.bubble.provider;
+
+import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
+import net.momirealms.customnameplates.api.manager.BubbleManager;
+import net.momirealms.customnameplates.api.mechanic.bubble.provider.AbstractChatProvider;
+import net.momirealms.customnameplates.api.util.LogUtils;
+import net.william278.huskchat.bukkit.BukkitHuskChat;
+import net.william278.huskchat.bukkit.event.ChatMessageEvent;
+import net.william278.huskchat.channel.Channel;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Player;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.HandlerList;
+
+public class HuskChatProvider extends AbstractChatProvider {
+
+    public HuskChatProvider(BubbleManager chatBubblesManager) {
+        super(chatBubblesManager);
+    }
+
+    @Override
+    public void register() {
+        Bukkit.getPluginManager().registerEvents(this, CustomNameplatesPlugin.get());
+    }
+
+    @Override
+    public void unregister() {
+        HandlerList.unregisterAll(this);
+    }
+
+    @Override
+    public boolean hasJoinedChannel(Player player, String channelID) {
+        String channel = BukkitHuskChat.getInstance().getPlayerCache().getPlayerChannel(player.getUniqueId());
+        if (channel == null) {
+            LogUtils.warn("Channel " + channelID + " doesn't exist.");
+            return false;
+        }
+        return channel.equals(channelID);
+    }
+
+    @Override
+    public boolean canJoinChannel(Player player, String channelID) {
+        Channel channel = BukkitHuskChat.getInstance().getSettings().getChannels().get(channelID);
+        if (channel == null) {
+            LogUtils.warn("Channel " + channelID + " doesn't exist.");
+            return false;
+        }
+        String receivePerm = channel.getReceivePermission();
+        if (receivePerm == null) {
+            return true;
+        }
+        return player.hasPermission(receivePerm);
+    }
+
+    @EventHandler (ignoreCancelled = true)
+    public void onHuskChat(ChatMessageEvent event) {
+        String channel = event.getChannelId();
+        for (String black : chatBubblesManager.getBlacklistChannels()) {
+            if (channel.equals(black)) return;
+        }
+        Player player = Bukkit.getPlayer(event.getSender().getUuid());
+        if (player == null || !player.isOnline())
+            return;
+        CustomNameplatesPlugin.get().getScheduler().runTaskAsync(() -> {
+            chatBubblesManager.onChat(player, event.getMessage(), channel);
+        });
+    }
+}

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/bubble/provider/PaperAsyncChatProvider.java

@@ -0,0 +1,81 @@
+/*
+ *  Copyright (C) <2022> <XiaoMoMi>
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package net.momirealms.customnameplates.paper.mechanic.bubble.provider;
+
+import io.papermc.paper.event.player.AsyncChatEvent;
+import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
+import net.momirealms.customnameplates.api.manager.BubbleManager;
+import net.momirealms.customnameplates.api.mechanic.bubble.provider.AbstractChatProvider;
+import net.momirealms.customnameplates.paper.util.ReflectionUtils;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Player;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.HandlerList;
+
+import java.lang.reflect.InvocationTargetException;
+import java.lang.reflect.Method;
+
+public class PaperAsyncChatProvider extends AbstractChatProvider {
+
+    private Method messageMethod;
+
+    public PaperAsyncChatProvider(BubbleManager chatBubblesManager) {
+        super(chatBubblesManager);
+        try {
+            this.messageMethod = AsyncChatEvent.class.getMethod("message");
+        } catch (Exception e) {
+            e.printStackTrace();
+        }
+    }
+
+    @Override
+    public void register() {
+        Bukkit.getPluginManager().registerEvents(this, CustomNameplatesPlugin.get());
+    }
+
+    @Override
+    public void unregister() {
+        HandlerList.unregisterAll(this);
+    }
+
+    @Override
+    public boolean hasJoinedChannel(Player player, String channelID) {
+        return true;
+    }
+
+    @Override
+    public boolean canJoinChannel(Player player, String channelID) {
+        return true;
+    }
+
+    @EventHandler (ignoreCancelled = true)
+    public void onChat(AsyncChatEvent event) {
+        Object component = getComponentFromEvent(event);
+        String message = ReflectionUtils.getMiniMessageTextFromNonShadedComponent(component);
+        CustomNameplatesPlugin.get().getScheduler().runTaskAsync(() -> chatBubblesManager.onChat(event.getPlayer(), message));
+    }
+
+    private Object getComponentFromEvent(AsyncChatEvent event) {
+        try {
+            return this.messageMethod.invoke(event);
+        } catch (InvocationTargetException | IllegalAccessException e) {
+            e.printStackTrace();
+        }
+        return ReflectionUtils.getEmptyComponent();
+    }
+}

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/bubble/provider/TrChatProvider.java

@@ -0,0 +1,87 @@
+/*
+ *  Copyright (C) <2022> <XiaoMoMi>
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package net.momirealms.customnameplates.paper.mechanic.bubble.provider;
+
+import me.arasple.mc.trchat.TrChat;
+import me.arasple.mc.trchat.api.event.TrChatEvent;
+import me.arasple.mc.trchat.module.display.channel.Channel;
+import me.arasple.mc.trchat.module.internal.filter.FilteredObject;
+import me.arasple.mc.trchat.taboolib.platform.BukkitAdapter;
+import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
+import net.momirealms.customnameplates.api.manager.BubbleManager;
+import net.momirealms.customnameplates.api.mechanic.bubble.provider.AbstractChatProvider;
+import net.momirealms.customnameplates.api.util.LogUtils;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Player;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.HandlerList;
+
+public class TrChatProvider extends AbstractChatProvider {
+
+    private final BukkitAdapter adapter;
+
+    public TrChatProvider(BubbleManager chatBubblesManager) {
+        super(chatBubblesManager);
+        this.adapter = new BukkitAdapter();
+    }
+
+    @Override
+    public void register() {
+        Bukkit.getPluginManager().registerEvents(this, CustomNameplatesPlugin.get());
+    }
+
+    @Override
+    public void unregister() {
+        HandlerList.unregisterAll(this);
+    }
+
+    @Override
+    public boolean hasJoinedChannel(Player player, String channelID) {
+        if (TrChat.INSTANCE.api().getChannelManager().getChannel(channelID) instanceof Channel channel) {
+            return channel.getListeners().contains(player.getName());
+        } else {
+            LogUtils.warn("Channel " + channelID + " doesn't exist.");
+            return false;
+        }
+    }
+
+    @Override
+    public boolean canJoinChannel(Player player, String channelID) {
+        if (TrChat.INSTANCE.api().getChannelManager().getChannel(channelID) instanceof Channel channel) {
+            String perm = channel.getSettings().getJoinPermission();
+            return player.hasPermission(perm);
+        } else {
+            LogUtils.warn("Channel " + channelID + " doesn't exist.");
+            return false;
+        }
+    }
+
+    @EventHandler (ignoreCancelled = true)
+    public void onTrChat(TrChatEvent event) {
+        if (!event.getForward()) return;
+        Channel channel = event.getChannel();
+        String channelName = channel.getId();
+        for (String black : chatBubblesManager.getBlacklistChannels()) {
+            if (channelName.equals(black)) return;
+        }
+        FilteredObject object = TrChat.INSTANCE.api().getFilterManager().filter(event.getMessage(), adapter.adaptPlayer(event.getPlayer()), true);
+        CustomNameplatesPlugin.get().getScheduler().runTaskAsync(() -> {
+            chatBubblesManager.onChat(event.getSession().getPlayer(), object.getFiltered(), channelName);
+        });
+    }
+}

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/bubble/provider/VentureChatProvider.java

@@ -0,0 +1,82 @@
+/*
+ *  Copyright (C) <2022> <XiaoMoMi>
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package net.momirealms.customnameplates.paper.mechanic.bubble.provider;
+
+import mineverse.Aust1n46.chat.api.MineverseChatAPI;
+import mineverse.Aust1n46.chat.api.MineverseChatPlayer;
+import mineverse.Aust1n46.chat.api.events.VentureChatEvent;
+import mineverse.Aust1n46.chat.channel.ChatChannel;
+import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
+import net.momirealms.customnameplates.api.manager.BubbleManager;
+import net.momirealms.customnameplates.api.mechanic.bubble.provider.AbstractChatProvider;
+import net.momirealms.customnameplates.api.util.LogUtils;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Player;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.HandlerList;
+
+public class VentureChatProvider extends AbstractChatProvider {
+
+    public VentureChatProvider(BubbleManager chatBubblesManager) {
+        super(chatBubblesManager);
+    }
+
+    @Override
+    public void register() {
+        Bukkit.getPluginManager().registerEvents(this, CustomNameplatesPlugin.get());
+    }
+
+    @Override
+    public void unregister() {
+        HandlerList.unregisterAll(this);
+    }
+
+    @Override
+    public boolean hasJoinedChannel(Player player, String channelID) {
+        MineverseChatPlayer mcp = MineverseChatAPI.getOnlineMineverseChatPlayer(player);
+        return mcp.getCurrentChannel().getName().equals(channelID);
+    }
+
+    @Override
+    public boolean canJoinChannel(Player player, String channelID) {
+        ChatChannel channel = ChatChannel.getChannel(channelID);
+        if (channel == null) {
+            LogUtils.warn("Channel " + channelID + " doesn't exist.");
+            return false;
+        }
+        if (channel.hasPermission()) {
+            return player.hasPermission(channel.getPermission());
+        }
+        return true;
+    }
+
+    @EventHandler (ignoreCancelled = true)
+    public void onVentureChat(VentureChatEvent event) {
+        String channelName = event.getChannel().getName();
+        for (String channel : chatBubblesManager.getBlacklistChannels()) {
+            if (channelName.equals(channel)) return;
+        }
+        final MineverseChatPlayer chatPlayer = event.getMineverseChatPlayer();
+        if (chatPlayer == null) {
+            return;
+        }
+        CustomNameplatesPlugin.get().getScheduler().runTaskAsync(() -> {
+            chatBubblesManager.onChat(chatPlayer.getPlayer(), event.getChat(), channelName);
+        });
+    }
+}

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/font/WidthManagerImpl.java

@@ -72,10 +72,12 @@ public class WidthManagerImpl implements WidthManager {
     private FontData NONLATIN_EUROPEAN_DATA;
     private FontData UNIFONT_DATA;
     private FontData UNICODE_DATA;
+    private final HashSet<Integer> bitMapChars;
 
     public WidthManagerImpl(CustomNameplatesPlugin plugin) {
         this.plugin = plugin;
         this.fontDataMap = new HashMap<>();
+        this.bitMapChars = new HashSet<>();
         this.saveFontImages();
         this.cacheImageWidthIfNotCached();
         this.loadCachedFontData();
@@ -96,6 +98,7 @@ public class WidthManagerImpl implements WidthManager {
         if (this.cacheSystem != null)
             this.cacheSystem.destroy();
         fontDataMap.clear();
+        bitMapChars.clear();
     }
 
     private void loadInternalConfigs() {
@@ -158,6 +161,10 @@ public class WidthManagerImpl implements WidthManager {
                     Key.of(CNConfig.namespace, "ascent_" + ascent), descentFont
             );
         }
+
+        this.bitMapChars.addAll(ASCII_DATA.getWidthData().keySet());
+        this.bitMapChars.addAll(NONLATIN_EUROPEAN_DATA.getWidthData().keySet());
+        this.bitMapChars.addAll(ACCENTED_DATA.getWidthData().keySet());
     }
 
     private void loadUserConfigs() {
@@ -176,6 +183,7 @@ public class WidthManagerImpl implements WidthManager {
                         case "unifont" -> fontData.overrideWith(UNIFONT_DATA);
                     }
                 }
+                boolean defaultFont = entry.getKey().equals("minecraft:default");
                 ConfigurationSection customSection = innerSection.getConfigurationSection("values");
                 if (customSection != null)
                     for (Map.Entry<String, Object> innerEntry : customSection.getValues(false).entrySet()) {
@@ -187,8 +195,12 @@ public class WidthManagerImpl implements WidthManager {
                                 continue;
                             }
                             fontData.registerCharWidth(stripped.charAt(0), (Integer) innerEntry.getValue());
+                            if (defaultFont)
+                                bitMapChars.add((int) stripped.charAt(0));
                         } else if (key.length() == 1) {
                             fontData.registerCharWidth(key.charAt(0), (Integer) innerEntry.getValue());
+                            if (defaultFont)
+                                bitMapChars.add((int) key.charAt(0));
                         } else {
                             LogUtils.warn("Illegal image format: " + key);
                         }
@@ -442,7 +454,9 @@ public class WidthManagerImpl implements WidthManager {
                                     }
                                 }
                             }
-                            int charWidth = (int) (((double) (x_final - i * single) / single * 8) + 1);
+                            int pixels = x_final - i * single + 1;
+                            double times = (double) width / 128;
+                            int charWidth = (int) (pixels / times);
                             yml.set(ConfigUtils.native2ascii(c), charWidth);
                             i++;
                         }
@@ -501,7 +515,9 @@ public class WidthManagerImpl implements WidthManager {
                                     }
                                 }
                             }
-                            int charWidth = (int) (((double) (x_final - i * single) / single * 8) + 1);
+                            int pixels = x_final - i * single + 1;
+                            double times = (double) width / 128;
+                            int charWidth = (int) (pixels / times);
                             yml.set(ConfigUtils.native2ascii(c), charWidth);
                             i++;
                         }
@@ -548,7 +564,10 @@ public class WidthManagerImpl implements WidthManager {
                                     }
                                 }
                             }
-                            int charWidth = (int) (((double) (x_final - i * single) / single * 8) + 1);
+
+                            int pixels = x_final - i * single + 1;
+                            double times = (double) width / 128;
+                            int charWidth = (int) (pixels / times);
                             yml.set(ConfigUtils.native2ascii(c), charWidth);
                             i++;
                         }
@@ -652,11 +671,12 @@ public class WidthManagerImpl implements WidthManager {
                         char[] chars = ConfigUtils.convertUnicodeStringToChars(line);
                         for (char c : chars) {
                             int width = bufferedImage.getWidth();
+                            double times = (double) width / 144;
                             int single = width / 16;
                             int x_final = i * single;
                             outer:
                             for (int x = i * single; x < (i+1) * single; x++) {
-                                for (int y = j * single; y < (j+1) * single; y++) {
+                                for (int y = (int) (j * 12 * times); y < (j+1) * 12 * times; y++) {
                                     int rgb = bufferedImage.getRGB(x, y);
                                     int alpha = (rgb >> 24) & 0xff;
                                     if (alpha != 0) {
@@ -665,7 +685,9 @@ public class WidthManagerImpl implements WidthManager {
                                     }
                                 }
                             }
-                            int charWidth = (int) (((double) (x_final - i * single) / single * 8) + 1);
+
+                            int pixels = x_final - i * single + 1;
+                            int charWidth = (int) (pixels / times);
                             yml.set(ConfigUtils.native2ascii(c), charWidth);
                             i++;
                         }
@@ -786,7 +808,9 @@ public class WidthManagerImpl implements WidthManager {
                                     }
                                 }
                             }
-                            int charWidth = (int) (((double) (x_final - i * single) / single * 8) + 1);
+                            int pixels = x_final - i * single + 1;
+                            double times = (double) width / 128;
+                            int charWidth = (int) (pixels / times);
                             yml.set(unicode, charWidth);
                             i++;
                         }
@@ -846,8 +870,12 @@ public class WidthManagerImpl implements WidthManager {
         }
     }
 
+    public boolean isNotReplacedUnifont(int codePoint) {
+        return !bitMapChars.contains(codePoint);
+    }
+
     @Override
-    public boolean registerFontData(Key key, FontData fontData) {
+    public boolean registerFontData(@NotNull Key key, @NotNull FontData fontData) {
         if (fontDataMap.containsKey(key)) {
             return false;
         }
@@ -856,18 +884,18 @@ public class WidthManagerImpl implements WidthManager {
     }
 
     @Override
-    public boolean unregisterFontData(Key key) {
+    public boolean unregisterFontData(@NotNull Key key) {
         return fontDataMap.remove(key) != null;
     }
 
     @Nullable
     @Override
-    public FontData getFontData(Key key) {
+    public FontData getFontData(@NotNull Key key) {
         return fontDataMap.get(key);
     }
 
     @Override
-    public int getTextWidth(String textWithTags) {
+    public int getTextWidth(@NotNull String textWithTags) {
         return cacheSystem.getWidthFromCache(textWithTags);
     }
 
@@ -894,25 +922,47 @@ public class WidthManagerImpl implements WidthManager {
                 text = AdventureManagerImpl.getInstance().legacyToMiniMessage(text);
             ElementNode node = (ElementNode) MiniMessage.miniMessage().deserializeToTree(text);
             ArrayList<Tuple<String, Key, Boolean>> list = new ArrayList<>();
-            nodeToStringInfo(node, list, Key.of("minecraft", "default"), false);
-
+            Key defaultFont = Key.of("minecraft", "default");
+            nodeToStringInfo(node, list, defaultFont, false);
             int totalLength = 0;
-            for (Tuple<String, Key, Boolean> element : list) {
+            for (int i = 0, size = list.size(); i < size; i++) {
+                Tuple<String, Key, Boolean> element = list.get(i);
                 FontData data = getFontData(element.getMid());
                 if (data == null) {
                     LogUtils.warn("Unknown font: " + element.getMid() + " Please register it in font-width-data.yml");
                     continue;
                 }
                 char[] chars = element.getLeft().toCharArray();
-                for (int i = 0; i < chars.length; i++) {
-                    if (Character.isHighSurrogate(chars[i])) {
-                        totalLength += data.getWidth(Character.toCodePoint(chars[i], chars[++i]));
-                    } else {
-                        totalLength += data.getWidth(chars[i]);
+                if (!element.getMid().equals(defaultFont)) {
+                    for (int j = 0; j < chars.length; j++) {
+                        int width;
+                        if (Character.isHighSurrogate(chars[j])) {
+                            width = data.getWidth(Character.toCodePoint(chars[j], chars[++j]));
+                        } else {
+                            width = data.getWidth(chars[j]);
+                        }
+                        totalLength += (width + (element.getRight() ? 2 : 1)) * 2;
+                    }
+                } else {
+                    for (int j = 0; j < chars.length; j++) {
+                        if (Character.isHighSurrogate(chars[j])) {
+                            int codePoint = Character.toCodePoint(chars[j], chars[++j]);
+                            if (isNotReplacedUnifont(codePoint)) {
+                                totalLength += (data.getWidth(codePoint) * 2 + (element.getRight() ? 3 : 2));
+                            } else {
+                                totalLength += (element.getRight() ? 2 : 1) * 2;
+                            }
+                        } else {
+                            if (isNotReplacedUnifont(chars[j])) {
+                                totalLength += (data.getWidth(chars[j]) * 2 + (element.getRight() ? 3 : 2));
+                            } else {
+                                totalLength += (data.getWidth(chars[j]) + (element.getRight() ? 2 : 1)) * 2;
+                            }
+                        }
                     }
                 }
-                totalLength += element.getRight() ? element.getLeft().length() * 2 : element.getLeft().length();
             }
+            totalLength /= 2;
             return totalLength;
         }
 
@@ -924,7 +974,11 @@ public class WidthManagerImpl implements WidthManager {
             } else if (node instanceof TagNode tagNode) {
                 if (tagNode.tag() instanceof Inserting inserting) {
                     Component component = inserting.value();
-                    isBold = component.hasDecoration(TextDecoration.BOLD);
+                    if (component.decoration(TextDecoration.BOLD) == TextDecoration.State.TRUE) {
+                        isBold = true;
+                    } else if (component.decoration(TextDecoration.BOLD) == TextDecoration.State.FALSE) {
+                        isBold = false;
+                    }
                     var key = component.font();
                     if (key != null) {
                         font = net.momirealms.customnameplates.common.Key.of(key.namespace(), key.value());

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/misc/DisplayController.java

@@ -21,6 +21,7 @@ import me.clip.placeholderapi.PlaceholderAPI;
 import net.momirealms.customnameplates.api.manager.RequirementManager;
 import net.momirealms.customnameplates.api.requirement.Condition;
 import net.momirealms.customnameplates.api.requirement.Requirement;
+import net.momirealms.customnameplates.api.util.LogUtils;
 import org.bukkit.entity.Player;
 
 public class DisplayController {
@@ -35,6 +36,7 @@ public class DisplayController {
     private int timeLeft;
     private int index;
     private final TimeLimitText[] texts;
+    private boolean metAnyCondition;
 
     public DisplayController(
             Player player,
@@ -44,10 +46,10 @@ public class DisplayController {
     ) {
         this.owner = player;
         this.checkFrequency = checkFrequency;
-        this.checkTimer = 0;
         this.refreshTimer = 0;
         this.requirements = requirements;
         this.texts = texts;
+        this.checkTimer = checkFrequency - 1;
     }
 
     public NextStage stateCheck(Condition condition) {
@@ -78,21 +80,33 @@ public class DisplayController {
     }
 
     public boolean updateText(Condition condition) {
-        timeLeft--;
-        if (timeLeft <= 0) {
+        if (timeLeft > 0)
+            timeLeft--;
+
+        // Definitely goto "if" on init
+        if (timeLeft == 0) {
+            int triedTimes = 0;
             do {
                 index++;
                 if (index >= texts.length) {
                     index = 0;
                 }
+                if (triedTimes == texts.length) {
+                    timeLeft = Math.max(checkFrequency, 1);
+                    metAnyCondition = false;
+                    LogUtils.warn("No text is available for player " + owner.getName() + ". Please check your conditions.");
+                    return updateText("");
+                }
+                triedTimes++;
             } while (!RequirementManager.isRequirementMet(condition, texts[index].getRequirements()));
 
+            metAnyCondition = true;
             timeLeft = texts[index].getDuration();
             refreshTimer = 0;
             return updateText(texts[index].getText());
         }
 
-        if (texts[index].getRefreshFrequency() <= 0) {
+        if (!metAnyCondition || texts[index].getRefreshFrequency() <= 0) {
             return false;
         }
 
@@ -114,12 +128,13 @@ public class DisplayController {
         return true;
     }
 
-    public void initialize() {
-        index = 0;
+    public void initialize(Condition condition) {
+        index = texts.length - 1;
         checkTimer = 0;
         refreshTimer = 0;
-        timeLeft = texts[0].getDuration();
-        latestValue = PlaceholderAPI.setPlaceholders(owner, texts[0].getText());
+        timeLeft = 1;
+        // The text would definitely be refreshed
+        updateText(condition);
     }
 
     public String getLatestContent() {

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/misc/MessageManager.java

@@ -1,9 +0,0 @@
-package net.momirealms.customnameplates.paper.mechanic.misc;
-
-import org.bukkit.event.Listener;
-
-public class MessageManager implements Listener {
-
-
-
-}

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/misc/VersionManagerImpl.java

@@ -26,6 +26,7 @@ import org.bukkit.entity.Player;
 import org.bukkit.event.EventHandler;
 import org.bukkit.event.Listener;
 import org.bukkit.event.player.PlayerJoinEvent;
+import org.jetbrains.annotations.NotNull;
 
 import java.io.BufferedReader;
 import java.io.InputStream;
@@ -97,6 +98,7 @@ public class VersionManagerImpl implements VersionManager, Listener {
         return isNewerThan1_20_R2;
     }
 
+    @NotNull
     @Override
     public String getPluginVersion() {
         return pluginVersion;
@@ -236,7 +238,7 @@ public class VersionManagerImpl implements VersionManager, Listener {
         final Player player = event.getPlayer();
         if (player.isOp()) {
             if (!PlaceholderAPI.isRegistered("player")) {
-                AdventureManagerImpl.getInstance().sendMessageWithPrefix(player, "You haven't installed Player Expansion yet. Click <b><gold><click:run_command:/papi ecloud download Player>HERE</click></gold><b> to download.");
+                AdventureManagerImpl.getInstance().sendMessageWithPrefix(player, "You haven't installed Player Expansion yet. Click <b><gold><u><click:run_command:/papi ecloud download Player>HERE</click></u></gold></b> to download. Otherwise you might encounter console spam on first installation.");
             }
         }
     }

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/nameplate/NameplateManagerImpl.java

@@ -51,9 +51,11 @@ import org.bukkit.event.EventPriority;
 import org.bukkit.event.HandlerList;
 import org.bukkit.event.Listener;
 import org.bukkit.event.entity.EntityPoseChangeEvent;
+import org.bukkit.event.entity.EntityPotionEffectEvent;
 import org.bukkit.event.player.PlayerJoinEvent;
 import org.bukkit.event.player.PlayerQuitEvent;
 import org.bukkit.event.player.PlayerToggleSneakEvent;
+import org.bukkit.potion.PotionEffectType;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
@@ -81,6 +83,8 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
     private final EntityMoveListener entityMoveListener;
     private final EntityLookListener entityLookListener;
     private final EntityTeleportListener entityTeleportListener;
+    private final EntityAddEffectListener entityAddEffectListener;
+    private final EntityRemoveEffectListener entityRemoveEffectListener;
 
     /**
      * Configs
@@ -113,6 +117,8 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
         this.entitySpawnListener = new EntitySpawnListener(this);
         this.entityLookListener = new EntityLookListener(this);
         this.entityMoveListener = new EntityMoveListener(this);
+        this.entityAddEffectListener = new EntityAddEffectListener(this);
+        this.entityRemoveEffectListener = new EntityRemoveEffectListener(this);
     }
 
     public void reload() {
@@ -135,6 +141,8 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
         ProtocolLibrary.getProtocolManager().removePacketListener(entityLookListener);
         ProtocolLibrary.getProtocolManager().removePacketListener(entityMoveListener);
         ProtocolLibrary.getProtocolManager().removePacketListener(entityTeleportListener);
+        ProtocolLibrary.getProtocolManager().removePacketListener(entityAddEffectListener);
+        ProtocolLibrary.getProtocolManager().removePacketListener(entityRemoveEffectListener);
     }
 
     public void disable() {
@@ -145,6 +153,14 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
 
     public void load() {
         this.unlimitedTagManager.load();
+        Bukkit.getPluginManager().registerEvents(this, plugin);
+        ProtocolLibrary.getProtocolManager().addPacketListener(entityDestroyListener);
+        ProtocolLibrary.getProtocolManager().addPacketListener(entitySpawnListener);
+        ProtocolLibrary.getProtocolManager().addPacketListener(entityLookListener);
+        ProtocolLibrary.getProtocolManager().addPacketListener(entityMoveListener);
+        ProtocolLibrary.getProtocolManager().addPacketListener(entityTeleportListener);
+        ProtocolLibrary.getProtocolManager().addPacketListener(entityAddEffectListener);
+        ProtocolLibrary.getProtocolManager().addPacketListener(entityRemoveEffectListener);
 
         if (!CNConfig.nameplateModule) return;
         this.loadConfig();
@@ -160,13 +176,6 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
         for (Player online : Bukkit.getOnlinePlayers()) {
             createNameTag(online);
         }
-
-        Bukkit.getPluginManager().registerEvents(this, plugin);
-        ProtocolLibrary.getProtocolManager().addPacketListener(entityDestroyListener);
-        ProtocolLibrary.getProtocolManager().addPacketListener(entitySpawnListener);
-        ProtocolLibrary.getProtocolManager().addPacketListener(entityLookListener);
-        ProtocolLibrary.getProtocolManager().addPacketListener(entityMoveListener);
-        ProtocolLibrary.getProtocolManager().addPacketListener(entityTeleportListener);
     }
 
     private void loadConfig() {
@@ -259,6 +268,8 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
 
     @EventHandler (ignoreCancelled = true, priority = EventPriority.LOW)
     public void onDataLoaded(NameplateDataLoadEvent event) {
+        if (!CNConfig.nameplateModule) return;
+
         OnlineUser data = event.getOnlineUser();
         String nameplate = data.getNameplateKey();
         if (nameplate.equals("none")) {
@@ -286,26 +297,43 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
     @EventHandler
     public void onPlayerJoin(PlayerJoinEvent event) {
         var player = event.getPlayer();
+        handlePlayerJoin(player);
+    }
+
+    @Override
+    public void handlePlayerJoin(Player player) {
         this.putEntityIDToMap(player.getEntityId(), player);
-        if (!CNConfig.isOtherTeamPluginHooked() && !isProxyMode())
-            plugin.getTeamManager().createTeam(player);
-        plugin.getScheduler().runTaskAsyncLater(() -> {
-            if (player.isOnline())
-                this.createNameTag(player);
-        }, 200, TimeUnit.MILLISECONDS);
+
+        // nameplate module part
+        if (CNConfig.nameplateModule) {
+            if (!CNConfig.isOtherTeamPluginHooked() && !isProxyMode()) {
+                plugin.getTeamManager().createTeam(player);
+            }
+            plugin.getScheduler().runTaskAsyncLater(() -> {
+                if (player.isOnline())
+                    this.createNameTag(player);
+            }, 50, TimeUnit.MILLISECONDS);
+        }
     }
 
     @EventHandler
     public void onPlayerQuit(PlayerQuitEvent event) {
         var player = event.getPlayer();
-        this.removeCachedNameplateFromMap(player.getUniqueId());
-        this.removeEntityIDFromMap(player.getEntityId());
+        handlePlayerQuit(player);
+    }
 
+    @Override
+    public void handlePlayerQuit(Player player) {
+        this.removeEntityIDFromMap(player.getEntityId());
         this.teamTagManager.handlePlayerQuit(player);
         this.unlimitedTagManager.handlePlayerQuit(player);
 
-        if (!CNConfig.isOtherTeamPluginHooked() && !isProxyMode()) {
-            plugin.getTeamManager().removeTeam(player);
+        // nameplate module part
+        if (CNConfig.nameplateModule) {
+            this.removeCachedNameplateFromMap(player.getUniqueId());
+            if (!CNConfig.isOtherTeamPluginHooked() && !isProxyMode()) {
+                plugin.getTeamManager().removeTeam(player);
+            }
         }
     }
 
@@ -322,8 +350,19 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
         }
     }
 
+    // TODO: Potion effect packet seems to be only sent to the player who has effect,
+    //  it might be something related to metadata. Using BukkitAPI is not the best choice
+    //  since it might conflict with some potion plugins that based on packets
+    @EventHandler (ignoreCancelled = true)
+    public void onPotionEffectChange(EntityPotionEffectEvent event) {
+        if (event.getModifiedType() == PotionEffectType.INVISIBILITY) {
+            unlimitedTagManager.handlePotionEffect(event.getEntity(),
+                    event.getAction() == EntityPotionEffectEvent.Action.REMOVED || event.getAction() == EntityPotionEffectEvent.Action.CLEARED);
+        }
+    }
+
     @Override
-    public boolean putEntityIDToMap(int entityID, Entity entity) {
+    public boolean putEntityIDToMap(int entityID, @NotNull Entity entity) {
         if (this.entityID2EntityMap.containsKey(entityID))
             return false;
         this.entityID2EntityMap.put(entityID, entity);
@@ -336,7 +375,7 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
     }
 
     @Override
-    public boolean putCachedNameplateToMap(UUID uuid, CachedNameplate nameplate) {
+    public boolean putCachedNameplateToMap(@NotNull UUID uuid, @NotNull CachedNameplate nameplate) {
         if (this.cachedNameplateMap.containsKey(uuid)) {
             return false;
         }
@@ -345,7 +384,7 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
     }
 
     @Override
-    public CachedNameplate removeCachedNameplateFromMap(UUID uuid) {
+    public CachedNameplate removeCachedNameplateFromMap(@NotNull UUID uuid) {
         return this.cachedNameplateMap.remove(uuid);
     }
 
@@ -364,7 +403,7 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
     }
 
     @Override
-    public boolean updateCachedNameplate(Player player) {
+    public boolean updateCachedNameplate(@NotNull Player player) {
         Optional<OnlineUser> onlineUser = plugin.getStorageManager().getOnlineUser(player.getUniqueId());
         if (onlineUser.isEmpty()) return false;
         Nameplate nameplate = onlineUser.get().getNameplate();
@@ -372,45 +411,49 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
     }
 
     @Override
-    public boolean updateCachedNameplate(Player player, Nameplate nameplate) {
+    public boolean updateCachedNameplate(@NotNull Player player, Nameplate nameplate) {
         CachedNameplate cachedNameplate = cachedNameplateMap.get(player.getUniqueId());
         if (cachedNameplate == null) return false;
         return updateCachedNameplate(cachedNameplate, player, nameplate);
     }
 
     @Override
-    public CachedNameplate getCacheNameplate(Player player) {
+    public CachedNameplate getCacheNameplate(@NotNull Player player) {
         return cachedNameplateMap.get(player.getUniqueId());
     }
 
     @Override
-    public void createNameTag(Player player) {
+    public NameplatePlayer createNameTag(@NotNull Player player) {
         if (tagMode == TagMode.TEAM) {
-            putNameplatePlayerToMap(this.teamTagManager.createTagForPlayer(player, teamPrefix, teamSuffix));
-            EntityTagPlayer tagPlayer = this.unlimitedTagManager.createOrGetTagForPlayer(player, false);
+            NameplatePlayer nameplatePlayer = this.teamTagManager.createTagForPlayer(player, teamPrefix, teamSuffix);
+            putNameplatePlayerToMap(nameplatePlayer);
+            this.unlimitedTagManager.createOrGetTagForPlayer(player);
+            return nameplatePlayer;
         } else if (tagMode == TagMode.UNLIMITED) {
-            EntityTagPlayer tagPlayer = this.unlimitedTagManager.createOrGetTagForPlayer(player, true);
+            EntityTagPlayer tagPlayer = this.unlimitedTagManager.createOrGetTagForPlayer(player);
             for (DynamicTextTagSetting setting : tagSettings) {
                 tagPlayer.addTag(setting);
             }
             putNameplatePlayerToMap(tagPlayer);
+            return tagPlayer;
         } else {
-            EntityTagPlayer tagPlayer = this.unlimitedTagManager.createOrGetTagForPlayer(player, false);
+            this.unlimitedTagManager.createOrGetTagForPlayer(player);
+            return null;
         }
     }
 
     @Override
-    public void putNameplatePlayerToMap(NameplatePlayer player) {
+    public void putNameplatePlayerToMap(@NotNull NameplatePlayer player) {
         this.nameplatePlayerMap.put(player.getPlayer().getUniqueId(), player);
     }
 
     @Override
-    public NameplatePlayer getNameplatePlayer(UUID uuid) {
+    public NameplatePlayer getNameplatePlayer(@NotNull UUID uuid) {
         return this.nameplatePlayerMap.get(uuid);
     }
 
     @Override
-    public NameplatePlayer removeNameplatePlayerFromMap(UUID uuid) {
+    public NameplatePlayer removeNameplatePlayerFromMap(@NotNull UUID uuid) {
         return this.nameplatePlayerMap.remove(uuid);
     }
 
@@ -443,22 +486,25 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
         return true;
     }
 
+    @NotNull
     @Override
-    public String getNameplatePrefix(Player player) {
+    public String getNameplatePrefix(@NotNull Player player) {
         CachedNameplate cachedNameplate = cachedNameplateMap.get(player.getUniqueId());
         if (cachedNameplate == null) return "";
         return cachedNameplate.getTagPrefix();
     }
 
+    @NotNull
     @Override
-    public String getNameplateSuffix(Player player) {
+    public String getNameplateSuffix(@NotNull Player player) {
         CachedNameplate cachedNameplate = cachedNameplateMap.get(player.getUniqueId());
         if (cachedNameplate == null) return "";
         return cachedNameplate.getTagSuffix();
     }
 
+    @NotNull
     @Override
-    public String getFullNameTag(Player player) {
+    public String getFullNameTag(@NotNull Player player) {
         CachedNameplate cachedNameplate = cachedNameplateMap.get(player.getUniqueId());
         if (cachedNameplate == null) {
             return player.getName();
@@ -471,8 +517,9 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
                 + cachedNameplate.getNameSuffix();
     }
 
+    @NotNull
     @Override
-    public List<String> getAvailableNameplates(Player player) {
+    public List<String> getAvailableNameplates(@NotNull Player player) {
         List<String> nameplates = new ArrayList<>();
         for (String nameplate : nameplateMap.keySet()) {
             if (hasNameplate(player, nameplate)) {
@@ -482,8 +529,9 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
         return nameplates;
     }
 
+    @NotNull
     @Override
-    public List<String> getAvailableNameplateDisplayNames(Player player) {
+    public List<String> getAvailableNameplateDisplayNames(@NotNull Player player) {
         List<String> nameplates = new ArrayList<>();
         for (Map.Entry<String, Nameplate> entry : nameplateMap.entrySet()) {
             if (hasNameplate(player, entry.getKey())) {
@@ -494,7 +542,7 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
     }
 
     @Override
-    public boolean equipNameplate(Player player, String nameplateKey, boolean temp) {
+    public boolean equipNameplate(@NotNull Player player, @NotNull String nameplateKey, boolean temp) {
         Nameplate nameplate = getNameplate(nameplateKey);
         if (nameplate == null && nameplateKey.equals("none")) {
             return false;
@@ -545,14 +593,14 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
     }
 
     @Override
-    public boolean registerNameplate(String key, Nameplate nameplate) {
+    public boolean registerNameplate(@NotNull String key, @NotNull Nameplate nameplate) {
         if (this.nameplateMap.containsKey(key)) return false;
         this.nameplateMap.put(key, nameplate);
         return true;
     }
 
     @Override
-    public boolean unregisterNameplate(String key) {
+    public boolean unregisterNameplate(@NotNull String key) {
         return this.nameplateMap.remove(key) != null;
     }
 
@@ -566,39 +614,43 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
         return previewDuration;
     }
 
+    @NotNull
     @Override
     public TagMode getTagMode() {
         return tagMode;
     }
 
-    @Override
     @Nullable
-    public Nameplate getNameplate(String key) {
+    @Override
+    public Nameplate getNameplate(@NotNull String key) {
         return nameplateMap.get(key);
     }
 
+    @NotNull
     @Override
     public Collection<Nameplate> getNameplates() {
         return nameplateMap.values();
     }
 
+    @NotNull
     @Override
     public Collection<String> getNameplateKeys() {
         return nameplateMap.keySet();
     }
 
     @Override
-    public boolean containsNameplate(String key) {
+    public boolean containsNameplate(@NotNull String key) {
         return nameplateMap.containsKey(key);
     }
 
     @Override
-    public boolean hasNameplate(Player player, String nameplate) {
+    public boolean hasNameplate(@NotNull Player player, @NotNull String nameplate) {
         return player.hasPermission("nameplates.equip." + nameplate);
     }
 
+    @NotNull
     @Override
-    public TeamColor getTeamColor(Player player) {
+    public TeamColor getTeamColor(@NotNull Player player) {
         CachedNameplate nameplate = getCacheNameplate(player);
         return nameplate == null ? TeamColor.WHITE : nameplate.getTeamColor();
     }
@@ -609,11 +661,13 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
         return defaultNameplate;
     }
 
+    @NotNull
     @Override
     public TeamTagManager getTeamTagManager() {
         return teamTagManager;
     }
 
+    @NotNull
     @Override
     public UnlimitedTagManager getUnlimitedTagManager() {
         return unlimitedTagManager;
@@ -636,4 +690,12 @@ public class NameplateManagerImpl implements NameplateManager, Listener {
     public void onEntityTeleport(Player receiver, int entityID, double x, double y, double z, boolean onGround) {
         unlimitedTagManager.handleEntityTeleportPacket(receiver, entityID, x, y, z, onGround);
     }
+
+//    public void onEntityRemoveEffect(Player player, int entityID) {
+//        unlimitedTagManager.handlePotionEffect(player, entityID,true);
+//    }
+//
+//    public void onEntityAddEffect(Player player, int entityID) {
+//        unlimitedTagManager.handlePotionEffect(player, entityID,false);
+//    }
 }

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/nameplate/tag/listener/DisguiseListener.java

@@ -0,0 +1,51 @@
+/*
+ *  Copyright (C) <2022> <XiaoMoMi>
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package net.momirealms.customnameplates.paper.mechanic.nameplate.tag.listener;
+
+import me.libraryaddict.disguise.events.DisguiseEvent;
+import me.libraryaddict.disguise.events.UndisguiseEvent;
+import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
+import net.momirealms.customnameplates.paper.mechanic.nameplate.tag.unlimited.UnlimitedPlayer;
+import net.momirealms.customnameplates.paper.mechanic.nameplate.tag.unlimited.UnlimitedTagManagerImpl;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.Listener;
+
+import java.util.concurrent.TimeUnit;
+
+public class DisguiseListener implements Listener {
+
+    private final UnlimitedTagManagerImpl unlimitedTagManager;
+
+    public DisguiseListener(UnlimitedTagManagerImpl unlimitedTagManager) {
+        this.unlimitedTagManager = unlimitedTagManager;
+    }
+
+    @EventHandler (ignoreCancelled = true)
+    public void onDisguise(DisguiseEvent event) {
+        if (this.unlimitedTagManager.getUnlimitedObject(event.getEntity().getUniqueId()) instanceof UnlimitedPlayer player) {
+            CustomNameplatesPlugin.get().getScheduler().runTaskAsyncLater(player::updateVisibility, 50, TimeUnit.MILLISECONDS);
+        }
+    }
+
+    @EventHandler (ignoreCancelled = true)
+    public void onUnDisguise(UndisguiseEvent event) {
+        if (this.unlimitedTagManager.getUnlimitedObject(event.getEntity().getUniqueId()) instanceof UnlimitedPlayer player) {
+            CustomNameplatesPlugin.get().getScheduler().runTaskAsyncLater(player::updateVisibility, 50, TimeUnit.MILLISECONDS);
+        }
+    }
+}

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/nameplate/tag/listener/EntityAddEffectListener.java

@@ -0,0 +1,45 @@
+/*
+ *  Copyright (C) <2022> <XiaoMoMi>
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package net.momirealms.customnameplates.paper.mechanic.nameplate.tag.listener;
+
+import com.comphenix.protocol.PacketType;
+import com.comphenix.protocol.events.ListenerPriority;
+import com.comphenix.protocol.events.PacketAdapter;
+import com.comphenix.protocol.events.PacketEvent;
+import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
+import net.momirealms.customnameplates.paper.mechanic.nameplate.NameplateManagerImpl;
+
+public class EntityAddEffectListener extends PacketAdapter {
+
+    private final NameplateManagerImpl manager;
+
+    public EntityAddEffectListener(NameplateManagerImpl manager) {
+        super(CustomNameplatesPlugin.getInstance(), ListenerPriority.NORMAL, PacketType.Play.Server.ENTITY_EFFECT);
+        this.manager = manager;
+    }
+
+    @Override
+    public void onPacketSending(PacketEvent event) {
+//        PacketContainer packet = event.getPacket();
+//        System.out.println("添加包");
+//        if (packet.getEffectTypes().read(0) == PotionEffectType.INVISIBILITY) {
+//            System.out.println("是隐身");
+//            manager.onEntityAddEffect(event.getPlayer(), packet.getIntegers().read(0));
+//        }
+    }
+}

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/nameplate/tag/listener/EntityDestroyListener.java

@@ -30,11 +30,13 @@ public class EntityDestroyListener extends PacketAdapter {
     private final NameplateManagerImpl manager;
 
     public EntityDestroyListener(NameplateManagerImpl manager) {
-        super(CustomNameplatesPlugin.getInstance(), ListenerPriority.HIGH, PacketType.Play.Server.ENTITY_DESTROY);
+        super(CustomNameplatesPlugin.getInstance(), ListenerPriority.NORMAL, PacketType.Play.Server.ENTITY_DESTROY);
         this.manager = manager;
     }
 
+    @Override
     public void onPacketSending(PacketEvent event) {
+        if (event.isCancelled()) return;
         PacketContainer packet = event.getPacket();
         manager.onEntityDestroy(event.getPlayer(), packet.getIntLists().read(0));
     }

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/nameplate/tag/listener/EntityLookListener.java

@@ -30,11 +30,13 @@ public class EntityLookListener extends PacketAdapter {
     private final NameplateManagerImpl manager;
 
     public EntityLookListener(NameplateManagerImpl manager) {
-        super(CustomNameplatesPlugin.getInstance(), ListenerPriority.HIGHEST, PacketType.Play.Server.REL_ENTITY_MOVE_LOOK);
+        super(CustomNameplatesPlugin.getInstance(), ListenerPriority.NORMAL, PacketType.Play.Server.REL_ENTITY_MOVE_LOOK);
         this.manager = manager;
     }
 
+    @Override
     public void onPacketSending(PacketEvent event) {
+        if (event.isCancelled()) return;
         PacketContainer packet = event.getPacket();
         manager.onEntityMove(event.getPlayer(),
                 packet.getIntegers().read(0),

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/nameplate/tag/listener/EntityMoveListener.java

@@ -30,11 +30,13 @@ public class EntityMoveListener extends PacketAdapter {
     private final NameplateManagerImpl manager;
 
     public EntityMoveListener(NameplateManagerImpl manager) {
-        super(CustomNameplatesPlugin.getInstance(), ListenerPriority.HIGHEST, PacketType.Play.Server.REL_ENTITY_MOVE);
+        super(CustomNameplatesPlugin.getInstance(), ListenerPriority.NORMAL, PacketType.Play.Server.REL_ENTITY_MOVE);
         this.manager = manager;
     }
 
+    @Override
     public void onPacketSending(PacketEvent event) {
+        if (event.isCancelled()) return;
         PacketContainer packet = event.getPacket();
         manager.onEntityMove(event.getPlayer(),
                 packet.getIntegers().read(0),

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/nameplate/tag/listener/EntityRemoveEffectListener.java

@@ -0,0 +1,44 @@
+/*
+ *  Copyright (C) <2022> <XiaoMoMi>
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package net.momirealms.customnameplates.paper.mechanic.nameplate.tag.listener;
+
+import com.comphenix.protocol.PacketType;
+import com.comphenix.protocol.events.ListenerPriority;
+import com.comphenix.protocol.events.PacketAdapter;
+import com.comphenix.protocol.events.PacketEvent;
+import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
+import net.momirealms.customnameplates.paper.mechanic.nameplate.NameplateManagerImpl;
+
+public class EntityRemoveEffectListener extends PacketAdapter {
+
+    private final NameplateManagerImpl manager;
+
+    public EntityRemoveEffectListener(NameplateManagerImpl manager) {
+        super(CustomNameplatesPlugin.getInstance(), ListenerPriority.HIGHEST, PacketType.Play.Server.REMOVE_ENTITY_EFFECT);
+        this.manager = manager;
+    }
+
+    @Override
+    public void onPacketSending(PacketEvent event) {
+//        if (event.isCancelled()) return;
+//        PacketContainer packet = event.getPacket();
+//        if (packet.getEffectTypes().read(0) == PotionEffectType.INVISIBILITY) {
+//            manager.onEntityRemoveEffect(event.getPlayer(), packet.getIntegers().read(0));
+//        }
+    }
+}

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/nameplate/tag/listener/EntitySpawnListener.java

@@ -29,11 +29,13 @@ public class EntitySpawnListener extends PacketAdapter {
     private final NameplateManagerImpl manager;
 
     public EntitySpawnListener(NameplateManagerImpl manager) {
-        super(CustomNameplatesPlugin.getInstance(), ListenerPriority.HIGH, CustomNameplatesPlugin.getInstance().getVersionManager().isVersionNewerThan1_20_R2() ? PacketType.Play.Server.SPAWN_ENTITY : PacketType.Play.Server.NAMED_ENTITY_SPAWN);
+        super(CustomNameplatesPlugin.getInstance(), ListenerPriority.NORMAL, CustomNameplatesPlugin.getInstance().getVersionManager().isVersionNewerThan1_20_R2() ? PacketType.Play.Server.SPAWN_ENTITY : PacketType.Play.Server.NAMED_ENTITY_SPAWN);
         this.manager = manager;
     }
 
-    public synchronized void onPacketSending(PacketEvent event) {
+    @Override
+    public void onPacketSending(PacketEvent event) {
+        if (event.isCancelled()) return;
         manager.onEntitySpawn(event.getPlayer(), event.getPacket().getIntegers().read(0));
     }
 }

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/nameplate/tag/listener/EntityTeleportListener.java

@@ -30,11 +30,13 @@ public class EntityTeleportListener extends PacketAdapter {
     private final NameplateManagerImpl manager;
 
     public EntityTeleportListener(NameplateManagerImpl manager) {
-        super(CustomNameplatesPlugin.getInstance(), ListenerPriority.HIGHEST, PacketType.Play.Server.ENTITY_TELEPORT);
+        super(CustomNameplatesPlugin.getInstance(), ListenerPriority.NORMAL, PacketType.Play.Server.ENTITY_TELEPORT);
         this.manager = manager;
     }
 
+    @Override
     public void onPacketSending(PacketEvent event) {
+        if (event.isCancelled()) return;
         PacketContainer packet = event.getPacket();
         manager.onEntityTeleport(
                 event.getPlayer(),

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/nameplate/tag/listener/MagicCosmeticsListener.java

@@ -22,12 +22,15 @@ import com.francobm.magicosmetics.api.CosmeticType;
 import com.francobm.magicosmetics.cache.PlayerData;
 import com.francobm.magicosmetics.cache.cosmetics.Hat;
 import com.francobm.magicosmetics.events.*;
+import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
 import net.momirealms.customnameplates.paper.mechanic.nameplate.tag.unlimited.UnlimitedPlayer;
 import net.momirealms.customnameplates.paper.mechanic.nameplate.tag.unlimited.UnlimitedTagManagerImpl;
 import org.bukkit.entity.Player;
 import org.bukkit.event.EventHandler;
 import org.bukkit.event.Listener;
 
+import java.util.concurrent.TimeUnit;
+
 public class MagicCosmeticsListener implements Listener {
 
     private final UnlimitedTagManagerImpl unlimitedTagManager;
@@ -36,18 +39,19 @@ public class MagicCosmeticsListener implements Listener {
         this.unlimitedTagManager = unlimitedTagManager;
     }
 
-    @EventHandler
+    @EventHandler (ignoreCancelled = true)
     public void onChangeCos(CosmeticChangeEquipEvent event) {
         final Cosmetic cosmetic = event.getNewCosmetic();
         final Player player = event.getPlayer();
         if (cosmetic instanceof Hat hat) {
             if (unlimitedTagManager.getUnlimitedObject(player.getUniqueId()) instanceof UnlimitedPlayer unlimitedPlayer) {
                 unlimitedPlayer.setHatOffset(hat.isHideCosmetic() ? 0 : hat.getOffSetY());
+                unlimitedPlayer.teleport();
             }
         }
     }
 
-    @EventHandler
+    @EventHandler (ignoreCancelled = true)
     public void onEnterBlackListWorld(PlayerChangeBlacklistEvent event) {
         var player = event.getPlayer();
         if (unlimitedTagManager.getUnlimitedObject(player.getUniqueId()) instanceof UnlimitedPlayer unlimitedPlayer) {
@@ -59,40 +63,46 @@ public class MagicCosmeticsListener implements Listener {
                     final Cosmetic cosmetic = playerData.getHat();
                     if (cosmetic instanceof Hat hat) {
                         unlimitedPlayer.setHatOffset(hat.isHideCosmetic() ? 0 : hat.getOffSetY());
+                        unlimitedPlayer.teleport();
                     }
                 }
             }
         }
     }
 
-    @EventHandler
+    @EventHandler (ignoreCancelled = true)
     public void onEquip(CosmeticEquipEvent event) {
         final Cosmetic cosmetic = event.getCosmetic();
         final Player player = event.getPlayer();
         if (cosmetic instanceof Hat hat) {
             if (unlimitedTagManager.getUnlimitedObject(player.getUniqueId()) instanceof UnlimitedPlayer unlimitedPlayer) {
                 unlimitedPlayer.setHatOffset(hat.isHideCosmetic() ? 0 : hat.getOffSetY());
+                unlimitedPlayer.teleport();
             }
         }
     }
 
-    @EventHandler
+    @EventHandler (ignoreCancelled = true)
     public void onUnEquip(CosmeticUnEquipEvent event) {
         final Player player = event.getPlayer();
         if (event.getCosmeticType() == CosmeticType.HAT) {
             if (unlimitedTagManager.getUnlimitedObject(player.getUniqueId()) instanceof UnlimitedPlayer unlimitedPlayer) {
                 unlimitedPlayer.setHatOffset(0);
+                unlimitedPlayer.teleport();
             }
         }
     }
 
-    @EventHandler
+    @EventHandler (ignoreCancelled = true)
     public void onDataLoaded(PlayerDataLoadEvent event) {
         for (Cosmetic cosmetic : event.getEquippedCosmetics()) {
             if (cosmetic instanceof Hat hat) {
-                if (unlimitedTagManager.getUnlimitedObject(event.getPlayerData().getUniqueId()) instanceof UnlimitedPlayer unlimitedPlayer) {
-                    unlimitedPlayer.setHatOffset(hat.isHideCosmetic() ? 0 : hat.getOffSetY());
-                }
+                CustomNameplatesPlugin.get().getScheduler().runTaskAsyncLater(() -> {
+                    if (unlimitedTagManager.getUnlimitedObject(event.getPlayerData().getUniqueId()) instanceof UnlimitedPlayer unlimitedPlayer) {
+                        unlimitedPlayer.setHatOffset(hat.isHideCosmetic() ? 0 : hat.getOffSetY());
+                        unlimitedPlayer.teleport();
+                    }
+                }, 100, TimeUnit.MILLISECONDS);
             }
         }
     }

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/nameplate/tag/listener/PlayerInfoListener.java

@@ -26,9 +26,7 @@ import com.comphenix.protocol.wrappers.EnumWrappers;
 import com.comphenix.protocol.wrappers.PlayerInfoData;
 import com.comphenix.protocol.wrappers.WrappedChatComponent;
 import com.comphenix.protocol.wrappers.WrappedGameProfile;
-import com.destroystokyo.paper.profile.PlayerProfile;
 import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
-import net.momirealms.customnameplates.paper.mechanic.nameplate.NameplateManagerImpl;
 import net.momirealms.customnameplates.paper.mechanic.nameplate.tag.team.TeamTagManagerImpl;
 
 import java.util.ArrayList;
@@ -40,11 +38,13 @@ public class PlayerInfoListener extends PacketAdapter {
     private final TeamTagManagerImpl manager;
 
     public PlayerInfoListener(TeamTagManagerImpl manager) {
-        super(CustomNameplatesPlugin.getInstance(), ListenerPriority.HIGHEST, PacketType.Play.Server.PLAYER_INFO);
+        super(CustomNameplatesPlugin.getInstance(), ListenerPriority.NORMAL, PacketType.Play.Server.PLAYER_INFO);
         this.manager = manager;
     }
 
+    @Override
     public void onPacketSending(PacketEvent event) {
+        if (event.isCancelled()) return;
         PacketContainer packet = event.getPacket();
         Set<EnumWrappers.PlayerInfoAction> actions = packet.getPlayerInfoActions().read(0);
         if (!actions.contains(EnumWrappers.PlayerInfoAction.UPDATE_DISPLAY_NAME))

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/nameplate/tag/team/TeamTagManagerImpl.java

@@ -28,6 +28,7 @@ import net.momirealms.customnameplates.paper.mechanic.nameplate.tag.listener.Pla
 import org.bukkit.Bukkit;
 import org.bukkit.entity.Entity;
 import org.bukkit.entity.Player;
+import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 import java.util.List;
@@ -40,7 +41,7 @@ public class TeamTagManagerImpl implements TeamTagManager {
     private final NameplateManager manager;
     private final ConcurrentHashMap<UUID, TeamPlayer> teamPlayerMap;
     private CancellableTask refreshTask;
-    private PlayerInfoListener tabListener;
+    private final PlayerInfoListener tabListener;
 
     public TeamTagManagerImpl(NameplateManager manager) {
         this.manager = manager;
@@ -84,11 +85,12 @@ public class TeamTagManagerImpl implements TeamTagManager {
         ProtocolLibrary.getProtocolManager().removePacketListener(tabListener);
     }
 
+    @NotNull
     @Override
     @SuppressWarnings("DuplicatedCode")
     public TeamPlayer createTagForPlayer(Player player, String prefix, String suffix) {
         if (this.teamPlayerMap.containsKey(player.getUniqueId())) {
-            return null;
+            return this.teamPlayerMap.get(player.getUniqueId());
         }
 
         var teamPlayer = new TeamPlayer(this, player, prefix, suffix);

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/nameplate/tag/unlimited/DynamicTextEntityImpl.java

@@ -26,6 +26,8 @@ import net.momirealms.customnameplates.api.mechanic.tag.unlimited.DynamicTextEnt
 import net.momirealms.customnameplates.api.requirement.Condition;
 import net.momirealms.customnameplates.api.requirement.Requirement;
 import net.momirealms.customnameplates.paper.mechanic.misc.PacketManager;
+import net.momirealms.customnameplates.paper.setting.CNConfig;
+import net.momirealms.customnameplates.paper.util.DisguiseUtils;
 import net.momirealms.customnameplates.paper.util.FakeEntityUtils;
 import org.bukkit.Location;
 import org.bukkit.entity.EntityType;
@@ -47,6 +49,7 @@ public class DynamicTextEntityImpl implements DynamicTextEntity {
     private final Requirement[] ownerRequirements;
     private final Requirement[] viewerRequirements;
     private final Vector<Player> viewers;
+    private Player[] viewerArray;
     private final int refreshFrequency;
     private final int checkFrequency;
     private int checkTimer;
@@ -71,10 +74,11 @@ public class DynamicTextEntityImpl implements DynamicTextEntity {
         this.viewerRequirements = viewerRequirements;
         this.checkFrequency = checkFrequency;
         this.refreshFrequency = refreshFrequency;
-        this.viewers = new Vector<>();
         this.ownerCanShow = RequirementManager.isRequirementMet(new Condition(owner.getPlayer()), ownerRequirements);
         this.destroyPacket = new PacketContainer(PacketType.Play.Server.ENTITY_DESTROY);
         this.destroyPacket.getIntLists().write(0, List.of(entityId));
+        this.viewers = new Vector<>();
+        this.viewersToArray();
     }
 
     @Override
@@ -116,21 +120,7 @@ public class DynamicTextEntityImpl implements DynamicTextEntity {
         checkTimer++;
         if (checkTimer >= checkFrequency) {
             checkTimer = 0;
-            if (!RequirementManager.isRequirementMet(new Condition(owner.getPlayer()), ownerRequirements)) {
-                ownerCanShow = false;
-                for (Player all : owner.getNearbyPlayers()) {
-                    removePlayerFromViewers(all);
-                }
-            } else {
-                ownerCanShow = true;
-                for (Player all : owner.getNearbyPlayers()) {
-                    if (canSee(all)) {
-                        addPlayerToViewers(all);
-                    } else {
-                        removePlayerFromViewers(all);
-                    }
-                }
-            }
+            updateVisibility();
         }
 
         refreshTimer++;
@@ -141,12 +131,32 @@ public class DynamicTextEntityImpl implements DynamicTextEntity {
         }
     }
 
+    @Override
+    public void updateVisibility() {
+        if (!RequirementManager.isRequirementMet(new Condition(owner.getPlayer()), ownerRequirements)) {
+            ownerCanShow = false;
+            for (Player all : owner.getNearbyPlayers()) {
+                removePlayerFromViewers(all);
+            }
+        } else {
+            ownerCanShow = true;
+            for (Player all : owner.getNearbyPlayers()) {
+                if (canSee(all)) {
+                    addPlayerToViewers(all);
+                } else {
+                    removePlayerFromViewers(all);
+                }
+            }
+        }
+    }
+
     @Override
     public void removePlayerFromViewers(Player player) {
         if (!viewers.contains(player)) {
             return;
         }
         this.viewers.remove(player);
+        viewersToArray();
         destroy(player);
     }
 
@@ -156,6 +166,7 @@ public class DynamicTextEntityImpl implements DynamicTextEntity {
             return;
         }
         this.viewers.add(player);
+        viewersToArray();
         spawn(player, owner.getPlayer().getPose());
     }
 
@@ -168,7 +179,7 @@ public class DynamicTextEntityImpl implements DynamicTextEntity {
     public void setOffset(double offset) {
         if (yOffset == offset) return;
         yOffset = offset;
-        for (Player all : viewers) {
+        for (Player all : viewerArray) {
             PacketManager.getInstance().send(all, getTeleportPacket(0));
         }
     }
@@ -187,18 +198,19 @@ public class DynamicTextEntityImpl implements DynamicTextEntity {
 
     @Override
     public void spawn(Pose pose) {
-        for (Player all : viewers) {
+        for (Player all : viewerArray) {
             spawn(all, pose);
         }
     }
 
     @Override
     public void destroy() {
-        for (Player all : viewers) {
+        for (Player all : viewerArray) {
             PacketManager.getInstance().send(all, destroyPacket);
         }
         viewerText.clear();
         viewers.clear();
+        viewersToArray();
     }
 
     @Override
@@ -210,15 +222,15 @@ public class DynamicTextEntityImpl implements DynamicTextEntity {
     @Override
     public void teleport(double x, double y, double z, boolean onGround) {
         PacketContainer packet = getTeleportPacket(x, y, z, onGround);
-        for (Player all : viewers) {
+        for (Player all : viewerArray) {
             PacketManager.getInstance().send(all, packet);
         }
     }
 
     @Override
     public void teleport() {
-        PacketContainer packet = getTeleportPacket(getCorrection(owner.getPlayer().getPose()));
-        for (Player viewer : viewers) {
+        PacketContainer packet = getTeleportPacket(getPlayerHeight());
+        for (Player viewer : viewerArray) {
             PacketManager.getInstance().send(viewer, packet);
         }
     }
@@ -233,7 +245,7 @@ public class DynamicTextEntityImpl implements DynamicTextEntity {
     @Override
     public void setSneak(boolean isSneaking, boolean onGround) {
         if (!onGround) {
-            for (Player viewer : viewers) {
+            for (Player viewer : viewerArray) {
                 PacketManager.getInstance().send(viewer, FakeEntityUtils.getMetaPacket(entityId, viewerText.getLatestValue(viewer), isSneaking));
             }
         }
@@ -247,7 +259,7 @@ public class DynamicTextEntityImpl implements DynamicTextEntity {
     @Override
     public void move(short x, short y, short z, boolean onGround) {
         PacketContainer packet = getMovePacket(x, y, z, onGround);
-        for (Player viewer : viewers) {
+        for (Player viewer : viewerArray) {
             PacketManager.getInstance().send(viewer, packet);
         }
     }
@@ -268,14 +280,14 @@ public class DynamicTextEntityImpl implements DynamicTextEntity {
 
     @Override
     public void respawn(Pose pose) {
-        for (Player viewer : viewers) {
+        for (Player viewer : viewerArray) {
             respawn(viewer, pose);
         }
     }
 
     @Override
     public void updateText() {
-        for (Player viewer : viewers) {
+        for (Player viewer : viewerArray) {
             updateText(viewer);
         }
     }
@@ -296,7 +308,7 @@ public class DynamicTextEntityImpl implements DynamicTextEntity {
     public void handlePose(Pose previous, Pose pose) {
         // Add delay to prevent the tag from appearing earlier
         CustomNameplatesPlugin.get().getScheduler().runTaskAsyncLater(() -> {
-            for (Player viewer : viewers) {
+            for (Player viewer : viewerArray) {
                 respawn(viewer, pose);
             }
         }, 20, TimeUnit.MILLISECONDS);
@@ -316,7 +328,7 @@ public class DynamicTextEntityImpl implements DynamicTextEntity {
         PacketContainer packet = new PacketContainer(PacketType.Play.Server.ENTITY_TELEPORT);
         packet.getIntegers().write(0, entityId);
         packet.getDoubles().write(0, x);
-        packet.getDoubles().write(1, y + owner.getHatOffset() + getCorrection(owner.getPlayer().getPose()) + yOffset);
+        packet.getDoubles().write(1, y + owner.getHatOffset() + getPlayerHeight() + yOffset);
         packet.getDoubles().write(2, z);
         packet.getBooleans().write(0, onGround);
         return packet;
@@ -332,14 +344,14 @@ public class DynamicTextEntityImpl implements DynamicTextEntity {
         return packet;
     }
 
-    private Location getEntityLocation(double correction) {
+    private Location getEntityLocation(double playerHeight) {
         var player = owner.getPlayer();
         double x = player.getLocation().getX();
         double y = player.getLocation().getY();
         double z = player.getLocation().getZ();
         y += yOffset;
         y += owner.getHatOffset();
-        y += correction;
+        y += playerHeight;
         return new Location(null, x, y, z);
     }
 
@@ -348,7 +360,7 @@ public class DynamicTextEntityImpl implements DynamicTextEntity {
         entityPacket.getModifier().write(0, entityId);
         entityPacket.getModifier().write(1, uuid);
         entityPacket.getEntityTypeModifier().write(0, EntityType.ARMOR_STAND);
-        Location location = getEntityLocation(getCorrection(pose));
+        Location location = getEntityLocation(getPlayerHeight());
         entityPacket.getDoubles().write(0, location.getX());
         entityPacket.getDoubles().write(1, location.getY());
         entityPacket.getDoubles().write(2, location.getZ());
@@ -356,13 +368,14 @@ public class DynamicTextEntityImpl implements DynamicTextEntity {
         return new PacketContainer[] {entityPacket, metaPacket};
     }
 
-    private double getCorrection(Pose pose) {
-        return switch (pose) {
-            case STANDING -> 1.8;
-            case SNEAKING -> 1.5;
-            case SLEEPING -> 0.2;
-            case SWIMMING, FALL_FLYING, SPIN_ATTACK -> 0.55;
-            default -> 0;
-        };
+    private double getPlayerHeight() {
+        if (CNConfig.hasLibsDisguise && DisguiseUtils.isDisguised(owner.getPlayer()) && DisguiseUtils.getDisguisedType(owner.getPlayer()) != EntityType.PLAYER) {
+            return DisguiseUtils.getDisguisedHeight(owner.getPlayer());
+        }
+        return owner.getPlayer().getHeight();
+    }
+
+    private void viewersToArray() {
+        viewerArray = viewers.toArray(new Player[0]);
     }
 }

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/nameplate/tag/unlimited/StaticTextEntityImpl.java

@@ -23,6 +23,8 @@ import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
 import net.momirealms.customnameplates.api.mechanic.tag.unlimited.NearbyRule;
 import net.momirealms.customnameplates.api.mechanic.tag.unlimited.StaticTextEntity;
 import net.momirealms.customnameplates.paper.mechanic.misc.PacketManager;
+import net.momirealms.customnameplates.paper.setting.CNConfig;
+import net.momirealms.customnameplates.paper.util.DisguiseUtils;
 import net.momirealms.customnameplates.paper.util.FakeEntityUtils;
 import org.bukkit.Location;
 import org.bukkit.entity.EntityType;
@@ -42,11 +44,12 @@ public class StaticTextEntityImpl implements StaticTextEntity {
     private double yOffset;
     private final int entityId;
     private final Vector<Player> viewers;
+    private Player[] viewerArray;
     private final ConcurrentHashMap<UUID, String> textCache;
     private final NearbyRule comeRule;
     private final NearbyRule leaveRule;
     private String defaultText;
-    private final String plugin;
+    private final String id;
     private final PacketContainer destroyPacket;
 
     public StaticTextEntityImpl (
@@ -55,7 +58,7 @@ public class StaticTextEntityImpl implements StaticTextEntity {
             NearbyRule comeRule,
             NearbyRule leaveRule,
             String defaultText,
-            String plugin
+            String id
     ) {
         this.entityId = FakeEntityUtils.getAndIncrease();
         this.owner = owner;
@@ -65,14 +68,15 @@ public class StaticTextEntityImpl implements StaticTextEntity {
         this.comeRule = comeRule;
         this.leaveRule = leaveRule;
         this.defaultText = defaultText;
-        this.plugin = plugin;
+        this.id = id;
         this.destroyPacket = new PacketContainer(PacketType.Play.Server.ENTITY_DESTROY);
         this.destroyPacket.getIntLists().write(0, List.of(entityId));
+        this.viewersToArray();
     }
 
     @Override
-    public String getPlugin() {
-        return plugin;
+    public String getID() {
+        return id;
     }
 
     @Override
@@ -109,6 +113,7 @@ public class StaticTextEntityImpl implements StaticTextEntity {
             return;
         }
         this.viewers.remove(player);
+        viewersToArray();
         destroy(player);
     }
 
@@ -118,6 +123,7 @@ public class StaticTextEntityImpl implements StaticTextEntity {
             return;
         }
         this.viewers.add(player);
+        viewersToArray();
         spawn(player, owner.getEntity().getPose());
     }
 
@@ -130,7 +136,7 @@ public class StaticTextEntityImpl implements StaticTextEntity {
     public void setOffset(double offset) {
         if (yOffset == offset) return;
         yOffset = offset;
-        for (Player all : viewers) {
+        for (Player all : viewerArray) {
             PacketManager.getInstance().send(all, getTeleportPacket());
         }
     }
@@ -139,7 +145,7 @@ public class StaticTextEntityImpl implements StaticTextEntity {
     public void setText(String text) {
         if (text.equals(defaultText)) return;
         this.defaultText = text;
-        for (Player viewer : viewers) {
+        for (Player viewer : viewerArray) {
             PacketManager.getInstance().send(viewer, FakeEntityUtils.getMetaPacket(entityId, getText(viewer), owner.getEntity().isSneaking()));
         }
     }
@@ -174,11 +180,12 @@ public class StaticTextEntityImpl implements StaticTextEntity {
 
     @Override
     public void destroy() {
-        for (Player all : viewers) {
+        for (Player all : viewerArray) {
             PacketManager.getInstance().send(all, destroyPacket);
         }
         viewers.clear();
         textCache.clear();
+        viewersToArray();
     }
 
     @Override
@@ -190,7 +197,7 @@ public class StaticTextEntityImpl implements StaticTextEntity {
     @Override
     public void teleport(double x, double y, double z, boolean onGround) {
         PacketContainer packet = getTeleportPacket(x, y, z, onGround);
-        for (Player all : viewers) {
+        for (Player all : viewerArray) {
             PacketManager.getInstance().send(all, packet);
         }
     }
@@ -205,7 +212,7 @@ public class StaticTextEntityImpl implements StaticTextEntity {
     @Override
     public void teleport() {
         PacketContainer packet = getTeleportPacket();
-        for (Player viewer : viewers) {
+        for (Player viewer : viewerArray) {
             PacketManager.getInstance().send(viewer, packet);
         }
     }
@@ -218,7 +225,7 @@ public class StaticTextEntityImpl implements StaticTextEntity {
     @Override
     public void move(short x, short y, short z, boolean onGround) {
         PacketContainer packet = getMovePacket(x, y, z, onGround);
-        for (Player viewer : viewers) {
+        for (Player viewer : viewerArray) {
             PacketManager.getInstance().send(viewer, packet);
         }
     }
@@ -239,7 +246,7 @@ public class StaticTextEntityImpl implements StaticTextEntity {
 
     @Override
     public void respawn(Pose pose) {
-        for (Player viewer : viewers) {
+        for (Player viewer : viewerArray) {
             respawn(viewer, pose);
         }
     }
@@ -253,12 +260,21 @@ public class StaticTextEntityImpl implements StaticTextEntity {
     public void handlePose(Pose previous, Pose pose) {
         // Add delay to prevent the tag from appearing earlier
         CustomNameplatesPlugin.get().getScheduler().runTaskAsyncLater(() -> {
-            for (Player viewer : viewers) {
+            for (Player viewer : viewerArray) {
                 respawn(viewer, pose);
             }
         }, 20, TimeUnit.MILLISECONDS);
     }
 
+    @Override
+    public void setSneak(boolean isSneaking, boolean onGround) {
+        if (!onGround) {
+            for (Player viewer : viewerArray) {
+                PacketManager.getInstance().send(viewer, FakeEntityUtils.getMetaPacket(entityId, getText(viewer), isSneaking));
+            }
+        }
+    }
+
     public PacketContainer getMovePacket(short x, short y, short z, boolean onGround) {
         PacketContainer packet = new PacketContainer(PacketType.Play.Server.REL_ENTITY_MOVE);
         packet.getIntegers().write(0, entityId);
@@ -273,7 +289,7 @@ public class StaticTextEntityImpl implements StaticTextEntity {
         PacketContainer packet = new PacketContainer(PacketType.Play.Server.ENTITY_TELEPORT);
         packet.getIntegers().write(0, entityId);
         packet.getDoubles().write(0, x);
-        packet.getDoubles().write(1, y + yOffset);
+        packet.getDoubles().write(1, y + ((owner instanceof UnlimitedPlayer player) ? player.getHatOffset() : 0) + getCorrection() + yOffset);
         packet.getDoubles().write(2, z);
         packet.getBooleans().write(0, onGround);
         return packet;
@@ -295,6 +311,8 @@ public class StaticTextEntityImpl implements StaticTextEntity {
         double y = entity.getLocation().getY();
         double z = entity.getLocation().getZ();
         y += yOffset;
+        if (owner instanceof UnlimitedPlayer player) y += player.getHatOffset();
+        y += getCorrection();
         return new Location(null, x, y, z);
     }
 
@@ -305,9 +323,21 @@ public class StaticTextEntityImpl implements StaticTextEntity {
         entityPacket.getEntityTypeModifier().write(0, EntityType.ARMOR_STAND);
         Location location = getEntityLocation();
         entityPacket.getDoubles().write(0, location.getX());
-        entityPacket.getDoubles().write(1, location.getY() + (pose == Pose.SNEAKING ? -0.3 : 0));
+        entityPacket.getDoubles().write(1, location.getY());
         entityPacket.getDoubles().write(2, location.getZ());
         PacketContainer metaPacket = FakeEntityUtils.getMetaPacket(entityId, text, pose == Pose.SNEAKING);
         return new PacketContainer[] {entityPacket, metaPacket};
     }
+
+    private double getCorrection() {
+        double height = owner.getEntity().getHeight();
+        if (CNConfig.hasLibsDisguise && DisguiseUtils.isDisguised(owner.getEntity()) && DisguiseUtils.getDisguisedType(owner.getEntity()) != EntityType.PLAYER) {
+            height = DisguiseUtils.getDisguisedHeight(owner.getEntity());
+        }
+        return height - 1.8;
+    }
+
+    private void viewersToArray() {
+        viewerArray = viewers.toArray(new Player[0]);
+    }
 }

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/nameplate/tag/unlimited/UnlimitedEntity.java

@@ -26,6 +26,8 @@ import org.bukkit.entity.Entity;
 import org.bukkit.entity.Player;
 import org.bukkit.entity.Pose;
 
+import java.util.ArrayList;
+import java.util.Collection;
 import java.util.Vector;
 
 public class UnlimitedEntity implements EntityTagEntity {
@@ -33,21 +35,25 @@ public class UnlimitedEntity implements EntityTagEntity {
     protected final UnlimitedTagManagerImpl manager;
     protected final Entity entity;
     protected final Vector<Player> nearbyPlayers;
+    protected Player[] nearbyPlayerArray;
     protected final Vector<StaticTextEntity> staticTags;
+    protected StaticTextEntity[] staticTagArray;
 
     public UnlimitedEntity(UnlimitedTagManagerImpl manager, Entity entity) {
         this.manager = manager;
         this.entity = entity;
         this.nearbyPlayers = new Vector<>();
         this.staticTags = new Vector<>();
+        staticTagVectorToArray();
+        playerVectorToArray();
     }
 
     public Entity getEntity() {
         return entity;
     }
 
-    public Vector<Player> getNearbyPlayers() {
-        return nearbyPlayers;
+    public Player[] getNearbyPlayers() {
+        return nearbyPlayerArray;
     }
 
     public void addNearbyPlayerNaturally(Player player) {
@@ -55,7 +61,8 @@ public class UnlimitedEntity implements EntityTagEntity {
             return;
         }
         nearbyPlayers.add(player);
-        for (StaticTextEntity tag : staticTags) {
+        playerVectorToArray();
+        for (StaticTextEntity tag : staticTagArray) {
             if (tag.getComeRule().isPassed(player, entity)) {
                 tag.addPlayerToViewers(player);
             }
@@ -67,7 +74,8 @@ public class UnlimitedEntity implements EntityTagEntity {
             return;
         }
         nearbyPlayers.remove(player);
-        for (StaticTextEntity tag : staticTags) {
+        playerVectorToArray();
+        for (StaticTextEntity tag : staticTagArray) {
             if (tag.getLeaveRule().isPassed(player, entity)) {
                 tag.removePlayerFromViewers(player);
             }
@@ -91,8 +99,11 @@ public class UnlimitedEntity implements EntityTagEntity {
             return;
         }
         staticTags.add(tag);
+        staticTagVectorToArray();
         for (Player all : nearbyPlayers) {
-            tag.addPlayerToViewers(all);
+            if (tag.getComeRule().isPassed(all, entity)) {
+                tag.addPlayerToViewers(all);
+            }
         }
     }
 
@@ -107,12 +118,13 @@ public class UnlimitedEntity implements EntityTagEntity {
     public void removeTag(StaticTextEntity tag) {
         if (staticTags.remove(tag)) {
             tag.destroy();
+            staticTagVectorToArray();
         }
     }
 
     @Override
-    public Vector<StaticTextEntity> getStaticTags() {
-        return staticTags;
+    public Collection<StaticTextEntity> getStaticTags() {
+        return new ArrayList<>(staticTags);
     }
 
     @Override
@@ -121,7 +133,8 @@ public class UnlimitedEntity implements EntityTagEntity {
             return;
         }
         nearbyPlayers.add(player);
-        for (StaticTextEntity tag : staticTags) {
+        playerVectorToArray();
+        for (StaticTextEntity tag : staticTagArray) {
             tag.addPlayerToViewers(player);
         }
     }
@@ -132,32 +145,32 @@ public class UnlimitedEntity implements EntityTagEntity {
             return;
         }
         nearbyPlayers.remove(player);
-        for (StaticTextEntity tag : staticTags) {
+        playerVectorToArray();
+        for (StaticTextEntity tag : staticTagArray) {
             tag.removePlayerFromViewers(player);
         }
     }
 
-
     public void move(Player receiver, short x, short y, short z, boolean onGround) {
-        for (StaticTextEntity tag : staticTags) {
+        for (StaticTextEntity tag : staticTagArray) {
             tag.move(receiver, x, y, z, onGround);
         }
     }
 
     public void teleport(Player receiver, double x, double y, double z, boolean onGround) {
-        for (StaticTextEntity tag : staticTags) {
+        for (StaticTextEntity tag : staticTagArray) {
             tag.teleport(receiver, x, y, z, onGround);
         }
     }
 
     public void teleport() {
-        for (StaticTextEntity tag : staticTags) {
+        for (StaticTextEntity tag : staticTagArray) {
             tag.teleport();
         }
     }
 
     public void handlePose(Pose previous, Pose pose) {
-        for (StaticTextEntity tag : staticTags) {
+        for (StaticTextEntity tag : staticTagArray) {
             tag.handlePose(previous, pose);
         }
     }
@@ -165,16 +178,44 @@ public class UnlimitedEntity implements EntityTagEntity {
     @Override
     public void destroy() {
         manager.removeUnlimitedEntityFromMap(entity.getUniqueId());
-        for (StaticTextEntity tag : staticTags) {
+        for (StaticTextEntity tag : staticTagArray) {
             tag.destroy();
         }
         nearbyPlayers.clear();
         staticTags.clear();
+        staticTagArray = null;
+        nearbyPlayerArray = null;
     }
 
     public void respawn() {
-        for (StaticTextEntity tag : staticTags) {
+        for (StaticTextEntity tag : staticTagArray) {
             tag.respawn(entity.getPose());
         }
     }
+
+    protected void staticTagVectorToArray() {
+        staticTagArray = staticTags.toArray(new StaticTextEntity[0]);
+    }
+
+    protected void playerVectorToArray() {
+        nearbyPlayerArray = nearbyPlayers.toArray(new Player[0]);
+    }
+
+    public void setVisibility(boolean visible) {
+        if (!visible) {
+            for (StaticTextEntity tag : staticTagArray) {
+                for (Player player : nearbyPlayerArray) {
+                    tag.removePlayerFromViewers(player);
+                }
+            }
+        } else {
+            for (StaticTextEntity tag : staticTagArray) {
+                for (Player player : nearbyPlayerArray) {
+                    if (tag.getComeRule().isPassed(player, entity)) {
+                        tag.addPlayerToViewers(player);
+                    }
+                }
+            }
+        }
+    }
 }

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/nameplate/tag/unlimited/UnlimitedPlayer.java

@@ -18,32 +18,31 @@
 package net.momirealms.customnameplates.paper.mechanic.nameplate.tag.unlimited;
 
 import net.momirealms.customnameplates.api.CustomNameplatesPlugin;
+import net.momirealms.customnameplates.api.mechanic.nameplate.TagMode;
 import net.momirealms.customnameplates.api.mechanic.tag.unlimited.*;
 import net.momirealms.customnameplates.common.team.TeamColor;
 import net.momirealms.customnameplates.common.team.TeamTagVisibility;
+import net.momirealms.customnameplates.paper.setting.CNConfig;
 import org.bukkit.entity.Player;
 import org.bukkit.entity.Pose;
 
+import java.util.ArrayList;
+import java.util.Collection;
 import java.util.Vector;
 
 public class UnlimitedPlayer extends UnlimitedEntity implements EntityTagPlayer {
 
     private final Player owner;
     private final Vector<DynamicTextEntity> dynamicTags;
+    private DynamicTextEntity[] dynamicTagArray;
     private double hatOffset;
     private boolean isPreviewing;
-    private boolean manageTeams;
 
     public UnlimitedPlayer(UnlimitedTagManagerImpl manager, Player player) {
         super(manager, player);
         this.owner = player;
         this.dynamicTags = new Vector<>();
-        this.manageTeams = false;
-    }
-
-    @Override
-    public void setManageTeams(boolean manageTeams) {
-        this.manageTeams = manageTeams;
+        this.dynamicTagVectorToArray();
     }
 
     @Override
@@ -52,7 +51,8 @@ public class UnlimitedPlayer extends UnlimitedEntity implements EntityTagPlayer
             return;
         }
         dynamicTags.add(tag);
-        for (Player all : nearbyPlayers) {
+        dynamicTagVectorToArray();
+        for (Player all : getNearbyPlayers()) {
             if (tag.canShow() && tag.canSee(all)) {
                 tag.addPlayerToViewers(all);
             }
@@ -65,8 +65,11 @@ public class UnlimitedPlayer extends UnlimitedEntity implements EntityTagPlayer
             return;
         }
         staticTags.add(tag);
-        for (Player all : nearbyPlayers) {
-            tag.addPlayerToViewers(all);
+        staticTagVectorToArray();
+        for (Player all : getNearbyPlayers()) {
+            if (tag.getComeRule().isPassed(all, owner)) {
+                tag.addPlayerToViewers(all);
+            }
         }
     }
 
@@ -88,19 +91,13 @@ public class UnlimitedPlayer extends UnlimitedEntity implements EntityTagPlayer
     public void removeTag(DynamicTextEntity tag) {
         if (dynamicTags.remove(tag)) {
             tag.destroy();
+            dynamicTagVectorToArray();
         }
     }
 
     @Override
-    public void removeTag(StaticTextEntity tag) {
-        if (staticTags.remove(tag)) {
-            tag.destroy();
-        }
-    }
-
-    @Override
-    public Vector<DynamicTextEntity> getDynamicTags() {
-        return dynamicTags;
+    public Collection<DynamicTextEntity> getDynamicTags() {
+        return new ArrayList<>(dynamicTags);
     }
 
     @Override
@@ -133,7 +130,7 @@ public class UnlimitedPlayer extends UnlimitedEntity implements EntityTagPlayer
 
     @Override
     public void updateText() {
-        for (DynamicTextEntity tag : dynamicTags) {
+        for (DynamicTextEntity tag : dynamicTagArray) {
             tag.updateText();
         }
     }
@@ -149,13 +146,14 @@ public class UnlimitedPlayer extends UnlimitedEntity implements EntityTagPlayer
             return;
         }
         nearbyPlayers.add(player);
+        playerVectorToArray();
         setNameInvisibleFor(player);
-        for (StaticTextEntity tag : staticTags) {
+        for (StaticTextEntity tag : staticTagArray) {
             if (tag.getComeRule().isPassed(player, entity)) {
                 tag.addPlayerToViewers(player);
             }
         }
-        for (DynamicTextEntity tag : dynamicTags) {
+        for (DynamicTextEntity tag : dynamicTagArray) {
             if (tag.canShow() && tag.canSee(player)) {
                 tag.addPlayerToViewers(player);
             }
@@ -167,14 +165,15 @@ public class UnlimitedPlayer extends UnlimitedEntity implements EntityTagPlayer
         if (!nearbyPlayers.contains(player)) {
             return;
         }
-        super.nearbyPlayers.remove(player);
+        nearbyPlayers.remove(player);
+        playerVectorToArray();
         setNameVisibleFor(player);
-        for (StaticTextEntity tag : staticTags) {
+        for (StaticTextEntity tag : staticTagArray) {
             if (tag.getLeaveRule().isPassed(player, entity)) {
                 tag.removePlayerFromViewers(player);
             }
         }
-        for (DynamicTextEntity tag : dynamicTags) {
+        for (DynamicTextEntity tag : dynamicTagArray) {
             tag.removePlayerFromViewers(player);
         }
     }
@@ -182,22 +181,26 @@ public class UnlimitedPlayer extends UnlimitedEntity implements EntityTagPlayer
     @Override
     public void destroy() {
         manager.removeUnlimitedEntityFromMap(entity.getUniqueId());
-        for (Player viewer : nearbyPlayers) {
+        for (Player viewer : getNearbyPlayers()) {
             setNameVisibleFor(viewer);
         }
-        for (DynamicTextEntity tag : dynamicTags) {
+        for (DynamicTextEntity tag : dynamicTagArray) {
             tag.destroy();
         }
-        for (StaticTextEntity tag : staticTags) {
+        for (StaticTextEntity tag : staticTagArray) {
             tag.destroy();
         }
         nearbyPlayers.clear();
         dynamicTags.clear();
         staticTags.clear();
+        staticTagArray = null;
     }
 
     public void sneak(boolean sneaking, boolean flying) {
-        for (DynamicTextEntity tag : dynamicTags) {
+        for (StaticTextEntity tag : staticTagArray) {
+            tag.setSneak(sneaking, !flying);
+        }
+        for (DynamicTextEntity tag : dynamicTagArray) {
             tag.setSneak(sneaking, !flying);
         }
     }
@@ -205,7 +208,7 @@ public class UnlimitedPlayer extends UnlimitedEntity implements EntityTagPlayer
     @Override
     public void respawn() {
         super.respawn();
-        for (DynamicTextEntity tag : dynamicTags) {
+        for (DynamicTextEntity tag : dynamicTagArray) {
             tag.respawn(owner.getPose());
         }
     }
@@ -213,7 +216,7 @@ public class UnlimitedPlayer extends UnlimitedEntity implements EntityTagPlayer
     @Override
     public void move(Player receiver, short x, short y, short z, boolean onGround) {
         super.move(receiver, x, y, z, onGround);
-        for (DynamicTextEntity tag : dynamicTags) {
+        for (DynamicTextEntity tag : dynamicTagArray) {
             tag.move(receiver, x, y, z, onGround);
         }
     }
@@ -221,7 +224,7 @@ public class UnlimitedPlayer extends UnlimitedEntity implements EntityTagPlayer
     @Override
     public void teleport(Player receiver, double x, double y, double z, boolean onGround) {
         super.teleport(receiver, x, y, z, onGround);
-        for (DynamicTextEntity tag : dynamicTags) {
+        for (DynamicTextEntity tag : dynamicTagArray) {
             tag.teleport(receiver, x, y, z, onGround);
         }
     }
@@ -229,7 +232,7 @@ public class UnlimitedPlayer extends UnlimitedEntity implements EntityTagPlayer
     @Override
     public void teleport() {
         super.teleport();
-        for (DynamicTextEntity tag : dynamicTags) {
+        for (DynamicTextEntity tag : dynamicTagArray) {
             tag.teleport();
         }
     }
@@ -237,38 +240,50 @@ public class UnlimitedPlayer extends UnlimitedEntity implements EntityTagPlayer
     @Override
     public void handlePose(Pose previous, Pose pose) {
         super.handlePose(previous, pose);
-        for (DynamicTextEntity tag : dynamicTags) {
+        for (DynamicTextEntity tag : dynamicTagArray) {
             tag.handlePose(previous, pose);
         }
     }
 
     private void setNameInvisibleFor(Player viewer) {
-        if (!manageTeams) return;
-        CustomNameplatesPlugin.get().getTeamManager().updateTeam(
-                owner,
-                viewer,
-                "",
-               "",
-                TeamColor.WHITE,
-                TeamTagVisibility.NEVER
-        );
+        if (CNConfig.nameplateModule && CustomNameplatesPlugin.get().getNameplateManager().getTagMode() == TagMode.UNLIMITED) {
+            CustomNameplatesPlugin.get().getTeamManager().updateTeam(
+                    owner,
+                    viewer,
+                    "",
+                    "",
+                    TeamColor.WHITE,
+                    TeamTagVisibility.NEVER
+            );
+        }
     }
 
     private void setNameVisibleFor(Player viewer) {
-        if (!manageTeams) return;
-        CustomNameplatesPlugin.get().getTeamManager().updateTeam(
-                owner,
-                viewer,
-                "",
-               "",
-                TeamColor.WHITE,
-                TeamTagVisibility.ALWAYS
-        );
+        if (CNConfig.nameplateModule && CustomNameplatesPlugin.get().getNameplateManager().getTagMode() == TagMode.UNLIMITED) {
+            CustomNameplatesPlugin.get().getTeamManager().updateTeam(
+                    owner,
+                    viewer,
+                    "",
+                   "",
+                    TeamColor.WHITE,
+                    TeamTagVisibility.ALWAYS
+            );
+        }
     }
 
     public void timer() {
-        for (DynamicTextEntity tag : dynamicTags) {
+        for (DynamicTextEntity tag : dynamicTagArray) {
             tag.timer();
         }
     }
+
+    public void updateVisibility() {
+        for (DynamicTextEntity tag : dynamicTagArray) {
+            tag.updateVisibility();
+        }
+    }
+
+    private void dynamicTagVectorToArray() {
+        dynamicTagArray = dynamicTags.toArray(new DynamicTextEntity[0]);
+    }
 }

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/nameplate/tag/unlimited/UnlimitedTagManagerImpl.java

@@ -24,8 +24,10 @@ import net.momirealms.customnameplates.api.mechanic.misc.ViewerText;
 import net.momirealms.customnameplates.api.mechanic.tag.unlimited.*;
 import net.momirealms.customnameplates.api.scheduler.CancellableTask;
 import net.momirealms.customnameplates.api.util.LogUtils;
+import net.momirealms.customnameplates.paper.mechanic.nameplate.tag.listener.DisguiseListener;
 import net.momirealms.customnameplates.paper.mechanic.nameplate.tag.listener.MagicCosmeticsListener;
 import org.bukkit.Bukkit;
+import org.bukkit.GameMode;
 import org.bukkit.entity.Entity;
 import org.bukkit.entity.Player;
 import org.bukkit.entity.Pose;
@@ -44,6 +46,7 @@ public class UnlimitedTagManagerImpl implements UnlimitedTagManager {
     private final ConcurrentHashMap<UUID, UnlimitedEntity> unlimitedEntityMap;
     private CancellableTask refreshTask;
     private MagicCosmeticsListener magicCosmeticsListener;
+    private DisguiseListener disguiseListener;
     private final VehicleChecker vehicleChecker;
 
     public UnlimitedTagManagerImpl(NameplateManager nameplateManager) {
@@ -53,6 +56,9 @@ public class UnlimitedTagManagerImpl implements UnlimitedTagManager {
         if (Bukkit.getPluginManager().getPlugin("MagicCosmetics") != null) {
             this.magicCosmeticsListener = new MagicCosmeticsListener(this);
         }
+        if (Bukkit.getPluginManager().getPlugin("LibsDisguises") != null) {
+            this.disguiseListener = new DisguiseListener(this);
+        }
     }
     
     public void load() {
@@ -82,6 +88,9 @@ public class UnlimitedTagManagerImpl implements UnlimitedTagManager {
         if (this.magicCosmeticsListener != null) {
             Bukkit.getPluginManager().registerEvents(magicCosmeticsListener, CustomNameplatesPlugin.get());
         }
+        if (this.disguiseListener != null) {
+            Bukkit.getPluginManager().registerEvents(disguiseListener, CustomNameplatesPlugin.get());
+        }
     }
     
     public void unload() {
@@ -95,6 +104,9 @@ public class UnlimitedTagManagerImpl implements UnlimitedTagManager {
         if (this.magicCosmeticsListener != null) {
             HandlerList.unregisterAll(magicCosmeticsListener);
         }
+        if (this.disguiseListener != null) {
+            HandlerList.unregisterAll(disguiseListener);
+        }
     }
 
     @NotNull
@@ -106,7 +118,7 @@ public class UnlimitedTagManagerImpl implements UnlimitedTagManager {
                 setting.getComeRule(),
                 setting.getLeaveRule(),
                 setting.getDefaultText(),
-                setting.getPlugin()
+                setting.getID()
         );
     }
 
@@ -126,6 +138,10 @@ public class UnlimitedTagManagerImpl implements UnlimitedTagManager {
 
     @Override
     public UnlimitedEntity createOrGetTagForEntity(Entity entity) {
+        if (entity instanceof Player player) {
+            return createOrGetTagForPlayer(player);
+        }
+
         final UUID uuid = entity.getUniqueId();
         if (this.unlimitedEntityMap.containsKey(uuid)) {
             return this.unlimitedEntityMap.get(uuid);
@@ -156,30 +172,9 @@ public class UnlimitedTagManagerImpl implements UnlimitedTagManager {
                 unlimitedPlayer
         );
 
-        unlimitedPlayer.addNearByPlayerToMap(48);
-        return unlimitedPlayer;
-    }
-
-    @Override
-    @SuppressWarnings("DuplicatedCode")
-    public UnlimitedPlayer createOrGetTagForPlayer(Player player, boolean manageTeam) {
-        if (!player.isOnline())
-            return null;
-        final UUID uuid = player.getUniqueId();
-        if (this.unlimitedEntityMap.containsKey(uuid)) {
-            UnlimitedPlayer unlimitedPlayer = (UnlimitedPlayer) this.unlimitedEntityMap.get(uuid);
-            unlimitedPlayer.setManageTeams(manageTeam);
-            return unlimitedPlayer;
+        if (player.getGameMode() != GameMode.SPECTATOR) {
+            unlimitedPlayer.addNearByPlayerToMap(48);
         }
-
-        var unlimitedPlayer = new UnlimitedPlayer(this, player);
-        this.unlimitedEntityMap.put(
-                uuid,
-                unlimitedPlayer
-        );
-        unlimitedPlayer.setManageTeams(manageTeam);
-
-        unlimitedPlayer.addNearByPlayerToMap(48);
         return unlimitedPlayer;
     }
 
@@ -192,11 +187,21 @@ public class UnlimitedTagManagerImpl implements UnlimitedTagManager {
         return unlimitedEntityMap.get(uuid);
     }
 
+    public void handlePotionEffect(Entity entity, boolean visible) {
+        UnlimitedEntity unlimitedEntity = getUnlimitedObject(entity.getUniqueId());
+        if (unlimitedEntity == null) return;
+        unlimitedEntity.setVisibility(visible);
+        if (unlimitedEntity instanceof UnlimitedPlayer unlimitedPlayer) {
+            CustomNameplatesPlugin.get().getScheduler().runTaskAsyncLater(unlimitedPlayer::updateVisibility, 50, TimeUnit.MILLISECONDS);
+        }
+    }
+
     public void handleEntitySpawnPacket(Player receiver, int entityId) {
         Player spawned = manager.getPlayerByEntityID(entityId);
         if (spawned == null) return;
         UnlimitedEntity unlimitedEntity = getUnlimitedObject(spawned.getUniqueId());
         if (unlimitedEntity == null) return;
+        if (receiver == spawned) return;
         unlimitedEntity.addNearbyPlayerNaturally(receiver);
     }
 

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/pack/ResourcePackManagerImpl.java

@@ -111,6 +111,7 @@ public class ResourcePackManagerImpl implements ResourcePackManager {
     }
 
     private void generateShaders() {
+        if (!CNConfig.enableShader) return;
         String path = "ResourcePack" + File.separator + "assets" + File.separator + "minecraft" + File.separator + "shaders" + File.separator + "core" + File.separator;
         plugin.saveResource(path + "rendertype_text.fsh", true);
         plugin.saveResource(path + "rendertype_text.json", true);
@@ -312,33 +313,42 @@ public class ResourcePackManagerImpl implements ResourcePackManager {
     }
 
     private void copyResourcePackToHookedPlugins(File resourcePackFolder) {
-            Plugin ia = Bukkit.getPluginManager().getPlugin("ItemsAdder");
-            if (ia != null) {
-                File file = new File(ia.getDataFolder(), "config.yml");
-                YamlConfiguration iaConfig = YamlConfiguration.loadConfiguration(file);
-                List<String> folders = iaConfig.getStringList("resource-pack.zip.merge_other_plugins_resourcepacks_folders");
-                boolean changed = false;
-                if (CNConfig.copyPackIA) {
-                    if (!folders.contains("CustomNameplates/ResourcePack")) {
-                        folders.add("CustomNameplates/ResourcePack");
-                        iaConfig.set("resource-pack.zip.merge_other_plugins_resourcepacks_folders", folders);
-                        changed = true;
-                    }
-                } else {
-                    if (folders.contains("CustomNameplates/ResourcePack")) {
-                        folders.remove("CustomNameplates/ResourcePack");
-                        iaConfig.set("resource-pack.zip.merge_other_plugins_resourcepacks_folders", folders);
-                        changed = true;
-                    }
+        Plugin ia = Bukkit.getPluginManager().getPlugin("ItemsAdder");
+        if (ia != null) {
+            File file = new File(ia.getDataFolder(), "config.yml");
+            YamlConfiguration iaConfig = YamlConfiguration.loadConfiguration(file);
+            List<String> folders = iaConfig.getStringList("resource-pack.zip.merge_other_plugins_resourcepacks_folders");
+            boolean changed = false;
+            if (CNConfig.copyPackIA) {
+                if (!folders.contains("CustomNameplates/ResourcePack")) {
+                    folders.add("CustomNameplates/ResourcePack");
+                    iaConfig.set("resource-pack.zip.merge_other_plugins_resourcepacks_folders", folders);
+                    changed = true;
                 }
-                if (changed) {
-                    try {
-                        iaConfig.save(file);
-                    } catch (IOException e) {
-                        e.printStackTrace();
-                    }
+            } else {
+                if (folders.contains("CustomNameplates/ResourcePack")) {
+                    folders.remove("CustomNameplates/ResourcePack");
+                    iaConfig.set("resource-pack.zip.merge_other_plugins_resourcepacks_folders", folders);
+                    changed = true;
                 }
             }
+            if (changed) {
+                try {
+                    iaConfig.save(file);
+                } catch (IOException e) {
+                    e.printStackTrace();
+                }
+            }
+        }
+        if (CNConfig.copyPackIAOld){
+            try {
+                FileUtils.copyDirectory(new File(resourcePackFolder, "assets"), new File(Objects.requireNonNull(Bukkit.getPluginManager().getPlugin("ItemsAdder")).getDataFolder() + File.separator + "contents" + File.separator + "nameplates" + File.separator + "resourcepack" + File.separator + "assets") );
+            }
+            catch (IOException e){
+                e.printStackTrace();
+                LogUtils.warn("Failed to copy files to ItemsAdder...");
+            }
+        }
         if (CNConfig.copyPackOraxen){
             try {
                 FileUtils.copyDirectory(new File(resourcePackFolder, "assets"), new File(Objects.requireNonNull(Bukkit.getPluginManager().getPlugin("Oraxen")).getDataFolder() + File.separator + "pack" + File.separator + "assets"));

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/placeholder/PlaceholderManagerImpl.java

@@ -24,6 +24,7 @@ import net.momirealms.customnameplates.api.mechanic.placeholder.*;
 import net.momirealms.customnameplates.api.requirement.Requirement;
 import net.momirealms.customnameplates.api.util.LogUtils;
 import net.momirealms.customnameplates.common.Pair;
+import net.momirealms.customnameplates.paper.setting.CNConfig;
 import org.bukkit.configuration.ConfigurationSection;
 import org.bukkit.configuration.file.YamlConfiguration;
 import org.jetbrains.annotations.NotNull;
@@ -230,6 +231,7 @@ public class PlaceholderManagerImpl implements PlaceholderManager {
 
             vanillaHudMap.put(entry.getKey(),
                     VanillaHud.builder()
+                            .reverse(innerSection.getBoolean("reverse", true))
                             .half(halfC.getCharacter())
                             .empty(emptyC.getCharacter())
                             .full(fullC.getCharacter())
@@ -241,21 +243,31 @@ public class PlaceholderManagerImpl implements PlaceholderManager {
     }
 
     private void loadBackGroundTexts(ConfigurationSection section) {
+        if (!CNConfig.backgroundModule) return;
         for (Map.Entry<String, Object> entry : section.getValues(false).entrySet()) {
             if (!(entry.getValue() instanceof ConfigurationSection innerSection))
                 continue;
 
-            backGroundTextMap.put(entry.getKey(),
-                    BackGroundText.builder()
-                            .background(Objects.requireNonNull(plugin.getBackGroundManager().getBackGround(innerSection.getString("background"))))
-                            .text(innerSection.getString("text", ""))
-                            .removeShadow(innerSection.getBoolean("remove-shadow"))
-                            .build()
-            );
+            if (innerSection.contains("background")) {
+                String bg = innerSection.getString("background");
+                var background = plugin.getBackGroundManager().getBackGround(bg);
+                if (background == null) {
+                    LogUtils.warn("Background: " + bg + " doesn't exist");
+                    continue;
+                }
+                backGroundTextMap.put(entry.getKey(),
+                        BackGroundText.builder()
+                                .background(background)
+                                .text(innerSection.getString("text", ""))
+                                .removeShadow(innerSection.getBoolean("remove-shadow"))
+                                .build()
+                );
+            }
         }
     }
 
     private void loadNameplateTexts(ConfigurationSection section) {
+        if (!CNConfig.nameplateModule) return;
         for (Map.Entry<String, Object> entry : section.getValues(false).entrySet()) {
             if (!(entry.getValue() instanceof ConfigurationSection innerSection))
                 continue;
@@ -324,7 +336,7 @@ public class PlaceholderManagerImpl implements PlaceholderManager {
                     entry.getKey(),
                     SwitchText.builder()
                             .toParse(Objects.requireNonNull(innerSection.getString("switch")))
-                            .defaultValue(innerSection.getString("default"))
+                            .defaultValue(innerSection.getString("default", ""))
                             .valueMap(valueMap)
                             .build()
             );

paper/src/main/java/net/momirealms/customnameplates/paper/mechanic/placeholder/PluginPlaceholders.java

@@ -119,6 +119,11 @@ public class PluginPlaceholders extends PlaceholderExpansion {
                 if (vanillaHud == null) return "Vanilla text not exists: " + mainArg;
                 return vanillaHud.getValue(offlinePlayer);
             }
+            case "switch" -> {
+                SwitchText switchText = placeholderManager.getSwitchText(mainArg);
+                if (switchText == null) return "Switch text not exists: " + mainArg;
+                return switchText.getValue(offlinePlayer);
+            }
         }
 
         Player onlinePlayer = offlinePlayer.getPlayer();