Version - 1.2.7 (#282)

* Deploy as `1.2.7-SNAPSHOT`

* example(internal): persistent npcs (#280)

* Add `PERSIST_COLORS_ON_UNLOAD` to ColoredFireModule (#281)

* Add modern Custom Model Data (#284)

* fix(velocity): legacy player detection (#285)

* Various additions to the Waypoint Module (#283)

* Feature - Emotes API (#286)

* Emotes API

* Update module overview

* Sync LunarClient Mods & Options (#288)

Co-authored-by: LunarClient Bot <lc-bot@moonsworth.com>

* Bump to 1.2.7 (#289)

---------

Co-authored-by: LunarClient Bot <lc-bot@moonsworth.com>

Author: ItsNature

api/src/main/java/com/lunarclient/apollo/common/icon/CustomModelData.java

@@ -0,0 +1,79 @@
+/*
+ * This file is part of Apollo, licensed under the MIT License.
+ *
+ * Copyright (c) 2026 Moonsworth
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package com.lunarclient.apollo.common.icon;
+
+import java.util.Collections;
+import java.util.List;
+import lombok.Builder;
+import lombok.Getter;
+
+/**
+ * Represents the custom model data attached to an {@link ItemStackIcon}.
+ *
+ * <p>Mirrors the Minecraft 1.21.4 {@code CustomModelData} item component, which
+ * replaced the single integer value with four parallel lists.</p>
+ *
+ * @since 1.2.7
+ */
+@Getter
+@Builder
+public final class CustomModelData {
+
+    /**
+     * Returns the custom model data {@link Float} values.
+     *
+     * @return the custom model data floats
+     * @since 1.2.7
+     */
+    @Builder.Default
+    List<Float> floats = Collections.emptyList();
+
+    /**
+     * Returns the custom model data {@link Boolean} flags.
+     *
+     * @return the custom model data flags
+     * @since 1.2.7
+     */
+    @Builder.Default
+    List<Boolean> flags = Collections.emptyList();
+
+    /**
+     * Returns the custom model data {@link String} values.
+     *
+     * @return the custom model data strings
+     * @since 1.2.7
+     */
+    @Builder.Default
+    List<String> strings = Collections.emptyList();
+
+    /**
+     * Returns the custom model data color {@link Integer} values.
+     *
+     * @return the custom model data colors
+     * @since 1.2.7
+     */
+    @Builder.Default
+    List<Integer> colors = Collections.emptyList();
+
+}

api/src/main/java/com/lunarclient/apollo/common/icon/ItemStackIcon.java

@@ -57,10 +57,20 @@ public final class ItemStackIcon extends Icon {
      * Returns the icon {@link Integer} custom model data.
      *
      * @return the icon custom model data
+     * @deprecated for removal since 1.2.7, use {@link ItemStackIcon#customModelDataObject} instead.
      * @since 1.0.7
      */
+    @Deprecated
     int customModelData;
 
+    /**
+     * Returns the icon {@link CustomModelData} object.
+     *
+     * @return the icon custom model data object
+     * @since 1.2.7
+     */
+    @Nullable CustomModelData customModelDataObject;
+
     /**
      * Returns the icon {@link Profile}.
      *

api/src/main/java/com/lunarclient/apollo/mods/Mods.java

@@ -135,7 +135,6 @@ public final class Mods {
             ModOneSevenVisuals.class,
             ModFps.class,
             ModCps.class,
-            ModSba.class,
             ModToggleSneak.class,
             ModZoom.class,
             ModHypixelMod.class,
@@ -206,7 +205,6 @@ public final class Mods {
             ModChunkBorders.class,
             ModSoundChanger.class,
             ModWaila.class,
-            ModNeu.class,
             ModHurtCam.class,
             ModTierTagger.class,
             ModDamageTint.class,
@@ -222,7 +220,9 @@ public final class Mods {
             ModInventoryMod.class,
             ModF3Display.class,
             ModRadio.class,
-            ModUhcOverlay.class
+            ModUhcOverlay.class,
+            ModSba.class,
+            ModNeu.class
         );
 
     private Mods() {

api/src/main/java/com/lunarclient/apollo/mods/impl/ModBossbar.java

@@ -87,7 +87,7 @@ public final class ModBossbar {
      */
     public static final SimpleOption<Boolean> CUSTOM_BOSS_BAR = SimpleOption.<Boolean>builder()
         .node("bossbar", "custom-boss-bar").type(TypeToken.get(Boolean.class))
-        .defaultValue(true)
+        .defaultValue(false)
         .notifyClient()
         .build();
 

api/src/main/java/com/lunarclient/apollo/mods/impl/ModNeu.java

@@ -27,17 +27,19 @@
 import io.leangen.geantyref.TypeToken;
 
 /**
- * Skyblock Mod made by Moulberry.
+ * No documentation available.
  *
  * @since 1.0.0
  */
+@Deprecated
 public final class ModNeu {
 
     /**
      * No documentation available.
      *
      * @since 1.0.0
      */
+    @Deprecated
     public static final SimpleOption<Boolean> ENABLED = SimpleOption.<Boolean>builder()
         .node("neu", "enabled").type(TypeToken.get(Boolean.class))
         .defaultValue(true)