added config option to enable chat format

Author: zefir-git

.run/Package.run.xml

@@ -0,0 +1,32 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="Package" type="MavenRunConfiguration" factoryName="Maven">
+    <MavenSettings>
+      <option name="myGeneralSettings" />
+      <option name="myRunnerSettings" />
+      <option name="myRunnerParameters">
+        <MavenRunnerParameters>
+          <option name="cmdOptions" />
+          <option name="profiles">
+            <set />
+          </option>
+          <option name="goals">
+            <list>
+              <option value="package" />
+            </list>
+          </option>
+          <option name="multimoduleDir" />
+          <option name="pomFileName" />
+          <option name="profilesMap">
+            <map />
+          </option>
+          <option name="projectsCmdOptionValues">
+            <list />
+          </option>
+          <option name="resolveToWorkspace" value="false" />
+          <option name="workingDirPath" value="$PROJECT_DIR$" />
+        </MavenRunnerParameters>
+      </option>
+    </MavenSettings>
+    <method v="2" />
+  </configuration>
+</component>

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

@@ -1,13 +1,26 @@
 package pro.cloudnode.smp.cloudnodemsg;
 
+import io.papermc.paper.chat.ChatRenderer;
+import me.clip.placeholderapi.PlaceholderAPI;
+import net.kyori.adventure.audience.Audience;
+import net.kyori.adventure.key.Key;
 import net.kyori.adventure.text.Component;
+import net.kyori.adventure.text.event.ClickEvent;
+import net.kyori.adventure.text.event.HoverEvent;
+import net.kyori.adventure.text.format.TextColor;
 import net.kyori.adventure.text.minimessage.MiniMessage;
+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.OfflinePlayer;
 import org.bukkit.configuration.file.FileConfiguration;
+import org.bukkit.entity.Player;
 import org.bukkit.scoreboard.Team;
 import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
 
 import java.util.Objects;
+import java.util.Optional;
 
 public final class PluginConfig {
     public @NotNull FileConfiguration config;
@@ -305,6 +318,44 @@ public PluginConfig(final @NotNull FileConfiguration config) {
         );
     }
 
+    /**
+     * Chat format
+     */
+    public @NotNull Optional<@NotNull ChatRenderer> chatFormat() {
+        final @Nullable String str = config.getString("chat-format");
+        if (str == null || str.equals("null") || str.isBlank())
+            return Optional.empty();
+        return Optional.of((source, sourceDisplayName, message, viewer) -> MiniMessage.miniMessage().deserialize(
+                str,
+                Placeholder.component("message", message),
+                TagResolver.resolver("papi", (args, ctx) -> {
+                    String placeholder = args.popOr("placeholder expected").value().trim();
+                    if (!placeholder.startsWith("%") && !placeholder.endsWith("%"))
+                        placeholder = "%" + placeholder + "%";
+                    if (!CloudnodeMSG.getInstance().getServer().getPluginManager().isPluginEnabled("PlaceholderAPI"))
+                        CloudnodeMSG.getInstance().getLogger().severe("Attempted to use PlaceholderAPI placeholder `" + placeholder
+                                + "` in chat format, but PlaceholderAPI is not present!");
+                    return Tag.inserting(Component.text(PlaceholderAPI.setPlaceholders(source, placeholder)));
+                }),
+                TagResolver.resolver("has-team", (args, ctx) -> {
+                    final String text = args.popOr("text expected").value();
+                    final Team team = source.getScoreboard().getPlayerTeam(source);
+                    if (team == null) {
+                        if (args.hasNext())
+                            return Tag.inserting(MiniMessage.miniMessage().deserialize(args.popOr("expected fallback value").value()));
+                        else return Tag.inserting(Component.empty());
+                    }
+                    return Tag.inserting(ctx.deserialize(text,
+                            Placeholder.component("team", team.displayName())
+                    ));
+                }),
+                TagResolver.resolver("player", (args, ctx) -> Tag.inserting(
+                        Component.text(source.getName())
+                                 .clickEvent(ClickEvent.suggestCommand("/tell " + source.getName() + " "))
+                ))
+        ));
+    }
+
     /**
      * No permission
      */

src/main/java/pro/cloudnode/smp/cloudnodemsg/listener/AsyncChatListener.java

@@ -1,7 +1,9 @@
 package pro.cloudnode.smp.cloudnodemsg.listener;
 
+import io.papermc.paper.chat.ChatRenderer;
 import io.papermc.paper.event.player.AsyncChatEvent;
 import net.kyori.adventure.audience.Audience;
+import net.kyori.adventure.text.Component;
 import org.bukkit.OfflinePlayer;
 import org.bukkit.Server;
 import org.bukkit.entity.Player;
@@ -68,4 +70,10 @@ public void teamChannel(final @NotNull AsyncChatEvent event) {
         }
         TeamMessageCommand.sendTeamMessage(sender, team.get(), event.message());
     }
+
+    @EventHandler(priority = EventPriority.LOWEST, ignoreCancelled = true)
+    public void chatFormat(final @NotNull AsyncChatEvent event) {
+        final @NotNull Optional<@NotNull ChatRenderer> format = CloudnodeMSG.getInstance().config().chatFormat();
+        format.ifPresent(event::renderer);
+    }
 }

src/main/resources/config.yml

@@ -88,6 +88,20 @@ toggle:
         #  <player> - the player's username
         other: "<green>(!) Re-enabled receiving of private messages for <gray><player></gray>.</green>"
 
+# Set custom global/public chat format. Disabled by default.
+#
+# Placeholders:
+#  <has-team:'if yes':'if no'> - show a different message based on whether the player is in a team
+#  <team> - the player's team display name (only works in <has-team>)
+#  <player> - the name of the player, when clicked suggests command `/tell` followed by the player's name
+#  <message> - the message being sent in chat
+#  <papi:…> - use a PlaceholderAPI placeholder, example `<papi:%player_displayname%>` or `<papi:player_displayname>`.
+#             Requires PlaceholderAPI to be installed.
+#
+# Example:
+#chat-format: <has-team:'<dark_gray>[<white><team></white>]</dark_gray> '><white><player></white><dark_gray>:</dark_gray> <gray><message></gray>
+chat-format: null
+
 # Error messages
 errors:
     # No permission