# Flagger<\/p>\n
Flagger is a Paper admin-moderation plugin for reviewing flagged players, teleporting to investigate, and applying escalating punishments with SQLite-backed history.<\/p>\n
## Features<\/p>\n
– Flag players with reasons using `\/flaggeradd ## Commands<\/p>\n – `\/flagger` ## Permissions<\/p>\n – `flagger.use` – Use `\/flagger` ## Data Storage<\/p>\n – Database: SQLite ## Build<\/p>\n “`powershell Output jar:<\/p>\n – `build\/libs\/flagger-1.0.0.jar`<\/p>\n ## Configuration<\/p>\n Main config file:<\/p>\n – `src\/main\/resources\/config.yml`<\/p>\n You can customize:<\/p>\n – Punishment day lengths Command placeholders for `punishments.execution.commands`:<\/p>\n – `%player%` Example custom command mode:<\/p>\n “`yml ## Compatibility<\/p>\n – Paper `1.21.4` ## License<\/p>\n See `LICENSE`.<\/p>\n","protected":false},"excerpt":{"rendered":" Flagger is a Paper admin-moderation plugin for reviewing flagged players, teleporting to investigate, and applying escalating punishments.<\/p>\n","protected":false},"featured_media":70766,"template":"","meta":{"_minecraft_slug":"flagger","_minecraft_project_id":"LW8KbA7k","_minecraft_author":"sidastuff","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":25,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"flagger.zip","_minecraft_size_bytes":32743,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:20:42.878123Z","_minecraft_date_created":"2026-02-15T00:00:55.617488Z","_minecraft_date_modified":"2026-02-14T22:19:36.817722Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/flagger","_minecraft_icon_attachment_id":70766,"_minecraft_imported_at":"2026-06-04T00:35:11+00:00","_minecraft_import_hash":"bf142a556ab946c2c5f27cbf9ab017ba","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,89,126,90,127,129,91,92],"mod_loader":[130,131,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-70765","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-spigot","mod_category-storage","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– Open a paginated flagged-player GUI using `\/flagger`.
\n– Consolidate multiple flags for the same player into one report.
\n– Group similar flag reasons automatically.
\n– Review flag details and punishment history in GUI menus.
\n– Teleport to flagged players in spectator mode for safe investigation.
\n– Punish from GUI with chat-entered reason and confirm step.
\n– Escalating ban durations:
\n – 1st offense: 14 days
\n – 2nd offense: 30 days
\n – 3rd+ offense: permanent
\n– Configurable messages, GUI items, titles, sizes, and permissions.<\/p>\n
\n – Opens the flagged-player GUI.
\n– `\/flagger reload`
\n – Reloads plugin configuration.
\n– `\/flaggeradd
\n – Adds or increments a grouped flag report for a player.<\/p>\n
\n– `flagger.add` – Use `\/flaggeradd`
\n– `flagger.manage` – Manage moderation GUI actions
\n– `flagger.reload` – Use `\/flagger reload`<\/p>\n
\n– Default file: `plugins\/Flagger\/flagger.db`
\n– Tracks:
\n – grouped flag reports per player
\n – grouped reasons\/counts per report
\n – punishment history and offense counts<\/p>\n
\n.gradlew.bat build
\n“`<\/p>\n
\n– Punishment execution mode:
\n – `BAN_THEN_KILL` (default, ban first then kill)
\n – `BAN_ONLY`
\n – `COMMANDS` (run custom console commands instead of built-in ban\/kill)
\n– GUI titles, sizes, and button materials
\n– Messages and placeholders
\n– Permission node mapping<\/p>\n
\n– `%reason%`
\n– `%offense%`
\n– `%punished_by%`
\n– `%ban_until%`<\/p>\n
\npunishments:
\n execution:
\n mode: COMMANDS
\n commands:
\n – “advancedban:ban %player% Flagger: %reason%”
\n“`<\/p>\n
\n– Java `21`<\/p>\n