Docs

FiveM Integration

Connect FiveM servers and create reports as tickets

Overview

Seamlessly connect your FiveM server to Modora's Discord ticket system. Players can submit reports directly from in-game, which automatically create tickets in Discord with full context, screenshots, and player information.

✓ In-Game Reports✓ Auto Ticket Creation✓ Staff Dashboard

Key Features

🎮 In-Game Report System

Players use /report to open the Modora-styled report NUI: category (Scam, Harassment, Exploit, Cheating, Other), title, description, optional evidence URLs and reported players. Validation, cooldown notice and success state are built-in.

📸 Screenshot Uploads

Upload screenshots and attachments directly from FiveM using Modora's CDN upload API - files are securely stored and linked to tickets

👥 Nearby Players Detection

Automatically detect and include nearby players in reports (configurable radius and max count) - perfect for identifying rule breakers

🎫 Automatic Ticket Creation

Reports automatically create Discord tickets with full context: reporter info, targets, position, category, and attachments

⚙️ Panel Configuration

Select which Discord ticket panel to use per category - different report types can go to different staff teams

🛡️ Rate Limiting

Built-in cooldown system prevents spam - configurable per server to balance accessibility and moderation

🔐 Secure API

HMAC signature verification ensures only authorized FiveM servers can submit reports - API keys are server-specific

📊 Staff Dashboard

View all FiveM reports, manage server configurations, and monitor integration status from the Modora dashboard

Setup

01

Enable FiveM Module

Go to Dashboard → Your Server → Modules → Enable "FiveM Integration"

02

Add FiveM Server

Go to Dashboard → Your Server → FiveM → Add Server

Enter server name and configure settings (default panel, nearby radius, cooldown, etc.)

03

Copy API Token

After creating a server, copy the API Token from the server settings page. This is the only credential you need.

04

Download & Install Resource

Download the Modora FiveM resource and place it in your resources/ folder

→ Download Resource
05

Configure Resource

Edit resources/modora-admin/config.lua and set API base and token

  • Config.ModoraAPIBase = 'https://api.modoralabs.com'
  • Config.APIToken = 'your_token_here' (paste your API token)
06

Add to server.cfg

Add ensure modora-admin to your server.cfg

07

Restart Server

Restart your FiveM server or run restart modora-admin

Resource Configuration

config.lua
Config = {}

-- ============================================
-- API CONFIGURATION (REQUIRED)
-- ============================================
-- API Base URL - Uses HTTP/1.1 for FiveM compatibility
Config.ModoraAPIBase = 'https://api.modoralabs.com'

-- API Token - Get this from your Modora Dashboard:
-- Dashboard > Guild > FiveM Integration > [Your Server] > API Token
Config.APIToken = 'your_api_token_here'

-- ============================================
-- REPORT SETTINGS
-- ============================================
Config.ReportCommand = 'report'
Config.ReportKeybind = 'F7'
Config.NearbyRadius = 30.0
Config.MaxNearbyPlayers = 5
Config.Locale = 'nl'  -- 'nl' or 'en'
Config.Debug = false

Resource Configuration

Note: The resource uses direct API integration via HTTP/1.1. Use api.modoralabs.com (FiveM blocks .xyz domains). Simply configure your API token from the dashboard and you're ready to go.

Server Stats Panel

The in-game Server Stats panel (default command: /serverstats) shows uptime, player count, resource count, server version, and the last 5 errors. Access is restricted by TXAdmin permission or ACE.

Dashboard configuration

Under Dashboard → Guild → FiveM → [Your Server] → Overview, use the "Server Stats" section to set the command (default: serverstats), which TXAdmin permission is required (e.g. console.view or all_permissions), optionally allow access without TXAdmin (e.g. via ACE only), and an optional ACE permission (e.g. modora.serverstats). The TXAdmin permission must match what you set in TXAdmin Admin Manager. To grant via ACE, add to server.cfg: add_ace group.X modora.serverstats allow.

Last 5 errors

The "Last 5 errors" list is only populated when errors are pushed from other resources or the server using TriggerEvent('modora:pushServerError', message) or exports['modora-admin']:PushServerError(message).

In-Game Commands

/report

Opens the report modal menu where players can submit reports with category, description, nearby players, and attachments

/modora staff

Staff-only command to view open reports, claim tickets, and manage reports from in-game (requires staff permissions)

Dashboard Features

Server Management

  • - Add multiple FiveM servers
  • - Configure per-server settings
  • - Set default ticket panels
  • - Custom categories per server
  • - Category-to-panel mapping

Report Management

  • - View all FiveM reports
  • - Link to Discord tickets
  • - Filter by status/category
  • - View reporter & target info
  • - Access attachments

API Token Authentication

Each FiveM server gets a unique API token for secure authentication. Simple and secure.

  • API Token: Auto-generated when you create a server
  • Simple Setup: Just copy the token to config.lua
  • Regenerable: Can be regenerated from the dashboard at any time
  • Secure: All communication uses HTTPS with HTTP/1.1 compatibility

Report Flow

01

Player Submits Report

Player types /report in-game, fills out the modal with category, description, selects nearby players, and uploads screenshots

02

Upload to CDN

Screenshots are uploaded to Modora's CDN using a secure upload token. Files are validated and stored securely

03

FiveM Server Validates

FiveM server validates the report, checks cooldown, collects player identifiers (license, Discord, Steam), and prepares the payload

04

API Request to Modora

FiveM server sends a secure API request to api.modoralabs.com with API token authentication (Bearer token), including all report data and attachment IDs

05

Ticket Created

Modora creates a Discord ticket in the configured panel with all report information, player details, position, targets, and linked attachments

06

Player Notified

Player receives confirmation in-game with ticket ID. Staff can now handle the report in Discord

Security Features

API Token Authentication

Simple and secure token-based authentication. Each server gets a unique API token that's validated on every request. All communication uses HTTPS with HTTP/1.1 compatibility for FiveM.

IP Whitelisting (Optional)

Configure allowed IP addresses for your FiveM server to restrict API access to specific IPs only.

Rate Limiting

Built-in cooldown system prevents spam. Each player has a configurable cooldown period between reports.

Secure File Uploads

Screenshots are uploaded using short-lived upload tokens. API secrets are never exposed to the FiveM client.

Requirements

FiveM Server

  • FiveM server (any version)
  • Server must be able to make HTTP requests
  • Resource folder access

Modora

  • Modora bot added to Discord server
  • Ticket module enabled
  • At least one ticket panel configured
  • FiveM module enabled in dashboard

Troubleshooting

Support

Info

Need help setting up FiveM integration? Join our Discord server or check the API documentation.

Was this page helpful?