# Discord overview

Learn FiveDash's Discord module, set up your city's bot and follow members, modules and commands on one screen.

Source: https://fivedash.fivex.gg/docs/en/discord/overview

The **Discord** module puts a bot with your city's name and avatar in your Discord server. It handles the front door (verification, welcome, whitelist), support (tickets, forms), the community (suggestions, creators, clock-in) and safety (moderation, summons, protection). Everything is set up here in the panel; the bot just carries it out. This page is for owners and staff who will turn the bot on and follow it day to day.

[Video: how to do it in under 20 seconds](https://fivedash.fivex.gg/docs/videos/discord-overview-en.mp4)

## Before you start

* The **Discord** module must be in your organization's plan. **Protection**, **Creators** and **Summons** open from the **Pro** plan up. See [Plans and billing](https://fivedash.fivex.gg/docs/en/getting-started/plans-and-billing).
* The bot is tied to **one FiveM server** in the panel. With no server, the page shows **No servers yet**; add one from the sidebar's picker.
* To run the bot's first setup you need the **Configure** level on the **Bot** page. Anyone without it sees **The bot isn't set up yet** until someone on the team finishes setup.
* To see the **Overview** once the bot is ready, you need the **View** level on **Overview** ("Numbers and activity from every module"). Without it, the panel opens the first Discord page you can see.

## Set up the bot for the first time

Open **Discord** in the sidebar. While the bot isn't ready, the page shows **Connect your city's bot**, with three steps. It takes about five minutes. The full walkthrough is in [Bot](https://fivedash.fivex.gg/docs/en/discord/bot).

### Create and connect the bot

In the Discord Developer Portal, create an application with your city's name, copy the token in the **Bot** tab (**Reset Token**) and turn on **Server Members Intent** and **Message Content Intent**. Paste the token in **Bot token** and click **Connect bot**.

### Add it to your server

Click **Add to Discord**, authorize the bot in your city's server and come back to the panel's tab. Under **Where the bot joined**, pick the server and click **Use this server**.

### Check the permissions

The panel checks everything directly on Discord. Once the required items show **All good**, click **Finish**. The bot is ready and **Go to the bot's panel** takes you to it.

## What the Overview shows

After setup, **Discord → Overview** shows the bot's health and a summary of every module.

### Bot header

| Item                      | What it shows                                                                                                                                      |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| Status                    | **Online**, **Starting**, **Offline** or **Token rejected**.                                                                                       |
| **Check connection**      | Runs the Discord checks again (permissions, intents, endpoint, commands). Anyone with access to the module can use it.                             |
| **More bot options** menu | **Change token** and **Disconnect bot**. Only shows for people with **Configure** on **Bot**.                                                      |
| **Connection health**     | **All good** or **Needs attention**, with the Gateway state: **Online on the Gateway**, **Starting on the Gateway** or **Offline on the Gateway**. |

What each status means:

| Status             | What happens                                                                                                       |
| ------------------ | ------------------------------------------------------------------------------------------------------------------ |
| **Online**         | Connected to the Gateway: joins, suggestions, protection and interview rooms arrive instantly.                     |
| **Starting**       | The bot is joining the Gateway. It takes a few minutes and the page updates on its own.                            |
| **Offline**        | Commands keep working, but joins, suggestions, protection and interview rooms are paused until the worker is back. |
| **Token rejected** | Discord rejected the token. Commands stop responding until a new token is saved.                                   |

### Server summary

| Number              | What it counts                                                    |
| ------------------- | ----------------------------------------------------------------- |
| **Members**         | Members of the Discord server, with how many are online.          |
| **Joins · 7 days**  | Who joined in the last 7 days, compared with the previous 7 days. |
| **Leaves · 7 days** | Who left in the last 7 days, compared with the previous 7 days.   |
| **Modules on**      | How many modules are on.                                          |

**Server movement** shows joins and leaves over the last 14 days, with the **Net**. Numbers show up as soon as the bot is online on the Gateway.

### Modules

Each module has a card with its main number for the last 7 days. A module that's off shows **Off** and a **Set up and turn on** button.

| Module                                                                 | Main number                          | Details                        | Alert                           |
| ---------------------------------------------------------------------- | ------------------------------------ | ------------------------------ | ------------------------------- |
| [Verification](https://fivedash.fivex.gg/docs/en/discord/verification) | verified in 7 days                   | **Today**, **Errors**          | —                               |
| [Welcome](https://fivedash.fivex.gg/docs/en/discord/welcome)           | joins in 7 days                      | **Leaves**, **Net**            | —                               |
| [Tickets](https://fivedash.fivex.gg/docs/en/discord/tickets)           | open now                             | **This week**, **Avg. rating** | tickets without a reply         |
| [Whitelist](https://fivedash.fivex.gg/docs/en/discord/whitelist)       | unlocked in 7 days                   | **To review**, **Interview**   | whitelists waiting for the team |
| [Connect](https://fivedash.fivex.gg/docs/en/discord/connect)           | players in the city (or city status) | **City occupancy**             | **The panel wasn't updated**    |
| [Suggestions](https://fivedash.fivex.gg/docs/en/discord/suggestions)   | awaiting an answer                   | **This week**, **Approved**    | new suggestions                 |
| [Moderation](https://fivedash.fivex.gg/docs/en/discord/moderation)     | punishments in 7 days                | **Banned**, **Timed out**      | —                               |
| [Protection](https://fivedash.fivex.gg/docs/en/discord/protection)     | blocks in 7 days                     | **Layers**, **Today**          | —                               |

### Recent activity and commands

* **Recent activity**: the latest opened tickets, suggestions, punishments (banned, kicked, timed out, unbanned, timeout lifted) and unlocked IDs. Click an item to open its details.
* **Commands**: the slash commands registered in your Discord server. Commands tagged **Staff** are for the team only. The full list is in [Commands](https://fivedash.fivex.gg/docs/en/discord/commands).

## Every page in the module

The pages are under **Discord** in the sidebar. Each one has its own access level, set in **Settings → Members**.

| Page                                                                   | What it's for                                 | View                                        | Manage                                                  | Configure                                      | Plan |
| ---------------------------------------------------------------------- | --------------------------------------------- | ------------------------------------------- | ------------------------------------------------------- | ---------------------------------------------- | ---- |
| **Overview**                                                           | Numbers and activity from every module        | ✓                                           | —                                                       | —                                              | All  |
| [Bot](https://fivedash.fivex.gg/docs/en/discord/bot)                   | Token, server, profile and look               | The bot's profile and look                  | —                                                       | Connect, change the token and edit the profile | All  |
| [Verification](https://fivedash.fivex.gg/docs/en/discord/verification) | Captcha before opening the server             | Verification activity                       | —                                                       | Roles, messages and panel                      | All  |
| [Welcome](https://fivedash.fivex.gg/docs/en/discord/welcome)           | Message and role for whoever joins            | Joins and leaves                            | —                                                       | Messages, role and DM                          | All  |
| [Tickets](https://fivedash.fivex.gg/docs/en/discord/tickets)           | Support in private channels                   | Tickets, conversations and leaderboard      | Share transcripts                                       | Categories, panel and messages                 | All  |
| [Whitelist](https://fivedash.fivex.gg/docs/en/discord/whitelist)       | Who gets into the city, and the ID unlock     | Whitelists, interviews and approved players | Approve, refuse and generate codes                      | Questions, modes and panels                    | All  |
| [Connect](https://fivedash.fivex.gg/docs/en/discord/connect)           | Live panel with the city's status             | Panel and status                            | —                                                       | Address, buttons and panel                     | All  |
| [Suggestions](https://fivedash.fivex.gg/docs/en/discord/suggestions)   | Votes and discussion for each idea            | Suggestions and discussions                 | Approve and refuse                                      | Channel, votes and messages                    | All  |
| [Moderation](https://fivedash.fivex.gg/docs/en/discord/moderation)     | /ban, /kick and /mute with a record           | Punishment log                              | Unban, lift timeouts and attach evidence                | Commands, roles and messages                   | All  |
| [Summons](https://fivedash.fivex.gg/docs/en/discord/alignment)         | Call a member in to talk, with a deadline     | Summons and numbers                         | Mark attendance, extend deadlines and cancel            | Command, channels, rooms and messages          | Pro  |
| [Forms](https://fivedash.fivex.gg/docs/en/discord/forms)               | Forms with a panel on Discord                 | Forms and answers                           | Approve and refuse answers                              | Create and edit forms, panels and messages     | All  |
| [Creators](https://fivedash.fivex.gg/docs/en/discord/creators)         | Streamer and creator program                  | Creators, posts and applications            | Approve applications, change levels and remove creators | Levels, roles, channels, form and messages     | Pro  |
| [Clock-in](https://fivedash.fivex.gg/docs/en/discord/clock-in)         | The team's clock-in channel                   | Who clocks in and what was deleted          | —                                                       | Channel, rules, who's exempt and notices       | All  |
| [Protection](https://fivedash.fivex.gg/docs/en/discord/protection)     | Anti-link, anti-spam, anti-raid and anti-nuke | Incidents                                   | Undo incidents and pause invites                        | Layers, limits and alerts                      | Pro  |

> Some limits depend on the plan, per bot: forms (Plus 3, Pro 10, Ultra 25), ticket categories (Plus 5, Pro 15, Ultra 25) and how long a ticket transcript can be kept (Plus 30 days, Pro 180 days, Ultra 365 days).

## FAQ

**Do commands work while the bot is Offline?**
Yes. Slash commands keep responding. What pauses are the live events: joins, suggestions, protection and interview rooms, until the bot is online on the Gateway again.

**Can I use the same bot in two FiveDash servers?**
No. Each bot is tied to one FiveDash server. If the token belongs to a bot already connected elsewhere, the panel shows "This bot is already connected to another FiveDash server."

**Someone on the team can't see the Overview. Why?**
They're missing the **View** level on **Overview**. Change it in **Settings → Members**. See [Team and permissions](https://fivedash.fivex.gg/docs/en/dashboard/team-and-permissions).

## Next steps

[Bot](https://fivedash.fivex.gg/docs/en/discord/bot)Create the application, connect the token and set up the profile.
[Commands](https://fivedash.fivex.gg/docs/en/discord/commands)Every slash command and who can use it.
[Verification](https://fivedash.fivex.gg/docs/en/discord/verification)Captcha before opening the server.
[Team and permissions](https://fivedash.fivex.gg/docs/en/dashboard/team-and-permissions)Decide who views, manages and configures each page.
