Flagger

Flagger is a Paper admin-moderation plugin for reviewing flagged players, teleporting to investigate, and applying escalating punishments with SQLite-backed history.

Features

• Flag players with reasons using /flaggeradd <player> <reason>.
• Open a paginated flagged-player GUI using /flagger.
• Consolidate multiple flags for the same player into one report.
• Group similar flag reasons automatically.
• Review flag details and punishment history in GUI menus.
• Teleport to flagged players in spectator mode for safe investigation.
• Punish from GUI with chat-entered reason and confirm step.
• Escalating ban durations:
  • 1st offense: 14 days
  • 2nd offense: 30 days
  • 3rd+ offense: permanent
• Configurable messages, GUI items, titles, sizes, and permissions.

Commands

• /flagger
  • Opens the flagged-player GUI.
• /flagger reload
  • Reloads plugin configuration.
• /flaggeradd <player> <reason>
  • Adds or increments a grouped flag report for a player.

Permissions

• flagger.use - Use /flagger
• flagger.add - Use /flaggeradd
• flagger.manage - Manage moderation GUI actions
• flagger.reload - Use /flagger reload

Data Storage

• Database: SQLite
• Default file: plugins/Flagger/flagger.db
• Tracks:
  • grouped flag reports per player
  • grouped reasons/counts per report
  • punishment history and offense counts

Build

.\gradlew.bat build

Output jar:

• build/libs/flagger-1.0.0.jar

Configuration

Main config file:

• src/main/resources/config.yml

You can customize:

• Punishment day lengths
• Punishment execution mode:
  • BAN_THEN_KILL (default, ban first then kill)
  • BAN_ONLY
  • COMMANDS (run custom console commands instead of built-in ban/kill)
• GUI titles, sizes, and button materials
• Messages and placeholders
• Permission node mapping

Command placeholders for punishments.execution.commands:

• %player%
• %reason%
• %offense%
• %punished_by%
• %ban_until%

Example custom command mode:

punishments:
  execution:
    mode: COMMANDS
    commands:
      - "advancedban:ban %player% Flagger: %reason%"

Compatibility

• Paper 1.21.4
• Java 21

License

See LICENSE.