Introduction to FiveM Bot

Welcome to FiveM Bot - the most powerful and user-friendly Discord bot for managing your FiveM servers.

This documentation will guide you through the complete setup process and help you get your bot running in minutes.

What is FiveM Bot?

FiveM Bot is a free Discord bot that allows you to monitor and manage your FiveM servers directly from Discord. With real-time updates, player tracking, and administrative controls, it's the perfect tool for server owners and administrators.

Key Features

  • Real-time server monitoring
  • Player list and statistics
  • RCON command execution
  • Automatic alerts and notifications
  • Multi-server support
  • 100% Free to use

Video Tutorial

Watch Setup Tutorial

Requirements

Before setting up FiveM Bot, ensure you have the following:

Discord Requirements

  • A Discord server where you have administrator permissions
  • Ability to add bots to your server
  • A dedicated channel for bot commands (recommended)

FiveM Server Requirements

  • A running FiveM server
  • Server IP address and port
  • RCON password (optional, for admin commands)
  • Server must be publicly accessible

Note: Your FiveM server must be accessible from the internet. Localhost or private network servers won't work unless properly configured with port forwarding.

Adding the Bot to Your Server

Follow these simple steps to add FiveM Bot to your Discord server:

Step 1: Invite the Bot

  1. Click the "Add to Discord" button on our website or use the invite link
  2. You'll be redirected to Discord's authorization page
  3. Select your server from the dropdown menu
  4. Review the required permissions
  5. Click "Authorize"
  6. Complete the captcha if prompted

Once authorized, the bot will immediately join your server and be ready for configuration!

Step 2: Verify Bot Presence

After adding the bot, check that it appears in your server's member list. The bot should show as online with a green status indicator.

Bot Permissions

FiveM Bot requires specific permissions to function properly. Here's what each permission is used for:

Required Permissions

Send Messages

Allows the bot to send status updates and respond to commands

Embed Links

Required for rich embeds showing server statistics

Use Slash Commands

Enables modern slash command interactions

Read Messages

Allows the bot to see commands in channels

Optional Permissions

  • Manage Messages: For cleaning up old status messages
  • Add Reactions: For interactive command confirmations
  • Manage Webhooks: For advanced notification features

Setting Up Your First Server

Once the bot is in your Discord server, let's connect it to your FiveM server.

Step 1: Use the /setserver Command

/setserver ip:YOUR_SERVER_IP port:YOUR_SERVER_PORT

Example:

/setserver ip:192.168.1.100 port:30120

Step 2: Set the Status Channel

Choose where you want the bot to post server status updates:

/setchannel #your-channel-name

Step 3: Test the Connection

Verify everything is working correctly:

/serverstatus

Tip: If you see your server information, congratulations! Your bot is now fully configured and monitoring your server.

Server Configuration

Customize how the bot monitors and interacts with your FiveM server.

Basic Configuration

Setting Server Details

/setserver ip:IP port:PORT name:"Server Name"

Configure RCON (Optional)

To enable admin commands, set up RCON access:

/setrcon password:YOUR_RCON_PASSWORD

Security Warning: Only use this command in a private channel. The bot will delete the message immediately for security, but be cautious.

Update Intervals

Configure how often the bot checks your server:

/setinterval minutes:5

Available intervals: 1, 5, 10, 15, 30 minutes

Channel Setup

Configure different channels for various bot functions.

Status Channel

Main channel for server status updates:

/setchannel status #status-channel

Alert Channel

Separate channel for important alerts:

/setchannel alerts #alert-channel

Log Channel

Channel for detailed server logs:

/setchannel logs #log-channel

Basic Commands

Essential commands for everyday server monitoring.

Server Status

/serverstatus

Shows current server status, player count, and basic information.

Player List

/players

Displays all online players with their IDs and ping.

Server Info

/serverinfo

Shows detailed server information including resources and configuration.

Statistics

/stats period:day

View server statistics for different time periods (day, week, month).

Quick Setup Guide

Get your bot up and running in just 4 simple steps!

  1. Add the Bot to Your Discord Server

    Click the button below to invite FiveM Bot to your server:

    Add to Discord

  2. Configure Your FiveM Server

    Use the following command in any channel:

    /setserver ip:YOUR_IP port:YOUR_PORT

  3. Set Your Status Channel

    Choose where the bot should post updates:

    /setchannel #channel-name

  4. Test Your Setup

    Verify everything is working:

    /serverstatus

That's it! Your bot is now monitoring your FiveM server.

Role Permissions

Configure who can use different bot commands based on Discord roles.

Default Permission Levels

Everyone

Basic commands like /serverstatus, /players, /stats

Moderator

Player management, basic server control

Administrator

Full RCON access, server configuration, alerts

Setting Custom Permissions

/setrole admin @AdminRole

Assign specific Discord roles to bot permission levels.

Permission Commands

  • /setrole admin @role - Set admin role
  • /setrole moderator @role - Set moderator role
  • /permissions view - View current permissions
  • /permissions reset - Reset to defaults

Alert Settings

Configure automatic notifications for important server events.

Available Alert Types

  • Server goes offline/online
  • Player count milestones (50%, 75%, 100% full)
  • New player record reached
  • Server restart notifications
  • High ping warnings
  • Resource errors

Enable/Disable Alerts

/alerts enable all

Configure Alert Channel

/setchannel alerts #alert-channel

Alert Commands

  • /alerts enable [type] - Enable specific alert type
  • /alerts disable [type] - Disable specific alert type
  • /alerts list - Show all alert settings
  • /alerts test - Send test alert

Admin Commands

Powerful administrative tools for server management.

These commands require administrator permissions and RCON access.

Server Management

/restart resource [name]

Restart a specific resource on the server.

/announce message:"Your message here"

Send a server-wide announcement to all players.

Player Management

/kick player:ID reason:"Reason"

Kick a player from the server.

/tempban player:ID duration:hours reason:"Reason"

Temporarily ban a player.

RCON Usage

Remote Console access for advanced server control.

Setting Up RCON

  1. Configure RCON Password

    /setrcon password:YOUR_RCON_PASSWORD

    Use this in a private channel - the message will be deleted for security.

  2. Test RCON Connection

    /rcon test

Execute RCON Commands

/rcon command:"your command here"

Common RCON Commands

  • restart [resource] - Restart a resource
  • stop [resource] - Stop a resource
  • start [resource] - Start a resource
  • refresh - Refresh resource list
  • quit - Stop the server (use with caution!)

Security Note: Never share your RCON password. Only trusted administrators should have access to RCON commands.

Server Monitoring

Real-time monitoring and statistics tracking for your FiveM server.

Status Updates

The bot automatically posts status updates showing:

  • Online/Offline status
  • Current player count
  • Server uptime
  • Average ping
  • Resource usage

Update Frequency

/setinterval minutes:5

Available intervals: 1, 5, 10, 15, 30 minutes

Statistics Tracking

/stats period:week

View detailed statistics including:

  • Peak player counts
  • Average players per hour
  • Total unique players
  • Uptime percentage

Export Data

/export type:csv period:month

Export server statistics for external analysis.

Multiple Servers

Monitor and manage multiple FiveM servers from one bot.

Adding Multiple Servers

  1. Add First Server

    /addserver name:"Main" ip:1.1.1.1 port:30120

  2. Add Additional Servers

    /addserver name:"Test" ip:2.2.2.2 port:30121

Switch Between Servers

/switchserver name:"Server Name"

List All Servers

/listservers

Server-Specific Channels

Set different channels for each server:

/setchannel server:"Main" status #main-status

Pro Tip: Use different channels for each server to keep updates organized.

Webhooks

Integrate with external services using webhooks.

Discord Webhooks

Send formatted messages to specific channels:

/setwebhook type:status url:"webhook_url"

Custom Webhooks

Send data to your own endpoints:

/webhook custom url:"your_api" events:all

Available Events

  • server_start - Server comes online
  • server_stop - Server goes offline
  • player_join - Player joins
  • player_leave - Player leaves
  • milestone - Player count milestones
  • error - Server errors

Webhook Format

Data is sent as JSON:

{ "event": "server_start", "server": "Main Server", "timestamp": "2025-01-01T12:00:00Z", "data": {...} }

Connection Problems

Troubleshooting guide for connection issues.

Server Not Found

Check Server IP and Port

  • Verify the IP address is correct (use external IP, not localhost)
  • Ensure port is correct (default: 30120)
  • Test connection: /testconnection ip:YOUR_IP port:YOUR_PORT

Firewall Issues

Configure Firewall Settings

  • Open port 30120 (or your custom port) in Windows Firewall
  • Configure router port forwarding if hosting from home
  • Check cloud provider security groups (AWS, Azure, etc.)
  • Ensure FiveM server is allowed through antivirus

RCON Connection Failed

RCON Troubleshooting

  • Verify RCON password is correct
  • Check if RCON is enabled in server.cfg
  • Ensure RCON port (usually 30120) is open
  • Try resetting RCON: /rcon reset

Bot Offline in Server

Bot Connection Issues

  • Check bot has proper permissions
  • Verify bot role is above restricted roles
  • Try kicking and re-inviting the bot
  • Check Discord server outages

Debug Mode: Enable debug mode with /debug enable to see detailed error messages.

Frequently Asked Questions

Is FiveM Bot really free?

Yes! FiveM Bot is 100% free to use with no hidden costs or premium features. All functionality is available to everyone.

How many servers can I monitor?

You can monitor up to 10 FiveM servers per Discord server with a single bot instance.

Does the bot store player data?

The bot only stores necessary data for functionality (player counts, statistics). No personal player information is retained. See our Privacy Policy for details.

Can I customize the bot's messages?

Yes! Use /customize to modify message formats, colors, and embed styles.

What permissions does the bot need?

Minimum: Send Messages, Embed Links, Use Slash Commands. Optional: Manage Messages, Add Reactions for enhanced features.

How often does the bot update server status?

Default is every 5 minutes. You can change this with /setinterval (1-30 minutes).

Can I use the bot with localhost servers?

No, the bot needs to access your server from the internet. Localhost/private network servers won't work unless configured with port forwarding or tunneling.

Is the source code available?

The bot is not open-source, but we welcome feature requests and bug reports through our support channels.

How do I report issues or request features?

Join our Discord support server or use /feedback command to submit suggestions directly.

Can the bot restart my server automatically?

Yes, with RCON configured, you can set up scheduled restarts using /schedule restart daily 04:00.

Still have questions? Join our support server or use /help for more information.

Common Issues & Solutions

Bot is offline or not responding

Solution:

  • Check if the bot has proper permissions in your server
  • Ensure the bot role is not below other restrictive roles
  • Try kicking and re-inviting the bot

Cannot connect to FiveM server

Solution:

  • Verify your server IP and port are correct
  • Ensure your server is publicly accessible
  • Check firewall settings on your server
  • Confirm the server is actually running

Commands not working

Solution:

  • Make sure you're using slash commands (/)
  • Check that the bot has permission to use slash commands
  • Try refreshing Discord (Ctrl+R)
  • Ensure you have the required role permissions