Added configurable message sounds

Author: zefir-git

.idea/codeStyles/Project.xml

@@ -89,6 +89,17 @@ public void send(final @NotNull Context context) throws InvalidPlayerError {
             setReplyTo(sender, recipient);
         if (recipient.getUniqueId().equals(console.getUniqueId()) || (recipientPlayer.isPresent() && !Message.hasChannel(recipientPlayer.get(), sender)))
             setReplyTo(recipient, sender);
+
+        senderPlayer.ifPresent(player -> CloudnodeMSG.getInstance()
+                .config()
+                .sound(PluginConfig.SoundEvent.PERSONAL_OUTGOING)
+                .ifPresent(sound -> sound.play(player))
+        );
+        recipientPlayer.ifPresent(player -> CloudnodeMSG.getInstance()
+                .config()
+                .sound(PluginConfig.SoundEvent.PERSONAL_INCOMING)
+                .ifPresent(sound -> sound.play(player))
+        );
     }
 
     public final static @NotNull OfflinePlayer console = CloudnodeMSG.getInstance().getServer()
@@ -315,7 +326,7 @@ public static boolean hasTeamChannel(final @NotNull Player player) {
     /**
      * The context in which this message is sent
      */
-    public static enum Context {
+    public enum Context {
         /**
          * Message sent via command (i.e. no special context)
          */

.idea/codeStyles/codeStyleConfig.xml

@@ -12,7 +12,10 @@
 import net.kyori.adventure.text.minimessage.tag.Tag;
 import net.kyori.adventure.text.minimessage.tag.resolver.Placeholder;
 import net.kyori.adventure.text.minimessage.tag.resolver.TagResolver;
+import org.bukkit.NamespacedKey;
 import org.bukkit.OfflinePlayer;
+import org.bukkit.Registry;
+import org.bukkit.Sound;
 import org.bukkit.configuration.file.FileConfiguration;
 import org.bukkit.entity.Player;
 import org.bukkit.scoreboard.Team;
@@ -356,6 +359,34 @@ public PluginConfig(final @NotNull FileConfiguration config) {
         ));
     }
 
+    public @NotNull Optional<@NotNull ConfiguredSound> sound(final @NotNull SoundEvent event) {
+        final @Nullable String name = config.getString(String.format("sound.%s.sound", event.key));
+        if (name == null || name.isBlank() || name.equalsIgnoreCase("null") || name.equalsIgnoreCase("none")) {
+            return Optional.empty();
+        }
+
+        final @Nullable NamespacedKey key = name.indexOf(':') > -1
+                ? NamespacedKey.fromString(name)
+                : NamespacedKey.minecraft(name);
+
+        if (key == null) {
+            CloudnodeMSG.getInstance().getLogger().warning(String.format("Invalid sound identifier ‘%s’ for sound event ‘%s’", name, event.key));
+            return Optional.empty();
+        }
+
+        final @Nullable Sound sound = Registry.SOUNDS.get(key);
+
+        if (sound == null) {
+            CloudnodeMSG.getInstance().getLogger().warning(String.format("Unknown sound ‘%s’ for sound event ‘%s’", name, event.key));
+            return Optional.empty();
+        }
+
+        final float volume = (float) config.getDouble(String.format("sound.%s.volume", event.key), 1.0);
+        final float pitch = (float) config.getDouble(String.format("sound.%s.pitch", event.key), 1.0);
+
+        return Optional.of(new ConfiguredSound(sound, volume, pitch));
+    }
+
     /**
      * No permission
      */
@@ -476,5 +507,23 @@ public PluginConfig(final @NotNull FileConfiguration config) {
     public @NotNull Component notInTeam() {
         return MiniMessage.miniMessage().deserialize(Objects.requireNonNull(config.getString("errors.not-in-team")));
     }
-}
 
+    public enum SoundEvent {
+        PERSONAL_INCOMING("personal.incoming"),
+        PERSONAL_OUTGOING("personal.outgoing"),
+        TEAM_INCOMING("team.incoming"),
+        TEAM_OUTGOING("team.outgoing");
+
+        public final @NotNull String key;
+
+        SoundEvent(final @NotNull String key) {
+            this.key = key;
+        }
+    }
+
+    public record ConfiguredSound(@NotNull Sound sound, float volume, float pitch) {
+        public void play(final @NotNull Player player) {
+            player.playSound(player, sound, volume, pitch);
+        }
+    }
+}

src/main/java/pro/cloudnode/smp/cloudnodemsg/Message.java

@@ -9,6 +9,7 @@
 import pro.cloudnode.smp.cloudnodemsg.CloudnodeMSG;
 import pro.cloudnode.smp.cloudnodemsg.Message;
 import pro.cloudnode.smp.cloudnodemsg.Permissions;
+import pro.cloudnode.smp.cloudnodemsg.PluginConfig;
 import pro.cloudnode.smp.cloudnodemsg.error.NoPermissionError;
 import pro.cloudnode.smp.cloudnodemsg.error.NotInTeamError;
 import pro.cloudnode.smp.cloudnodemsg.error.NotPlayerError;
@@ -48,7 +49,19 @@ public boolean run(final @NotNull CommandSender sender, final @NotNull String la
      * Send message to online team members
      */
     public static boolean sendTeamMessage(final @NotNull Player sender, final @NotNull Team team, final @NotNull Component message) {
+        CloudnodeMSG.getInstance()
+                .config()
+                .sound(PluginConfig.SoundEvent.TEAM_OUTGOING)
+                .ifPresent(sound -> sound.play(sender));
+
         for (final @NotNull Player player : sender.getServer().getOnlinePlayers()) {
+            if (!sender.getUniqueId().equals(player.getUniqueId())) {
+                CloudnodeMSG.getInstance()
+                        .config()
+                        .sound(PluginConfig.SoundEvent.TEAM_INCOMING)
+                        .ifPresent(sound -> sound.play(player));
+            }
+
             if (Message.isIgnored(player, sender)) continue;
             if (Optional.ofNullable(player.getScoreboard().getPlayerTeam(player)).map(t -> t.equals(team))
                     .orElse(false))

src/main/java/pro/cloudnode/smp/cloudnodemsg/PluginConfig.java

@@ -102,6 +102,38 @@ toggle:
 #chat-format: <has-team:'<dark_gray>[<white><team></white>]</dark_gray> '><white><player></white><dark_gray>:</dark_gray> <gray><message></gray>
 chat-format: null
 
+# Play a sound…
+sound:
+  personal:
+    # …when receiving a private message
+    incoming:
+      # The ID of the sound.
+      # Set to null, none, or "" to disable.
+      sound: entity.chicken.egg
+
+      # Volume of the sound from 0.0 to 1.0. Decrease to be quieter.
+      volume: 1.0
+
+      # Pitch of the sound from 0.5 to 2.0.
+      # Optional: defaults to 1.0.
+      # Values below 1.0 lower the pitch and increase the duration;
+      # values above 1.0 raise the pitch and reduce the duration.
+      pitch: 0.82
+
+    # …when sending a private message
+    outgoing:
+      sound: null
+
+  team:
+    # …when receiving a team message
+    incoming:
+      sound: ui.hud.bubble_pop
+      pitch: .7
+
+    # …when sending a team message
+    outgoing:
+      sound: null
+
 # Error messages
 errors:
     # No permission