Banning players on a FiveM server

#Banning with txAdmin

1. Open the player in txAdmin (online or from the player database).
2. Choose Ban, pick a duration (hours, days, permanent) and write a clear reason.
3. txAdmin stores the player’s identifiers and hardware IDs and refuses matching connections.

Only staff with players.ban can ban — see txAdmin permissions. Scripts can react to txAdmin:events:playerBanned for logging.

#A custom ban check

local function collect(src)
    local list = GetPlayerIdentifiers(src)
    for i = 0, GetNumPlayerTokens(src) - 1 do
        list[#list + 1] = GetPlayerToken(src, i)
    end
    return list
end

AddEventHandler('playerConnecting', function(name, setKickReason, deferrals)
    local src = source
    deferrals.defer()
    Wait(0)
    deferrals.update('Checking bans…')

    local ids = collect(src)
    local ban = MySQL.single.await(
        'SELECT b.id, b.reason, b.expires FROM bans b JOIN ban_ids i ON i.ban_id = b.id WHERE i.value IN (?) AND (b.expires IS NULL OR b.expires > NOW()) LIMIT 1',
        { ids }
    )

    if ban then
        deferrals.done(('Banned (#%d): %s. Appeal at discord.gg/yourserver'):format(ban.id, ban.reason))
    else
        deferrals.done()
    end
end)

One row per ban and one row per identifier/token keeps the lookup indexed and fast. Identifier types are explained in player identifiers; deferrals in connecting cards.

#Stopping ban evasion

• Match any identifier or token, not all of them.
• When a banned player joins with a new licence but a matching token, add the new identifiers to the same ban.
• Do not rely on IP alone — shared and dynamic IPs cause false bans.

#Ban messages and appeals

A good message states the reason, the expiry (or “permanent”), a ban ID and where to appeal. The ID lets staff find the evidence quickly; logs with screenshots or clips make appeals fair. Staff abuse is prevented by permissions and by logging who banned whom.

#Server bans vs Cfx.re global bans

Your bans only affect your server. Cfx.re can ban accounts platform-wide (for example for cheating); server owners cannot issue or lift those, and players must use Cfx.re support for them.