/el_bwh

FiveM Ban/Warning/Help-Assist System

Primary LanguageLuaDo What The F*ck You Want To Public LicenseWTFPL

el_bwh

FiveM Ban/Warning/Help-Assist System for ESX (Unoffical New Version Development)

Installation

  1. Download the resource
  2. Rename it to el_bwh and put it in your resources folder
  3. Import sql.sql into your database
  4. Edit the config to your liking
  5. Add start el_bwh to your server.cfg Make sure to add this after mysql-async and es_extended
  6. Start it and you're good to go

Documentation

There's a few commands this adds:

  • /bwh <- root admin command, this will display all sub-commands
  • /bwh ban <- opens the ban menu
  • /bwh warn <- opens the warn menu
  • /bwh banlist <- opens the ban list
  • /bwh warnlist <- opens the warning list
  • /bwh assists <- shows pending/active assists in the chat
  • /bwh refresh <- pulls all bans from the database and refreshes the ban cache
  • /accassist <player id> <- admin command, admins can accept help requests from players
  • /finassist <- admin command, this closes the current help request and teleports you back to your original position
  • /decassist <- admin command, this just hides the current assist popup on the screen
  • /assist <reason> <- player command, players can request help with this
  • /cassist <- player command, this cancels the players ongoing assist request

External banning/warning: !! THESE ARE SERVER ONLY EVENTS !!

-- banning
-- 1st parameter -> ESX user object of the sender
-- 2nd parameter -> ESX user object of the receiver OR if the player is offline, their steam identifier
-- 3rd parameter -> reason
-- 4th parameter -> length (exp. date of ban) in this format YYYY/MM/DD HH:SS, other formats won't work
-- 5th parameter -> if the player is offline, set to true, otherwise leave false or nil
TriggerEvent("el_bwh:ban", ESX.GetPlayerFromId(sender), ESX.GetPlayerFromId(target), reason, length, offline)

-- warning
-- 1st parameter -> ESX user object of the sender
-- 2nd parameter -> ESX user object of the receiver
-- 3rd parameter -> message of warn
-- 4th parameter -> boolean, if set to true the sender name will not show for the player
TriggerEvent("el_bwh:warn", ESX.GetPlayerFromId(sender), ESX.GetPlayerFromId(target), message, anonymous)

To unban someone, go to the ban list and scroll far right to the "Actions" section, you'll find a green unban button there

Important notes

This bans all players identifiers, that means their ip,license,steam,discord,xbl ids will get banned
Offline bans ban everything that's stored in the identifier db
If you don't like the current design, you can edit the html/index.html and html/style.css files to change the design to your liking

THIS IS NOT AN OFFICAL VERSION. DO NOT CONTACT ECLIPSE WITH REGARDS TO THIS FORK.