FreeTool
telemetry
by PocusSoftware · version 2026.11.11 · updated 4 days ago
No reviews yet
- Downloads
- 0
- Reviews
- 0
- Size
- 10 KB
- Code check
- Checked
- Licence
- LGPL-3.0
- Released
- Nov 2026
Script error telemetry for FiveM & RedM: catches server and client Lua errors and forwards them to an event and an optional Discord webhook.
telemetry
Script error telemetry for FiveM & RedM. It catches Lua errors on the server and on
clients, rate limits them, and hands them to your code through one event and
an optional Discord webhook.
RedM is Untested in a live server so far. Read the limits below before relying on it.
Install
The hook needs Lua 5.4 in the watched resource (
Receive errors
A local server event fires for every error:
The event is not networked, so clients cannot trigger it.
Discord webhook
Set the URL in
value to every client):
Messages are sent with mentions disabled. Discord rate limits webhooks and
failed sends are dropped silently.
Config
See server/config.lua: cooldown, stack wait, trace length, console
logging for client errors, and an ignore list.
Limits
resource.
loads. Errors in NUI callbacks, state bag handlers, exports or
License
LGPL-3.0-or-later, see LICENSE.
Script error telemetry for FiveM & RedM. It catches Lua errors on the server and on
clients, rate limits them, and hands them to your code through one event and
an optional Discord webhook.
RedM is Untested in a live server so far. Read the limits below before relying on it.
Install
- Put the folder in
resources/andensure telemetrybefore the
- Server errors need nothing else. The server reads the console channel of
script:).
- For client errors, add the hook as the first client script of each
client_scripts {
'@telemetry/client/hook.lua',
'client.lua',
}The hook needs Lua 5.4 in the watched resource (
lua54 'yes').Receive errors
A local server event fires for every error:
AddEventHandler('telemetry:error', function(entry)
-- entry.side 'client' | 'server'
-- entry.resource string
-- entry.trace string
-- entry.source integer, client errors only
end)The event is not networked, so clients cannot trigger it.
Discord webhook
Set the URL in
server.cfg with set, never setr (setr replicates thevalue to every client):
set telemetry:webhook "https://discord.com/api/webhooks/..."Messages are sent with mentions disabled. Discord rate limits webhooks and
failed sends are dropped silently.
Config
See server/config.lua: cooldown, stack wait, trace length, console
logging for client errors, and an ignore list.
Limits
entry.resourceon client errors is reported by the client. It is checked
resource.
entry.source is trustworthy.
- Reports are throttled per resource (and per player for clients), so a
- The hook wraps
AddEventHandler,RegisterNetEvent,RegisterCommand,
CreateThread and SetTimeout, and only for code registered after itloads. Errors in NUI callbacks, state bag handlers, exports or
Citizen.SetTimeout are not caught client side.
- Wrapped handlers swallow the error after reporting it, instead of passing
- The server stack is stitched from console lines with a short wait
stackWait). A very slow console can cut a trace.License
LGPL-3.0-or-later, see LICENSE.