Accolades

# Accolades **Tracks combat accomplishments with announcements, history, stats, rewards, and anti-abuse safeguards.** Accolades is a standalone Paper plugin that recognises meaningful combat moments without changing combat balance. It announces and records when players protect others, save someone from danger, land long-range projectile kills, build PvP streaks, shut down enemy streaks, or avenge recent player deaths. Accolades is observational only. It does not give gameplay advantages by itself unless you enable optional reward commands. ## Features - Protection announcements when a player kills a recent attacker. - Save announcements when the protected player was close to death or would have died. - Sharpshooter announcements for long-range projectile kills. - Shutdown announcements when a player ends another player's PvP killstreak. - Hot streak announcements at configurable PvP killstreak thresholds. - Avenger announcements when a player kills someone who recently killed another player. - Persistent accolade history with actor, subjects, source, value, detail, and timestamp data. - Per-player accolade stats and top lists. - Configurable messages, colours, cooldowns, tracking windows, and delivery behaviour. - Optional grouped subject messages for multi-victim protection moments. - World blacklist or whitelist support. - Player filters for spectator, creative, dead, vanished, and NPC players. - Ignores Totem of Undying and similar self-resurrection saves. - Resolves projectiles, TNT, evoker fangs, area effect clouds, and similar Bukkit-supported damage sources. - Can credit tamed mob damage or kills to the online owner. - Supports optional direct-killer fallback when recent kill credit is unavailable. - Disabled-by-default rewards with separate settings for each accolade kind. - Optional Bukkit events and public API for integrations. - Admin tools for status, audit, stats, top lists, history, save, backup, prune, and reload. ## Accolade Types Accolades currently tracks these accolade kinds: - `PROTECTION` - `SAVE` - `SHARPSHOOTER` - `SHUTDOWN` - `HOT_STREAK` - `AVENGER` Protection and save events focus on defensive play. Sharpshooter, shutdown, hot streak, and avenger events highlight skill shots, PvP momentum, and revenge moments. ## Persistence Accolades stores recent history and player stats so accomplishments can survive restarts. Supported storage modes: - `YAML` - `SQLITE` - `MYSQL` - `MARIADB` History can be viewed in game, saved manually, backed up, and pruned by age. ## Storage And Security - YAML storage is available for simple local setups. - SQLite, MySQL, and MariaDB are available for larger servers. - SQLite paths are kept inside the plugin data folder. - Example MySQL and MariaDB URLs use certificate and hostname verification. - JDBC credentials are redacted from status and diagnostics. - Reward commands are disabled by default. - Cooldowns help prevent announcement and reward spam. - World and player filters help reduce abuse on public servers. - Backups can be created before pruning old history. ## Commands Main command: - `/accolades` Common commands: - `/accolades status` - `/accolades audit` - `/accolades stats [player|uuid]` - `/accolades top [all|protections|saves|sharpshooter|shutdown|hot-streak|avenger] [limit]` - `/accolades history [limit]` - `/accolades save` - `/accolades backup` - `/accolades prune ` - `/accolades reload` Prune ages can use formats such as `30d`, `12h`, `90m`, or `3600s`. ## Permissions Every permission defaults to operator access. Grant all Accolades permissions: - `accolades.admin` Or assign individual permissions: - `accolades.use` - `accolades.reload` - `accolades.stats` - `accolades.history` - `accolades.save` - `accolades.backup` - `accolades.prune` ## Optional Integrations Accolades works with several other Thunder plugins while still remaining fully standalone. - **Alignments** can consume protection and save events as reputation evidence. - **StormQuests** can use Accolades events as quest objective progress. - **StormEconomy** can pay configurable rewards for accolade events. - **Teamwork** can treat protection, save, and avenger events as nearby cooperation credit. - **Bodyguard** can submit guard defence moments through the normal Accolades announcement, cooldown, event, reward, and history pipeline. - **VillagePolitics** can submit village defence moments through the Accolades API. - Other plugins can use `AccoladesApi#recordExternalAccolade(...)` to record external accolade moments safely. These hooks are optional. If the other plugins are not installed, Accolades keeps working normally with its own tracking, announcements, commands, and history. ## Notes Accolades is designed to recognise real combat accomplishments without becoming a reward farm. The default configuration uses player filters, world filters, per-kind cooldowns, recent attacker windows, kill-credit freshness checks, disabled-by-default rewards, and persistent history limits to keep the system fair on public servers.