Neenbyss Logs (nb-logs)
Advanced logging and auditing system for FiveM servers, focused on ox_inventory and critical gameplay events, with direct Discord webhook integration.
This script provides full traceability of sensitive actions within the server, enabling effective moderation, abuse detection, and real-time administrative monitoring.
What this script does
Centralizes ox_inventory logs.
Tracks player-to-player interactions.
Monitors deaths and kills, including cause and exact location.
Sends structured logs directly to Discord.
This is not a visual script. It is a backend control and logging system.
Main Features
Complete ox_inventory logging
Automatically records:
Items dropped on the ground.
Items picked up.
Item transfers between players.
Stash deposits and withdrawals.
Inventory and container access.
Shop purchases.
Each log includes player data, identifiers, items, quantities, metadata, and coordinates.
Death and kill tracking
Detects who killed whom.
Logs the exact cause of death.
Stores precise coordinates of the event.
Differentiates between:
Natural death.
Player kills.
Specific causes (weapons, vehicle impact, etc.).
Discord integration
Webhook-based logging system.
Clean, readable message format.
Designed for:
Staff teams.
Moderators.
Administrative logs.
Post-incident review.
Available placeholders
General placeholders
| Placeholder | Description |
|---|---|
playerName | Player name |
playerIdentifier | Unique identifier |
source | Player ID |
itemName | Item name |
count | Item quantity |
metadata | Item metadata |
coords | Event coordinates |
targetName | Target player name |
targetIdentifier | Target identifier |
targetSource | Target ID |
stash | Stash type |
killerName | Killer name |
killerIdentifier | Killer identifier |
killerSource | Killer ID |
victimName | Victim name |
victimIdentifier | Victim identifier |
victimSource | Victim ID |
victimIdCoords | Victim coordinates |
cause | Cause of death |
ox_inventory events
| Event | Description | Placeholders |
|---|---|---|
drop | Item dropped | playerName, playerIdentifier, source, itemName, count, metadata, coords |
pickup | Item picked up | playerName, playerIdentifier, source, itemName, count, metadata, coords |
give | Item transfer | playerName, targetName, itemName, count, metadata, playerIdentifier, targetIdentifier, coords |
stash_pick | Stash deposit | playerName, playerIdentifier, source, itemName, count, metadata, stash, coords |
stash | Stash withdrawal | playerName, playerIdentifier, source, itemName, count, metadata, stash, coords |
openInventory | Inventory open | playerName, playerIdentifier, source, inventory, coords |
buyItem | Shop purchase | playerName, playerIdentifier, item, shop, price, currency, coords |
Currency handling (currency)
Automatically detects
money,bank, or custom currencies.Fully compatible with custom currencies (
crypto,gold, etc.).If no manual mapping exists, the raw server value is logged.
Gameplay events
| Event | Description | Placeholders |
|---|---|---|
killPlayer | Player kill | killerName, killerIdentifier, victimName, victimIdentifier, victimIdCoords |
died (cause) | Death without killer | victimName, victimIdentifier, cause, victimIdCoords |
died (kill) | Death with killer | killerName, killerIdentifier, victimName, victimIdentifier, cause, victimIdCoords |
Requirements
ox_inventory
Updated FiveM server
Discord webhooks
Limitations
No graphical interface included.
No ban or punishment system.
Not plug-and-play: webhook setup required.
Does not replace an anticheat.
Recommended use
Roleplay servers.
Active staff teams.
Economy and inventory auditing.
Incident investigation and review.
