Add /profile, /seen, /following, /confess; FollowModule; achievement rarity; silent 5h update checks; Discord markdown color codes

Major feature additions (all four surfaces are new in this commit):

  /profile [player]  — rich player passport embed (avatar, NameMC
                       link, first/last seen, sessions, total
                       playtime, advancement count, link status,
                       follower count, online indicator) with a
                       Follow/Unfollow button that DMs the
                       requester whenever the player logs in.
  /seen <player>     — quick last-seen lookup with relative
                       Discord timestamps and playtime.
  /following         — list of Minecraft players the requester
                       follows.
  /confess <message> — anonymous confessions to a configured
                       channels.confessions; confessors get a
                       stable Confessor #XXXX handle.

Under the hood:
  * FollowModule (new) — in-memory player→follower cache, JDA
    openPrivateChannel() DM dispatch on join, button handler.
  * FollowModule dispatches in parallel via PlatformAdapter.
  * StorageManager + YamlStorage + MySQLStorage grew 12 new
    methods (last_seen, first_join, sessions, advancement
    unlock ledger, follow graph). YAML uses three new files;
    MySQL uses three new tables.
  * AdvancementListener now persists unlocks and reads rarity
    stats in an async hop; the embed gains a First-of-the-day
    badge (1 unlockers) or a Rare-N% badge (<25% of active).
  * UpdateChecker now polls every 5h (was 6) and posts a
    single quiet embed to misc.update-channel via
    postSilentDiscordNotice(); AtomicBoolean guards the
    one-time post. misc.update-silent suppresses the in-game
    admin banner for operators who want only the Discord
    notice.
  * ColorUtil.toDiscordMarkdown converts &l/&o/&n/&m to
    Discord markdown (** * __ ~~); colour codes are dropped.
    Applied to every player-visible embed field that
    previously went through ColorUtil.stripColor (so player
    authors of confessions, welcome messages, and embed
    templates keep their formatting).
  * PlayerProfileBuilder — single source of truth for the
    profile-card embed. LeaderboardModule.getStat added for
    per-player stat lookups.

Config additions:
  channels.confessions      — /confess target channel
  misc.update-silent        — suppress in-game update banner
  misc.update-channel       — silent Discord notice channel
  profile.embed.color       — profile card colour

Tests:
  * 8 new ColorUtil.toDiscordMarkdown cases (bold/italic/
    underline/strike/colour drop/section-sign/nested
    runs/null).
  * 5 new YamlStorage cases (lastSeen monotonic,
    firstJoin set-once, session counter, advancement
    idempotence, follower round-trip).

Version stays at 1.1.0; the release workflow will republish
v1.1.0 on the next green push.

Author: ZDiscord Maintainer

CHANGELOG.md

@@ -7,6 +7,75 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 ## [Unreleased]
 
 ### Added
+- `/profile [player]` Discord slash command that renders a rich
+  "player passport" embed: avatar, NameMC link, first/last seen
+  (relative Discord timestamps), session count, total playtime,
+  advancement count, link status, follower count, and online
+  indicator. A **Follow** / **Unfollow** button on the embed
+  subscribes the requester to DM notifications whenever the
+  player logs in.
+- `/seen <player>` Discord slash command for quick last-seen
+  lookups. Returns online/offline status, last-seen timestamp,
+  total tracked playtime, and session count.
+- `/following` Discord slash command listing the Minecraft
+  players the requester currently follows.
+- `/confess <message>` Discord slash command that posts an
+  anonymous confession to a configured `channels.confessions`
+  channel. Each confessor gets a stable "Confessor #XXXX" handle
+  derived from their user id hash. `&` colour codes in the
+  message are converted to Discord markdown.
+- Silent update check every 5 hours (was 6). When a new release
+  is detected, a single quiet embed is posted to
+  `misc.update-channel` (no pings, no looping) and a
+  `misc.update-silent` flag suppresses the in-game admin banner
+  for operators who want to keep console/Discord as the only
+  signal.
+- Achievement **rarity display**: the advancement announcement
+  embed now includes a "First of the day" badge when the player
+  is the first to unlock that advancement in the last 24 hours,
+  and a "Rare — only N% of players have this" badge when fewer
+  than 25% of active players have ever unlocked it.
+- Player activity storage (per-player `last_seen`, `first_join`,
+  `sessions`, advancement unlock ledger, follow relationships).
+  YAML uses new `player_activity.yml`, `advancement_unlocks.yml`,
+  and `player_follows.yml` files; MySQL uses three new tables.
+- `ColorUtil.toDiscordMarkdown(text)` converts Minecraft
+  formatting codes (`&l` bold, `&o` italic, `&n` underline,
+  `&m` strikethrough) to Discord markdown; colour codes (0-9,
+  a-f) are dropped. Applied to all player-visible embed text.
+- `FollowModule` keeps an in-memory cache of player→follower
+  sets and dispatches DM notifications on join via JDA's
+  `User.openPrivateChannel()` API. The cache is populated
+  lazily on the first join and refreshed on add/remove.
+- `LeaderboardModule.getStat(uuid, stat)` for cheap per-player
+  stat lookups (used by the profile card and `/seen`).
+- `PlayerProfileBuilder` util — single source of truth for the
+  profile-card embed.
+
+### Changed
+- `YamlStorage` and `MySQLStorage` grew three new files / three
+  new tables each, plus 12 new methods on the
+  `StorageManager` interface.
+- `AdvancementListener` now persists the unlock to storage and
+  reads the rarity stats in an async hop before posting the
+  embed on the main thread (so a slow disk can't stall the
+  event).
+- `UpdateChecker` interval is now 5 hours (was 6). The
+  `postSilentDiscordNotice(...)` helper only fires once per
+  detected release thanks to an `AtomicBoolean` guard.
+- `JoinQuitListener` writes `last_seen` and increments the
+  session counter on every join; the same on every quit, so
+  the timestamp stays fresh even if the player disconnects
+  abnormally.
+- `ColorUtil.stripColor` is now only used internally for
+  pre-processing before `toDiscordMarkdown` runs; the embed
+  fields use the new converter so formatting is preserved.
+
+### Fixed
+- `JoinQuitListener` no longer double-calls the in-game
+  welcome message on Paper (the `first-join-message` is now
+  also rendered through `toDiscordMarkdown` so it carries its
+  formatting into the events channel embed).
 - MockBukkit test framework with JUnit 5. The build workflow now runs
   the unit test suite in CI; new tests cover config loading, ticket
   category parsing, status embed structure, update-checker version

src/main/java/dev/demonz/zdiscord/ZDiscord.java

@@ -35,6 +35,7 @@
 import dev.demonz.zdiscord.modules.CommandLoggerModule;
 import dev.demonz.zdiscord.modules.ConsoleModule;
 import dev.demonz.zdiscord.modules.EmbedBuilderModule;
+import dev.demonz.zdiscord.modules.FollowModule;
 import dev.demonz.zdiscord.modules.LeaderboardModule;
 import dev.demonz.zdiscord.modules.LinkModule;
 import dev.demonz.zdiscord.modules.PerformanceModule;
@@ -87,6 +88,7 @@ public class ZDiscord extends JavaPlugin {
     private StaffChatModule staffChatModule;
     private VoiceStatusModule voiceStatusModule;
     private ConsoleModule consoleModule;
+    private FollowModule followModule;
 
     @Override
     public void onEnable() {
@@ -144,6 +146,7 @@ public void onDisable() {
         if (staffChatModule != null) staffChatModule.shutdown();
         if (voiceStatusModule != null) voiceStatusModule.shutdown();
         if (consoleModule != null) consoleModule.shutdown();
+        if (followModule != null) followModule.shutdown();
 
         if (storageManager != null) storageManager.shutdown();
         if (webhookManager != null) webhookManager.shutdown();
@@ -244,6 +247,9 @@ private void initModules() {
             voiceStatusModule.init();
         }
 
+        followModule = new FollowModule(this);
+        followModule.init();
+
         getLogger().info("Modules initialised.");
     }
 
@@ -295,6 +301,7 @@ public void reload() {
         if (commandLoggerModule != null) commandLoggerModule.reload();
         if (staffChatModule != null) staffChatModule.reload();
         if (voiceStatusModule != null) voiceStatusModule.reload();
+        if (followModule != null) followModule.reload();
 
         if (botManager != null && botManager.isConnected()) {
             botManager.updateActivity();
@@ -386,6 +393,10 @@ public ConsoleModule getConsoleModule() {
         return consoleModule;
     }
 
+    public FollowModule getFollowModule() {
+        return followModule;
+    }
+
     public void debug(String message) {
         if (configManager.getBoolean("misc.debug", false)) {
             getLogger().log(Level.INFO, "[debug] " + message);

src/main/java/dev/demonz/zdiscord/discord/SlashCommandManager.java

@@ -18,19 +18,24 @@
 
 import dev.demonz.zdiscord.ZDiscord;
 import dev.demonz.zdiscord.util.ColorUtil;
+import dev.demonz.zdiscord.util.HeadUtil;
 import dev.demonz.zdiscord.util.PlaceholderUtil;
+import dev.demonz.zdiscord.util.PlayerProfileBuilder;
 import dev.demonz.zdiscord.util.StatusEmbedBuilder;
 import dev.demonz.zdiscord.util.TPSUtil;
 import net.dv8tion.jda.api.EmbedBuilder;
 import net.dv8tion.jda.api.entities.Guild;
 import net.dv8tion.jda.api.events.interaction.command.SlashCommandInteractionEvent;
+import net.dv8tion.jda.api.events.interaction.component.ButtonInteractionEvent;
 import net.dv8tion.jda.api.hooks.ListenerAdapter;
 import net.dv8tion.jda.api.interactions.commands.OptionType;
 import net.dv8tion.jda.api.interactions.commands.build.Commands;
 import org.bukkit.Bukkit;
+import org.bukkit.OfflinePlayer;
 import org.bukkit.entity.Player;
 
 import java.time.Instant;
+import java.util.UUID;
 import java.util.stream.Collectors;
 
 /**
@@ -70,7 +75,17 @@ public void registerCommands() {
                                 "Quick setup: module name (chat, status, events, etc.)",
                                 false, true)
                         .addOption(OptionType.CHANNEL, "channel",
-                                "Quick setup: target channel", false))
+                                "Quick setup: target channel", false),
+                Commands.slash("profile", "View a Minecraft player's profile card")
+                        .addOption(OptionType.STRING, "player",
+                                "Player name (omit for yourself)", false),
+                Commands.slash("seen", "When was a player last online?")
+                        .addOption(OptionType.STRING, "player",
+                                "Player name", true),
+                Commands.slash("following", "List the Minecraft players you follow"),
+                Commands.slash("confess", "Post an anonymous confession to the confessions channel")
+                        .addOption(OptionType.STRING, "message",
+                                "What do you want to confess?", true))
                 .queue(
                         success -> plugin.getLogger().info("Registered "
                                 + success.size() + " slash commands."),
@@ -107,6 +122,18 @@ public void onSlashCommandInteraction(SlashCommandInteractionEvent event) {
             case "leaderboard":
                 handleLeaderboard(event);
                 break;
+            case "profile":
+                handleProfile(event);
+                break;
+            case "seen":
+                handleSeen(event);
+                break;
+            case "following":
+                handleFollowing(event);
+                break;
+            case "confess":
+                handleConfess(event);
+                break;
             default:
                 break;
         }
@@ -242,4 +269,195 @@ private void handleLeaderboard(SlashCommandInteractionEvent event) {
         String stat = event.getOption("stat").getAsString();
         plugin.getLeaderboardModule().sendLeaderboard(event, stat);
     }
+
+    private void handleProfile(SlashCommandInteractionEvent event) {
+        // The work below does offline-player lookups + a few storage
+        // reads; we run it off the event handler thread to keep the
+        // JDA thread responsive even on a slow disk.
+        event.deferReply().queue();
+        String queryName = event.getOption("player") == null
+                ? null
+                : event.getOption("player").getAsString();
+        String discordTag = event.getUser().getAsTag();
+
+        plugin.getPlatformAdapter().runAsync(() -> {
+            OfflinePlayer target = resolveProfileTarget(queryName, event.getUser().getId());
+            if (target == null) {
+                String msg = queryName == null
+                        ? "You don't have a linked Minecraft account yet. "
+                                + "Run `/link <code>` after `/zdiscord link` in-game, "
+                                + "or pass `player:<name>` to look up someone else."
+                        : "No player named **" + queryName + "** has joined this server before.";
+                event.getHook().sendMessage(msg).setEphemeral(true).queue();
+                return;
+            }
+
+            PlayerProfileBuilder.Profile profile =
+                    PlayerProfileBuilder.build(plugin, target);
+            EmbedBuilder embed = PlayerProfileBuilder.toEmbed(plugin, profile, discordTag);
+
+            if (plugin.getFollowModule() != null) {
+                boolean following = plugin.getFollowModule()
+                        .isFollowing(profile.uuid, event.getUser().getId());
+                var rows = new java.util.ArrayList<net.dv8tion.jda.api.interactions.components.LayoutComponent>();
+                rows.add(net.dv8tion.jda.api.interactions.components.ActionRow.of(
+                        following
+                                ? plugin.getFollowModule().buildUnfollowButton(profile.uuid)
+                                : plugin.getFollowModule().buildFollowButton(profile.uuid)));
+                event.getHook().sendMessageEmbeds(embed.build())
+                        .addComponents(rows).queue();
+            } else {
+                event.getHook().sendMessageEmbeds(embed.build()).queue();
+            }
+        });
+    }
+
+    private OfflinePlayer resolveProfileTarget(String queryName, String requesterDiscordId) {
+        if (queryName != null && !queryName.isEmpty()) {
+            return PlayerProfileBuilder.findOfflineByName(queryName);
+        }
+        // No name → look up the requester's linked MC account.
+        if (plugin.getLinkModule() == null) {
+            return null;
+        }
+        UUID mcUuid = plugin.getLinkModule().getPlayerUUID(requesterDiscordId);
+        if (mcUuid == null) {
+            return null;
+        }
+        return Bukkit.getOfflinePlayer(mcUuid);
+    }
+
+    private void handleSeen(SlashCommandInteractionEvent event) {
+        event.deferReply().queue();
+        String queryName = event.getOption("player").getAsString();
+        plugin.getPlatformAdapter().runAsync(() -> {
+            OfflinePlayer target = PlayerProfileBuilder.findOfflineByName(queryName);
+            if (target == null) {
+                event.getHook().sendMessage("No player named **" + queryName
+                        + "** has joined this server before.")
+                        .setEphemeral(true).queue();
+                return;
+            }
+            UUID uuid = target.getUniqueId();
+            String name = target.getName() != null ? target.getName() : "Unknown";
+            long lastSeen = plugin.getStorageManager().getLastSeen(uuid);
+            long playtimeSec = plugin.getLeaderboardModule() != null
+                    ? plugin.getLeaderboardModule().getStat(uuid, "playtime")
+                    : 0L;
+
+            EmbedBuilder embed = new EmbedBuilder()
+                    .setAuthor(name + "  ·  Last seen",
+                            "https://namemc.com/profile/" + uuid,
+                            HeadUtil.crafatar(uuid))
+                    .setColor(ColorUtil.parseHex("#3498DB"))
+                    .setTimestamp(Instant.now());
+
+            if (target.isOnline()) {
+                embed.setDescription(":green_circle: **" + name + "** is online right now.");
+            } else if (lastSeen > 0) {
+                embed.setDescription("Last seen: <t:" + (lastSeen / 1000L) + ":R>.")
+                        .addField("Last seen", "<t:" + (lastSeen / 1000L) + ":F>", false)
+                        .addField("Total playtime",
+                                PlayerProfileBuilder.formatDuration(playtimeSec), true)
+                        .addField("Sessions", String.valueOf(
+                                plugin.getStorageManager().getSessions(uuid)), true);
+            } else {
+                embed.setDescription("No activity recorded for **" + name + "** yet.");
+            }
+            event.getHook().sendMessageEmbeds(embed.build()).queue();
+        });
+    }
+
+    private void handleFollowing(SlashCommandInteractionEvent event) {
+        event.deferReply().queue();
+        String discordId = event.getUser().getId();
+        plugin.getPlatformAdapter().runAsync(() -> {
+            if (plugin.getFollowModule() == null) {
+                event.getHook().sendMessage("The follow feature is disabled.")
+                        .setEphemeral(true).queue();
+                return;
+            }
+            java.util.Set<UUID> followed = plugin.getFollowModule().getFollowedPlayers(discordId);
+            if (followed.isEmpty()) {
+                event.getHook().sendMessage(
+                        "You aren't following any Minecraft players. "
+                                + "Use `/profile player:<name>` to find someone and hit **Follow**.")
+                        .setEphemeral(true).queue();
+                return;
+            }
+            StringBuilder sb = new StringBuilder();
+            for (UUID uuid : followed) {
+                OfflinePlayer op = Bukkit.getOfflinePlayer(uuid);
+                String name = op.getName() != null ? op.getName() : uuid.toString();
+                sb.append(":small_blue_diamond: **").append(name).append("**")
+                        .append("  (`").append(uuid).append("`)\n");
+            }
+            EmbedBuilder embed = new EmbedBuilder()
+                    .setTitle("Following " + followed.size() + " player"
+                            + (followed.size() == 1 ? "" : "s"))
+                    .setDescription(sb.toString())
+                    .setColor(ColorUtil.parseHex("#9B59B6"))
+                    .setTimestamp(Instant.now());
+            event.getHook().sendMessageEmbeds(embed.build()).queue();
+        });
+    }
+
+    @Override
+    public void onButtonInteraction(ButtonInteractionEvent event) {
+        String id = event.getComponentId();
+        if (id == null) {
+            return;
+        }
+        if (id.startsWith(dev.demonz.zdiscord.modules.FollowModule.FOLLOW_BUTTON_ID)
+                || id.startsWith(dev.demonz.zdiscord.modules.FollowModule.UNFOLLOW_BUTTON_ID)) {
+            if (plugin.getFollowModule() != null) {
+                plugin.getFollowModule().handleFollowButton(event);
+            } else {
+                event.reply("The follow feature is disabled.").setEphemeral(true).queue();
+            }
+        }
+    }
+
+    private void handleConfess(SlashCommandInteractionEvent event) {
+        String channelId = plugin.getConfigManager()
+                .getString("channels.confessions", "").trim();
+        if (channelId.isEmpty() || channelId.startsWith("YOUR_")) {
+            event.reply(":lock: Confessions are disabled on this server "
+                    + "(no `channels.confessions` is configured).")
+                    .setEphemeral(true).queue();
+            return;
+        }
+        var channel = plugin.getBotManager().getJda()
+                .getTextChannelById(channelId);
+        if (channel == null) {
+            event.reply(":lock: Confessions are disabled on this server "
+                    + "(the configured channel could not be found).")
+                    .setEphemeral(true).queue();
+            return;
+        }
+        String message = event.getOption("message").getAsString();
+        if (message.length() > 1500) {
+            event.reply(":lock: Your confession is too long (max 1500 characters).")
+                    .setEphemeral(true).queue();
+            return;
+        }
+        // Anonymise: a deterministic but unguessable handle based
+        // on the user id (so the same person keeps the same
+        // handle, which is nice for ongoing confessions, but the
+        // handle itself reveals nothing).
+        String handle = "Confessor #" + Math.abs(event.getUser().getId().hashCode() % 10000);
+
+        EmbedBuilder embed = new EmbedBuilder()
+                .setAuthor(":love_letter: A new confession", null, null)
+                .setDescription(ColorUtil.toDiscordMarkdown(message))
+                .setColor(0x9B59B6)
+                .setFooter(handle + "  ·  posted at", null)
+                .setTimestamp(Instant.now());
+
+        channel.sendMessageEmbeds(embed.build()).queue(
+                success -> event.reply(":white_check_mark: Your confession was posted anonymously.")
+                        .setEphemeral(true).queue(),
+                error -> event.reply(":x: Failed to post your confession: "
+                        + error.getMessage()).setEphemeral(true).queue());
+    }
 }