Docs /Discord Bot/Usage
v1.0.0

Usage — foltone_fivem_discord_bot

Discord Slash Commands

All commands are executed from Discord with the / prefix.

Players

CommandDescriptionPermission
/playerlistList connected players with server ID and identifiersmoderator
/playerinfo [id]Detailed information about a player (identifiers, job, money)moderator
/kick [id] [reason]Kick a player from the servermoderator
/ban [id] [duration] [reason]Ban a player (e.g., duration 7d, permanent)admin
/unban [identifier]Lift a player banadmin
/spectate [id]Enter spectator mode on a playermoderator

Moderation

CommandDescriptionPermission
/warn [id] [reason]Warn a player (logged to database)moderator
/mute [id] [duration] [reason]Mute a player in the in-game chatmoderator
/unmute [id]Unmute a playermoderator
/freeze [id]Freeze a player in placemoderator
/unfreeze [id]Unfreeze a playermoderator
/slap [id] [force]Knock a player backmoderator
/heal [id]Fully heal a playermoderator
/revive [id]Revive a downed playeradmin
/sanctions [id]View a player’s sanction historymoderator

Economy

CommandDescriptionPermission
/givemoney [id] [amount] [account]Give money to a playeradmin
/removemoney [id] [amount] [account]Remove money from a playeradmin
/setmoney [id] [amount] [account]Set a player’s moneyadmin
/giveitem [id] [item] [quantity]Give an item to a playeradmin
/removeitem [id] [item] [quantity]Remove an item from a playeradmin

Vehicles & Teleportation

CommandDescriptionPermission
/tp [id] [target_id]Teleport a player to another playeradmin
/spawnvehicle [id] [model]Spawn a vehicle for a playeradmin
/deletevehicle [id]Delete a player’s vehicleadmin

Job

CommandDescriptionPermission
/setjob [id] [job] [grade]Change a player’s jobadmin

Server

CommandDescriptionPermission
/announce [message]Send an announcement to all players in-gameadmin
/weather [type]Change the server weatheradmin
/time [hour]Change the server timeadmin
/whitelist [add/remove] [identifier]Manage the server whitelistadmin
/serverstatusShow server statisticsall

Tracking & Scheduling

CommandDescriptionPermission
/watchlist [add/remove/list] [identifier]Manage the watchlistadmin
/schedule [add/remove/list]Manage scheduled tasksfounder

Discord Dashboard

The dashboard is a Discord embed that auto-updates (every X seconds as per Config.Dashboard.refreshInterval).

It shows:

  • Connected players / maximum
  • Server uptime
  • Recent connections and disconnections
  • Recent admin actions
  • Quick action buttons (quick kick, view player list)

The dashboard updates automatically and requires no interaction.


Ticket System

From Discord

Players can open a ticket using buttons available in your welcome channel or via a configured command.

On creation:

  1. A private channel is created in the configured category
  2. The player and admins have access
  3. The channel is named ticket-{name}-{id}

On closure:

  1. An admin clicks the Close Ticket button
  2. The transcript is saved (if transcriptEnabled = true)
  3. The channel is deleted and a log is sent to logsChannelId

From the game

Players can open a ticket directly from FiveM:

  • Command: /{Config.Tickets.command} (default: /ticket)
  • Shortcut key: Config.Tickets.keybind (default: F6)

Ticket messages are synchronized in real time between Discord and the game.


Synchronized Chat

Chat is bidirectional between Discord and the game:

  • Messages sent in the configured Discord channel appear in-game with the [DISCORD] prefix
  • Player messages in-game appear on Discord with their name

Discord messages display the user’s name and avatar.


Smart Alerts

The alerts system automatically sends notifications to the configured channel based on defined rules:

AlertTrigger
Excessive warningsPlayer with X warns in Y minutes
Suspicious transactionTransaction exceeding the threshold
Low server populationPlayer count below threshold
High server populationPlayer count above threshold
Watched playerA watchlisted player connects
Serial killerPlayer with X kills in Y minutes
Mass crashX players disconnected in Y minutes

Alerts mention the configured role in mentionRoleId for urgent alerts.


Admin NUI Panel (in-game)

The NUI panel is accessible only to in-game admins.

Access

  • Command: /adminpanel (or configured command in Config.Panel.command)
  • Shortcut key: F7 (or configured key in Config.Panel.keybind)
  • Close: same key or Escape

Available pages

PageDescription
DashboardOverview: online players, server stats, uptime
PlayersPlayer list with quick actions (kick, ban, tp, heal, revive)
EconomyManage player money and inventory
LogsServer log history with filters by type
TicketsView and manage open tickets
SchedulerManage scheduled tasks (restarts, announcements)

Quick actions (players panel)

In the players tab, select a player to access:

  • Kick / Ban
  • Teleport to / Teleport here
  • Give money / items
  • Heal / Revive / Freeze
  • View sanctions

Task Scheduler

Scheduled tasks (restarts, announcements) are managed through the scheduler:

From Discord

/schedule add daily_restart restart "0 4 * * *" 30,15,5,1
/schedule list
/schedule remove daily_restart

From the NUI panel

The Scheduler tab in the NUI panel allows viewing and managing tasks without leaving the game.

Cron format

ExpressionDescription
0 4 * * *Every day at 4:00 AM
0 */6 * * *Every 6 hours
0 12 * * 1Every Monday at 12:00 PM