add passenger condition

api/build.gradle.kts

@@ -23,6 +23,8 @@ dependencies {
     compileOnly("io.netty:netty-all:4.1.113.Final")
     // GSON
     compileOnly("com.google.code.gson:gson:${rootProject.properties["gson_version"]}")
+    // Fast util
+    compileOnly("it.unimi.dsi:fastutil:${rootProject.properties["fastutil_version"]}")
 }
 
 java {

api/src/main/java/net/momirealms/customnameplates/api/AbstractCNPlayer.java

@@ -18,6 +18,11 @@
 package net.momirealms.customnameplates.api;
 
 import io.netty.channel.Channel;
+import it.unimi.dsi.fastutil.ints.Int2ObjectLinkedOpenHashMap;
+import it.unimi.dsi.fastutil.ints.Int2ObjectOpenCustomHashMap;
+import it.unimi.dsi.fastutil.ints.Int2ObjectOpenHashMap;
+import it.unimi.dsi.fastutil.objects.ObjectArrayList;
+import it.unimi.dsi.fastutil.objects.ObjectOpenHashSet;
 import net.momirealms.customnameplates.api.feature.Feature;
 import net.momirealms.customnameplates.api.feature.TimeStampData;
 import net.momirealms.customnameplates.api.feature.tag.TeamView;
@@ -51,11 +56,11 @@ public abstract class AbstractCNPlayer implements CNPlayer {
 
     private final TeamView teamView = new TeamView();
 
-    private final Map<Integer, TimeStampData<String>> cachedValues = new ConcurrentHashMap<>();
-    private final Map<Integer, WeakHashMap<CNPlayer, TimeStampData<String>>> cachedRelationalValues = new ConcurrentHashMap<>();
+    private final Int2ObjectOpenHashMap<TimeStampData<String>> cachedValues = new Int2ObjectOpenHashMap<>(64);
+    private final Int2ObjectOpenHashMap<WeakHashMap<CNPlayer, TimeStampData<String>>> cachedRelationalValues = new Int2ObjectOpenHashMap<>(64);
 
-    private final Map<Requirement, TimeStampData<Boolean>> cachedRequirements = new ConcurrentHashMap<>();
-    private final Map<Requirement, WeakHashMap<CNPlayer, TimeStampData<Boolean>>> cachedRelationalRequirements = new ConcurrentHashMap<>();
+    private final Int2ObjectOpenHashMap<TimeStampData<Boolean>> cachedRequirements = new Int2ObjectOpenHashMap<>(128);
+    private final Int2ObjectOpenHashMap<WeakHashMap<CNPlayer, TimeStampData<Boolean>>> cachedRelationalRequirements = new Int2ObjectOpenHashMap<>(128);
 
     private final Set<Feature> activeFeatures = new CopyOnWriteArraySet<>();
     private final Map<Placeholder, Set<Feature>> placeholder2Features = new ConcurrentHashMap<>();
@@ -71,7 +76,7 @@ public abstract class AbstractCNPlayer implements CNPlayer {
     @Override
     public List<Placeholder> activePlaceholdersToRefresh() {
         Placeholder[] activePlaceholders = activePlaceholders();
-        List<Placeholder> placeholderWithChildren = new ArrayList<>();
+        List<Placeholder> placeholderWithChildren = new ObjectArrayList<>();
         for (Placeholder placeholder : activePlaceholders) {
             childrenFirstList(placeholder, placeholderWithChildren);
         }
@@ -79,9 +84,9 @@ public abstract class AbstractCNPlayer implements CNPlayer {
     }
 
     @Override
-    public void forceUpdatePlaceholders(Set<Placeholder> placeholders, Set<CNPlayer> others) {
+    public void forceUpdatePlaceholders(Set<Placeholder> placeholders, Collection<CNPlayer> others) {
         if (placeholders.isEmpty()) return;
-        List<Placeholder> placeholderWithChildren = new ArrayList<>();
+        List<Placeholder> placeholderWithChildren = new ObjectArrayList<>();
         for (Placeholder placeholder : placeholders) {
             childrenFirstList(placeholder, placeholderWithChildren);
         }
@@ -224,7 +229,7 @@ public abstract class AbstractCNPlayer implements CNPlayer {
         Set<Placeholder> allPlaceholders = feature.allPlaceholders();
         feature2Placeholders.put(feature, allPlaceholders);
         for (Placeholder placeholder : allPlaceholders) {
-            Set<Feature> featureSet = placeholder2Features.computeIfAbsent(placeholder, k -> new HashSet<>());
+            Set<Feature> featureSet = placeholder2Features.computeIfAbsent(placeholder, k -> new ObjectOpenHashSet<>());
             featureSet.add(feature);
         }
     }
@@ -330,7 +335,7 @@ public abstract class AbstractCNPlayer implements CNPlayer {
 
     @Override
     public Placeholder[] activePlaceholders() {
-        HashSet<Placeholder> placeholders = new HashSet<>();
+        Set<Placeholder> placeholders = new ObjectOpenHashSet<>();
         for (Feature feature : activeFeatures) {
             placeholders.addAll(feature.activePlaceholders());
         }
@@ -341,7 +346,7 @@ public abstract class AbstractCNPlayer implements CNPlayer {
     public boolean isMet(Requirement[] requirements) {
         int currentTicks = MainTask.getTicks();
         for (Requirement requirement : requirements) {
-            TimeStampData<Boolean> data = cachedRequirements.get(requirement);
+            TimeStampData<Boolean> data = cachedRequirements.get(requirement.countId());
             if (data != null) {
                 if (data.ticks() + requirement.refreshInterval() > currentTicks) {
                     if (!data.data()) {
@@ -358,7 +363,7 @@ public abstract class AbstractCNPlayer implements CNPlayer {
             } else {
                 boolean satisfied = requirement.isSatisfied(this, this);
                 data = new TimeStampData<>(satisfied, currentTicks, true);
-                cachedRequirements.put(requirement, data);
+                cachedRequirements.put(requirement.countId(), data);
                 if (!satisfied) {
                     return false;
                 }
@@ -371,7 +376,7 @@ public abstract class AbstractCNPlayer implements CNPlayer {
     public boolean isMet(CNPlayer another, Requirement[] requirements) {
         int currentTicks = MainTask.getTicks();
         for (Requirement requirement : requirements) {
-            WeakHashMap<CNPlayer, TimeStampData<Boolean>> innerMap = cachedRelationalRequirements.computeIfAbsent(requirement, k -> new WeakHashMap<>());
+            WeakHashMap<CNPlayer, TimeStampData<Boolean>> innerMap = cachedRelationalRequirements.computeIfAbsent(requirement.countId(), k -> new WeakHashMap<>());
             TimeStampData<Boolean> data = innerMap.get(another);
             if (data != null) {
                 if (data.ticks() + requirement.refreshInterval() > currentTicks) {
@@ -421,8 +426,8 @@ public abstract class AbstractCNPlayer implements CNPlayer {
     }
 
     @Override
-    public Set<CNPlayer> nearbyPlayers() {
-        return new HashSet<>(trackers.keySet());
+    public Collection<CNPlayer> nearbyPlayers() {
+        return new ObjectArrayList<>(trackers.keySet());
     }
 
     @Override
@@ -446,7 +451,7 @@ public abstract class AbstractCNPlayer implements CNPlayer {
 
     @Override
     public Set<Integer> getTrackedPassengerIds(CNPlayer another) {
-        return Optional.ofNullable(trackers.get(another)).map(Tracker::getPassengerIDs).orElse(new HashSet<>());
+        return Optional.ofNullable(trackers.get(another)).map(Tracker::getPassengerIDs).orElse(new ObjectOpenHashSet<>());
     }
 
     @Override

api/src/main/java/net/momirealms/customnameplates/api/CNPlayer.java

@@ -28,6 +28,7 @@ import net.momirealms.customnameplates.api.util.Vector3;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+import java.util.Collection;
 import java.util.List;
 import java.util.Set;
 import java.util.UUID;
@@ -190,7 +191,7 @@ public interface CNPlayer {
      * @param placeholders the placeholders to update
      * @param another      the players related to the placeholders
      */
-    void forceUpdatePlaceholders(Set<Placeholder> placeholders, Set<CNPlayer> another);
+    void forceUpdatePlaceholders(Set<Placeholder> placeholders, Collection<CNPlayer> another);
 
     /**
      * Retrieves the cached data for a given placeholder.
@@ -317,7 +318,7 @@ public interface CNPlayer {
      *
      * @return the set of nearby players
      */
-    Set<CNPlayer> nearbyPlayers();
+    Collection<CNPlayer> nearbyPlayers();
 
     /**
      * Adds passenger entities to the tracker for another player.

api/src/main/java/net/momirealms/customnameplates/api/CustomNameplates.java

@@ -17,6 +17,8 @@
 
 package net.momirealms.customnameplates.api;
 
+import it.unimi.dsi.fastutil.ints.Int2ObjectOpenHashMap;
+import it.unimi.dsi.fastutil.objects.ObjectArrayList;
 import net.momirealms.customnameplates.api.feature.actionbar.ActionBarManager;
 import net.momirealms.customnameplates.api.feature.advance.AdvanceManager;
 import net.momirealms.customnameplates.api.feature.background.BackgroundManager;
@@ -38,10 +40,7 @@ import net.momirealms.customnameplates.common.locale.TranslationManager;
 import net.momirealms.customnameplates.common.plugin.NameplatesPlugin;
 import net.momirealms.customnameplates.common.plugin.scheduler.SchedulerTask;
 
-import java.util.Collection;
-import java.util.HashMap;
-import java.util.HashSet;
-import java.util.UUID;
+import java.util.*;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.function.Consumer;
 import java.util.function.Supplier;
@@ -69,7 +68,7 @@ public abstract class CustomNameplates implements NameplatesPlugin {
     protected MainTask mainTask;
     protected SchedulerTask scheduledMainTask;
     protected ConcurrentHashMap<UUID, CNPlayer> onlinePlayerMap = new ConcurrentHashMap<>();
-    protected HashMap<Integer, CNPlayer> entityIDFastLookup = new HashMap<>();
+    protected Int2ObjectOpenHashMap<CNPlayer> entityIDFastLookup = new Int2ObjectOpenHashMap<>();
     protected AdvanceManager advanceManager;
     protected BackgroundManager backgroundManager;
     protected EventManager eventManager;
@@ -288,7 +287,7 @@ public abstract class CustomNameplates implements NameplatesPlugin {
      * @return a collection of {@link CNPlayer} instances
      */
     public Collection<CNPlayer> getOnlinePlayers() {
-        return new HashSet<>(onlinePlayerMap.values());
+        return new ObjectArrayList<>(onlinePlayerMap.values());
     }
 
     /**

api/src/main/java/net/momirealms/customnameplates/api/MainTask.java

@@ -17,6 +17,8 @@
 
 package net.momirealms.customnameplates.api;
 
+import it.unimi.dsi.fastutil.objects.ObjectOpenHashSet;
+
 import java.util.Collections;
 import java.util.HashSet;
 import java.util.Map;
@@ -29,7 +31,7 @@ public class MainTask implements Runnable {
 
     private static final Map<Integer, Integer> TIME_1 = new ConcurrentHashMap<>(2048);
     private static final Map<Integer, Integer> TIME_2 = new ConcurrentHashMap<>(2048);
-    private static final Set<Integer> requestedSharedPlaceholders = Collections.synchronizedSet(new HashSet<>());
+    private static final Set<Integer> requestedSharedPlaceholders = Collections.synchronizedSet(new ObjectOpenHashSet<>());
     private int timer;
 
     private final CustomNameplates plugin;

api/src/main/java/net/momirealms/customnameplates/api/feature/PreParsedDynamicText.java

@@ -17,6 +17,8 @@
 
 package net.momirealms.customnameplates.api.feature;
 
+import it.unimi.dsi.fastutil.objects.ObjectArrayList;
+import it.unimi.dsi.fastutil.objects.ObjectOpenHashSet;
 import net.momirealms.customnameplates.api.CNPlayer;
 import net.momirealms.customnameplates.api.CustomNameplates;
 import net.momirealms.customnameplates.api.placeholder.*;
@@ -27,8 +29,8 @@ import java.util.function.Function;
 public class PreParsedDynamicText {
 
     private final String text;
-    private final List<Function<CNPlayer, Function<CNPlayer, String>>> textFunctions = new ArrayList<>();
-    private final Set<Placeholder> set = new HashSet<>();
+    private final List<Function<CNPlayer, Function<CNPlayer, String>>> textFunctions = new ObjectArrayList<>();
+    private final Set<Placeholder> set = new ObjectOpenHashSet<>();
     private boolean init = false;
 
     public PreParsedDynamicText(String text) {
@@ -86,12 +88,12 @@ public class PreParsedDynamicText {
             String remaining = original0.substring(lastIndex);
             textFunctions.add((owner) -> (viewer) -> remaining);
         }
-        // To optimize the tree height, call new HashSet twice here
-        set.addAll(new HashSet<>(placeholders));
+        // To optimize the tree height
+        set.addAll(new ObjectArrayList<>(placeholders));
     }
 
     public DynamicText fastCreate(CNPlayer player) {
-        List<Function<CNPlayer, String>> functions = new ArrayList<>();
+        List<Function<CNPlayer, String>> functions = new ObjectArrayList<>();
         for (Function<CNPlayer, Function<CNPlayer, String>> textFunction : textFunctions) {
             functions.add(textFunction.apply(player));
         }

api/src/main/java/net/momirealms/customnameplates/api/feature/advance/CharacterFontAdvanceDataImpl.java

@@ -18,6 +18,7 @@
 package net.momirealms.customnameplates.api.feature.advance;
 
 import com.google.gson.JsonObject;
+import it.unimi.dsi.fastutil.ints.Int2FloatOpenHashMap;
 
 import java.util.HashMap;
 import java.util.List;
@@ -28,11 +29,11 @@ import static java.util.Objects.requireNonNull;
 
 public class CharacterFontAdvanceDataImpl implements CharacterFontAdvanceData {
 
-    private final HashMap<Integer, Float> data;
+    private final Map<Integer, Float> data;
     private final String id;
     private final Function<Map<String, Object>, List<JsonObject>> fontProviderFunction;
 
-    public CharacterFontAdvanceDataImpl(String id, HashMap<Integer, Float> data, Function<Map<String, Object>, List<JsonObject>> fontProviderFunction) {
+    public CharacterFontAdvanceDataImpl(String id, Map<Integer, Float> data, Function<Map<String, Object>, List<JsonObject>> fontProviderFunction) {
         this.data = data;
         this.id = requireNonNull(id);
         this.fontProviderFunction = requireNonNull(fontProviderFunction);
@@ -65,7 +66,7 @@ public class CharacterFontAdvanceDataImpl implements CharacterFontAdvanceData {
 
     public static class BuilderImpl implements Builder {
 
-        private final HashMap<Integer, Float> data = new HashMap<>();
+        private final Int2FloatOpenHashMap data = new Int2FloatOpenHashMap();
         private String id;
         private Function<Map<String, Object>, List<JsonObject>> fontProviderFunction = (stringObjectMap -> null);
 

api/src/main/java/net/momirealms/customnameplates/api/feature/advance/ConfigurableFontAdvanceDataImpl.java

@@ -17,18 +17,18 @@
 
 package net.momirealms.customnameplates.api.feature.advance;
 
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.HashMap;
-import java.util.List;
+import it.unimi.dsi.fastutil.ints.Int2FloatOpenHashMap;
+import it.unimi.dsi.fastutil.objects.ObjectArrayList;
+
+import java.util.*;
 
 import static java.util.Objects.requireNonNull;
 
 public class ConfigurableFontAdvanceDataImpl implements ConfigurableFontAdvanceData {
 
     private final float defaultAdvance;
-    private final HashMap<Integer, Float> data = new HashMap<>();
-    private final List<CharacterFontAdvanceData> parents = new ArrayList<>();
+    private final Map<Integer, Float> data = new Int2FloatOpenHashMap();
+    private final List<CharacterFontAdvanceData> parents = new ObjectArrayList<>();
     private final String id;
 
     public ConfigurableFontAdvanceDataImpl(String id, float defaultAdvance, HashMap<Integer, Float> customData, List<CharacterFontAdvanceData> parentFonts) {

api/src/main/java/net/momirealms/customnameplates/api/feature/image/Animation.java

@@ -0,0 +1,21 @@
+/*
+ *  Copyright (C) <2024> <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.feature.image;
+
+public record Animation(int speed, int frames) {
+}

api/src/main/java/net/momirealms/customnameplates/api/feature/image/Image.java

@@ -18,6 +18,7 @@
 package net.momirealms.customnameplates.api.feature.image;
 
 import net.momirealms.customnameplates.api.feature.ConfiguredCharacter;
+import org.jetbrains.annotations.Nullable;
 
 public interface Image {
 
@@ -33,15 +34,15 @@ public interface Image {
      *
      * @return true if the image has a shadow, false otherwise
      */
-    boolean hasShadow();
+    boolean removeShadow();
 
     /**
-     * Returns the opacity level of the image.
-     * The value should typically range from 0 (fully transparent) to 255 (fully opaque).
+     * Get the animation of the image
      *
-     * @return the opacity value of the image
+     * @return the animated image
      */
-    int opacity();
+    @Nullable
+    Animation animation();
 
     /**
      * Returns the configured character associated with this image.
@@ -73,20 +74,20 @@ public interface Image {
         Builder id(String id);
 
         /**
-         * Sets whether the image has a shadow effect.
+         * Sets whether to remove the shadow of the image
          *
-         * @param has true if the image should have a shadow, false otherwise
+         * @param remove true if to remove the shadow
          * @return the builder instance
          */
-        Builder hasShadow(boolean has);
+        Builder removeShadow(boolean remove);
 
         /**
-         * Sets the opacity level of the image.
+         * Sets the animation of the image
          *
-         * @param opacity the opacity value, typically from 0 to 255
+         * @param animation animation
          * @return the builder instance
          */
-        Builder opacity(int opacity);
+        Builder animation(@Nullable Animation animation);
 
         /**
          * Sets the configured character associated with this image.

api/src/main/java/net/momirealms/customnameplates/api/feature/image/ImageImpl.java

@@ -18,21 +18,22 @@
 package net.momirealms.customnameplates.api.feature.image;
 
 import net.momirealms.customnameplates.api.feature.ConfiguredCharacter;
+import org.jetbrains.annotations.Nullable;
 
 import java.util.Objects;
 
 public class ImageImpl implements Image {
 
     private final String id;
-    private final boolean hasShadow;
-    private final int opacity;
+    private final boolean removeShadow;
     private final ConfiguredCharacter character;
+    private final Animation animation;
 
-    public ImageImpl(String id, boolean hasShadow, int opacity, ConfiguredCharacter character) {
+    public ImageImpl(String id, boolean removeShadow, Animation animation, ConfiguredCharacter character) {
         this.id = id;
-        this.hasShadow = hasShadow;
-        this.opacity = opacity;
+        this.removeShadow = removeShadow;
         this.character = character;
+        this.animation = animation;
     }
 
     @Override
@@ -41,13 +42,13 @@ public class ImageImpl implements Image {
     }
 
     @Override
-    public boolean hasShadow() {
-        return hasShadow;
+    public boolean removeShadow() {
+        return removeShadow;
     }
 
     @Override
-    public int opacity() {
-        return opacity;
+    public @Nullable Animation animation() {
+        return animation;
     }
 
     @Override
@@ -71,9 +72,9 @@ public class ImageImpl implements Image {
     public static class BuilderImpl implements Builder {
 
         private String id;
-        private boolean hasShadow;
-        private int opacity;
+        private boolean removeShadow;
         private ConfiguredCharacter character;
+        private Animation animation;
 
         @Override
         public Builder id(String id) {
@@ -82,14 +83,14 @@ public class ImageImpl implements Image {
         }
 
         @Override
-        public Builder hasShadow(boolean has) {
-            this.hasShadow = has;
+        public Builder removeShadow(boolean removeShadow) {
+            this.removeShadow = removeShadow;
             return this;
         }
 
         @Override
-        public Builder opacity(int opacity) {
-            this.opacity = opacity;
+        public Builder animation(@Nullable Animation animation) {
+            this.animation = animation;
             return this;
         }
 
@@ -101,7 +102,7 @@ public class ImageImpl implements Image {
 
         @Override
         public Image build() {
-            return new ImageImpl(id, hasShadow, opacity, character);
+            return new ImageImpl(id, removeShadow, animation, character);
         }
     }
 }

api/src/main/java/net/momirealms/customnameplates/api/feature/nameplate/Nameplate.java

@@ -57,6 +57,13 @@ public interface Nameplate extends AdaptiveImage {
      */
     ConfiguredCharacter right();
 
+    /**
+     * Gets the min width of the nameplate
+     *
+     * @return the min width of the nameplate
+     */
+    int minWidth();
+
     /**
      * Creates a new builder for constructing a Nameplate configuration.
      *
@@ -87,6 +94,14 @@ public interface Nameplate extends AdaptiveImage {
          */
         Builder displayName(String displayName);
 
+        /**
+         * Sets the min width for the nameplate
+         *
+         * @param minWidth min width
+         * @return the builder instance
+         */
+        Builder minWidth(int minWidth);
+
         /**
          * Sets the configured character for the left side of the nameplate.
          *

api/src/main/java/net/momirealms/customnameplates/api/feature/nameplate/NameplateImpl.java

@@ -29,10 +29,12 @@ public class NameplateImpl implements Nameplate {
     private final ConfiguredCharacter left;
     private final ConfiguredCharacter middle;
     private final ConfiguredCharacter right;
+    private final int minWidth;
 
-    public NameplateImpl(String id, String displayName, ConfiguredCharacter left, ConfiguredCharacter middle, ConfiguredCharacter right) {
+    public NameplateImpl(String id, String displayName, int minWidth, ConfiguredCharacter left, ConfiguredCharacter middle, ConfiguredCharacter right) {
         this.id = id;
         this.displayName = displayName;
+        this.minWidth = minWidth;
         this.left = left;
         this.middle = middle;
         this.right = right;
@@ -63,6 +65,11 @@ public class NameplateImpl implements Nameplate {
         return right;
     }
 
+    @Override
+    public int minWidth() {
+        return minWidth;
+    }
+
     @Override
     public boolean equals(Object object) {
         if (this == object) return true;
@@ -80,6 +87,7 @@ public class NameplateImpl implements Nameplate {
     @Override
     public String createImagePrefix(float advance, float leftMargin, float rightMargin) {
         if (advance <= 0) return "";
+        advance = Math.max(minWidth, advance);
         StringBuilder sb = new StringBuilder();
         sb.append(left.character());
         sb.append(OffsetFont.NEG_1.character());
@@ -99,6 +107,7 @@ public class NameplateImpl implements Nameplate {
     @Override
     public String createImageSuffix(float advance, float leftMargin, float rightMargin) {
         if (advance <= 0) return "";
+        advance = Math.max(minWidth, advance);
         int mid_amount = (int) Math.ceil((advance + leftMargin + rightMargin) / (middle.advance() - 1));
         float exceed = mid_amount * (middle.advance() - 1) - advance - leftMargin - rightMargin;
         return OffsetFont.shortestPosChars((float) Math.ceil(exceed / 2) + rightMargin + right.advance());
@@ -108,6 +117,7 @@ public class NameplateImpl implements Nameplate {
     @Override
     public String createImage(float advance, float leftMargin, float rightMargin) {
         if (advance <= 0) return "";
+        advance = Math.max(minWidth, advance);
         StringBuilder sb = new StringBuilder();
         sb.append(left.character());
         sb.append(OffsetFont.NEG_1.character());
@@ -131,6 +141,7 @@ public class NameplateImpl implements Nameplate {
         private ConfiguredCharacter left;
         private ConfiguredCharacter middle;
         private ConfiguredCharacter right;
+        private int minWidth;
 
         @Override
         public Builder id(String id) {
@@ -144,6 +155,12 @@ public class NameplateImpl implements Nameplate {
             return this;
         }
 
+        @Override
+        public Builder minWidth(int minWidth) {
+            this.minWidth = minWidth;
+            return this;
+        }
+
         @Override
         public Builder left(ConfiguredCharacter left) {
             this.left = left;
@@ -164,7 +181,7 @@ public class NameplateImpl implements Nameplate {
 
         @Override
         public Nameplate build() {
-            return new NameplateImpl(id, displayName, left, middle, right);
+            return new NameplateImpl(id, displayName, minWidth, left, middle, right);
         }
     }
 }

api/src/main/java/net/momirealms/customnameplates/api/feature/tag/TeamView.java

@@ -17,16 +17,15 @@
 
 package net.momirealms.customnameplates.api.feature.tag;
 
+import it.unimi.dsi.fastutil.objects.Object2ObjectOpenHashMap;
+import it.unimi.dsi.fastutil.objects.ObjectOpenHashSet;
 import org.jetbrains.annotations.Nullable;
 
-import java.util.Collection;
-import java.util.HashMap;
-import java.util.HashSet;
-import java.util.Set;
+import java.util.*;
 
 public class TeamView {
 
-    private final HashMap<String, Set<String>> teamMembers = new HashMap<>();
+    private final Map<String, Set<String>> teamMembers = new Object2ObjectOpenHashMap<>();
 
     @Nullable
     public Set<String> getTeamMembers(String team) {
@@ -34,7 +33,7 @@ public class TeamView {
     }
 
     public void addTeamMembers(String team, Collection<String> members) {
-        teamMembers.computeIfAbsent(team, k -> new HashSet<>(members));
+        teamMembers.computeIfAbsent(team, k -> new ObjectOpenHashSet<>(members));
     }
 
     public void removeTeamMembers(String team, Collection<String> members) {

api/src/main/java/net/momirealms/customnameplates/api/network/Tracker.java

@@ -17,6 +17,7 @@
 
 package net.momirealms.customnameplates.api.network;
 
+import it.unimi.dsi.fastutil.objects.ObjectOpenHashSet;
 import net.momirealms.customnameplates.api.CNPlayer;
 
 import java.util.HashSet;
@@ -80,7 +81,7 @@ public class Tracker {
     }
 
     public Set<Integer> getPassengerIDs() {
-        return new HashSet<>(passengerIDs);
+        return new ObjectOpenHashSet<>(passengerIDs);
     }
 
     public boolean isEmpty() {

api/src/main/java/net/momirealms/customnameplates/api/placeholder/AbstractPlaceholder.java

@@ -17,6 +17,7 @@
 
 package net.momirealms.customnameplates.api.placeholder;
 
+import it.unimi.dsi.fastutil.objects.ObjectOpenHashSet;
 import net.momirealms.customnameplates.api.CustomNameplates;
 
 import java.util.HashSet;
@@ -29,8 +30,8 @@ public abstract class AbstractPlaceholder implements Placeholder {
     protected int countId = PlaceholderCounter.getAndIncrease();
     protected int refreshInterval;
     protected PlaceholderManager manager;
-    protected Set<Placeholder> children = new HashSet<>();
-    protected Set<Placeholder> parents = new HashSet<>();
+    protected Set<Placeholder> children = new ObjectOpenHashSet<>();
+    protected Set<Placeholder> parents = new ObjectOpenHashSet<>();
 
     protected AbstractPlaceholder(PlaceholderManager manager, String id, int refreshInterval) {
         if (refreshInterval == 0) {

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

@@ -18,6 +18,7 @@
 package net.momirealms.customnameplates.api.requirement;
 
 import net.momirealms.customnameplates.api.CNPlayer;
+import net.momirealms.customnameplates.api.CustomNameplates;
 
 /**
  * A requirement that is always satisfied, representing an "empty" or default requirement.
@@ -57,6 +58,11 @@ public class EmptyRequirement implements Requirement {
         return "empty";
     }
 
+    @Override
+    public int countId() {
+        return CustomNameplates.getInstance().getRequirementManager().countId(this);
+    }
+
     /**
      * Returns -1, indicating that this requirement does not have a refresh interval.
      *

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

@@ -40,6 +40,13 @@ public interface Requirement {
      */
     String type();
 
+    /**
+     * Returns the int id for faster lookup
+     *
+     * @return count id
+     */
+    int countId();
+
     /**
      * Returns the refresh interval of the requirement.
      *

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

@@ -87,4 +87,12 @@ public interface RequirementManager extends Reloadable {
      */
     @NotNull
     Requirement parseSimpleRequirement(@NotNull String type, @NotNull Object value);
+
+    /**
+     * Gets the count id for the requirement for faster lookup
+     *
+     * @param requirement requirement
+     * @return the id
+     */
+    int countId(Requirement requirement);
 }

backend/build.gradle.kts

@@ -26,4 +26,6 @@ dependencies {
     // TTF
     compileOnly("org.lwjgl:lwjgl-freetype:${rootProject.properties["lwjgl_version"]}")
     compileOnly("org.lwjgl:lwjgl:${rootProject.properties["lwjgl_version"]}")
+    // Fast util
+    compileOnly("it.unimi.dsi:fastutil:${rootProject.properties["fastutil_version"]}")
 }

backend/src/main/java/net/momirealms/customnameplates/backend/feature/actionbar/ActionBarSender.java

@@ -17,6 +17,7 @@
 
 package net.momirealms.customnameplates.backend.feature.actionbar;
 
+import it.unimi.dsi.fastutil.objects.ObjectOpenHashSet;
 import net.momirealms.customnameplates.api.CNPlayer;
 import net.momirealms.customnameplates.api.ConfigManager;
 import net.momirealms.customnameplates.api.CustomNameplates;
@@ -177,7 +178,7 @@ public class ActionBarSender implements Feature {
 
     @Override
     public Set<Placeholder> allPlaceholders() {
-        HashSet<Placeholder> placeholders = new HashSet<>();
+        Set<Placeholder> placeholders = new ObjectOpenHashSet<>();
         for (ActionBarConfig config : manager.actionBarConfigs()) {
             for (CarouselText text : config.carouselTexts()) {
                 placeholders.addAll(text.preParsedDynamicText().placeholders());

backend/src/main/java/net/momirealms/customnameplates/backend/feature/advance/AdvanceManagerImpl.java

@@ -25,6 +25,8 @@ import com.google.gson.JsonObject;
 import com.google.gson.JsonParser;
 import dev.dejvokep.boostedyaml.YamlDocument;
 import dev.dejvokep.boostedyaml.block.implementation.Section;
+import it.unimi.dsi.fastutil.objects.Object2ObjectOpenHashMap;
+import it.unimi.dsi.fastutil.objects.ObjectArrayList;
 import net.kyori.adventure.key.Key;
 import net.kyori.adventure.text.Component;
 import net.kyori.adventure.text.TextComponent;
@@ -292,8 +294,8 @@ public class AdvanceManagerImpl implements AdvanceManager {
     private final HashMap<String, BiConsumer<String, Section>> templateConfigConsumersMap = new HashMap<>();
 
     private final CustomNameplates plugin;
-    private final HashMap<String, CharacterFontAdvanceData> charFontWidthDataMap = new HashMap<>();
-    private final HashMap<String, ConfigurableFontAdvanceData> configFontWidthDataMap = new HashMap<>();
+    private final Object2ObjectOpenHashMap<String, CharacterFontAdvanceData> charFontWidthDataMap = new Object2ObjectOpenHashMap<>();
+    private final Object2ObjectOpenHashMap<String, ConfigurableFontAdvanceData> configFontWidthDataMap = new Object2ObjectOpenHashMap<>();
 
     private final Cache<String, Float> textWidthCache;
 
@@ -1220,7 +1222,7 @@ public class AdvanceManagerImpl implements AdvanceManager {
     public List<Tuple<String, Key, Boolean>> miniMessageToIterable(String text) {
         if (AdventureHelper.legacySupport) text = AdventureHelper.legacyToMiniMessage(text);
         ElementNode node = (ElementNode) AdventureHelper.miniMessage().deserializeToTree(text);
-        ArrayList<Tuple<String, Key, Boolean>> iterableTexts = new ArrayList<>();
+        List<Tuple<String, Key, Boolean>> iterableTexts = new ObjectArrayList<>();
         nodeToIterableTexts(node, iterableTexts, MINECRAFT_DEFAULT_FONT, false);
         return iterableTexts;
     }

backend/src/main/java/net/momirealms/customnameplates/backend/feature/background/BackgroundManagerImpl.java

@@ -18,6 +18,7 @@
 package net.momirealms.customnameplates.backend.feature.background;
 
 import dev.dejvokep.boostedyaml.YamlDocument;
+import it.unimi.dsi.fastutil.objects.ObjectArrayList;
 import net.momirealms.customnameplates.api.ConfigManager;
 import net.momirealms.customnameplates.api.CustomNameplates;
 import net.momirealms.customnameplates.api.feature.ConfiguredCharacter;
@@ -57,7 +58,7 @@ public class BackgroundManagerImpl implements BackgroundManager {
 
     @Override
     public Collection<Background> getBackgrounds() {
-        return new HashSet<>(backgrounds.values());
+        return new ObjectArrayList<>(backgrounds.values());
     }
 
     private void loadConfigs() {

backend/src/main/java/net/momirealms/customnameplates/backend/feature/bossbar/BossBarSender.java

@@ -17,6 +17,7 @@
 
 package net.momirealms.customnameplates.backend.feature.bossbar;
 
+import it.unimi.dsi.fastutil.objects.ObjectOpenHashSet;
 import net.momirealms.customnameplates.api.CNPlayer;
 import net.momirealms.customnameplates.api.CustomNameplates;
 import net.momirealms.customnameplates.api.feature.CarouselText;
@@ -163,7 +164,7 @@ public class BossBarSender implements Feature, BossBar {
 
     @Override
     public Set<Placeholder> allPlaceholders() {
-        HashSet<Placeholder> placeholders = new HashSet<>();
+        Set<Placeholder> placeholders = new ObjectOpenHashSet<>();
         for (CarouselText text : config.carouselTexts()) {
             placeholders.addAll(text.preParsedDynamicText().placeholders());
         }

backend/src/main/java/net/momirealms/customnameplates/backend/feature/bubble/BubbleManagerImpl.java

@@ -27,6 +27,8 @@ import dev.dejvokep.boostedyaml.settings.general.GeneralSettings;
 import dev.dejvokep.boostedyaml.settings.loader.LoaderSettings;
 import dev.dejvokep.boostedyaml.settings.updater.UpdaterSettings;
 import dev.dejvokep.boostedyaml.utils.format.NodeRole;
+import it.unimi.dsi.fastutil.objects.Object2ObjectOpenHashMap;
+import it.unimi.dsi.fastutil.objects.ObjectArrayList;
 import net.momirealms.customnameplates.api.CNPlayer;
 import net.momirealms.customnameplates.api.ConfigManager;
 import net.momirealms.customnameplates.api.CustomNameplates;
@@ -51,7 +53,7 @@ import java.util.concurrent.TimeUnit;
 public class BubbleManagerImpl implements BubbleManager, ChatListener {
 
     private final CustomNameplates plugin;
-    private final Map<String, Bubble> bubbles = new HashMap<>();
+    private final Map<String, Bubble> bubbles = new Object2ObjectOpenHashMap<>();
     private Requirement[] sendBubbleRequirements;
     private Requirement[] viewBubbleRequirements;
     private String defaultBubbleId;
@@ -62,7 +64,7 @@ public class BubbleManagerImpl implements BubbleManager, ChatListener {
     private float viewRange;
     private Set<String> blacklistChannels;
     private ChannelMode channelMode;
-    private final HashMap<String, BubbleConfig> bubbleConfigs = new HashMap<>();
+    private final Map<String, BubbleConfig> bubbleConfigs = new Object2ObjectOpenHashMap<>();
 
     public BubbleManagerImpl(CustomNameplates plugin) {
         this.plugin = plugin;
@@ -94,12 +96,12 @@ public class BubbleManagerImpl implements BubbleManager, ChatListener {
 
     @Override
     public Collection<Bubble> bubbles() {
-        return new HashSet<>(bubbles.values());
+        return new ObjectArrayList<>(bubbles.values());
     }
 
     @Override
     public Collection<BubbleConfig> bubbleConfigs() {
-        return new HashSet<>(bubbleConfigs.values());
+        return new ObjectArrayList<>(bubbleConfigs.values());
     }
 
     @Override
@@ -231,7 +233,7 @@ public class BubbleManagerImpl implements BubbleManager, ChatListener {
                             .displayName(inner.getString("display-name", key))
                             .lineWidth(inner.getInt("line-width", 100))
                             .backgroundColor(ConfigUtils.argb(inner.getString("background-color", "0,0,0,0")))
-                            .textPrefix(inner.getString("text-prefix", ""))
+                            .textPrefix(inner.getString("text-prefix", "").replace("{namespace}", ConfigManager.namespace()))
                             .textSuffix(inner.getString("text-suffix", ""))
                             .scale(ConfigUtils.vector3(inner.getString("scale", "1,1,1")))
                             .build());
@@ -305,6 +307,7 @@ public class BubbleManagerImpl implements BubbleManager, ChatListener {
         String fullText = config.textPrefix() + AdventureHelper.stripTags(message.replace("\\", "\\\\")) + config.textSuffix();
         int lines = plugin.getAdvanceManager().getLines(fullText, config.lineWidth());
         if (lines > config.maxLines()) return;
+        if (lines <= 0) return;
         int space = (int) plugin.getAdvanceManager().getLineAdvance(" ");
         String fakeSpace = AdventureHelper.surroundWithNameplatesFont(OffsetFont.createOffsets(space));
         fullText = fullText.replace(" ", fakeSpace);

backend/src/main/java/net/momirealms/customnameplates/backend/feature/image/ImageManagerImpl.java

@@ -18,9 +18,11 @@
 package net.momirealms.customnameplates.backend.feature.image;
 
 import dev.dejvokep.boostedyaml.YamlDocument;
+import it.unimi.dsi.fastutil.objects.ObjectArrayList;
 import net.momirealms.customnameplates.api.ConfigManager;
 import net.momirealms.customnameplates.api.CustomNameplates;
 import net.momirealms.customnameplates.api.feature.ConfiguredCharacter;
+import net.momirealms.customnameplates.api.feature.image.Animation;
 import net.momirealms.customnameplates.api.feature.image.Image;
 import net.momirealms.customnameplates.api.feature.image.ImageManager;
 import net.momirealms.customnameplates.api.util.ConfigUtils;
@@ -59,7 +61,7 @@ public class ImageManagerImpl implements ImageManager {
 
     @Override
     public Collection<Image> images() {
-        return new HashSet<>(images.values());
+        return new ObjectArrayList<>(images.values());
     }
 
     private void loadConfigs() {
@@ -73,8 +75,11 @@ public class ImageManagerImpl implements ImageManager {
             String id = configFile.getName().substring(0, configFile.getName().lastIndexOf("."));
             Image image = Image.builder()
                     .id(id)
-                    .hasShadow(!config.getBoolean("shadow.remove", false))
-                    .opacity(config.getInt("shadow.opacity", 254))
+                    .animation(config.contains("animation") ? new Animation(
+                            config.getInt("animation.speed", 64),
+                            config.getInt("animation.frames", 1)
+                    ) : null)
+                    .removeShadow(!config.getBoolean("shadow", true))
                     .character(ConfiguredCharacter.create(
                                     ConfigUtils.getFileInTheSameFolder(configFile, config.getString("image") + ".png"),
                                     config.getInt("ascent", 8),

backend/src/main/java/net/momirealms/customnameplates/backend/feature/nameplate/NameplateManagerImpl.java

@@ -18,6 +18,7 @@
 package net.momirealms.customnameplates.backend.feature.nameplate;
 
 import dev.dejvokep.boostedyaml.YamlDocument;
+import it.unimi.dsi.fastutil.objects.ObjectArrayList;
 import net.momirealms.customnameplates.api.CNPlayer;
 import net.momirealms.customnameplates.api.ConfigManager;
 import net.momirealms.customnameplates.api.CustomNameplates;
@@ -61,7 +62,7 @@ public class NameplateManagerImpl implements NameplateManager {
 
     @Override
     public Collection<Nameplate> nameplates() {
-        return new HashSet<>(nameplates.values());
+        return new ObjectArrayList<>(nameplates.values());
     }
 
     @Override
@@ -115,6 +116,7 @@ public class NameplateManagerImpl implements NameplateManager {
             Nameplate nameplate = Nameplate.builder()
                     .id(id)
                     .displayName(config.getString("display-name", id))
+                    .minWidth(config.getInt("min-width", 0))
                     .left(ConfiguredCharacter.create(
                             ConfigUtils.getFileInTheSameFolder(configFile, config.getString("left.image") + ".png"),
                             config.getInt("left.ascent", 12),

backend/src/main/java/net/momirealms/customnameplates/backend/feature/pack/ResourcePackManagerImpl.java

@@ -29,6 +29,7 @@ import net.momirealms.customnameplates.api.feature.OffsetFont;
 import net.momirealms.customnameplates.api.feature.advance.CharacterFontAdvanceData;
 import net.momirealms.customnameplates.api.feature.background.Background;
 import net.momirealms.customnameplates.api.feature.bubble.Bubble;
+import net.momirealms.customnameplates.api.feature.image.Animation;
 import net.momirealms.customnameplates.api.feature.image.Image;
 import net.momirealms.customnameplates.api.feature.nameplate.Nameplate;
 import net.momirealms.customnameplates.api.feature.pack.ResourcePackManager;
@@ -321,11 +322,53 @@ public class ResourcePackManagerImpl implements ResourcePackManager {
             jo.add("chars", ja);
             list.add(jo);
             try {
+                File targetFile = new File(texturesFolder,
+                        ConfigManager.imagePath().replace("\\", File.separator) + character.imageFile().getName());
                 FileUtils.copyFile(
                         new File(plugin.getDataFolder(),
-                                "contents" + File.separator + "images" + File.separator + character.imageFile().getName()),
-                        new File(texturesFolder,
-                                ConfigManager.imagePath().replace("\\", File.separator) + character.imageFile().getName()));
+                                "contents" + File.separator + "images" + File.separator + character.imageFile().getName()), targetFile);
+                if (image.removeShadow() || image.animation() != null) {
+                    BufferedImage bufferedImage = ImageIO.read(targetFile);
+                    if (image.removeShadow()) {
+                        for (int y = 0; y < bufferedImage.getHeight(); y++) {
+                            for (int x = 0; x < bufferedImage.getWidth(); x++) {
+                                int argb = bufferedImage.getRGB(x, y);
+                                int alpha = (argb >> 24) & 0xff;
+                                if (alpha != 0) {
+                                    int rgb = argb & 0x00ffffff;
+                                    int newArgb = (254 << 24) | rgb;
+                                    bufferedImage.setRGB(x, y, newArgb);
+                                }
+                            }
+                        }
+                    }
+
+                    Animation animation = image.animation();
+                    if (animation != null) {
+                        int height = bufferedImage.getHeight();
+                        int extra = height % animation.frames();
+                        if (extra > 0) {
+                            plugin.getPluginLogger().warn("Image height is not a multiple of frame rate: " + image.id());
+                            continue;
+                        }
+                        int eachFrameHeight = height / animation.frames();
+                        int width = bufferedImage.getWidth();
+                        int speed = Math.min(Math.max(animation.speed(), 1), 255);
+
+                        int alpha = 1;
+                        int red = speed;
+                        int green = width;
+                        int blue = eachFrameHeight;
+                        int argb = (alpha << 24) | (red << 16) | (green << 8) | blue;
+
+                        for (int i = 0; i < animation.frames(); i++) {
+                            int y = i * eachFrameHeight;
+                            bufferedImage.setRGB(0, y, argb);
+                        }
+                    }
+
+                    ImageIO.write(bufferedImage, "png", targetFile);
+                }
             } catch (IOException e) {
                 throw new RuntimeException(e);
             }
@@ -583,6 +626,7 @@ public class ResourcePackManagerImpl implements ResourcePackManager {
                         "        vertexColor = ((.6 + .6 * cos(6. * (gl_Position.x + GameTime * 1000.) + vec4(0, 23, 21, 1))) + vec4(0., 0., 0., 1.)) * texelFetch(Sampler2, UV2 / 16, 0);\n" +
                         "        gl_Position = ProjMat * ModelViewMat * vertex;\n" +
                         "    } else ";
+
         public static final String Hide_ScoreBoard_Numbers =
                         "\n" +
                         "    if (Position.z == 0.0\n" +

backend/src/main/java/net/momirealms/customnameplates/backend/feature/tag/NameTag.java

@@ -17,6 +17,7 @@
 
 package net.momirealms.customnameplates.backend.feature.tag;
 
+import it.unimi.dsi.fastutil.objects.ObjectOpenHashSet;
 import net.momirealms.customnameplates.api.CNPlayer;
 import net.momirealms.customnameplates.api.CustomNameplates;
 import net.momirealms.customnameplates.api.feature.CarouselText;
@@ -195,7 +196,7 @@ public class NameTag extends AbstractTag implements RelationalFeature {
 
     @Override
     public Set<Placeholder> allPlaceholders() {
-        HashSet<Placeholder> placeholders = new HashSet<>();
+        Set<Placeholder> placeholders = new ObjectOpenHashSet<>();
         for (CarouselText text : config.carouselTexts()) {
             placeholders.addAll(text.preParsedDynamicText().placeholders());
         }

backend/src/main/java/net/momirealms/customnameplates/backend/feature/tag/TagRendererImpl.java

@@ -17,6 +17,7 @@
 
 package net.momirealms.customnameplates.backend.feature.tag;
 
+import it.unimi.dsi.fastutil.objects.ObjectOpenHashSet;
 import net.momirealms.customnameplates.api.CNPlayer;
 import net.momirealms.customnameplates.api.CustomNameplates;
 import net.momirealms.customnameplates.api.feature.Feature;
@@ -69,14 +70,15 @@ public class TagRendererImpl implements TagRenderer {
 
     @Override
     public void onTick() {
-        HashSet<CNPlayer> playersToUpdatePassengers = new HashSet<>();
-        HashSet<CNPlayer> tagTranslationUpdates = new HashSet<>();
+        Set<CNPlayer> playersToUpdatePassengers = new ObjectOpenHashSet<>();
+        Set<CNPlayer> tagTranslationUpdates = new ObjectOpenHashSet<>();
 
+        Collection<CNPlayer> nearbyPlayers = owner.nearbyPlayers();
         for (Tag tag : tagArray) {
             boolean canShow = tag.canShow();
             if (canShow) {
                 if (tag.isShown()) {
-                    for (CNPlayer nearby : owner.nearbyPlayers()) {
+                    for (CNPlayer nearby : nearbyPlayers) {
                         if (tag.isShown(nearby)) {
                             if (!tag.canShow(nearby)) {
                                 tag.hide(nearby);
@@ -97,7 +99,7 @@ public class TagRendererImpl implements TagRenderer {
                     tag.init();
                     tag.tick();
                     tag.show();
-                    for (CNPlayer nearby : owner.nearbyPlayers()) {
+                    for (CNPlayer nearby : nearbyPlayers) {
                         if (tag.canShow(nearby) && !tag.isShown(nearby)) {
                             tag.show(nearby);
                             playersToUpdatePassengers.add(nearby);
@@ -110,7 +112,7 @@ public class TagRendererImpl implements TagRenderer {
                 if (tag.isShown()) {
                     tag.hide();
                     if (!tag.relativeTranslation())
-                        tagTranslationUpdates.addAll(owner.nearbyPlayers());
+                        tagTranslationUpdates.addAll(nearbyPlayers);
                 }
             }
         }

backend/src/main/java/net/momirealms/customnameplates/backend/feature/tag/UnlimitedTagManagerImpl.java

@@ -148,6 +148,8 @@ public class UnlimitedTagManagerImpl implements UnlimitedTagManager, JoinQuitLis
         }
         if (isAlwaysShow()) {
             setTempPreviewing(player, isAlwaysShow());
+        } else if (player.isLoaded() && player.isTempPreviewing()) {
+            setTempPreviewing(player, false);
         }
     }
 

backend/src/main/java/net/momirealms/customnameplates/backend/placeholder/PlaceholderManagerImpl.java

@@ -19,6 +19,10 @@ package net.momirealms.customnameplates.backend.placeholder;
 
 import dev.dejvokep.boostedyaml.YamlDocument;
 import dev.dejvokep.boostedyaml.block.implementation.Section;
+import it.unimi.dsi.fastutil.ints.Int2IntOpenHashMap;
+import it.unimi.dsi.fastutil.objects.Object2ObjectOpenHashMap;
+import it.unimi.dsi.fastutil.objects.ObjectArrayList;
+import it.unimi.dsi.fastutil.objects.ObjectOpenHashSet;
 import net.momirealms.customnameplates.api.CNPlayer;
 import net.momirealms.customnameplates.api.ConfigManager;
 import net.momirealms.customnameplates.api.CustomNameplates;
@@ -51,7 +55,7 @@ public class PlaceholderManagerImpl implements PlaceholderManager {
 
     private final CustomNameplates plugin;
     private final HashMap<String, Integer> refreshIntervals = new HashMap<>();
-    private final HashMap<Integer, Integer> fasterRefreshIntervals = new HashMap<>();
+    private final Int2IntOpenHashMap fasterRefreshIntervals = new Int2IntOpenHashMap();
     private final Map<String, Placeholder> registeredPlaceholders = new HashMap<>();
     private final HashMap<Placeholder, List<PreParsedDynamicText>> childrenText = new HashMap<>();
     private final HashMap<String, Placeholder> nestedPlaceholders = new HashMap<>();
@@ -201,7 +205,7 @@ public class PlaceholderManagerImpl implements PlaceholderManager {
             this.registerPlayerPlaceholder("%np_gradient_" + i + "%", (player) -> {
                 int currentTicks = MainTask.getTicks();
                 double progress = currentTicks * 0.01 * speed;
-                return String.format("%.2f", -1 + (progress % 2.0001));
+                return String.format(Locale.US, "%.2f", -1 + (progress % 2.0001));
             });
         }
         for (int i = 1; i <= 20; i++) {
@@ -209,7 +213,7 @@ public class PlaceholderManagerImpl implements PlaceholderManager {
             this.registerSharedPlaceholder("%shared_np_gradient_" + i + "%", () -> {
                 int currentTicks = MainTask.getTicks();
                 double progress = currentTicks * 0.01 * speed;
-                return String.format("%.2f", -1 + (progress % 2.0001));
+                return String.format(Locale.US, "%.2f", -1 + (progress % 2.0001));
             });
         }
         this.registerPlayerPlaceholder("%np_is_showing%", (player) -> String.valueOf(player.isToggleablePreviewing()));
@@ -575,9 +579,9 @@ public class PlaceholderManagerImpl implements PlaceholderManager {
     public void refreshPlaceholders() {
         for (CNPlayer player : plugin.getOnlinePlayers()) {
             if (!player.isOnline()) continue;
-            Set<Feature> featuresToNotifyUpdates = new HashSet<>();
-            Map<Feature, List<CNPlayer>> relationalFeaturesToNotifyUpdates = new HashMap<>();
-            List<RelationalPlaceholder> delayedPlaceholdersToUpdate = new ArrayList<>();
+            Set<Feature> featuresToNotifyUpdates = new ObjectOpenHashSet<>();
+            Map<Feature, List<CNPlayer>> relationalFeaturesToNotifyUpdates = new Object2ObjectOpenHashMap<>();
+            List<RelationalPlaceholder> delayedPlaceholdersToUpdate = new ObjectArrayList<>();
             for (Placeholder placeholder : player.activePlaceholdersToRefresh()) {
                 if (placeholder instanceof PlayerPlaceholder playerPlaceholder) {
                     TimeStampData<String> previous = player.getValue(placeholder);
@@ -652,7 +656,7 @@ public class PlaceholderManagerImpl implements PlaceholderManager {
                         for (Feature feature : player.activeFeatures(placeholder)) {
                             // Filter features that will not be updated for all players
                             if (!featuresToNotifyUpdates.contains(feature)) {
-                                List<CNPlayer> players = relationalFeaturesToNotifyUpdates.computeIfAbsent(feature, k -> new ArrayList<>());
+                                List<CNPlayer> players = relationalFeaturesToNotifyUpdates.computeIfAbsent(feature, k -> new ObjectArrayList<>());
                                 players.add(nearby);
                             }
                         }
@@ -663,7 +667,7 @@ public class PlaceholderManagerImpl implements PlaceholderManager {
                                 for (Feature feature : player.activeFeatures(placeholder)) {
                                     // Filter features that will not be updated for all players
                                     if (!featuresToNotifyUpdates.contains(feature)) {
-                                        List<CNPlayer> players = relationalFeaturesToNotifyUpdates.computeIfAbsent(feature, k -> new ArrayList<>());
+                                        List<CNPlayer> players = relationalFeaturesToNotifyUpdates.computeIfAbsent(feature, k -> new ObjectArrayList<>());
                                         players.add(nearby);
                                     }
                                 }
@@ -677,7 +681,7 @@ public class PlaceholderManagerImpl implements PlaceholderManager {
                             for (Feature feature : player.activeFeatures(placeholder)) {
                                 // Filter features that will not be updated for all players
                                 if (!featuresToNotifyUpdates.contains(feature)) {
-                                    List<CNPlayer> players = relationalFeaturesToNotifyUpdates.computeIfAbsent(feature, k -> new ArrayList<>());
+                                    List<CNPlayer> players = relationalFeaturesToNotifyUpdates.computeIfAbsent(feature, k -> new ObjectArrayList<>());
                                     players.add(nearby);
                                 }
                             }
@@ -773,7 +777,7 @@ public class PlaceholderManagerImpl implements PlaceholderManager {
         if (firstPercent == 0 && text.charAt(text.length() - 1) == '%' && text.indexOf('%', 1) == text.length() - 1) {
             return Collections.singletonList(text);
         }
-        List<String> placeholders = new ArrayList<>();
+        List<String> placeholders = new ObjectArrayList<>();
         Matcher m = PATTERN.matcher(text);
         while (m.find()) {
             placeholders.add(m.group());

backend/src/main/java/net/momirealms/customnameplates/backend/requirement/AbstractRequirement.java

@@ -17,16 +17,29 @@
 
 package net.momirealms.customnameplates.backend.requirement;
 
+import net.momirealms.customnameplates.api.CustomNameplates;
 import net.momirealms.customnameplates.api.requirement.Requirement;
+import org.jetbrains.annotations.Nullable;
 
 public abstract class AbstractRequirement implements Requirement {
 
     protected final int refreshInterval;
+    @Nullable
+    protected Integer countId;
 
     public AbstractRequirement(int refreshInterval) {
         this.refreshInterval = refreshInterval;
     }
 
+    @Override
+    public int countId() {
+        // lazy init
+        if (countId == null) {
+            countId = CustomNameplates.getInstance().getRequirementManager().countId(this);
+        }
+        return countId;
+    }
+
     @Override
     public int refreshInterval() {
         return refreshInterval;

backend/src/main/java/net/momirealms/customnameplates/backend/requirement/AbstractRequirementManager.java

@@ -18,6 +18,8 @@
 package net.momirealms.customnameplates.backend.requirement;
 
 import dev.dejvokep.boostedyaml.block.implementation.Section;
+import it.unimi.dsi.fastutil.objects.Object2IntOpenHashMap;
+import it.unimi.dsi.fastutil.objects.Object2ObjectOpenHashMap;
 import net.momirealms.customnameplates.api.ConfigManager;
 import net.momirealms.customnameplates.api.CustomNameplates;
 import net.momirealms.customnameplates.api.feature.PreParsedDynamicText;
@@ -26,6 +28,7 @@ import net.momirealms.customnameplates.api.requirement.RequirementFactory;
 import net.momirealms.customnameplates.api.requirement.RequirementManager;
 import net.momirealms.customnameplates.api.util.ConfigUtils;
 import net.momirealms.customnameplates.backend.requirement.builtin.*;
+import net.momirealms.customnameplates.common.util.ListUtils;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
@@ -34,7 +37,9 @@ import java.util.*;
 public abstract class AbstractRequirementManager implements RequirementManager {
 
     protected final CustomNameplates plugin;
-    private final HashMap<String, RequirementFactory> requirementFactoryMap = new HashMap<>();
+    private final Object2ObjectOpenHashMap<String, RequirementFactory> requirementFactoryMap = new Object2ObjectOpenHashMap<>(128);
+    private int countId = 0;
+    private final Map<Requirement, Integer> registeredRequirements = new Object2IntOpenHashMap<>(128);
 
     public AbstractRequirementManager(CustomNameplates plugin) {
         this.plugin = plugin;
@@ -42,6 +47,21 @@ public abstract class AbstractRequirementManager implements RequirementManager {
         this.registerPlatformRequirements();
     }
 
+    @Override
+    public void reload() {
+        this.countId = 0;
+        this.registeredRequirements.clear();
+    }
+
+    @Override
+    public int countId(Requirement requirement) {
+        if (requirement == null) return -1;
+        if (this.registeredRequirements.containsKey(requirement)) return this.registeredRequirements.get(requirement);
+        this.countId++;
+        this.registeredRequirements.put(requirement, countId);
+        return this.countId;
+    }
+
     private void registerInternalRequirements() {
         this.registerRequirement((args, interval) -> {
             Section section = ConfigUtils.safeCast(args, Section.class);
@@ -178,6 +198,10 @@ public abstract class AbstractRequirementManager implements RequirementManager {
             boolean has = (boolean) args;
             return new HasBubbleRequirement(interval, has);
         }, "has-bubble");
+        this.registerRequirement((args, interval) -> new NameplateRequirement(interval, new HashSet<>(ListUtils.toList(args))), "nameplate");
+        this.registerRequirement((args, interval) -> new NotNameplateRequirement(interval, new HashSet<>(ListUtils.toList(args))), "!nameplate");
+        this.registerRequirement((args, interval) -> new BubbleRequirement(interval, new HashSet<>(ListUtils.toList(args))), "bubble");
+        this.registerRequirement((args, interval) -> new NotBubbleRequirement(interval, new HashSet<>(ListUtils.toList(args))), "!bubble");
     }
 
     protected abstract void registerPlatformRequirements();

backend/src/main/java/net/momirealms/customnameplates/backend/requirement/builtin/BubbleRequirement.java

@@ -0,0 +1,61 @@
+/*
+ *  Copyright (C) <2024> <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.backend.requirement.builtin;
+
+import net.momirealms.customnameplates.api.CNPlayer;
+import net.momirealms.customnameplates.api.ConfigManager;
+import net.momirealms.customnameplates.api.CustomNameplates;
+import net.momirealms.customnameplates.backend.requirement.AbstractRequirement;
+
+import java.util.Objects;
+import java.util.Set;
+
+public class BubbleRequirement extends AbstractRequirement {
+
+    private final Set<String> bubbles;
+
+    public BubbleRequirement(int refreshInterval, Set<String> bubbles) {
+        super(refreshInterval);
+        this.bubbles = bubbles;
+    }
+
+    @Override
+    public boolean isSatisfied(CNPlayer p1, CNPlayer p2) {
+        if (!ConfigManager.bubbleModule()) return false;
+        String bubble = p1.equippedBubble();
+        if (bubble.equals("none")) bubble = CustomNameplates.getInstance().getBubbleManager().defaultBubbleId();
+        return bubbles.contains(bubble);
+    }
+
+    @Override
+    public String type() {
+        return "bubble";
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (!(o instanceof BubbleRequirement that)) return false;
+        return bubbles.equals(that.bubbles);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(bubbles);
+    }
+}

backend/src/main/java/net/momirealms/customnameplates/backend/requirement/builtin/NameplateRequirement.java

@@ -0,0 +1,61 @@
+/*
+ *  Copyright (C) <2024> <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.backend.requirement.builtin;
+
+import net.momirealms.customnameplates.api.CNPlayer;
+import net.momirealms.customnameplates.api.ConfigManager;
+import net.momirealms.customnameplates.api.CustomNameplates;
+import net.momirealms.customnameplates.backend.requirement.AbstractRequirement;
+
+import java.util.Objects;
+import java.util.Set;
+
+public class NameplateRequirement extends AbstractRequirement {
+
+    private final Set<String> nameplates;
+
+    public NameplateRequirement(int refreshInterval, Set<String> nameplates) {
+        super(refreshInterval);
+        this.nameplates = nameplates;
+    }
+
+    @Override
+    public boolean isSatisfied(CNPlayer p1, CNPlayer p2) {
+        if (!ConfigManager.nameplateModule()) return false;
+        String nameplate = p1.equippedNameplate();
+        if (nameplate.equals("none")) nameplate = CustomNameplates.getInstance().getNameplateManager().defaultNameplateId();
+        return nameplates.contains(nameplate);
+    }
+
+    @Override
+    public String type() {
+        return "nameplate";
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (!(o instanceof NameplateRequirement that)) return false;
+        return nameplates.equals(that.nameplates);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(nameplates);
+    }
+}

backend/src/main/java/net/momirealms/customnameplates/backend/requirement/builtin/NotBubbleRequirement.java

@@ -0,0 +1,61 @@
+/*
+ *  Copyright (C) <2024> <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.backend.requirement.builtin;
+
+import net.momirealms.customnameplates.api.CNPlayer;
+import net.momirealms.customnameplates.api.ConfigManager;
+import net.momirealms.customnameplates.api.CustomNameplates;
+import net.momirealms.customnameplates.backend.requirement.AbstractRequirement;
+
+import java.util.Objects;
+import java.util.Set;
+
+public class NotBubbleRequirement extends AbstractRequirement {
+
+    private final Set<String> bubbles;
+
+    public NotBubbleRequirement(int refreshInterval, Set<String> bubbles) {
+        super(refreshInterval);
+        this.bubbles = bubbles;
+    }
+
+    @Override
+    public boolean isSatisfied(CNPlayer p1, CNPlayer p2) {
+        if (!ConfigManager.bubbleModule()) return false;
+        String bubble = p1.equippedBubble();
+        if (bubble.equals("none")) bubble = CustomNameplates.getInstance().getBubbleManager().defaultBubbleId();
+        return !bubbles.contains(bubble);
+    }
+
+    @Override
+    public String type() {
+        return "!bubble";
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (!(o instanceof NotBubbleRequirement that)) return false;
+        return bubbles.equals(that.bubbles);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(bubbles);
+    }
+}

backend/src/main/java/net/momirealms/customnameplates/backend/requirement/builtin/NotNameplateRequirement.java

@@ -0,0 +1,61 @@
+/*
+ *  Copyright (C) <2024> <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.backend.requirement.builtin;
+
+import net.momirealms.customnameplates.api.CNPlayer;
+import net.momirealms.customnameplates.api.ConfigManager;
+import net.momirealms.customnameplates.api.CustomNameplates;
+import net.momirealms.customnameplates.backend.requirement.AbstractRequirement;
+
+import java.util.Objects;
+import java.util.Set;
+
+public class NotNameplateRequirement extends AbstractRequirement {
+
+    private final Set<String> nameplates;
+
+    public NotNameplateRequirement(int refreshInterval, Set<String> nameplates) {
+        super(refreshInterval);
+        this.nameplates = nameplates;
+    }
+
+    @Override
+    public boolean isSatisfied(CNPlayer p1, CNPlayer p2) {
+        if (!ConfigManager.nameplateModule()) return false;
+        String nameplate = p1.equippedNameplate();
+        if (nameplate.equals("none")) nameplate = CustomNameplates.getInstance().getNameplateManager().defaultNameplateId();
+        return !nameplates.contains(nameplate);
+    }
+
+    @Override
+    public String type() {
+        return "!nameplate";
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (!(o instanceof NotNameplateRequirement that)) return false;
+        return nameplates.equals(that.nameplates);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(nameplates);
+    }
+}

backend/src/main/java/net/momirealms/customnameplates/backend/requirement/builtin/PlaceholdersRequirement.java

@@ -37,8 +37,9 @@ public abstract class PlaceholdersRequirement extends AbstractRequirement {
 
     @Override
     public boolean isSatisfied(CNPlayer p1, CNPlayer p2) {
-        p1.forceUpdatePlaceholders(t1.placeholders(), Set.of(p2));
-        p1.forceUpdatePlaceholders(t2.placeholders(), Set.of(p2));
+        Set<CNPlayer> set = Set.of(p2);
+        p1.forceUpdatePlaceholders(t1.placeholders(), set);
+        p1.forceUpdatePlaceholders(t2.placeholders(), set);
         String a1 = t1.fastCreate(p1).render(p2);
         String a2 = t2.fastCreate(p1).render(p2);
         return checkArgument(a1, a2);

backend/src/main/resources/config.yml

@@ -167,13 +167,14 @@ other-settings:
       unicode:
         file: unicode_page_%02x.png   # Default Unicode characters
         sizes: glyph_sizes.bin        # Glyph size configuration
-    ttf:
-      example:
-        generate: false               # Should this TTF file be included in the generated pack
-        file: example.ttf             # Define the TTF file to load the font from
-        size: 10.0                    # Set font size
-        oversample: 8.0               # Oversample rate for TTF rendering
-        skip: []                      # Skipped characters in list format
+    ttf: {}
+#    ttf:
+#      example:
+#        generate: false               # Should this TTF file be included in the generated pack
+#        file: example.ttf             # Define the TTF file to load the font from
+#        size: 10.0                    # Set font size
+#        oversample: 8.0               # Oversample rate for TTF rendering
+#        skip: []                      # Skipped characters in list format
   shift-fonts:
     shift_0:
       - space

backend/src/main/resources/configs/bubble.yml

@@ -26,5 +26,5 @@ bubble-settings:
       3: chat_3
     line-width: 150
     background-color: 0,0,0,0
-    text-prefix: "<black><font:nameplates:shift_0>"
+    text-prefix: "<black><font:{namespace}:shift_0>" # {namespace} would be replaced by the namespace set in config.yml
     text-suffix: "</font></black>"

backend/src/main/resources/configs/custom-placeholders.yml

@@ -2,21 +2,22 @@
 conditional-text:
   actionbar:
     priority_1:
-      text: '%np_background_other_actionbar%'
+      text: '%np_background_other_actionbar%' # hides the money hud when a player rides something or dives in water
       conditions:
         '||':
+          is-passenger: true
           '!=':
             value1: '%player_remaining_air%'
             value2: "300"
           '!gamemode': survival
     priority_2:
-      text: '%np_static_money_hud%%np_offset_-179%%np_static_other_actionbar%'
+      text: '%np_static_money_hud%%np_offset_-179%%np_static_other_actionbar%' # displays the money hud + other plugin's actionbar message
       conditions:
         '!equals':
           value1: '%np_actionbar%'
           value2: ""
     priority_3:
-      text: '%np_static_money_hud%'
+      text: '%np_static_money_hud%' # displays the money hud only
   weather:
     priority_1:
       text: 'Sunny'

backend/src/main/resources/configs/nameplate.yml

@@ -9,7 +9,20 @@ nameplate:
   player-name: '%np_shift_player_name%'
   suffix: '%np_switch_nameplate_color_suffix%'
 unlimited:
-  tag_1:
+  tag_normal:
+    text: '%np_tag-text%'
+    translation: 0,0.2,0
+    viewer-conditions: { }
+    owner-conditions:
+      has-nameplate: false
+      potion-effect: "INVISIBILITY<0"
+      self-disguised: false
+    affected-by-crouching: true
+    affected-by-scale-attribute: true
+    affected-by-spectator: true
+    line-width: 1024
+    background-color: 64,0,0,0
+  tag_image_part:
     text: '%np_tag-image%'
     translation: 0,0.2,0
     viewer-conditions: { }
@@ -22,7 +35,7 @@ unlimited:
     affected-by-spectator: true
     line-width: 1024
     background-color: 0,0,0,0
-  tag_2:
+  tag_text_part:
     text: '%np_tag-text%'
     translation: 0.01,0.2,0.01
     viewer-conditions: { }
@@ -34,17 +47,4 @@ unlimited:
     affected-by-scale-attribute: true
     affected-by-spectator: true
     line-width: 1024
-    background-color: 0,0,0,0
-  tag_3:
-    text: '%np_tag-text%'
-    translation: 0,0.2,0
-    viewer-conditions: { }
-    owner-conditions:
-      has-nameplate: false
-      potion-effect: "INVISIBILITY<0"
-      self-disguised: false
-    affected-by-crouching: true
-    affected-by-scale-attribute: true
-    affected-by-spectator: true
-    line-width: 1024
-    background-color: 64,0,0,0
+    background-color: 0,0,0,0

backend/src/main/resources/contents/images/bell.yml

@@ -1,3 +1,4 @@
 image: bell
 height: 10
-ascent: 4
+ascent: 4
+shadow: false

backend/src/main/resources/contents/images/bubble.yml

@@ -1,3 +1,4 @@
 image: bubble
 height: 10
-ascent: 4
+ascent: 4
+shadow: false

backend/src/main/resources/contents/images/clock.yml

@@ -1,3 +1,4 @@
 image: clock
 height: 10
-ascent: 4
+ascent: 4
+shadow: false

backend/src/main/resources/contents/images/coin.yml

@@ -1,3 +1,4 @@
 image: coin
 height: 10
-ascent: -14
+ascent: -14
+shadow: false

backend/src/main/resources/contents/images/compass.yml

@@ -1,3 +1,4 @@
 image: compass
 height: 10
-ascent: 4
+ascent: 4
+shadow: false

backend/src/main/resources/contents/images/stamina_0.yml

@@ -1,3 +1,4 @@
 image: stamina_0
 height: 9
-ascent: -16
+ascent: -16
+shadow: false

backend/src/main/resources/contents/images/stamina_1.yml

@@ -1,3 +1,4 @@
 image: stamina_1
 height: 9
-ascent: -16
+ascent: -16
+shadow: false

backend/src/main/resources/contents/images/stamina_2.yml

@@ -1,3 +1,4 @@
 image: stamina_2
 height: 9
-ascent: -16
+ascent: -16
+shadow: false

backend/src/main/resources/contents/images/weather.yml

@@ -1,3 +1,4 @@
 image: weather
 height: 10
-ascent: 4
+ascent: 4
+shadow: false

bukkit/src/main/java/net/momirealms/customnameplates/bukkit/BukkitChatManager.java

@@ -63,7 +63,7 @@ public class BukkitChatManager extends AbstractChatManager {
         }
         if (Bukkit.getPluginManager().isPluginEnabled("Oraxen")) {
             try {
-                this.emojiProviders.add(new OraxenEmojiProvider());
+                this.emojiProviders.add(new OraxenEmojiProvider(Bukkit.getPluginManager().getPlugin("Oraxen").getDescription().getVersion().startsWith("1") ? 1 : 2));
             } catch (Exception ignore) {
             }
         }

bukkit/src/main/java/net/momirealms/customnameplates/bukkit/BukkitCustomNameplates.java

@@ -40,6 +40,7 @@ import net.momirealms.customnameplates.bukkit.command.BukkitCommandManager;
 import net.momirealms.customnameplates.bukkit.compatibility.NameplatesExpansion;
 import net.momirealms.customnameplates.bukkit.compatibility.NameplatesExtraExpansion;
 import net.momirealms.customnameplates.bukkit.compatibility.cosmetic.MagicCosmeticsHook;
+import net.momirealms.customnameplates.bukkit.compatibility.region.WorldGuardRegion;
 import net.momirealms.customnameplates.bukkit.requirement.BukkitRequirementManager;
 import net.momirealms.customnameplates.bukkit.scheduler.BukkitSchedulerAdapter;
 import net.momirealms.customnameplates.bukkit.util.SimpleLocation;
@@ -204,6 +205,12 @@ public class BukkitCustomNameplates extends CustomNameplates implements Listener
             } catch (Exception ignore) {
             }
         }
+        if (Bukkit.getPluginManager().isPluginEnabled("WorldGuard")) {
+            try {
+                WorldGuardRegion.register();
+            } catch (Exception ignore) {
+            }
+        }
 
         boolean downloadFromPolymart = polymart.equals("1");
         boolean downloadFromBBB = buildByBit.equals("true");
@@ -302,6 +309,8 @@ public class BukkitCustomNameplates extends CustomNameplates implements Listener
         for (CNPlayer player : getOnlinePlayers()) {
             ((AbstractCNPlayer) player).reload();
         }
+        // clear requirement ids
+        this.requirementManager.reload();
         // load basics
         this.configManager.reload();
         this.storageManager.reload();
@@ -314,8 +323,6 @@ public class BukkitCustomNameplates extends CustomNameplates implements Listener
         this.advanceManager.reload();
         // set up placeholders
         this.placeholderManager.reload();
-        // set up requirements
-        this.requirementManager.reload();
         // use the placeholders
         this.actionBarManager.reload();
         this.bossBarManager.reload();

bukkit/src/main/java/net/momirealms/customnameplates/bukkit/BukkitPlatform.java

@@ -204,22 +204,61 @@ public class BukkitPlatform implements Platform {
             }
         }, "PacketPlayOutEntityDestroy", "ClientboundRemoveEntitiesPacket");
 
+        // for skin plugin compatibility
+        registerPacketConsumer((player, event, packet) -> {
+            try {
+                UUID pUUID = player.uuid();
+                @SuppressWarnings("unchecked")
+                List<UUID> uuids = (List<UUID>) Reflections.field$ClientboundPlayerInfoRemovePacket$profileIds.get(packet);
+                for (UUID uuid : uuids) {
+                    if (uuid.equals(pUUID)) {
+                        CNPlayer removed = CustomNameplates.getInstance().getPlayer(uuid);
+                        if (removed != null) {
+                            removed.removePlayerFromTracker(player);
+                            CustomNameplates.getInstance().getUnlimitedTagManager().onRemovePlayer(removed, player);
+                        }
+                    }
+                }
+            } catch (ReflectiveOperationException e) {
+                CustomNameplates.getInstance().getPluginLogger().severe("Failed to handle ClientboundPlayerInfoRemovePacket", e);
+            }
+        }, "ClientboundPlayerInfoRemovePacket");
+
         registerPacketConsumer((player, event, packet) -> {
             try {
                 EnumSet<?> enums = (EnumSet<?>) Reflections.field$ClientboundPlayerInfoUpdatePacket$actions.get(packet);
                 if (enums == null) return;
-                if (!enums.contains(Reflections.enum$ClientboundPlayerInfoUpdatePacket$Action$UPDATE_GAME_MODE)) return;
-                List<Object> entries = (List<Object>) Reflections.field$ClientboundPlayerInfoUpdatePacket$entries.get(packet);
-                for (Object entry : entries) {
-                    UUID uuid = (UUID) Reflections.field$ClientboundPlayerInfoUpdatePacket$Entry$profileId.get(entry);
-                    if (uuid == null) continue;
-                    Object gameType = Reflections.field$ClientboundPlayerInfoUpdatePacket$Entry$gameMode.get(entry);
-                    if (gameType == null) continue;
-                    int mode = (int) Reflections.method$GameType$getId.invoke(gameType);
-                    boolean isSpectator = mode == 3;
-                    CNPlayer another = CustomNameplates.getInstance().getPlayer(uuid);
-                    if (another != null) {
-                        CustomNameplates.getInstance().getUnlimitedTagManager().onPlayerGameModeChange(another, player, isSpectator);
+                UUID pUUID = player.uuid();
+                boolean add_player = enums.contains(Reflections.enum$ClientboundPlayerInfoUpdatePacket$Action$ADD_PLAYER);
+                boolean update_gamemode = enums.contains(Reflections.enum$ClientboundPlayerInfoUpdatePacket$Action$UPDATE_GAME_MODE);
+                if (add_player || update_gamemode) {
+                    @SuppressWarnings("unchecked")
+                    List<Object> entries = (List<Object>) Reflections.field$ClientboundPlayerInfoUpdatePacket$entries.get(packet);
+                    for (Object entry : entries) {
+                        UUID uuid = (UUID) Reflections.field$ClientboundPlayerInfoUpdatePacket$Entry$profileId.get(entry);
+                        if (uuid == null) continue;
+
+                        // for skin plugin compatibility
+                        if (add_player && uuid.equals(pUUID)) {
+                            if (player.isTempPreviewing() || player.isToggleablePreviewing() || CustomNameplates.getInstance().getUnlimitedTagManager().isAlwaysShow()) {
+                                Tracker tracker = player.addPlayerToTracker(player);
+                                tracker.setScale(player.scale());
+                                tracker.setCrouching(player.isCrouching());
+                                tracker.setSpectator(player.isSpectator());
+                                CustomNameplates.getInstance().getUnlimitedTagManager().onAddPlayer(player, player);
+                            }
+                        }
+
+                        CNPlayer another = CustomNameplates.getInstance().getPlayer(uuid);
+                        if (update_gamemode) {
+                            Object gameType = Reflections.field$ClientboundPlayerInfoUpdatePacket$Entry$gameMode.get(entry);
+                            if (gameType == null) continue;
+                            int mode = (int) Reflections.method$GameType$getId.invoke(gameType);
+                            boolean isSpectator = mode == 3;
+                            if (another != null) {
+                                CustomNameplates.getInstance().getUnlimitedTagManager().onPlayerGameModeChange(another, player, isSpectator);
+                            }
+                        }
                     }
                 }
             } catch (ReflectiveOperationException e) {

bukkit/src/main/java/net/momirealms/customnameplates/bukkit/command/feature/NameplatesPreviewCommand.java

@@ -19,6 +19,7 @@ package net.momirealms.customnameplates.bukkit.command.feature;
 
 import net.momirealms.customnameplates.api.CNPlayer;
 import net.momirealms.customnameplates.api.ConfigManager;
+import net.momirealms.customnameplates.api.CustomNameplates;
 import net.momirealms.customnameplates.api.feature.JoinQuitListener;
 import net.momirealms.customnameplates.bukkit.BukkitCustomNameplates;
 import net.momirealms.customnameplates.bukkit.command.BukkitCommandFeature;
@@ -45,6 +46,7 @@ public class NameplatesPreviewCommand extends BukkitCommandFeature<CommandSender
                 .senderType(Player.class)
                 .handler(context -> {
                     if (!ConfigManager.nametagModule()) return;
+                    if (CustomNameplates.getInstance().getUnlimitedTagManager().isAlwaysShow()) return;
                     CNPlayer player = plugin.getPlayer(context.sender().getUniqueId());
                     if (player == null) {
                         throw new RuntimeException("Player should not be null");

bukkit/src/main/java/net/momirealms/customnameplates/bukkit/requirement/BukkitRequirementManager.java

@@ -52,6 +52,14 @@ public class BukkitRequirementManager extends AbstractRequirementManager {
         this.registerGameMode();
         this.registerBedrock();
         this.registerDisguise();
+        this.registerPassenger();
+    }
+
+    private void registerPassenger() {
+        this.registerRequirement((args, interval) -> {
+            boolean is = (boolean) args;
+            return new PassengerRequirement(interval, is);
+        }, "is-passenger");
     }
 
     private void registerDisguise() {

bukkit/src/main/java/net/momirealms/customnameplates/bukkit/requirement/builtin/PassengerRequirement.java

@@ -0,0 +1,55 @@
+/*
+ *  Copyright (C) <2024> <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.bukkit.requirement.builtin;
+
+import com.google.common.base.Objects;
+import net.momirealms.customnameplates.api.CNPlayer;
+import net.momirealms.customnameplates.backend.requirement.AbstractRequirement;
+import org.bukkit.entity.Player;
+
+public class PassengerRequirement extends AbstractRequirement {
+
+	private final boolean is;
+
+	public PassengerRequirement(int refreshInterval, boolean is) {
+		super(refreshInterval);
+		this.is = is;
+	}
+
+	@Override
+	public boolean isSatisfied(CNPlayer p1, CNPlayer p2) {
+		return ((Player) p1.player()).isInsideVehicle();
+	}
+
+	@Override
+	public String type() {
+		return "is-passenger";
+	}
+
+	@Override
+	public boolean equals(Object o) {
+		if (this == o) return true;
+		if (!(o instanceof PassengerRequirement that)) return false;
+        return is == that.is;
+	}
+
+	@Override
+	public int hashCode() {
+		return Objects.hashCode(is);
+	}
+}

bukkit/src/main/java/net/momirealms/customnameplates/bukkit/util/Reflections.java

@@ -429,6 +429,18 @@ public class Reflections {
             )
     );
 
+    public static final Class<?> clazz$ClientboundPlayerInfoRemovePacket = requireNonNull(
+            ReflectionUtils.getClazz(
+                    BukkitReflectionUtils.assembleMCClass("network.protocol.game.ClientboundPlayerInfoRemovePacket")
+            )
+    );
+
+    public static final Field field$ClientboundPlayerInfoRemovePacket$profileIds = requireNonNull(
+            ReflectionUtils.getInstanceDeclaredField(
+                    clazz$ClientboundPlayerInfoRemovePacket, 0
+            )
+    );
+
     public static final Field field$ClientboundRemoveEntitiesPacket$entityIds = requireNonNull(
             ReflectionUtils.getInstanceDeclaredField(
                     clazz$ClientboundRemoveEntitiesPacket, 0
@@ -819,7 +831,7 @@ public class Reflections {
     );
 
     public static final Enum<?> enum$ClientboundPlayerInfoUpdatePacket$Action$UPDATE_GAME_MODE;
-
+    public static final Enum<?> enum$ClientboundPlayerInfoUpdatePacket$Action$ADD_PLAYER;
 
     static {
         Enum<?> updateGameMode;
@@ -829,6 +841,14 @@ public class Reflections {
             updateGameMode = Enum.valueOf((Class<Enum>) clazz$ClientboundPlayerInfoUpdatePacket$Action, "c");
         }
         enum$ClientboundPlayerInfoUpdatePacket$Action$UPDATE_GAME_MODE = updateGameMode;
+
+        Enum<?> addPlayer;
+        try {
+            addPlayer = Enum.valueOf((Class<Enum>) clazz$ClientboundPlayerInfoUpdatePacket$Action, "ADD_PLAYER");
+        } catch (Exception e) {
+            addPlayer = Enum.valueOf((Class<Enum>) clazz$ClientboundPlayerInfoUpdatePacket$Action, "a");
+        }
+        enum$ClientboundPlayerInfoUpdatePacket$Action$ADD_PLAYER = addPlayer;
     }
 
     public static final Class<?> clazz$ClientboundPlayerInfoUpdatePacket$Entry = requireNonNull(

bukkit/src/main/resources/plugin.yml

@@ -15,6 +15,7 @@ softdepend:
   - AdvancedChat
   - VentureChat
   - EssentialsChat
+  - WorldGuard
 permissions:
   nameplates.command.equip:
     default: true

compatibility/build.gradle.kts

@@ -11,11 +11,16 @@ repositories {
     maven("https://repo.essentialsx.net/releases/") // ess
     maven("https://repo.md-5.net/content/groups/public/") // disguise
     maven("https://repo.opencollab.dev/main/") // geyser
+    maven("https://maven.enginehub.org/repo/") // worldguard worldedit
 }
 
 dependencies {
     compileOnly(project(":api"))
     compileOnly(project(":common"))
+    compileOnly(project(":backend"))
+    compileOnly("dev.dejvokep:boosted-yaml:${rootProject.properties["boosted_yaml_version"]}")
+    // WorldGuard
+    compileOnly("com.sk89q.worldguard:worldguard-bukkit:7.0.9")
     // Platform
     compileOnly("dev.folia:folia-api:${rootProject.properties["paper_version"]}-R0.1-SNAPSHOT")
     // Chat

compatibility/src/main/java/net/momirealms/customnameplates/bukkit/compatibility/emoji/OraxenEmojiProvider.java

@@ -24,14 +24,24 @@ import net.momirealms.customnameplates.api.CNPlayer;
 import net.momirealms.customnameplates.api.feature.chat.emoji.EmojiProvider;
 import org.bukkit.entity.Player;
 
+import java.lang.reflect.Method;
 import java.util.Map;
 
 public class OraxenEmojiProvider implements EmojiProvider {
 
     private final FontManager fontManager;
 
-    public OraxenEmojiProvider() {
-        this.fontManager = OraxenPlugin.get().getFontManager();
+    public OraxenEmojiProvider(int version) {
+        if (version == 1) {
+            this.fontManager = OraxenPlugin.get().getFontManager();
+        } else {
+            try {
+                Method fm = OraxenPlugin.class.getMethod("fontManager");
+                this.fontManager = (FontManager) fm.invoke(OraxenPlugin.get());
+            } catch (ReflectiveOperationException e) {
+                throw new RuntimeException(e);
+            }
+        }
     }
 
     @Override

compatibility/src/main/java/net/momirealms/customnameplates/bukkit/compatibility/region/RegionRequirement.java

@@ -0,0 +1,92 @@
+/*
+ *  Copyright (C) <2024> <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.bukkit.compatibility.region;
+
+import com.google.common.base.Objects;
+import com.sk89q.worldedit.bukkit.BukkitAdapter;
+import com.sk89q.worldedit.math.BlockVector3;
+import com.sk89q.worldguard.WorldGuard;
+import com.sk89q.worldguard.protection.ApplicableRegionSet;
+import com.sk89q.worldguard.protection.managers.RegionManager;
+import com.sk89q.worldguard.protection.regions.ProtectedRegion;
+import net.momirealms.customnameplates.api.CNPlayer;
+import net.momirealms.customnameplates.backend.requirement.AbstractRequirement;
+import org.bukkit.Location;
+import org.bukkit.entity.Player;
+
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.List;
+import java.util.Set;
+import java.util.stream.Collectors;
+
+public class RegionRequirement extends AbstractRequirement {
+
+    private final List<String> regions;
+    private final int mode;
+
+    public RegionRequirement(int refreshInterval, int mode, Collection<String> regions) {
+        super(refreshInterval);
+        this.regions = new ArrayList<>(regions);
+        this.mode = mode;
+    }
+
+    @Override
+    public boolean isSatisfied(CNPlayer p1, CNPlayer p2) {
+        Location location = ((Player) p1.player()).getLocation();
+        RegionManager regionManager = WorldGuard.getInstance().getPlatform().getRegionContainer().get(BukkitAdapter.adapt(location.getWorld()));
+        if (regionManager != null) {
+            ApplicableRegionSet set = regionManager.getApplicableRegions(BlockVector3.at(location.getBlockX(), location.getBlockY(), location.getBlockZ()));
+            if (mode == 1) {
+                for (ProtectedRegion region : set) {
+                    if (regions.contains(region.getId())) {
+                        return true;
+                    }
+                }
+            } else if (mode == 2) {
+                outer: {
+                    Set<String> ids = set.getRegions().stream().map(ProtectedRegion::getId).collect(Collectors.toSet());
+                    for (String region : regions) {
+                        if (!ids.contains(region)) {
+                            break outer;
+                        }
+                    }
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+
+    @Override
+    public String type() {
+        return "region";
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (!(o instanceof RegionRequirement that)) return false;
+        return mode == that.mode && Objects.equal(regions, that.regions);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(regions, mode);
+    }
+}

compatibility/src/main/java/net/momirealms/customnameplates/bukkit/compatibility/region/WorldGuardRegion.java

@@ -0,0 +1,51 @@
+/*
+ *  Copyright (C) <2024> <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.bukkit.compatibility.region;
+
+import dev.dejvokep.boostedyaml.block.implementation.Section;
+import net.momirealms.customnameplates.api.CustomNameplates;
+import net.momirealms.customnameplates.api.requirement.EmptyRequirement;
+
+import java.util.HashSet;
+import java.util.List;
+
+public class WorldGuardRegion {
+
+    public static void register() {
+        CustomNameplates.getInstance().getRequirementManager().registerRequirement((args, interval) -> {
+            HashSet<String> regions = new HashSet<>();
+            int mode = 1;
+            if (args instanceof Section section) {
+                mode = section.getInt("mode", 1);
+                regions.addAll(section.getStringList("values"));
+            } else {
+                if (args instanceof List<?> list) {
+                    for (Object o : list) {
+                        if (o instanceof String) {
+                            regions.add((String) o);
+                        }
+                    }
+                } else {
+                    CustomNameplates.getInstance().getPluginLogger().warn("Invalid value type: " + args.getClass().getSimpleName() + " found at region requirement which is expected be `Section` or `StringList`");
+                    return EmptyRequirement.instance();
+                }
+            }
+            return new RegionRequirement(interval, mode, regions);
+        }, "region");
+    }
+}

gradle.properties

@@ -1,6 +1,6 @@
 # Project settings
 # Rule: [major update].[feature update].[bug fix]
-project_version=3.0.7
+project_version=3.0.10
 config_version=32
 project_group=net.momirealms
 
@@ -44,6 +44,7 @@ vault_version=1.7
 guava_version=33.3.1-jre
 commons_io_version=2.17.0
 lwjgl_version=3.3.4
+fastutil_version=8.5.15
 
 # Proxy settings
 #systemProp.socks.proxyHost=127.0.0.1