TigerReports by MrTigreroux

1.7+ Spigot plugin
MySQL & BungeeCord support
Vault chat prefixes and suffixes support
Discord support by installing TigerReportsSupports plugin

Description

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

Operation

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.

Pictures

Reason menu:

Report menu:

Comments menu:

Config

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

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)

Commands

You can see all available commands here.

Permissions

You can see all available permissions here.

Installation

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

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:

'-CONSOLE tellraw _Staff_ {"text":"[Apply the punish command]","clickEvent":{"action":"run_command","value":"/bungeebancommand _Reported_ 5d Fly"}}'

(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 performance:
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

Terms of Service

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).

And that's all, thank you for reading this page.
If you want to look at sources, the plugin is on GitHub.

If you encounter any bug or have suggestions, let me know them here:

GitHub

I will answer as soon as possible.

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 like or feedback is highly appreciated. :)

TigerReports

Compatibility

Minecraft: Java Edition

Platforms

Links

Creators

Details