Server

Joueur

IsInJail

Vérifie si un joueur est en prison côté serveur.

exports.core:IsInJail(source)

• source: number
  • L'ID serveur du joueur.

Retourne boolean.

RegisterNetEvent("monEvent", function()
    local src = source

    if exports.core:IsInJail(src) then
        return
    end

    -- Le joueur n'est pas en prison, continuer
end)

Société & Service

IsPolice

Vérifie si un nom de job fait partie des jobs de type police.

exports.core:IsPolice(jobName)

• jobName: string
  • Le nom du job à vérifier.

Retourne boolean.

local xPlayer = ESX.GetPlayerFromId(source)

if exports.core:IsPolice(xPlayer.job.name) then
    print("Ce joueur est policier")
end

IsAmbulance

Vérifie si un nom de job fait partie des jobs de type ambulance.

exports.core:IsAmbulance(jobName)

• jobName: string
  • Le nom du job à vérifier.

Retourne boolean.

local xPlayer = ESX.GetPlayerFromId(source)

if exports.core:IsAmbulance(xPlayer.job.name) then
    print("Ce joueur est ambulancier")
end

Admin & Permissions

hasPermission

Vérifie si un joueur possède une permission staff spécifique.

exports.core:hasPermission(source, permission)

• source: number
  • L'ID serveur du joueur.
• permission: string
  • La clé de permission à vérifier (ex: "players.revive", "builder.drugs").

Retourne boolean.

RegisterNetEvent("monEvent", function()
    local src = source

    if not exports.core:hasPermission(src, "players.revive") then
        return print("Pas la permission")
    end

    -- Logique avec permission
end)

isStaff

Vérifie si un joueur est membre du staff.

exports.core:isStaff(source)

• source: number
  • L'ID serveur du joueur.

Retourne boolean.

if exports.core:isStaff(source) then
    print("Ce joueur est staff")
end

IsStaffInService

Vérifie si un membre du staff est actuellement en service.

exports.core:IsStaffInService(source)

• source: number
  • L'ID serveur du joueur.

Retourne boolean.

BanPlayer

Bannit un joueur du serveur.

exports.core:BanPlayer(args, callback)

• args: table
  • args[1]: string — Unique ID du joueur
  • args[2]: number — Durée en heures (0 = permanent)
  • args[3+]: string — Raison du ban (les éléments restants sont concaténés)
• callback?: function(success: boolean)

exports.core:BanPlayer({ uniqueId, 24, "Triche en jeu" }, function(success)
    if success then
        print("Joueur banni pour 24 heures")
    end
end)

UnbanPlayer

Retire le ban d'un joueur.

exports.core:UnbanPlayer(uniqueId, callback)

• uniqueId: string
  • L'identifiant unique du joueur.
• callback?: function(success: boolean)

exports.core:UnbanPlayer(uniqueId, function(success)
    if success then
        print("Joueur débanni")
    end
end)

JailPlayer

Envoie un joueur en prison.

exports.core:JailPlayer(uid, time, raison, callback, staff)

• uid: number
  • L'ID Unique du joueur.
• time: number
  • Durée en minutes (0 = permanent).
• raison: string
  • La raison de la prison.
• callback?: function(code: boolean|string)
  • true en cas de succès, sinon un code d'erreur : "jail" (déjà en prison), "raison" (raison manquante), "time" (durée invalide), "id" (joueur introuvable).
• staff?: string
  • Nom du staff affiché (défaut "Console").

exports.core:JailPlayer(uniqueId, 30, "RDM répété", function(code)
    if code == true then
        print("Joueur emprisonné 30 minutes")
    end
end, "Staff")

UnjailPlayer

Libère un joueur de prison.

exports.core:UnjailPlayer(uid, callback)

• uid: number
  • L'ID Unique du joueur.
• callback?: function(code: boolean|string)
  • true en cas de succès, sinon "jail" (pas en prison) ou "id" (joueur introuvable).

exports.core:UnjailPlayer(uniqueId, function(code)
    if code == true then
        print("Joueur libéré")
    end
end)

WarnPlayer

Ajoute un avertissement (warn) à un joueur.

exports.core:WarnPlayer(uid, reason, staff)

• uid: number
  • L'ID Unique du joueur.
• reason: string
  • La raison de l'avertissement.
• staff?: string
  • Nom du staff enregistré comme modérateur (défaut "Console").

Retourne boolean (true si le warn a été ajouté).

local ok = exports.core:WarnPlayer(uniqueId, "Insultes au chat", "Staff")

if ok then
    print("Avertissement ajouté")
end

UnwarnPlayer

Supprime un avertissement à partir de son identifiant.

exports.core:UnwarnPlayer(warnId)

• warnId: number
  • L'id du warn à supprimer (voir GetWarnList).

Retourne boolean (true si le warn a été supprimé).

local ok = exports.core:UnwarnPlayer(42)

if ok then
    print("Avertissement supprimé")
end

GetWarnList

Récupère la liste des avertissements d'un joueur.

exports.core:GetWarnList(uid)

• uid: number
  • L'ID Unique du joueur.

Retourne table — une liste de warns, chaque entrée contenant :

• id: number — Identifiant du warn.
• identifier: string — Identifiant du joueur.
• date: number — Timestamp Unix de création.
• reason: string — La raison de l'avertissement.
• moderator: string — Le staff ayant émis le warn.

local warns = exports.core:GetWarnList(uniqueId)

for i = 1, #warns do
    print(warns[i].reason, warns[i].moderator)
end

RevivePlayer

Réanime un joueur qui est en coma / mort.

exports.core:RevivePlayer(uniqueId, callback)

• uniqueId: string
  • L'identifiant unique du joueur.
• callback?: function()

exports.core:RevivePlayer(uniqueId, function()
    print("Joueur réanimé")
end)