docs: clean up all docs, add DiscordSRV comparison, expand listings

Author: Cyrusbye720

.github/CONTRIBUTING.md

@@ -20,7 +20,7 @@ cd ZDiscord
 mvn clean package
 ```
 
-The shaded JAR is written to `target/ZDiscord-1.1.0.jar`. The build runs
+The shaded JAR is written to `target/ZDiscord-1.2.0.jar`. The build runs
 tests automatically during the `test` phase.
 
 ## Running tests

.github/ISSUE_TEMPLATE/bug_report.md

@@ -26,7 +26,7 @@ What actually happens. Include the exact error message or screenshot if relevant
 
 ## Environment
 
-- ZDiscord version: (e.g. 1.1.0)
+- ZDiscord version: (e.g. 1.2.0)
 - Server software and version: (e.g. Paper 1.20.4, Folia, Spigot 1.20.4)
 - Java version: (`java -version`)
 - Storage backend: (YAML or MySQL)

.github/SECURITY.md

@@ -4,6 +4,7 @@
 
 | Version | Supported |
 |---|---|
+| 1.2.x   | Yes       |
 | 1.1.x   | Yes       |
 | 1.0.x   | No        |
 

.github/listings/curseforge.md

@@ -20,7 +20,7 @@ Discord integration for Paper, Folia, and Spigot. Chat bridge with player heads,
 
 ZDiscord bridges your Minecraft server and Discord guild. Chat flows both ways, players see server status from Discord, and staff manage tickets from a dropdown panel.
 
-Built with modern JDA 5 for native slash commands and button interactions. Supports Paper, Folia, and Spigot out of the box. 15+ toggleable modules — use what you need, disable what you don't.
+Uses JDA 5 with real slash commands and button interactions. Works on Paper, Folia, and Spigot — no extra setup per platform. Pick from 15+ modules in config; flip off whatever you won't use.
 
 ### Features
 
@@ -50,7 +50,7 @@ Built with modern JDA 5 for native slash commands and button interactions. Suppo
 
 ### Installation
 
-1. Download `ZDiscord-1.1.0.jar` from the files tab.
+1. Download `ZDiscord-1.2.0.jar` from the files tab.
 2. Place the JAR in your server's `plugins/` directory.
 3. Start the server to generate the default `config.yml` and `messages.yml`.
 4. Open `plugins/ZDiscord/config.yml` and set:

.github/listings/hangar.md

@@ -20,7 +20,7 @@ Discord integration for Paper servers. Chat bridge, status, tickets, account lin
 
 ZDiscord bridges your Minecraft server and Discord guild. Chat flows both ways, players see server status from Discord, and staff manage tickets from a dropdown panel.
 
-Built with modern JDA 5 for native slash commands and button interactions. Supports Paper 1.20.4 or newer, Folia, and Spigot 1.20.4 or newer. 15+ toggleable modules — use what you need, disable what you don't.
+Uses JDA 5 with real slash commands and button interactions. Works on Paper 1.20.4+, Folia, and Spigot 1.20.4+ with no per-platform config. Pick from 15+ modules — turn off the ones you're not using.
 
 ### Features
 
@@ -50,7 +50,7 @@ Built with modern JDA 5 for native slash commands and button interactions. Suppo
 
 ### Installation
 
-1. Download `ZDiscord-1.1.0.jar` from the versions tab.
+1. Download `ZDiscord-1.2.0.jar` from the versions tab.
 2. Place the JAR in your server's `plugins/` directory.
 3. Start the server to generate the default `config.yml` and `messages.yml`.
 4. Open `plugins/ZDiscord/config.yml` and set:

.github/listings/modrinth.md

@@ -26,7 +26,7 @@ ZDiscord bridges your Minecraft server and Discord guild. Chat flows both ways,
 
 ### Why ZDiscord?
 
-Built with modern JDA 5 for native slash commands and button interactions. Supports Paper, Folia, and Spigot out of the box. 15+ toggleable modules — use what you need, disable what you don't.
+Uses JDA 5 with real slash commands and button interactions. Works on Paper, Folia, and Spigot — no extra setup per platform. Pick from 15+ modules in config; flip off whatever you won't use.
 
 ### Features
 
@@ -56,7 +56,7 @@ Built with modern JDA 5 for native slash commands and button interactions. Suppo
 
 ### Installation
 
-1. Download `ZDiscord-1.1.0.jar` from the releases page.
+1. Download `ZDiscord-1.2.0.jar` from the releases page.
 2. Place the JAR in your server's `plugins/` directory.
 3. Start the server to generate the default `config.yml` and `messages.yml`.
 4. Open `plugins/ZDiscord/config.yml` and set:

.github/listings/spigot.md

@@ -16,7 +16,7 @@ Chat bridge, tickets, status, account linking, anti-raid, player profiles, confe
 
 ZDiscord bridges your Minecraft server and Discord guild. Chat flows both ways, players see server status from Discord, and staff manage tickets from a dropdown panel.
 
-Built with modern JDA 5 for native slash commands and button interactions. Supports Paper, Folia, and Spigot out of the box. 15+ toggleable modules — use what you need, disable what you don't.
+Uses JDA 5 with real slash commands and button interactions. Works on Paper, Folia, and Spigot — no extra setup per platform. Pick from 15+ modules in config; flip off whatever you won't use.
 
 ### Features
 
@@ -46,7 +46,7 @@ Built with modern JDA 5 for native slash commands and button interactions. Suppo
 
 ### Installation
 
-1. Download `ZDiscord-1.1.0.jar` from the downloads section.
+1. Download `ZDiscord-1.2.0.jar` from the downloads section.
 2. Place the JAR in your server's `plugins/` directory.
 3. Start the server to generate the default `config.yml` and `messages.yml`.
 4. Open `plugins/ZDiscord/config.yml` and set:

CHANGELOG.md

@@ -6,8 +6,14 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [1.2.0] - 2026-06-16
+
 ### Added
-- `/profile [player]` — renders a player card embed with avatar, NameMC link, first/last seen (Discord timestamps), sessions, playtime, advancement count, link status, follower count, and online indicator. Follow/Unfollow button on the embed subscribes the requester to DM notifications.
+- **Developer API**: Clean public interface for third-party plugins (`ZDiscordAPI`, `ZDiscordProvider`, models, and Bukkit events like `ZDiscordPlayerLinkEvent`, `ZDiscordFollowEvent`, `ZDiscordStatUpdateEvent`).
+- **Interactive Leaderboards**: `LeaderboardModule` completely rewritten with 🥇🥈🥉 medals, player head thumbnails, stat-specific styling, progress bars, pagination buttons, and a stat-switcher dropdown.
+- **Persistent Leaderboard Panel**: Auto-updating leaderboard panel in a configurable channel, including a new "Most Followed Players" leaderboard.
+- **Centralized Logger (`ZLogger`)**: 9 categories, 6 levels, compact format, and zero-cost debug via `Supplier`. Added a professional boxed `StartupBanner`.
+- `/profile [player]` — renders a player card embed with avatar, NameMC link, first/last seen (Discord timestamps), sessions, playtime, advancement count, link status, follower count, online indicator, kills, deaths, and K/D ratio. Follow/Unfollow button on the embed subscribes the requester to DM notifications.
 - `/seen <player>` — quick last-seen lookup. Returns online/offline status, last-seen timestamp, playtime, and session count.
 - `/following` — lists the Minecraft players the requester follows.
 - `/unfollow <player>` — stops following a player (previously only the button on `/profile`).
@@ -25,6 +31,8 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 - MySQL `isFollowing` uses `SELECT COUNT(*) > 0` instead of fetching all followers.
 
 ### Changed
+- `config-version` bumped to 4. Default `avatar-url` changed to `mc-heads.net` for higher reliability and uptime compared to `crafatar.com`.
+- `HeadUtil` rewritten to support `mc-heads.net` with `avatar()`, `body()`, and `combo()` methods and various size constants.
 - `YamlStorage` and `MySQLStorage` gained three new files / three new tables each, plus 12 new `StorageManager` methods.
 - `AdvancementListener` persists the unlock to storage, reads rarity stats asynchronously, and guards against duplicate events (e.g. from `/reload`). Duplicate events suppress the generic "Unlocked by" field.
 - `UpdateChecker` interval changed from 6 to 5 hours. `postSilentDiscordNotice()` fires once per detected release via `AtomicBoolean` guard and respects `misc.update-silent`.
@@ -33,6 +41,10 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 - `ColorUtil.stripColor` used only internally for pre-processing before `toDiscordMarkdown`.
 
 ### Fixed
+- `SetupCommand` bug causing "Loading options failed" fixed (StringSelectMenu `addOption` parameter order corrected).
+- `SetupCommand` NPE when a selected ticket category was removed from config fixed.
+- `JoinQuitListener` null-safe bot connection checks added to prevent NPEs when the bot is disconnected. Playtime session tracking now records join timestamp before checking bot status.
+- `/seen` avatar resolution fixed to use the new `HeadUtil.avatar()`.
 - `FollowModule.onPlayerJoin` no longer blocks the scheduler thread — `retrieveUserById().complete()` replaced with `.queue()`.
 - `MySQLStorage.isFollowing` uses `SELECT COUNT(*)` instead of fetching all followers.
 - `/seen` shows "This player has never joined the server" instead of "No activity recorded yet."

README.md

@@ -6,7 +6,7 @@
 
 Discord integration for Minecraft servers.
 
-[![Version](https://img.shields.io/badge/version-1.1.0-blue)](https://github.com/DemonZ-Development/ZDiscord/releases)
+[![Version](https://img.shields.io/badge/version-1.2.0-blue)](https://github.com/DemonZ-Development/ZDiscord/releases)
 [![Minecraft](https://img.shields.io/badge/Minecraft-1.20.4%2B-green)](https://papermc.io)
 [![Platform](https://img.shields.io/badge/Paper%20%7C%20Folia%20%7C%20Spigot-orange)](https://papermc.io)
 [![Java](https://img.shields.io/badge/Java-17%2B-red)](https://adoptium.net)
@@ -63,7 +63,7 @@ ZDiscord connects your Minecraft server to Discord. Chat flows both ways, player
 
 ## Installation
 
-1. Download `ZDiscord-1.1.0.jar` from the [Releases](https://github.com/DemonZ-Development/ZDiscord/releases) page.
+1. Download `ZDiscord-1.2.0.jar` from the [Releases](https://github.com/DemonZ-Development/ZDiscord/releases) page.
 2. Place the JAR in your server's `plugins/` directory.
 3. Start the server to generate the default `config.yml` and `messages.yml`.
 4. Open `plugins/ZDiscord/config.yml` and set:
@@ -142,7 +142,7 @@ cd ZDiscord
 mvn clean package
 ```
 
-The shaded JAR is written to `target/ZDiscord-1.1.0.jar`.
+The shaded JAR is written to `target/ZDiscord-1.2.0.jar`.
 
 ## License