Ravn-Logs - FiveM Event & Player Logging Made Easy

FiveM Releases
, , ,
1

Ravn Logs is an open source FiveM logging resource for tracking player activity and server events. It helps server owners and admins see what’s happening in the game, whether for moderation or development.

GitHub Repository:

Log Preview

ravn-logs preview
ravn-logs preview1070×700 94.4 KB

Version:

v0.9.0

  • Initial public beta release of Ravn Logs

Supported Frameworks:

Ravn Logs uses FiveM Natives which should allow the resource to function on all frameworks.

  • Qbox
  • QBcore
  • ESX (Untested, community feedback would be appreciated)

Prerequisites:

  • FiveM Artifact: 25770 or higher
  • GTA Game Build: 3258 or higher
  • Tx Admin

Features:

Full Player Death Logging

Tracks multiple types of player deaths:

  • Player vs Player (PVP) kills
  • NPC combat
  • Vehicle related deaths (can distinguish if the killer was a player or NPC)
  • Self inflicted deaths
  • Environmental deaths

Weapon Fire Logging

  • Logs each time a player fires a weapon
  • Log includes:
    • Player’s FiveM screen name
    • Server ID and identifiers
    • Weapon name (or hash for custom weapons)
    • Coordinates of where the shot was fired

Explosion Event Logging

  • Logs when an explosion occurs in the world.
  • Log includes:
    • Type of explosion
    • Coordinates of where the explosion occurred.

Chat Message Logging

  • Logs specific commands in player chat (e.g., /ooc, /me, /scene) along with the player’s message
  • Log includes:
    • Player’s FiveM screen name
    • Server ID and identifiers
    • Displays the type of command used
    • Displays the message the player sent

F8 Console Logging

  • Logs specific F8 console entries
    • Player’s FiveM screen name
    • Server ID and identifiers
    • Displays the command the player used
      **NOTE: Some of the FiveM native F8 console commands are unable to be intercepted and logged such as the “quit” and “disconnect” command. (I tried :/)

Player Joined Logs

  • Logs each time a player connects to the server.
  • Log includes:
    • Player’s FiveM screen name
    • Server ID and identifiers

Player Disconnect Logs

  • Logs each time a player disconnects from the server.
  • Log includes:
    • Player’s FiveM screen name
    • Server ID and identifiers
    • Disconnect reason, pulled from TxAdmin.

Discord Integration

  • Send server logs to Discord channels via webhooks!
  • Safely handles Discord API rate limits and errors.
  • Queue system with retries for reliable message delivery.

NDJSON Logging

  • Logs are written locally to NDJSON files inside the ravn-logs resource folder.
  • Automatic daily log file rotation.
  • Configurable log file retention and automatic file cleanup.
  • Each log entry is timestamped in ISO 8601 format (UTC).
  • Formatted for compatibility with Promtail log ingestion.

License

Ravn Logs is licensed under the GNU General Public License v3 (GPLv3).
See the LICENSE file for details: ravn-logs/LICENSE.txt

This project is open source. If you redistribute it, you must comply with the GPLv3 license, including providing source code.

Help & Troubleshooting

  • Ask questions or get help troubleshooting Ravn Logs in the Github repository Discussions.

Contributing & Feedback

Community contributions are welcomed and appreciated!

Ways to Contribute:

  • Report bugs through Issues.
  • Suggest new features or improvements in Discussions.
  • Submit Pull Requests for bug fixes or enhancements.
Code is accessible Yes
Subscription-based No
Lines (approximately) 1,600+
Requirements FiveM Artifact 25770 or higher, Build 3258 or higher, and TxAdmin
Support Yes
1 Like