Documentation
Protection and staffComplete

Reports and tickets

Players report cheaters and open support tickets, and your staff handles everything in game or from the web editor.

The Reports and tickets module gives players two ways to reach your staff: /report to report another player, and /ticket to ask for help. Your staff is alerted on every server of the network and can handle both in game or from the web editor.

Note

This module requires the complete edition. See editions.

Features

Reports

  • Report with a menu or a command. /report <player> opens a menu of reasons. Players can also type the reason directly, and if you allow it, any free text.
  • Priorities. Each reason has a priority (Low, Normal, High or Urgent) used to sort the reports.
  • Grouped reports. A new report on a player who already has an open report is added to it with a counter, and the report takes the highest priority given.
  • Context saved. The position of the reported player and their last chat messages are saved with the report.
  • Staff alerts on every server, with buttons to teleport, claim the report and see the details.
  • Teleport to the reported player, even on another server of the network. If the player is offline, you go to their last known position when it is on your server.
  • Claim and close. A staff member claims a report so others know it is handled, then closes it with a resolution. Ready made resolutions are offered.
  • Sanction from the report. Each reason can suggest a sanction template from the sanctions module, applied in one click.
  • Players are told when their report is handled, right away or at their next login.
  • Anti abuse. Players can't report themselves, can't add a second report to a player they already reported while it is open, are limited in how many reports can wait at once, and have a cooldown between reports. Staff of a higher rank can be protected from reports.

Tickets

  • Open a ticket with a message, in a category you define (Question, Bug, Store, Appeal and Other by default).
  • Conversation. Players and staff answer each other. Players see staff answers in game, right away or at their next login.
  • Claim and close. Staff claim a ticket and close it when done. Players can close their own tickets too.
  • Ratings. When a ticket is closed, the player can rate the help from 1 to 5 stars.

With the discord module, new, claimed and closed reports and tickets can also be posted to Discord channels.

Setting it up

Open the Reports and tickets module in the web editor. It has four tabs.

Reports

Counters of reports to claim, in progress and handled today, and the list of reports with filters (To handle, New, In progress, Closed, All) and a search by player or staff member. Click a report to see:

  • whether the reported player is online and on which server,
  • the reason and everyone who reported the player,
  • the last chat messages and where the players were,
  • who handles it and the resolution.

From there you can Claim the report, Close it with a resolution shown to the players who reported, or Sanction the player with a template (the template of the reason is suggested). Sanctioning needs the sanctions module.

Tickets

Counters of tickets to answer, open tickets and the average rating, then the list with filters (To answer, Open, Closed, All) and a search by player or subject. Pick a ticket to read the conversation, answer the player, Claim it or Close it.

Reasons and commands

Report reasons are shown in the /report menu. You can have up to 28.

Column What it does
Identifier Short id players can type, like /report Steve cheating. Lowercase letters, digits, - and _.
Name Name shown to players and staff.
Description Line shown under the name in the menu.
Icon Item shown in the menu.
Priority Low, Normal, High or Urgent. Sorts the reports.
Sanction template Template offered to sanction the player, or none.

Default reasons: Cheating, Insults, Spam, Advertising, Griefing and Other. Without any reason, players type their own.

Ticket categories: players pick one when they open a ticket. With a single category, nothing is asked. Each category has an identifier, a name, a description and an icon.

Commands: change the aliases, permission, cooldown, price, worlds and rank rules of each command, and choose whether it opens a menu or answers in the chat. Here you also set, per rank, Reports waiting at once (3 by default) and Open tickets at once (2 by default). See commands.

Settings

Setting What it does Default
Reports
Always show the reasons menu Opens the menu even when the player types a reason. Their text is kept as details. Off
Free reasons allowed Players can type any reason instead of picking one from the list. On
Report offline players Players who already joined can be reported even when they left. On
Protect the staff Nobody can report a staff member of a higher rank. On
Group reports on the same player A new report on a player already reported adds to the open one with a counter. On
Chat messages kept Last messages of the reported player saved with the report. 0 turns it off. 15
Ready made resolutions Offered when the staff closes a report. The player who reported sees it. Sanction applied, No rule broken, Not enough evidence
Tickets
Maximum message length In characters. 256
Ratings Players rate the help from 1 to 5 stars when a ticket is closed. On
Notifications
Alert the staff of new reports On every server, with buttons to teleport and claim. On
Alert the staff of tickets New tickets and player answers. On
Tell the player when their report is handled Right away, or at their next login. On
Alert sound Played with every alert and answer. Empty means no sound. Note block pling

Commands

All four commands can have their alias, permission, cooldown, price, worlds and rank rules changed in the editor. See commands.

For players

Command What it does Permission
/report <player> [reason] [details] Reports a player. Without a reason, opens the reasons menu. 60 second cooldown by default. inglis.reports.report
/ticket Opens your tickets menu. inglis.reports.ticket
/ticket create [category] <message> Opens a ticket. Alias new. inglis.reports.ticket
/ticket list Lists your tickets. inglis.reports.ticket
/ticket view <id> Shows the last messages of a ticket. inglis.reports.ticket
/ticket reply <id> <message> Answers in your ticket. inglis.reports.ticket
/ticket close <id> Closes your ticket. inglis.reports.ticket
/ticket rate <id> <1-5> Rates the help you got. inglis.reports.ticket

For staff

Command What it does Permission
/reports Opens the reports menu. inglis.reports.reports
/reports list [open|claimed|closed|all] Lists reports. Without a filter, shows those still to handle. inglis.reports.reports
/reports info <id> Shows a report with buttons to act on it. inglis.reports.reports
/reports claim <id> Takes care of a report. inglis.reports.reports
/reports tp <id> Teleports to the reported player, on any server. inglis.reports.reports
/reports close <id> [resolution] Closes a report. Without a resolution, opens the ready made resolutions menu. inglis.reports.reports
/tickets Opens the staff tickets menu. inglis.reports.tickets
/tickets list [open|waiting|closed|all] Lists tickets. waiting shows those waiting for a staff answer. inglis.reports.tickets
/tickets view <id> Shows a ticket. inglis.reports.tickets
/tickets reply <id> <message> Answers a ticket. inglis.reports.tickets
/tickets claim <id> Takes care of a ticket. inglis.reports.tickets
/tickets close <id> [message] Closes a ticket, sending the message first if you give one. inglis.reports.tickets

/report and /ticket are open to everyone by default. /reports and /tickets are reserved to operators by default.

Permissions

Permission What it grants
inglis.reports.notify Receive report alerts. With Protect the staff on, players with this permission can't be reported by lower ranks.
inglis.reports.tickets.notify Receive ticket alerts.

Tips

  • Give inglis.reports.notify and inglis.reports.tickets.notify to your staff ranks, together with the /reports and /tickets permissions.
  • Link each report reason to a sanction template so your staff can punish in one click with consistent durations.
  • Keep Chat messages kept above 0: the last messages of the reported player are often all the evidence you need for insults or spam.