TigerReports is a highly configurable and detailed plugin to manage player reports. It works with a simple command /report which register many data that is displayed in a staff GUI (a chest).


Players can report online and offline players (it depends on the config) with a cooldown and a minimum amount of characters. If they don't specify any reason, a GUI (chest) is opened to select one of the defaults (configurable) reasons.
When a report is sent, online staff is alerted by a clickable message that opens a menu.
This menu allows to:

• Teleport to current and older (during the report) location of the reporter and the reported players.
• Punish if it's an abusive report with a cooldown of configured time (the report is marked as false when this punishment is used).
• See advanced data like gamemode, health, effects, and more of the reported player.
• Mark the report status as: Waiting, In progress, Important or Done.
• Archive the report (removed from the main menu but kept in the database).
• Delete the report definitively.
• Write and see comments from the staff on the report.
• See messages history of participants of the report posted before the report.

When a staff marks a report as Done, he can leave an appreciation between: true, uncertain and false.
The report is displayed in the main menu until an advanced staff archives or deletes it.


Reason menu:


Menu reports:


Report menu:


Menu comments:


User menu:









The plugin can be configured in config.yml file.
You can see a list of all parameters that can be modified and a description of what they do here .
The default config.yml settings are here .


Messages are by default in French but all can be modified in messages.yml file.

Why? Because I'm French I don't want the default messages of the plugin to have bad english but I nevertheless wrote a base of english below if you don't have the time/motivation to translate them by yourself.
They are updated after all new versions.

If you run a 1.16+ Spigot server, you can set hex colors in messages.yml file with &#FFFFFF or &x&F&F&F&F&F&F format for #FFFFFF hex color with & set for Config: ColorCharacter in config.yml file.

Important: If you use Minecraft 1.8 or less, you must encode messages.yml file with ANSI, else you must encode it with UTF-8.
If messages are not changed, it means that you encoded with wrong format.

Also, you can't put a comment (#Message) at first line of the file. If you do it messages will simply not be implemented.

Update your messages:
If you recently updated TigerReports to the latest version, you can update your messages (in messages.yml file) with this online tool:


Default messages:
Click on your language below, then press CTRL and A keys to select all the messages and then copy/paste them ( CTRL and C then CTRL and V).
(thanks to people who shared these translations, their pseudo is at the top of the file)




Other spanish messages (with some english) for TigerReports versions lower than 5.0 here.





Other polish messages (with some english) for TigerReports versions lower than 4.11.3 here.




You can see all available commands here.


You can see all available permissions here.


TigerReports is a plugin which doesn't depend on the Minecraft version. It is meant to work on all versions of Spigot higher or equal to 1.7.

Installation of TigerReports is standard:

• Stop your Spigot server.
• Download and put TigerReports.jar file in plugins folder of your server.
• Launch your server.

That's it, you can now edit all that you want in ../plugins/TigerReports folder, save your changes and apply them on the server by reloading with /reports reload command. Some features/messages need a restart of the server to be updated.

If you have a BungeeCord network:

You have to configure a MySQL database in config.yml file (at the bottom of the file) of each of your Spigot servers and leave the BungeeCord option enabled .
(You don't have to put TigerReports.jar in the plugins folder of the BungeeCord network server)

I recommend you to:

• Edit messages.yml and config.yml files to your needs.
• Check that all is good on one server.
• Select TigerReports folder (in plugins folder of your server), then hold CTRL key and select TigerReports.jar.
• You can now copy both files and paste them on each of your Spigot servers.

If you want the Discord support:

Install the TigerReportsSupports plugin following instructions in the presentation page of that plugin (in Installation section).


Common issues:

If you use a MySQL database, it is recommended to execute, with phpMyAdmin's SQL tab (see this tutorial), the query: ALTER TABLE tigerreports_reports CONVERT TO CHARACTER SET utf8mb4;ALTER TABLE tigerreports_comments CONVERT TO CHARACTER SET utf8mb4 after having restarted your server with MySQL configured in config.yml file.

The BungeeCord (only) commands cannot be executed by a Spigot plugin for a player, therefore you can't configure a BungeeCord command in PunishCommands in config.yml file. However, a player can still execute them, therefore you can send a tellraw to the staff member, explaining him that he has to click on the message to execute the BungeeCord command.
You can use an online tellraw generator like this one.
Example of a command put for PunishCommands in config.yml file:
(Note: you must put ' at the beginning and at the end of the command because the tellraw command contains ")

If you experience some lags/want to minimize the impact of the plugin on the server performances:
You can consider:

• setting a high value for Config: MenuUpdatesInterval
• disabling Config: CollectSkulls
  
• setting a small value for Config: MessagesHistory
• setting a small value for Config: MaxReports
• enabling Config: StackReports if you frequently have several reports for a same player
  
• disabling Config: ChatReport feature
• setting a small or empty list for Config: CommandsHistory
• enabling Config: ReportOnline

Please respect my work respecting these directions:

• Do not claim this plugin as yours.
• Do not distribute or sell this plugin on this site or another, just redirect to this page.
• Do not copy part or all of source code without quoting me and notifying me (MrTigreroux).
• Do not post errors in the reviews section, please contact me directly instead.

And that's all, thank you for reading this page.
If you want to look at sources, the plugin is on GitHub.
If you are french you can follow @MrTigreroux on Twitter.

Please keep in mind that I made this plugin for free to help people who don't know how to create their own plugin, a good review is highly appreciated.