[PAID] Enhanced Report Handler

Introduction

Enhanced Report Handler is a script for FiveM servers which helps server staff deal with player reports in an organized way.

This script is fully dynamic and you can customize almost everything as you wish.

UI Show Case

showcase

How to use

Players may issue a command as shown below in order to open report menu.
image

/report

In order to cancel your report, you can simply type /cancelreport or just type in /report command and click on cancel report command
image

Whenever a new report is submitted, staff members who have the access to answer the report type, will get notified as shown below

Server staff will have to use /reports in order to see a list of active reports and use /ar [Report ID] to accept a report and /cr to close it.

Staff can also use /VR [Report ID] to see the content of a report

unknown

The player who started a report and the staff member who’s answering it may chat directly with the command /rd [Message]

Features

Customizability
This script is fully customizable and you can change nearly everything in the config.lua file such as commands, settings, etc.

Discord
You can link your reports to a channel in your discord server if you want the script to send messages in the discord channel as shown below

image image

Whenever someone submits, cancels, closes or accepts a report the script will send a message containing the details.

Report Types

There are 3 report types by default, you can change them and add more if you want.
There’s also an option to manage who can access each type of report.

  • Report Type 1: Rule break report
  • Report Type 2: Bug report
  • Report Type 3: Questions

Extra Options

There are some extra options for you to use as you want:

  • Report Cooldowns: You can set cooldowns for Reporting
    Default: 120 seconds

  • Report Idle: Reports will get closed automatically if not answered for a period of time
    Default: 10 minutes

  • Minimum Length: The minimum amount of characters have to write in reason to submit report
    Default: 5 characters

  • Maximum Length: The maximum amount of characters players can write in reason
    Default: 75 characters

  • Notify Report Idle Close: Notifies staff when a report gets automatically closed
    Default: Enabled

  • Notify Cancel: Notifies staff when a player cancels his/her report
    Default: Enabled

  • Notify Close: Notifies staff when a staff member closes a report
    Default: Enabled

  • Close Report On Leave: Closes player’s report if the player leaves the server
    Default: Disabled

  • Blur Background: Makes game interface blur when report UI opens
    Default: Enabled
    blur

  • Notify Close Report On Leave: if Close Reports on Leave is enabled, notifies the staff if a report gets closed because the player who initiated the report left the server.
    Default: Disabled

Other Features

  • Supports onesync/onesync legacy

  • No vulnerable triggers (Even if executors trigger events directly can’t do anything but submit a
    report with given cooldown interval set in config)

  • Optimized and no client/server-side usage of more than 0.01 ms

  • User friendly UI for submit/cancel reports

  • Highly configurable locale file you can even change UI texts without any programming knowledge just by editing the locale file

  • Every single command exist within this script can be changed through config

Discord WebHooks

Discord WebHooks allows this script to send messages directly to a channel in your Discord server.
To use it, go to config.lua file and change API Master Switch to True, then head down put your WebHook in the Config.WebHooks section between the double quotations
image

You can set different channels for each action.

API (For Developers)

Summary

In this section, I want to show you how Enhanced Report Handler’s API works.
We use an Object in our API which is called Data by default which contains the following information:

An object containing the report issuer’s information

issuer = { id = issuer id, identifier = issuer identifier }

Name of the player who issued the report

name = issuer name

Report’s current ID in the list

rid = Report current ID

Report type based on your config.lua file

type = report type

Report message

content = message

A nullable object which only exists if an staff member accepts a report and it contains responder’s server ID, name and identifier

?responder = {name = responder name, id = responder id, identifier = responder identifier}

A nullable object which only exists if a staff member closes a report and it contains closer’s server ID, name, and identifier

?closer {name = closer name, id = closer id, identifier = closer identifier}

Events

Summary

There are several events, we will see when each of them triggers

onReportSubmit
Triggers when a player submits a new report

onReportAccept
Triggers when a staff member accepts a report

onReportClose
Triggers when a staff member closes an open report

onReportCancel
Triggers when the report issuer cancels his/her own report

Dependencies

  • ESX

Terms of Service

By purchasing our script you accept these Terms of Service:

  • You must not resell or share this script
  • You must not transfer the files to another person or upload them somewhere else
  • Rsource is obfuscated by escrew and any attempt for accessing source code is not allowed
  • You must not Modify/Edit/Copy/Use this script for any commercial purposes!
  • You must not remove ANY Copyright trademark!
Code is accessible Partial (modules and HTML only)
Subscription-based No
Lines (approximately) 1100
Requirements ESX
Support Yes

⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ ⠀ Purchase (15€)

10 Likes

Interesting, I’m thinking of it rn
We needed smt like this in our server cause users kept hitting us with “im bugged” or “teleport me” u had to tp all the way to the user and check whats with him.
:thinking: keep it up sir
:clap: :+1:

Wow nice job! Looks great :ok_hand:

36 EUR lmao :neutral_face:

it’s 25, it’s your country tax

For Small Scale Servers Like 20-30 People. You can barely rely on ESX own report system ( ofc if you don’t want your reports to be organized and easier to work with)
But When You have many People in your server, You can really see the Goal in this Project.
And the Fact that Everything in this script is fully editable is nice!

1 Like

is it possible to use this for custom non esx frameworks?

It’s currently made for ESX framework maybe I can do it with ace permission in the future

thank you

Incredible!

very good script!!

Cool !

Enhanced scripts are now On Limited Offer for 50% Discount.

Enhanced Discord Bot
Enhanced Report Handler

NEW UPDATE AND BUG FIXES

  • Config now has includeICName option, if you guys enable this, script will include player character name in chat when the player submits a reports

  • Fixed sending incorrect messages when a staff member closes a report

  • Script no longer uses the deprecated chatMessage event however if you still want to use the deprecated event change Config.Chat.Legacy to true

  • Sending report data to discord webhook no longer applies FiveM color codes to the Discord Embed

NEW UPDATE

  • /report command no longer accepts any additional arguments and it just opens a UI

  • Added user-friendly UI for submitting/canceling reports

  • Moved some of the configs to shared.lua also resource files are now more organized

  • Added maxLength option in shared.lua to define maximum characters for report reason

  • Added makeBackGroundBlur option in shared.lua, if you enable this option when the report UI opens will change the game background to blur

  • If makeBackGroundBlur option is enabled there will be an eye icon at the top left which you can remove the blur effect by hovering your mouse over it

  • Added a new section to locales for editing UI translations