From 6aeca39a1c2b51becb7a6053f5b11d118e0d0aa2 Mon Sep 17 00:00:00 2001
From: Zefir Kirilov <contact@zefir.pro>
Date: Mon, 26 Jan 2026 15:08:27 +0200
Subject: [PATCH 1/2] Removed unnecessary quotes from config

---
 src/main/resources/config.yml | 54 +++++++++++++++++------------------
 1 file changed, 27 insertions(+), 27 deletions(-)

diff --git a/src/main/resources/config.yml b/src/main/resources/config.yml
index 6012eb5..6038585 100644
--- a/src/main/resources/config.yml
+++ b/src/main/resources/config.yml
@@ -3,11 +3,11 @@
 #  <sender> - the username of the message sender
 #  <recipient> - the username of the message recipient
 #  <message> - the message text
-incoming: '<click:suggest_command:/msg <sender> ><dark_gray>[<#60a5fa><sender></#60a5fa> <white>-></white> <#bfdbfe>me</#bfdbfe>]</dark_gray></click> <reset><#dbeafe><message></#dbeafe>'
+incoming: <click:suggest_command:/msg <sender> ><dark_gray>[<#60a5fa><sender></#60a5fa> <white>-></white> <#bfdbfe>me</#bfdbfe>]</dark_gray></click> <reset><#dbeafe><message></#dbeafe>
 
 # Outgoing message format (sender's point of view)
 # Same placeholders as incoming
-outgoing: '<click:suggest_command:/msg <recipient> ><dark_gray>[<#93c5fd>me</#93c5fd> <white>-></white> <#60a5fa><recipient></#60a5fa>]</dark_gray></click> <reset><#dbeafe><message></#dbeafe>'
+outgoing: <click:suggest_command:/msg <recipient> ><dark_gray>[<#93c5fd>me</#93c5fd> <white>-></white> <#60a5fa><recipient></#60a5fa>]</dark_gray></click> <reset><#dbeafe><message></#dbeafe>
 
 # Team message
 # Uses the vanilla teams from `/team`
@@ -15,24 +15,24 @@ outgoing: '<click:suggest_command:/msg <recipient> ><dark_gray>[<#93c5fd>me</#93
 #  <sender> - the username of the message sender
 #  <team> - team display name
 #  <message> - the message text
-team: '<click:suggest_command:/tm ><dark_gray>[<white><team></white>] <gray><sender></gray>:</dark_gray> <white><message></white></click>'
+team: <click:suggest_command:/tm ><dark_gray>[<white><team></white>] <gray><sender></gray>:</dark_gray> <white><message></white></click>
 
 # Private message format as seen by people with the spy permission and console
 # Same placeholders as incoming
-spy: '<dark_gray>[SPY] [<click:suggest_command:/msg <sender> ><gray><sender></gray></click> -> <click:suggest_command:/msg <recipient> ><gray><recipient></gray></click>] <gray><message></gray></dark_gray>'
+spy: <dark_gray>[SPY] [<click:suggest_command:/msg <sender> ><gray><sender></gray></click> -> <click:suggest_command:/msg <recipient> ><gray><recipient></gray></click>] <gray><message></gray></dark_gray>
 
 # Team message format as seen by people with the spy permission and console
 # Same placeholders as team
-team-spy: '<dark_gray>[SPY]</dark_gray> <dark_gray>[<white><team></white>] <gray><click:suggest_command:/msg <sender> ><sender></click></gray>:</dark_gray> <gray><message></gray>'
+team-spy: <dark_gray>[SPY]</dark_gray> <dark_gray>[<white><team></white>] <gray><click:suggest_command:/msg <sender> ><sender></click></gray>:</dark_gray> <gray><message></gray>
 
 # Player has successfully been ignored
 # Placeholders:
 #  <player> - the player's username
-ignored: "<green>(!) You will no longer see messages from <gray><player></gray>.</green>"
+ignored: <green>(!) You will no longer see messages from <gray><player></gray>.</green>
 
 # Player has successfully been unignored
 # Same placeholders as ignored
-unignored: "<yellow>(!) You are no longer ignoring <gray><player></gray>.</yellow>"
+unignored: <yellow>(!) You are no longer ignoring <gray><player></gray>.</yellow>
 
 channel:
     # Message channel created
@@ -63,30 +63,30 @@ channel:
     team-closed: <yellow>(!) Your chat messages will now be <gray>public</gray>.</yellow>
 
 # Name for console/server that should appear as <sender> or <recipient> in messages
-console-name: "Server"
+console-name: Server
 
 # Command usage format
 # Placeholders:
 #  <command> - the command name
 #  <usage> - the command usage parameters
-usage: "<yellow>(!) Usage:</yellow> <white>/<command> <usage></white>"
+usage: <yellow>(!) Usage:</yellow> <white>/<command> <usage></white>
 
 # Plugin reloaded
-reloaded: "<green>(!) Plugin successfully reloaded.</green>"
+reloaded: <green>(!) Plugin successfully reloaded.</green>
 
 toggle:
     disable:
         # Disable private messages
-        message: "<yellow>(!) Receiving private messages is now disabled. Run again to re-enable.</yellow>"
+        message: <yellow>(!) Receiving private messages is now disabled. Run again to re-enable.</yellow>
         # Placeholders:
         #  <player> - the player's username
-        other: "<green>(!) Receiving private messages now disabled for <gray><player></gray>.</green>"
+        other: <green>(!) Receiving private messages now disabled for <gray><player></gray>.</green>
     enable:
         # Enable private messages
-        message: "<green>(!) You can now receive private messages again.</green>"
+        message: <green>(!) You can now receive private messages again.</green>
         # Placeholders:
         #  <player> - the player's username
-        other: "<green>(!) Re-enabled receiving of private messages for <gray><player></gray>.</green>"
+        other: <green>(!) Re-enabled receiving of private messages for <gray><player></gray>.</green>
 
 # Set custom global/public chat format. Disabled by default.
 #
@@ -105,50 +105,50 @@ chat-format: null
 # Error messages
 errors:
     # No permission
-    no-permission: "<red>(!) You don't have permission to use this command.</red>"
+    no-permission: <red>(!) You don't have permission to use this command.</red>
 
     # Player has no username (somehow)
-    invalid-player: "<red>(!) Invalid player.</red>"
+    invalid-player: <red>(!) Invalid player.</red>
 
     # Player not found
     # Placeholders:
     #  <player> - the player's username
-    player-not-found: "<red>(!) Player <gray><player></gray> not found.</red>"
+    player-not-found: <red>(!) Player <gray><player></gray> not found.</red>
 
-    message-yourself: "<red>(!) You can't send a message to yourself.</red>"
+    message-yourself: <red>(!) You can't send a message to yourself.</red>
 
-    nobody-reply: "<red>(!) You have no one to reply to.</red>"
+    nobody-reply: <red>(!) You have no one to reply to.</red>
 
     # The player that messaged you is no longer online
     # Placeholders:
     #  <player> - the player's username
-    reply-offline: "<red>(!) Player <gray><player></gray> is no longer online.</red>"
+    reply-offline: <red>(!) Player <gray><player></gray> is no longer online.</red>
 
     # Only players can use this command
-    not-player: "<red>(!) You must be a player to use this command.</red>"
+    not-player: <red>(!) You must be a player to use this command.</red>
 
     # That player is not ignored
     # Placeholders:
     #  <player> - the player's username
-    not-ignored: "<red>(!) You are not ignoring that player.</red>"
+    not-ignored: <red>(!) You are not ignoring that player.</red>
 
     # Player cannot be ignored
     # Placeholders:
     #  <player> - the player's username
-    cannot-ignore: "<red>(!) You cannot ignore <gray><player></gray>.</red>"
+    cannot-ignore: <red>(!) You cannot ignore <gray><player></gray>.</red>
 
     # You are trying to ignore yourself
-    ignore-yourself: "<red>(!) You cannot ignore yourself.</red>"
+    ignore-yourself: <red>(!) You cannot ignore yourself.</red>
 
     # Target player has never joined the server
     # Placeholders:
     #  <player> - the player's username
-    never-joined: "<red>(!) <gray><player></gray> has never joined this server.</red>"
+    never-joined: <red>(!) <gray><player></gray> has never joined this server.</red>
 
     # Target player have disabled their incoming private messages.
     # Placeholders:
     #  <player> - the player's username
-    incoming-disabled: "<red>(!) You cannot message <gray><player></gray> because they have disabled private messages.</red>"
+    incoming-disabled: <red>(!) You cannot message <gray><player></gray> because they have disabled private messages.</red>
 
     # Trying to message a team, but not in one
-    not-in-team: "<red>(!) You are not in a team.</red>"
+    not-in-team: <red>(!) You are not in a team.</red>

From 25b12eacb716106508f6f458ebef9bd8096f942f Mon Sep 17 00:00:00 2001
From: Zefir Kirilov <contact@zefir.pro>
Date: Mon, 26 Jan 2026 16:28:32 +0200
Subject: [PATCH 2/2] Added configurable message sounds

---
 .idea/codeStyles/Project.xml                  |  1 +
 .idea/codeStyles/codeStyleConfig.xml          |  1 -
 .../cloudnode/smp/cloudnodemsg/Message.java   | 13 ++++-
 .../smp/cloudnodemsg/PluginConfig.java        | 51 ++++++++++++++++++-
 .../command/TeamMessageCommand.java           | 13 +++++
 src/main/resources/config.yml                 | 32 ++++++++++++
 6 files changed, 108 insertions(+), 3 deletions(-)

diff --git a/.idea/codeStyles/Project.xml b/.idea/codeStyles/Project.xml
index 2569ffc..c90d886 100644
--- a/.idea/codeStyles/Project.xml
+++ b/.idea/codeStyles/Project.xml
@@ -50,6 +50,7 @@
       <option name="DOWHILE_BRACE_FORCE" value="3" />
       <option name="WHILE_BRACE_FORCE" value="3" />
       <option name="FOR_BRACE_FORCE" value="3" />
+      <option name="ENUM_CONSTANTS_WRAP" value="2" />
       <option name="SOFT_MARGINS" value="120" />
       <arrangement>
         <rules>
diff --git a/.idea/codeStyles/codeStyleConfig.xml b/.idea/codeStyles/codeStyleConfig.xml
index 6e6eec1..79ee123 100644
--- a/.idea/codeStyles/codeStyleConfig.xml
+++ b/.idea/codeStyles/codeStyleConfig.xml
@@ -1,6 +1,5 @@
 <component name="ProjectCodeStyleConfiguration">
   <state>
     <option name="USE_PER_PROJECT_SETTINGS" value="true" />
-    <option name="PREFERRED_PROJECT_CODE_STYLE" value="Default" />
   </state>
 </component>
\ No newline at end of file
diff --git a/src/main/java/pro/cloudnode/smp/cloudnodemsg/Message.java b/src/main/java/pro/cloudnode/smp/cloudnodemsg/Message.java
index 3d00820..9947814 100644
--- a/src/main/java/pro/cloudnode/smp/cloudnodemsg/Message.java
+++ b/src/main/java/pro/cloudnode/smp/cloudnodemsg/Message.java
@@ -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)
          */
diff --git a/src/main/java/pro/cloudnode/smp/cloudnodemsg/PluginConfig.java b/src/main/java/pro/cloudnode/smp/cloudnodemsg/PluginConfig.java
index 2aa305e..3e3bb77 100644
--- a/src/main/java/pro/cloudnode/smp/cloudnodemsg/PluginConfig.java
+++ b/src/main/java/pro/cloudnode/smp/cloudnodemsg/PluginConfig.java
@@ -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);
+        }
+    }
+}
diff --git a/src/main/java/pro/cloudnode/smp/cloudnodemsg/command/TeamMessageCommand.java b/src/main/java/pro/cloudnode/smp/cloudnodemsg/command/TeamMessageCommand.java
index 0d377ba..a85a6ef 100644
--- a/src/main/java/pro/cloudnode/smp/cloudnodemsg/command/TeamMessageCommand.java
+++ b/src/main/java/pro/cloudnode/smp/cloudnodemsg/command/TeamMessageCommand.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))
diff --git a/src/main/resources/config.yml b/src/main/resources/config.yml
index 6038585..7f52e55 100644
--- a/src/main/resources/config.yml
+++ b/src/main/resources/config.yml
@@ -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