ev_showid

EV Show ID System

The EV Show ID System allows players to display the server IDs of nearby players for a limited time. It provides an immersive way to identify players in proximity with configurable keybindings and durations.

---

System Features

Core Features

• Proximity-Based Display: Displays the IDs of nearby players within a specified radius.

• Customizable Duration: Control how long the IDs remain visible on screen.

• Dynamic Update: IDs refresh in real-time as players enter or leave the proximity range.

• Keybinding Support: Easily configurable keybindings for triggering the display.

---

Configuration

The configuration file defines the basic settings for the system, including keybindings and display duration.

Example Configuration

Config = {}
Config.key = 'I' -- Keybinding to activate ID display (default: Page Up).
Config.commandName = "showid" -- Chat command to trigger the display (/id).
Config.drawDistance = 15 -- Maximum distance (in meters) to detect players.
Config.displayTime = 30 -- Duration (in seconds) to display IDs.

Client-Side Details

Core Logic

Keybinding and Command Setup

The system uses the defined keybinding (Config.key) or the /showid command to trigger the ID display:

RegisterKeyMapping(Config.commandName, "Show Near Players ID", 'keyboard', Config.key)

RegisterCommand(Config.commandName, function()
    if not forceDraw then
        focedrawloop()
        forceDraw = not forceDraw
        Wait(Config.displayTime * 1000)
        forceDraw = false
    else
        print('ID already on screen')
    end
end)

Drawing 3D Text

Player IDs are displayed in the game world using a 3D text renderer:

function Draw3DText(x, y, z, text, newScale)
    local onScreen, _x, _y = World3dToScreen2d(x, y, z)
    if onScreen then
        local dist = GetDistanceBetweenCoords(GetGameplayCamCoords(), x, y, z, 1)
        local scale = newScale * (1 / dist) * (1 / GetGameplayCamFov()) * 100
        SetTextScale(scale, scale)
        SetTextFont(4)
        SetTextProportional(1)
        SetTextColour(255, 255, 255, 255)
        SetTextDropShadow(0, 0, 0, 0, 255)
        SetTextDropShadow()
        SetTextEdge(4, 0, 0, 0, 255)
        SetTextOutline()
        SetTextEntry("STRING")
        SetTextCentre(1)
        AddTextComponentString(text)
        DrawText(_x, _y)
    end
end

Player Detection

The system identifies nearby players within the defined radius (Config.drawDistance):

function GetNeareastPlayers()
    local playerPed = PlayerPedId()
    local players_clean = {}
    local playerCoords = GetEntityCoords(playerPed)

    if IsPedInAnyVehicle(playerPed, false) then
        local playersId = tostring(GetPlayerServerId(PlayerId()))
        table.insert(players_clean, { playerId = playersId, coords = playerCoords })
    else
        local players, _ = GetPlayersInArea(playerCoords, Config.drawDistance)
        for i = 1, #players, 1 do
            local playerServerId = GetPlayerServerId(players[i])
            local player = GetPlayerFromServerId(playerServerId)
            local ped = GetPlayerPed(player)
            if IsEntityVisible(ped) then
                table.insert(players_clean, { playerId = playerServerId, coords = GetEntityCoords(ped) })
            end
        end
    end

    return players_clean
end

Continuous Display

A loop ensures that player IDs are rendered continuously for the duration specified in Config.displayTime:

function focedrawloop()
    Citizen.CreateThread(function()
        while forceDraw do
            Wait(0)
            for k, v in pairs(GetNeareastPlayers()) do
                local x, y, z = table.unpack(v.coords)
                Draw3DText(x, y, z + 1.1, v.playerId, 1.6)
            end
        end
    end)
end

---

Example Scenarios

Scenario 1: Viewing Nearby Players' IDs

1. The player presses the assigned key (default: I) or types /showid.

2. The IDs of players within the proximity radius appear as floating 3D text.

3. After the defined duration (Config.displayTime), the display automatically turns off.

Scenario 2: Player Too Far

1. A player attempts to display IDs.

2. If no players are within the proximity range, nothing is shown.

Using IDs is allowed for evidence reports.

---

Notes

• Performance: The proximity detection and rendering logic are optimized for smooth gameplay.

• Customization: Adjust the radius, keybinding, and display duration in the configuration file.