Sync LunarClient Mods & Options

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

@@ -57,6 +57,7 @@
 import com.lunarclient.apollo.mods.impl.ModHypixelMod;
 import com.lunarclient.apollo.mods.impl.ModInventoryMod;
 import com.lunarclient.apollo.mods.impl.ModItemCounter;
+import com.lunarclient.apollo.mods.impl.ModItemCustomizer;
 import com.lunarclient.apollo.mods.impl.ModItemPhysics;
 import com.lunarclient.apollo.mods.impl.ModItemTracker;
 import com.lunarclient.apollo.mods.impl.ModKeystrokes;
@@ -160,7 +161,6 @@ public final class Mods {
             ModNametag.class,
             ModShulkerPreview.class,
             ModScrollableTooltips.class,
-            ModUhcOverlay.class,
             ModParticleChanger.class,
             ModNickHider.class,
             ModCooldowns.class,
@@ -212,6 +212,7 @@ public final class Mods {
             ModDamageTint.class,
             ModMobSize.class,
             ModSkyblock.class,
+            ModItemCustomizer.class,
             ModHorseStats.class,
             ModOverlayMod.class,
             ModRewind.class,
@@ -220,7 +221,8 @@ public final class Mods {
             ModKillSounds.class,
             ModInventoryMod.class,
             ModF3Display.class,
-            ModRadio.class
+            ModRadio.class,
+            ModUhcOverlay.class
         );
 
     private Mods() {

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

@@ -173,11 +173,12 @@ public final class ModChat {
         .build();
 
     /**
-     * No documentation available.
+     * Prevents your chat history from being cleared when disconnecting from or switching between servers.
      *
      * @since 1.0.0
      */
     public static final SimpleOption<Boolean> NO_CLOSE_MY_CHAT = SimpleOption.<Boolean>builder()
+        .comment("Prevents your chat history from being cleared when disconnecting from or switching between servers.")
         .node("chat", "no-close-my-chat").type(TypeToken.get(Boolean.class))
         .defaultValue(true)
         .notifyClient()

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

@@ -26,6 +26,7 @@
 import com.lunarclient.apollo.option.NumberOption;
 import com.lunarclient.apollo.option.SimpleOption;
 import io.leangen.geantyref.TypeToken;
+import java.awt.Color;
 
 /**
  * Allows servers to display items or abilities that are on cooldown on the HUD.
@@ -57,6 +58,50 @@ public final class ModCooldowns {
         .notifyClient()
         .build();
 
+    /**
+     * No documentation available.
+     *
+     * @since 1.2.5
+     */
+    public static final SimpleOption<Color> COOLDOWN_CIRCLE_START_COLOR = SimpleOption.<Color>builder()
+        .node("cooldowns", "cooldown-circle-start-color").type(TypeToken.get(Color.class))
+        .defaultValue(new Color(89, 89, 89, 153))
+        .notifyClient()
+        .build();
+
+    /**
+     * No documentation available.
+     *
+     * @since 1.2.5
+     */
+    public static final SimpleOption<Color> COOLDOWN_CIRCLE_END_COLOR = SimpleOption.<Color>builder()
+        .node("cooldowns", "cooldown-circle-end-color").type(TypeToken.get(Color.class))
+        .defaultValue(new Color(229, 229, 229))
+        .notifyClient()
+        .build();
+
+    /**
+     * No documentation available.
+     *
+     * @since 1.2.5
+     */
+    public static final SimpleOption<Color> COOLDOWN_EDGE_COLOR = SimpleOption.<Color>builder()
+        .node("cooldowns", "cooldown-edge-color").type(TypeToken.get(Color.class))
+        .defaultValue(new Color(64, 64, 64))
+        .notifyClient()
+        .build();
+
+    /**
+     * No documentation available.
+     *
+     * @since 1.2.5
+     */
+    public static final SimpleOption<Color> TEXT_COLOR = SimpleOption.<Color>builder()
+        .node("cooldowns", "text-color").type(TypeToken.get(Color.class))
+        .defaultValue(new Color(255, 255, 255))
+        .notifyClient()
+        .build();
+
     private ModCooldowns() {
     }
 

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

@@ -81,6 +81,28 @@ public final class ModHypixelBedwars {
         .notifyClient()
         .build();
 
+    /**
+     * No documentation available.
+     *
+     * @since 1.2.5
+     */
+    public static final SimpleOption<Boolean> BW_HIDE_FOOD_BAR = SimpleOption.<Boolean>builder()
+        .node("hypixel-bedwars", "bw-hide-food-bar").type(TypeToken.get(Boolean.class))
+        .defaultValue(false)
+        .notifyClient()
+        .build();
+
+    /**
+     * No documentation available.
+     *
+     * @since 1.2.5
+     */
+    public static final SimpleOption<Boolean> BW_HIDE_ARMOR_BAR = SimpleOption.<Boolean>builder()
+        .node("hypixel-bedwars", "bw-hide-armor-bar").type(TypeToken.get(Boolean.class))
+        .defaultValue(false)
+        .notifyClient()
+        .build();
+
     /**
      * No documentation available.
      *

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

@@ -0,0 +1,50 @@
+/*
+ * 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.mods.impl;
+
+import com.lunarclient.apollo.option.SimpleOption;
+import io.leangen.geantyref.TypeToken;
+
+/**
+ * Allows you to customize the rendering/animation of held and dropped items.
+ *
+ * @since 1.2.5
+ */
+public final class ModItemCustomizer {
+
+    /**
+     * No documentation available.
+     *
+     * @since 1.2.5
+     */
+    public static final SimpleOption<Boolean> ENABLED = SimpleOption.<Boolean>builder()
+        .node("item-customizer", "enabled").type(TypeToken.get(Boolean.class))
+        .defaultValue(false)
+        .notifyClient()
+        .build();
+
+    private ModItemCustomizer() {
+    }
+
+}

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

@@ -28,6 +28,7 @@
 
 /**
  * Revert certain visuals and animations to how they behaved on 1.7.
+ * Note: the settings of this mod are unique on 1.8, and don't carry over to later versions, and vice versa.
  *
  * @since 1.0.0
  */
@@ -44,6 +45,18 @@ public final class ModOneSevenVisuals {
         .notifyClient()
         .build();
 
+    /**
+     * 1.7: Right-clicking while breaking blocks will stop the block break.
+     *
+     * @since 1.2.5
+     */
+    public static final SimpleOption<Boolean> USE_ITEM_WHILE_DIGGING = SimpleOption.<Boolean>builder()
+        .comment("1.7: Right-clicking while breaking blocks will stop the block break")
+        .node("one-seven-visuals", "use-item-while-digging").type(TypeToken.get(Boolean.class))
+        .defaultValue(true)
+        .notifyClient()
+        .build();
+
     /**
      * Provides better visual feedback when attacking while keeping vanilla behavior.
      *

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

@@ -82,30 +82,6 @@ public final class ModOverlayMod {
         .notifyClient()
         .build();
 
-    /**
-     * No documentation available.
-     *
-     * @since 1.2.2
-     */
-    public static final NumberOption<Float> TOTEM_SCALE = NumberOption.<Float>number()
-        .node("overlay-mod", "totem-scale").type(TypeToken.get(Float.class))
-        .min(0.25F).max(1.5F)
-        .defaultValue(1.0F)
-        .notifyClient()
-        .build();
-
-    /**
-     * No documentation available.
-     *
-     * @since 1.2.2
-     */
-    public static final NumberOption<Float> HELD_ITEM_SCALE = NumberOption.<Float>number()
-        .node("overlay-mod", "held-item-scale").type(TypeToken.get(Float.class))
-        .min(0.25F).max(1.5F)
-        .defaultValue(1.0F)
-        .notifyClient()
-        .build();
-
     /**
      * No documentation available.
      *
@@ -633,6 +609,32 @@ public final class ModOverlayMod {
         .notifyClient()
         .build();
 
+    /**
+     * No documentation available.
+     *
+     * @since 1.2.2
+     */
+    @Deprecated
+    public static final NumberOption<Float> TOTEM_SCALE = NumberOption.<Float>number()
+        .node("overlay-mod", "totem-scale").type(TypeToken.get(Float.class))
+        .min(0.25F).max(1.5F)
+        .defaultValue(1.0F)
+        .notifyClient()
+        .build();
+
+    /**
+     * No documentation available.
+     *
+     * @since 1.2.2
+     */
+    @Deprecated
+    public static final NumberOption<Float> HELD_ITEM_SCALE = NumberOption.<Float>number()
+        .node("overlay-mod", "held-item-scale").type(TypeToken.get(Float.class))
+        .min(0.25F).max(1.5F)
+        .defaultValue(1.0F)
+        .notifyClient()
+        .build();
+
     private ModOverlayMod() {
     }
 

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

@@ -177,12 +177,13 @@ public final class ModSkyblock {
         .build();
 
     /**
-     * No documentation available.
+     * Fixes being unable to use the "Pick Block" keybind on items when it is bound to a mouse button.
      *
-     * @since 1.2.1
+     * @since 1.2.5
      */
-    public static final SimpleOption<Boolean> SKYBLOCK_BOW_REEQUIP = SimpleOption.<Boolean>builder()
-        .node("skyblock", "skyblock-bow-reequip").type(TypeToken.get(Boolean.class))
+    public static final SimpleOption<Boolean> MIDDLE_CLICK_ARMOR_FIX = SimpleOption.<Boolean>builder()
+        .comment("Fixes being unable to use the \"Pick Block\" keybind on items when it is bound to a mouse button.")
+        .node("skyblock", "middle-click-armor-fix").type(TypeToken.get(Boolean.class))
         .defaultValue(true)
         .notifyClient()
         .build();
@@ -276,17 +277,6 @@ public final class ModSkyblock {
         .notifyClient()
         .build();
 
-    /**
-     * No documentation available.
-     *
-     * @since 1.2.2
-     */
-    public static final SimpleOption<Boolean> SKYBLOCK_HIDE_RANDOM_BOSSBARS = SimpleOption.<Boolean>builder()
-        .node("skyblock", "skyblock-hide-random-bossbars").type(TypeToken.get(Boolean.class))
-        .defaultValue(true)
-        .notifyClient()
-        .build();
-
     /**
      * Provides QOL for the Diana mayor that helps the user quickly locate burrows.
      *
@@ -409,18 +399,6 @@ public final class ModSkyblock {
         .notifyClient()
         .build();
 
-    /**
-     * Changes crop hitboxes with their 1.12+ variant. Only enabled on Hypixel or singleplayer.
-     *
-     * @since 1.0.9
-     */
-    public static final SimpleOption<Boolean> TALLER_CROPS = SimpleOption.<Boolean>builder()
-        .comment("Changes crop hitboxes with their 1.12+ variant. Only enabled on Hypixel or singleplayer.")
-        .node("skyblock", "taller-crops").type(TypeToken.get(Boolean.class))
-        .defaultValue(false)
-        .notifyClient()
-        .build();
-
     /**
      * No documentation available.
      *
@@ -899,6 +877,66 @@ public final class ModSkyblock {
         .notifyClient()
         .build();
 
+    /**
+     * No documentation available.
+     *
+     * @since 1.2.5
+     */
+    public static final SimpleOption<Boolean> CUSTOM_CHIME_VOLUME_ENABLED = SimpleOption.<Boolean>builder()
+        .node("skyblock", "custom-chime-volume-enabled").type(TypeToken.get(Boolean.class))
+        .defaultValue(false)
+        .notifyClient()
+        .build();
+
+    /**
+     * No documentation available.
+     *
+     * @since 1.2.5
+     */
+    public static final NumberOption<Float> CUSTOM_CHIME_VOLUME = NumberOption.<Float>number()
+        .node("skyblock", "custom-chime-volume").type(TypeToken.get(Float.class))
+        .min(0.0F).max(1.0F)
+        .defaultValue(5.0F)
+        .notifyClient()
+        .build();
+
+    /**
+     * No documentation available.
+     *
+     * @since 1.2.1
+     */
+    @Deprecated
+    public static final SimpleOption<Boolean> SKYBLOCK_BOW_REEQUIP = SimpleOption.<Boolean>builder()
+        .node("skyblock", "skyblock-bow-reequip").type(TypeToken.get(Boolean.class))
+        .defaultValue(true)
+        .notifyClient()
+        .build();
+
+    /**
+     * No documentation available.
+     *
+     * @since 1.2.2
+     */
+    @Deprecated
+    public static final SimpleOption<Boolean> SKYBLOCK_HIDE_RANDOM_BOSSBARS = SimpleOption.<Boolean>builder()
+        .node("skyblock", "skyblock-hide-random-bossbars").type(TypeToken.get(Boolean.class))
+        .defaultValue(true)
+        .notifyClient()
+        .build();
+
+    /**
+     * Changes crop hitboxes with their 1.12+ variant. Only enabled on Hypixel or singleplayer.
+     *
+     * @since 1.0.9
+     */
+    @Deprecated
+    public static final SimpleOption<Boolean> TALLER_CROPS = SimpleOption.<Boolean>builder()
+        .comment("Changes crop hitboxes with their 1.12+ variant. Only enabled on Hypixel or singleplayer.")
+        .node("skyblock", "taller-crops").type(TypeToken.get(Boolean.class))
+        .defaultValue(false)
+        .notifyClient()
+        .build();
+
     /**
      * No documentation available.
      *