StaffModeration

StaffModeration v1.6.20

This update introduces six new in-game commands and one new Discord command, focused on server transparency, player statistics, and community engagement. This release is fully backward compatible — no breaking changes, and all new permissions default to enabled.

---

✨ New Features

Balance Leaderboard — /baltop Displays the server's top balances as a paginated Discord embed.

• Interactive First / Previous / Next / Last navigation
• Toggleable sort order (highest-to-lowest or lowest-to-highest)
• Configurable page size (default: 10 players per page)
• Requires Vault and a compatible economy plugin

Kill & Death Statistics — /kills, /death Look up a player's combat statistics at a glance.

• /kills [player] — displays total kills in a dedicated embed
• /death [player] — displays total deaths in a dedicated embed
• Tracked natively by StaffModeration, independent of any third-party statistics plugin

Player Info Card — /playerinfo <player> A complete at-a-glance profile for any player.

• Displays IGN, Deaths, Kills, Balance, Playtime, and current online status
• Balance sourced from Vault; Playtime sourced from EssentialsX where available, with an automatic fallback to vanilla playtime tracking
• Supports both /playerinfo <player> and /playerinfo ign:<player> syntax

Server Information Panel — /serverinfo A live snapshot of the server's current status.

• Displays Server Name, Server Owner, TPS, and Memory usage
• Server Name and Owner are fully configurable — nothing is hardcoded
• Memory usage is read directly from the JVM in real time, ensuring accuracy across Purpur, Paper, Spigot, and Folia
• Optionally mirrors to a designated Discord channel

Server Rating System — /serverrate Allows players to submit a star rating and written feedback directly from the game.

• Guided flow: select a 1–5 star rating, then provide a written comment in chat
• Ratings are strictly validated within the 1–5 range
• Submissions are posted to Discord as a color-graded embed (red for low ratings, green for high ratings)
• Players with a linked Discord account automatically receive a thank-you message via DM

Community Suggestions — !suggest <message> (Discord) Enables server members to submit suggestions directly from Discord.

• Automatically posts an embed containing the submitter's Discord identity, linked IGN, and suggestion text
• Adds 👍 / 👎 reactions to each submission for community voting

---

⚙️ Configuration Changes

• Added new config.yml sections: serverinfo, baltop, playerinfo
• Added new discord.yml keys: rating-webhook, suggest-channel-id, additional embed color options, and a configurable rating-colors gradient (1–5 stars)
• Added new permission nodes (default: enabled): staffmod.baltop, staffmod.stats, staffmod.serverinfo, staffmod.serverrate
• All configuration files are automatically migrated on startup — existing installations require no manual intervention

---

🔧 Under the Hood

• Introduced two new database tables: player_stats (kill/death tracking) and player_ratings (rating history)
• Added optional integrations with Vault (economy) and EssentialsX (playtime) — both are fully optional and gracefully degrade if unavailable
• Registered Vault and EssentialsX as soft-dependencies to guarantee correct plugin load order

---

📋 Requirements

• Vault + a compatible economy plugin — required for /baltop and the Balance field in /playerinfo
• EssentialsX (optional) — enables accurate playtime tracking in /playerinfo

Discord Support

Click Here To Join