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

- Add DiscordSRV comparison table to README
- Update all marketplace listings (Modrinth, CurseForge, SpigotMC, Hangar)
- Expand CONTRIBUTING.md with build/test/structure guide
- Clean up issue templates with additional context fields
- Ensure CHANGELOG unreleased section is complete

Author: ZDiscord Maintainer

.github/CONTRIBUTING.md

@@ -12,6 +12,39 @@ edits are all welcome.
 4. Verify it builds: `mvn clean package`
 5. Push to your fork and open a pull request against `main`.
 
+## Building
+
+```bash
+git clone https://github.com/DemonZ-Development/ZDiscord.git
+cd ZDiscord
+mvn clean package
+```
+
+The shaded JAR is written to `target/ZDiscord-1.1.0.jar`. The build runs
+tests automatically during the `test` phase.
+
+## Running tests
+
+```bash
+mvn test
+```
+
+The test suite uses JUnit Jupiter 5.10.2. Tests cover:
+
+- **ConfigManager** — schema migration, key merging, defaults
+- **YamlStorage** — CRUD operations for links, stats, activity, follows
+- **TicketModule** — category parsing from config
+- **StatusEmbedBuilder** — embed structure and placeholder resolution
+- **UpdateChecker** — semver comparison and pre-release handling
+- **HeadUtil** — avatar URL resolution
+- **ColorUtil** — Discord markdown conversion
+- **PlaceholderUtil** — colour code stripping and placeholder expansion
+- **TPSUtil** — server performance metrics
+
+Tests use a `SyncPlatformAdapter` (runs tasks on the caller thread) and
+`BukkitStub` (fake `ServerBridge` backend) so they don't need a running
+server.
+
 ## Code style
 
 - 4-space indentation, no tabs.
@@ -22,6 +55,33 @@ edits are all welcome.
 - Do not commit `target/`, `.jar` build outputs, secrets, tokens, or
   real Discord credentials.
 
+## Project structure
+
+```
+src/main/java/dev/demonz/zdiscord/
+  ZDiscord.java                # Plugin entry point
+  platform/                    # Paper / Spigot / Folia scheduler adapters
+  config/                      # ConfigManager, MessageManager
+  storage/                     # StorageManager + YamlStorage / MySQLStorage
+  discord/                     # JDA wiring (BotManager, slash/button listeners)
+  discord/listeners/           # DiscordChatListener, ReconnectListener, etc.
+  minecraft/                   # In-game bridge
+    ChatBridge.java            # Shared MC→Discord forwarder
+    commands/                  # /zdiscord, /discord, /sc
+    listeners/                 # ChatListener, JoinQuitListener, ...
+  modules/                     # Feature modules (status, ticket, ...)
+  util/                        # ColorUtil, HeadUtil, ServerBridge, StatusEmbedBuilder, ...
+```
+
+## Adding a new module
+
+1. Create a class in `modules/` implementing `init()`, `shutdown()`, and
+   `reload()`.
+2. Add a config toggle in `config.yml` (e.g. `my-module.enabled`).
+3. Register the module in `ZDiscord.initModules()`.
+4. Add a shutdown call in `ZDiscord.onDisable()`.
+5. Add tests for any non-trivial logic.
+
 ## Reporting issues
 
 - Use the **Bug report** issue template for broken behaviour.

.github/ISSUE_TEMPLATE/bug_report.md

@@ -42,3 +42,7 @@ What actually happens. Include the exact error message or screenshot if relevant
 ```
 # Paste the relevant log output from plugins/ZDiscord/ or the server console
 ```
+
+## Additional context
+
+Add any other context about the problem here (e.g., other plugins installed, Discord bot permissions, etc.).

.github/ISSUE_TEMPLATE/documentation.md

@@ -17,3 +17,7 @@ What is wrong or missing?
 ## Suggested fix
 
 If you have a proposed change, describe it.
+
+## Additional context
+
+Add any other context about the documentation issue here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -24,4 +24,4 @@ Any other approaches you considered.
 
 ## Additional context
 
-Anything else relevant.
+Anything else relevant (e.g., similar features in other plugins, Discord API capabilities, etc.).

.github/ISSUE_TEMPLATE/question.md

@@ -19,3 +19,10 @@ Steps you have already attempted.
 - ZDiscord version:
 - Server software and version:
 - Storage backend:
+- Java version: (`java -version`)
+
+## Logs
+
+```
+# If applicable, paste relevant log output from plugins/ZDiscord/ or the server console
+```

.github/listings/curseforge.md

@@ -20,6 +20,8 @@ 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.
+
 ### Features
 
 - **Chat bridge** — Two-way chat between Minecraft and Discord. Webhooks display player heads as avatars. Linked players show their Discord name and avatar.
@@ -58,10 +60,6 @@ ZDiscord bridges your Minecraft server and Discord guild. Chat flows both ways,
 5. Restart the server.
 6. Run `/setup` in Discord to configure the remaining channels.
 
-### bStats
-
-[![bStats Server Signature](https://bstats.org/signatures/bukkit/MyZDiscord.svg)](https://bstats.org/plugin/bukkit/MyZDiscord/29652)
-
 ### License
 
 Apache License 2.0

.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.
 
-It supports Paper 1.20.4 or newer, Folia, and Spigot 1.20.4 or newer.
+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.
 
 ### Features
 
@@ -60,10 +60,6 @@ It supports Paper 1.20.4 or newer, Folia, and Spigot 1.20.4 or newer.
 5. Restart the server.
 6. Run `/setup` in Discord to configure the remaining channels.
 
-### bStats
-
-[![bStats Server Signature](https://bstats.org/signatures/bukkit/MyZDiscord.svg)](https://bstats.org/plugin/bukkit/MyZDiscord/29652)
-
 ### License
 
 Apache License 2.0

.github/listings/modrinth.md

@@ -18,12 +18,16 @@ Server-side
 
 ## Short description (max 100 chars)
 
-Discord integration for Paper, Folia, and Spigot servers. Chat bridge, tickets, leaderboards, anti-raid, player profiles, confessions.
+Discord integration for Paper, Folia, and Spigot. Chat bridge, tickets, leaderboards, anti-raid, player profiles, confessions.
 
 ## Long description
 
 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.
 
+### 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.
+
 ### Features
 
 - **Chat bridge** — Two-way chat between Minecraft and Discord. Webhooks display player heads as avatars. Linked players show their Discord name and avatar.
@@ -66,10 +70,6 @@ ZDiscord bridges your Minecraft server and Discord guild. Chat flows both ways,
 
 All configuration lives in `plugins/ZDiscord/config.yml`. User-facing strings are in `messages.yml`. See the wiki for a full reference.
 
-### bStats
-
-[![bStats Server Signature](https://bstats.org/signatures/bukkit/MyZDiscord.svg)](https://bstats.org/plugin/bukkit/MyZDiscord/29652)
-
 ### License
 
 Apache License 2.0
@@ -80,8 +80,6 @@ Apache License 2.0
 - Issues: https://github.com/DemonZ-Development/ZDiscord/issues
 - Wiki: https://github.com/DemonZ-Development/ZDiscord/wiki
 
-
-
 ## Tags
 
 `paper` `folia` `spigot` `discord` `chat` `tickets` `linking` `anti-raid` `utility`

.github/listings/spigot.md

@@ -16,6 +16,8 @@ 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.
+
 ### Features
 
 - **Chat bridge** — Two-way chat between Minecraft and Discord. Webhooks display player heads as avatars. Linked players show their Discord name and avatar.
@@ -77,8 +79,6 @@ Apache License 2.0
 - `zdiscord.bypass.link` (op) — bypass link-to-join enforcement
 - `zdiscord.bypass.console` (op) — reserved (currently unused)
 
-[URL=https://bstats.org/plugin/bukkit/MyZDiscord/29652][IMG]https://bstats.org/signatures/bukkit/MyZDiscord.svg[/IMG][/URL]
-
 ## External links
 
 - Source: https://github.com/DemonZ-Development/ZDiscord

CHANGELOG.md

@@ -8,9 +8,9 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ### 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.
-- `/seen <player]` — quick last-seen lookup. Returns online/offline status, last-seen timestamp, playtime, and session count.
+- `/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`).
+- `/unfollow <player>` — stops following a player (previously only the button on `/profile`).
 - `/confess <message>` — posts an anonymous confession to `channels.confessions`. Rate-limited (configurable via `confessions.cooldown`, default 300s). Stable monotonic handle per confessor. `&` colour codes convert to Discord markdown.
 - Silent update check every 5 hours (was 6). One quiet embed to `misc.update-channel`, no pings. `misc.update-silent` suppresses both the in-game banner and Discord notice.
 - Achievement rarity display — "First of the day" badge when the player is the first to unlock that advancement in 24 hours, and "Rare — only N% of players have this" badge below a configurable threshold (default 25%).