ShadowReports was inspired by the abandoned plugin ReportRTS (developed by ProjectInfinity), a ticket plugin that, despite its shortcomings, used to function well and get the job done. Although it did not receive any more updates, ReportRTS remained an important part of our network. Eventually, the plugin was not able to remain operational in the latest Minecraft updates, which lead to the development of ShadowReports.
ShadowReports is designed to be a modern, flexible and easy-to-use ticket plugin , which aims to provide the necessary features to make taking care of player issues/reports a lot easier for both players and staff.
ShadowReports is right at the sweet spot as it provides an easy-to-use and intuitive ticket system, while also being extremely customizable for those who prefer their own style. The plugin does not use GUIs or any other convoluted additions that result in overcomplicating the player and staff experience like other ticket plugins available.
The full appearance of tickets can be edited, formatted and coloured to your likings . You are even able to configure what command to run when clicking the ticket! But if you like the default looks of the plugin, there isn’t much you have to do to get the plugin up and running without any issues.
- Notifications for ticket opening, closing, etc.
- Intuitive clickable messages for easy usage.
- Full history of the tickets for easy lookup.
- MySQL data storage option for fast performance.
- Synchronisation between multiple servers.
- Bungee support for both notifications and teleportation.
- Powerfull and intuitive API.
- Fully customisable messages and formatting.
- Hex colour support (usage: #FFFFFF).
- A lot of custom placeholders for better customisation.
- Safe Teleport feature.
- /ticket open <message> | To open a ticket.
- /ticket read | To read a list of open tickets.
- /ticket read <id> | To read a specific ticket.
- /ticket comment <id> <message> | To write a comment on a ticket.
- /ticket note <id> <message> | To write a note on a ticket.
- /ticket close <id> | To close a ticket.
- /ticket tp <id> | To teleport to a ticket with the safe-teleport feature.
- /ticket tpo <id> | To teleport to a ticket without the safe-teleport feature.
- /ticket reopen <id> | To reopen a ticket.
- /ticket deletecomment <id> <commentid> | To delete a specific comment on a ticket.
- /ticket deletenote <id> <noteid> | To delete a specific note on a ticket.
- /ticket list | To read a list of all tickets.
- /ticket history | To read your ticket history.
- /ticket history <playername> | To read the ticket history of another player.
- /ticket reload | To reload the plugin.
- /ticket synch | To synchronise the plugin with the data.
- /ticket cleardata | To delete all tickets from the database. (Only accessible from the console)
- /ticket upgrade | To auto-upgrade the data structure to the new system when upgrading to v3.0.0. (Only accessible from the console)
- shadowreports.ticket.open | Permission to open a new ticket.
- shadowreports.ticket.read | Permission to read your own tickets.
- shadowreports.ticket.teleport | Permission to teleport to any ticket.
- shadowreports.ticket.comment | Permission to add a comment on an open ticket.
- shadowreports.ticket.note | Permission to add a note on an open ticket.
- shadowreports.ticket.close | Permission to close an open ticket.
- shadowreports.ticket.reopen | Permission to reopen a closed ticket.
- shadowreports.ticket.history | Permission to lookup your own ticket history.
- shadowreports.admin.deletecomments | Permission to delete any comments on tickets.
- shadowreports.admin.deletenotes | Permission to delete any notes on tickets.
- shadowreports.admin.readdeleted | Permission to read any deleted comments and/or notes on tickets.
- shadowreports.admin.history | Permission to look up the ticket history of any player.
- shadowreports.admin.list | Permission to look up a list of all tickets in the database.
- shadowreports.admin.reload | Permission to reload the plugin.
- shadowreports.admin.synch | Permission to synchronise the plugin with the data.
The plugin also includes a powerful and intuitive API for developers to work with the ticket system. The API gives
access to the tickets and their data,
functions to open, alter and close tickets without player interaction and lots of
custom events to fully customise the use of the ticket system.
To get started, simply add the ShadowReports.jar file as a library. Then, in your code, use ‘ TicketAPI.getInstance()’ to get the TicketAPI, which will give you access to the numerous variable, tickets and functions. It’s as easy as that!
The example below shows how to get a ticket, how to get the message of the ticket and finally how to add a comment to the ticket:
To get started, simply add the ShadowReports.jar file as a library. Then, in your code, use ‘ TicketAPI.getInstance()’ to get the TicketAPI, which will give you access to the numerous variable, tickets and functions. It’s as easy as that!
The example below shows how to get a ticket, how to get the message of the ticket and finally how to add a comment to the ticket:
In addition, there are also numerous of custom events to listen for. These events contain all important data and are also cancel-able!
A list of all custom events:
- TicketOpenEvent | Triggers when a ticket is opened.
- TicketReadEvent | Triggers when a ticket in state ‘Report’ is read by the reporter.
- TicketAddCommentEvent | Triggers when a comment is added on a ticket.
- TicketAddNoteEvent | Triggers when a note is added on a ticket.
- TicketDeleteCommentEvent | Triggers when a comment is deleted from a ticket.
- TicketDeleteNoteEvent | Triggers when a note is deleted from a ticket.
- TicketTeleportEvent | Triggers when a player teleports to a ticket.
- TicketCloseEvent | Triggers when an open ticket is closed.
- TicketReopenEvent | Triggers when a closed ticket is reopened.
- TicketClearDataEvent | Triggers when the data of the plugin is being cleared.
- TicketReloadEvent | Triggers when the plugin is being reloaded.
Special thanks to the staff team of ShadowKingdom for their feedback during development. They are the first network to use ShadowReports in production!
Be sure to check them out at: mc.shadowkingdom.org.
Please DO NOT use reviews for errors or support.
Instead, join our discord server for fast responses, bugfix updates and more!
____________________________________________________________________________________________________________________
A plugin by
![[IMG]](http://proxy.spigotmc.org/f8b50e213ed08dfd1094bc780a0eca224b7f7bb1?url=https%3A%2F%2Fbstats.org%2Fsignatures%2Fbukkit%2FShadowReports.svg)
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.17, 1.18, 1.19
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
ShadowReports is a free Minecraft Java mod. Compatible with Minecraft 1.17, 1.18, 1.19, 1.20 and newer. Downloaded 625 times (via Spigot). Download it and open it directly in the game.