📝 Add action for auto messages module

Author: Maxlego08

src/main/java/fr/maxlego08/essentials/module/modules/AutoMessageModule.java

@@ -4,6 +4,8 @@
 import fr.maxlego08.essentials.ZEssentialsPlugin;
 import fr.maxlego08.essentials.api.configuration.NonLoadable;
 import fr.maxlego08.essentials.module.ZModule;
+import fr.maxlego08.menu.api.requirement.Action;
+import fr.maxlego08.menu.api.utils.Placeholders;
 import org.bukkit.configuration.file.YamlConfiguration;
 
 import java.util.ArrayList;
@@ -40,11 +42,17 @@ public void loadConfiguration() {
 
         YamlConfiguration configuration = getConfiguration();
         List<Map<?, ?>> messagesList = configuration.getMapList("messages");
+        int index = 0;
         for (Map<?, ?> map : messagesList) {
             List<String> lines = (List<String>) map.get("lines");
             if (lines != null) {
-                this.autoMessages.add(new AutoMessage(lines));
+                List<Map<String, Object>> actionElements = (List<Map<String, Object>>) map.get("actions");
+                List<Action> actions = actionElements != null
+                        ? this.plugin.getButtonManager().loadActions(actionElements, "messages[" + index + "].actions", getConfigurationFile())
+                        : new ArrayList<>();
+                this.autoMessages.add(new AutoMessage(lines, actions));
             }
+            index++;
         }
 
         if (this.isEnable && !this.autoMessages.isEmpty() && this.interval > 0) {
@@ -63,13 +71,17 @@ private void broadcastNextMessage() {
             this.currentIndex = (this.currentIndex + 1) % this.autoMessages.size();
         }
 
+        var fakeInventory = this.plugin.getInventoryManager().getFakeInventory();
         for (var player : this.plugin.getServer().getOnlinePlayers()) {
             for (String line : message.lines()) {
                 this.componentMessage.sendMessage(player, line);
             }
+            for (Action action : message.actions()) {
+                action.preExecute(player, null, fakeInventory, new Placeholders());
+            }
         }
     }
 
-    private record AutoMessage(List<String> lines) {
+    private record AutoMessage(List<String> lines, List<Action> actions) {
     }
 }

src/main/resources/modules/automessage/config.yml

@@ -20,14 +20,31 @@ interval: 300
 random-order: false
 
 # List of messages to broadcast
+# Each message can have optional 'actions' that will be executed for each player when the message is sent.
+# Actions use the zMenu action system. Available action types:
+#   - type: message          # Send additional messages
+#   - type: console command  # Execute console commands (%player% placeholder available)
+#   - type: player command   # Execute commands as player
+#   - type: sound            # Play a sound
+#   - type: actionbar        # Send an action bar message
+#   - type: title            # Send a title
+# See zMenu documentation for more action types: https://docs.zmenu.dev/
 messages:
   - lines:
       - ""
       - "#ffd353ℹ ᴀɴɴᴏᴜɴᴄᴇᴍᴇɴᴛ"
       - "&7Welcome to our server! Type &f/rules &7for server rules."
       - ""
+    # actions:
+    #   - type: sound
+    #     sound: BLOCK_NOTE_BLOCK_PLING
+    #     pitch: 1.0
+    #     volume: 1.0
   - lines:
       - ""
       - "#ffd353ℹ ᴀɴɴᴏᴜɴᴄᴇᴍᴇɴᴛ"
       - "&7Join our Discord: &f/discord"
       - ""
+    # actions:
+    #   - type: actionbar
+    #     message: "&eClick here to join our Discord!"