Functions

Full list of features in arenagames

Is player in game

Client Side

Returns

• isInGame <boolean>

local isInGame = exports['zscripts-arenagames']:IsPlayerInGame()

es_extended

es_extended/client/modules/death.lua

Death = {}
Death._index = Death

function Death:ResetValues()
    self.killerEntity = nil
    self.deathCause = nil
    self.killerId = nil
    self.killerServerId = nil
end

function Death:ByPlayer()
    if exports['zscripts-arenagames']:IsPlayerInGame() then
        return    
    end

    local victimCoords = GetEntityCoords(ESX.PlayerData.ped)
    local killerCoords = GetEntityCoords(self.killerEntity)
    local distance = #(victimCoords - killerCoords)

    local data = {
        victimCoords = { x = ESX.Math.Round(victimCoords.x, 1), y = ESX.Math.Round(victimCoords.y, 1), z = ESX.Math.Round(victimCoords.z, 1) },
        killerCoords = { x = ESX.Math.Round(killerCoords.x, 1), y = ESX.Math.Round(killerCoords.y, 1), z = ESX.Math.Round(killerCoords.z, 1) },

        killedByPlayer = true,
        deathCause = self.deathCause,
        distance = ESX.Math.Round(distance, 1),

        killerServerId = self.killerServerId,
        killerClientId = self.killerId,
    }

    TriggerEvent("esx:onPlayerDeath", data)
    TriggerServerEvent("esx:onPlayerDeath", data)
end

function Death:Natual()
    if exports['zscripts-arenagames']:IsPlayerInGame() then
        return    
    end
    
    local coords = GetEntityCoords(ESX.PlayerData.ped)

    local data = {
        victimCoords = { x = ESX.Math.Round(coords.x, 1), y = ESX.Math.Round(coords.y, 1), z = ESX.Math.Round(coords.z, 1) },

        killedByPlayer = false,
        deathCause = self.deathCause,
    }

    TriggerEvent("esx:onPlayerDeath", data)
    TriggerServerEvent("esx:onPlayerDeath", data)
end

function Death:Damaged(victim, victimDied)
    if not victimDied then
        return
    end

    if not IsEntityAPed(victim) then
        return
    end

    if not IsPedAPlayer(victim) then
        return
    end

    local victimId = NetworkGetPlayerIndexFromPed(victim)
    local isDead = IsPedDeadOrDying(victim, true) or IsPedFatallyInjured(victim)
    if victimId ~= ESX.playerId or not isDead then
        return
    end

    self.killerEntity = GetPedSourceOfDeath(ESX.PlayerData.ped)
    self.deathCause = GetPedCauseOfDeath(ESX.PlayerData.ped)
    self.killerId = NetworkGetPlayerIndexFromPed(self.killerEntity)
    self.killerServerId = GetPlayerServerId(self.killerId)

    local isActive = NetworkIsPlayerActive(self.killerId)

    if self.killerEntity ~= ESX.PlayerData.ped and self.killerId and isActive then
        self:ByPlayer()
    else
        self:Natual()
    end

    self:ResetValues()
end

AddEventHandler("gameEventTriggered", function(event, data)
    if event ~= "CEventNetworkEntityDamage" then
        return
    end
    Death:Damaged(data[1], data[4])
end)

Get arena id by player id

Server Side

Returns

• arenaId <number>

local arenaId = exports['zscripts-arenagames']:GetArenaIdByPlayerId(playerId)

Start arena

Server Side

Returns

• status <boolean>

• errorMessage <string>

local status, errorMessage = exports['zscripts-arenagames']:StartArena(arenaId)