Discord Webhook Logging

A lightweight, high-performance logging system for FiveM designed to send detailed, formatted Discord webhooks. It features automated player identifier retrieval, cooldown protection to prevent spam, and a flexible placeholder system for custom data.

Features

• Automated Identifiers: Automatically pulls Discord ID, Steam Profile, FiveM License, and more.
• Template System: Define your webhooks in a central config with easy-to-use {placeholder} tags.
• Anti-Spam: Built-in 3-second cooldown per player to prevent webhook rate-limiting.
• Ox Lib Integration: Utilizes ox_lib for standardized coding practices.
• Multi-Context: Exports available for both Server and Client-side scripts.

Installation

1. Ensure you have ox_lib installed as it is a shared dependency.
2. Place the perc-logging folder into your resources directory.
3. Configure your Discord Webhook URLs in server/config.lua.
4. Add ensure perc-logging to your server.cfg.

Embed Example

This is how it can look. (Using my rental script)

Exports

Server-side Export

Use this in your server scripts to log sensitive actions.

exports['perc-logging']:SendLog(source, 'pawnshop', {
    amount = 5,
    item = 'Gold Watch',
    money_amount = 1500,
    money_type = 'money'
})

Client-side Export

Use this for client-side triggers. It automatically triggers a server event to process the log.

exports['perc-logging']:SendLog('pawnshop', {
    amount = 1,
    item = 'Diamond Ring',
    money_amount = 5000,
    money_type = 'black_money'
})