Want to measure your FiveM/RedM server performance using FPSMeter? Here’s a guide to install a small script that allows FPSMeter to retrieve the following data:

1. ✅ Real server FPS (tickrate)
2. ✅ Number of connected players
3. ✅ Average ping
4. ✅ Uptime (server running time)

⚠️ This script has no impact on performance, collects no sensitive data, and can be removed at any time.

✅ Step 1: Download the script

Create a folder in your server named fpsmeter_server

Inside the folder, create the following two files:

fxmanifest.lua

fx_version 'cerulean'
game { 'gta5', 'rdr3' }

author 'FPSMeter'
description 'Plugin de monitoring FPS pour FiveM / RedM'
version '1.1.0'

server_script 'server.lua'
				

server.lua

local fps = 0
local ticks = 0
local lastSecond = GetGameTimer()
local startTime = os.time()

local fpsHistory = {}
local pingHistory = {}
local maxHistory = 120 -- 120 secondes d'historique (2 minutes)

local minFPS, maxFPS = nil, nil
local minPing, maxPing = nil, nil

local tickDurations = {}
local waitCounter = 0
local lastClock = os.clock()

-- Moyenne
local function average(t)
    if #t == 0 then return 0 end
    local sum = 0
    for _, v in ipairs(t) do sum = sum + v end
    return sum / #t
end

-- Écart-type
local function standardDeviation(t)
    if #t == 0 then return 0 end
    local avg = average(t)
    local sum = 0
    for _, v in ipairs(t) do
        sum = sum + ((v - avg) ^ 2)
    end
    return math.sqrt(sum / #t)
end

CreateThread(function()
    while true do
        Wait(0) -- plus proche de la vraie cadence
        ticks = ticks + 1
        waitCounter = waitCounter + 1
        local now = GetGameTimer()

        if now - lastSecond >= 1000 then
            local currentFPS = ticks
            fps = currentFPS
            table.insert(fpsHistory, currentFPS)
            if #fpsHistory > maxHistory then table.remove(fpsHistory, 1) end

            minFPS = (minFPS == nil or currentFPS < minFPS) and currentFPS or minFPS
            maxFPS = (maxFPS == nil or currentFPS > maxFPS) and currentFPS or maxFPS

            -- Ping
            local pingSum = 0
            local pings = {}
            local players = GetPlayers()
            for _, id in ipairs(players) do
                local ping = GetPlayerPing(id)
                pingSum = pingSum + ping
                table.insert(pings, ping)
            end
            local avgPing = #pings > 0 and math.floor(pingSum / #pings) or 0
            table.insert(pingHistory, avgPing)
            if #pingHistory > maxHistory then table.remove(pingHistory, 1) end

            for _, v in ipairs(pings) do
                if minPing == nil or v < minPing then minPing = v end
                if maxPing == nil or v > maxPing then maxPing = v end
            end

            -- Tick duration (temps réel écoulé entre deux ticks par os.clock)
            local nowClock = os.clock()
            local duration = nowClock - lastClock
            lastClock = nowClock
            table.insert(tickDurations, duration)
            if #tickDurations > maxHistory then table.remove(tickDurations, 1) end

            ticks = 0
            lastSecond = now
        end
    end
end)

RegisterCommand("fpsmeter", function(source, args, raw)
    if source ~= 0 and not IsPlayerAceAllowed(source, "fpsmeter.use") then
        TriggerClientEvent("chat:addMessage", source, {
            args = {"[FPSMeter]", "Vous n’êtes pas autorisé à utiliser cette commande."}
        })
        return
    end

    local players = #GetPlayers()
    local uptime = os.time() - startTime
    local avgPing = average(pingHistory)
    local avgFPS = average(fpsHistory)
    local stddevFPS = standardDeviation(fpsHistory)
    local avgTickTime = average(tickDurations)

    local output = {
        fps_avg   = math.floor(avgFPS),
        fps_min   = minFPS or avgFPS,
        fps_max   = maxFPS or avgFPS,
        fps_std   = tonumber(string.format("%.2f", stddevFPS)),
        players   = players,
        avg_ping  = math.floor(avgPing),
        min_ping  = minPing or 0,
        max_ping  = maxPing or 0,
        uptime    = uptime,
        wait_calls = waitCounter,
        avg_tick_time = tonumber(string.format("%.4f", avgTickTime))
    }

    print(json.encode(output))
end, true)

print("[fpsmeter_server] Plugin FPSMeter amélioré chargé ✅ (historique, ping, ticks, stddev, uptime).")
				

✅ Step 2: Add the resource to your server.cfg

Add the following line at the end of your server.cfg file:

ensure fpsmeter_server

Then restart your server.

✅ Step 3: Configure your server’s RCON

Make sure you have defined an RCON password in your server.cfg:

rcon_password "votre_mot_de_passe_rcon"

FPSMeter will connect securely using this password to run the fpsmeter command.

✅ Step 4: Launch the analysis on FPSMeter

Once your server is online:

1. Go to https://fpsmeter.esport-cms.net/benchmark.php
2. Select FiveM from the list of games
3. Enter your server IP, RCON port and password
4. Start the analysis!

⚠️ Your firewall must allow TCP RCON connections on your server port (usually 30120).

---

ℹ️ What does this script do?

This small script exposes a "fpsmeter" command that FPSMeter can call via RCON. Each time it’s run, it returns:

1. The actual server FPS
2. The number of online players
3. The average ping
4. The server uptime

These values are then displayed as real-time graphs for a few minutes to help you evaluate your server’s stability and performance, especially after:

1. A game/server update
2. Installing a heavy or resource-intensive script
3. Changing your game server host

🔐 Security & Privacy

1. The script collects no personal data.
2. No data is sent anywhere except FPSMeter during the analysis.
3. The script is fully open-source and can be disabled at any time.

❌ Uninstalling the script

To disable the script:

1. Delete the fpsmeter_server folder
2. Remove the line start fpsmeter_server from your server.cfg
3. Restart your server

---

- ✍️ Written on: 02/07/2025 à 17h32
- 🔄 Last updated on: 04/07/2025 à 11h13
- 🧠 Author: Slymer
- 💬 Community discussion: View the conversation