v1.3.2

Author: xap3y

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>eu.xap3y</groupId>
     <artifactId>xagui</artifactId>
-    <version>1.3.1</version>
+    <version>1.3.2</version>
     <packaging>jar</packaging>
     <url>https://xagui.xap3y.space</url>
     <name>XaGui</name>

src/main/java/eu/xap3y/xagui/GuiMenu.java

@@ -67,6 +67,8 @@ public class GuiMenu implements InventoryHolder, GuiMenuInterface {
     private ItemStack nextPageButton = null;
     private ItemStack previousPageButton = null;
     private Sound pageSwitchSound = null;
+    private Sound openSound = null;
+    private float openSoundFloat = 1f;
 
     /** Callback invoked on inventory close. */
     public GuiCloseInterface onCloseAction = null;
@@ -891,6 +893,38 @@ public void setPageSwitchSound(Sound sound) {
         this.pageSwitchSound = sound;
     }
 
+    /**
+     * Set an optional sound to play when opening the GUI.
+     *
+     * @param sound open sound (nullable to disable)
+     * @param volume sound volume
+     */
+    @Override
+    public void setOpenSound(Sound sound, float volume) {
+        this.openSound = sound;
+        this.openSoundFloat = volume;
+    }
+
+    /**
+     * Get the sound played when opening the GUI.
+     *
+     * @return open sound
+     */
+    @Override
+    public Sound getOpenSound() {
+        return openSound;
+    }
+
+    /**
+     * Get the volume of the sound played when opening the GUI.
+     *
+     * @return open sound volume
+     */
+    @Override
+    public float getOpenSoundVolume() {
+        return openSoundFloat;
+    }
+
     // Borders
 
     /**

src/main/java/eu/xap3y/xagui/adapter/ParseUtil.java

@@ -61,10 +61,10 @@ public static Component parseText(String input) {
         // 1. Normalize section sign to ampersands
         String normalized = input.replace('§', '&');
 
-        // 2. Convert nibble hex (&x&F&F&0&0&0&A) -> <#FF000A>
+        // 2. Convert nibble hex (&x&F&F&0&0&0&A) -> <reset><#FF000A>
         normalized = convertNibbleHex(normalized);
 
-        // 3. Convert hash hex (&#FF00AA) -> <#FF00AA>
+        // 3. Convert hash hex (&#FF00AA) -> <reset><#FF00AA>
         normalized = convertHashHex(normalized);
 
         // 4. Convert legacy color and format codes to MiniMessage tags
@@ -81,7 +81,7 @@ public static Component parseText(String input) {
             try {
                 component = MINI.deserialize(normalized);
             } catch (Exception ex) {
-                // Fallback: do pure legacy parse on the original normalized (before conversions could be stored separately if desired)
+                // Fallback: do pure legacy parse
                 component = LegacyComponentSerializer.legacyAmpersand().deserialize(input.replace('§', '&'));
             }
         } else {
@@ -99,13 +99,14 @@ private static String convertHashHex(String s) {
         StringBuffer sb = new StringBuffer();
         while (m.find()) {
             String hex = m.group(1).toUpperCase();
-            m.appendReplacement(sb, "<#" + hex + ">");
+            // Color codes in legacy reset formatting; ensure we reset before applying color
+            m.appendReplacement(sb, "<reset><#" + hex + ">");
         }
         m.appendTail(sb);
         return sb.toString();
     }
 
-    // Convert &x&R&R&G&G&B&B sequences to <#RRGGBB>
+    // Convert &x&R&R&G&G&B&B sequences to <reset><#RRGGBB>
     private static String convertNibbleHex(String s) {
         StringBuilder out = new StringBuilder(s.length());
         int i = 0;
@@ -120,7 +121,7 @@ && isNibbleSequence(s, i)) {
                 for (int off = 3; off <= 13; off += 2) {
                     hex.append(s.charAt(i + off));
                 }
-                out.append("<#").append(hex.toString().toUpperCase()).append(">");
+                out.append("<reset><#").append(hex.toString().toUpperCase()).append(">");
                 i += 14;
             } else {
                 out.append(s.charAt(i));
@@ -157,17 +158,17 @@ private static String convertLegacyCodesToTags(String s) {
             if (c == '&' && i + 1 < s.length()) {
                 char code = Character.toLowerCase(s.charAt(i + 1));
 
-                // Formatting
+                // Formatting codes (&l, &o, &n, &m, &k, &r)
                 if (FORMAT_TAGS.containsKey(code)) {
                     String tag = FORMAT_TAGS.get(code);
                     out.append('<').append(tag).append('>');
                     i++;
                     continue;
                 }
-                // Color
+                // Color codes (&0..&f) should reset previous formatting
                 if (COLOR_TAGS.containsKey(code)) {
                     String tag = COLOR_TAGS.get(code);
-                    out.append('<').append(tag).append('>');
+                    out.append("<reset>").append('<').append(tag).append('>');
                     i++;
                     continue;
                 }

src/main/java/eu/xap3y/xagui/interfaces/GuiButtonInterface.java

@@ -50,6 +50,9 @@ public interface GuiButtonInterface {
 
     GuiButton withRedirect(Supplier<GuiMenuInterface> menu);
     GuiButton withClickSound(Sound sound, float volume);
+    default GuiButton withClickSound(Sound sound) {
+        return withClickSound(sound, 1.0f);
+    }
 
     void callRedirect(Player p);
 }

src/main/java/eu/xap3y/xagui/interfaces/GuiMenuInterface.java

@@ -91,6 +91,12 @@ public interface GuiMenuInterface {
     void setNextPageButton(ItemStack item);
     void setPreviousPageButton(ItemStack item);
     void setPageSwitchSound(Sound sound);
+    void setOpenSound(Sound sound, float volume);
+    default void setOpenSound(Sound sound) {
+        setOpenSound(sound, 1.0f);
+    }
+    Sound getOpenSound();
+    float getOpenSoundVolume();
 
     void fillBorder();
     void fillBorder(int page, ItemStack item);

src/main/java/eu/xap3y/xagui/listeners/MenuListener.java

@@ -122,6 +122,11 @@ public void onInventoryOpen(InventoryOpenEvent e) {
 
         XaGui.addOpenMenu(e.getPlayer().getUniqueId(), clickedInventory);
 
+        if (clickedInventory.getOpenSound() != null) {
+            Player player = (Player) e.getPlayer();
+            player.playSound(player, clickedInventory.getOpenSound(), clickedInventory.getOpenSoundVolume(), 1f);
+        }
+
         if (clickedInventory.onOpenAction != null) {
             clickedInventory.onOpenAction.onOpen(e);
         }