> For the complete documentation index, see [llms.txt](https://docs.meteofivem.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.meteofivem.net/packages/meteo-v2-package/configuration-guide.md).

# Configuration Guide

Complete configuration guide for the Meteo V2 package. All settings explained in one place - customize your server name, currency, language, Discord rich presence and more.

All the Meteo V2 package settings are controlled from a single file: `meteo.cfg`. Add it to your server config and customize everything from one place.

{% hint style="info" %}
All settings use `setr` (replicated to clients) or `set` (server-side only) as shown below.
{% endhint %}

***

## ox.cfg

A few ox settings are needed alongside `meteo.cfg`.

```
setr ox:locale "en"
set ox:logger "fivemanage"
set fivemanage:key "YOUR_KEY"
```

| Setting          | Description                                                                                                                                                                                         |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ox:locale`      | Sets the server language for all meteo scripts - see [How to Translate Meteo V2](/packages/meteo-v2-package/how-to/how-to-translate.md) for all supported language codes                            |
| `ox:logger`      | Where all meteo script logs are sent. Every meteo script logs through the ox\_lib logger - see [How to Use Fivemanage for Server Logs](/packages/meteo-v2-package/how-to/how-to-fivemanage-logs.md) |
| `fivemanage:key` | Your Fivemanage **logs** API key, used when `ox:logger` is `fivemanage` - get your key from [fivemanage.com](https://fivemanage.com/)                                                               |

***

## server.cfg

Only change these specific lines in `server.cfg` - everything else should stay as is.

```
sv_licenseKey "YOUR_LICENSE_KEY"
sv_maxclients 8
sets tags "your, server, tags"
sv_hostname "Your Server Name"
sets sv_projectName "Your Server Name"
sets sv_projectDesc "Your server description here"
sets locale "en-US"
set mysql_connection_string "mysql://root@localhost/meteov2?charset=utf8mb4"
```

| Setting                   | Description                                                                                                                                                                                                           |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sv_licenseKey`           | Your server license key from [portal.cfx.re](https://portal.cfx.re/) - required to run the server                                                                                                                     |
| `sv_maxclients`           | Max player slots. Keep at `8` to stream custom clothing for free. If you need more than 8 slots, you need **Argentum** or higher subscription from [portal.cfx.re/subscriptions](https://portal.cfx.re/subscriptions) |
| `sets tags`               | Tags shown on the FiveM server list - helps players find your server                                                                                                                                                  |
| `sv_hostname`             | Server name shown in the server browser                                                                                                                                                                               |
| `sets sv_projectName`     | Project name shown on the FiveM server list                                                                                                                                                                           |
| `sets sv_projectDesc`     | Short description shown on the FiveM server list                                                                                                                                                                      |
| `sets locale`             | Sets the country flag shown on the FiveM server list (e.g. `en-US`, `de-DE`, `fr-FR`, `tr-TR`)                                                                                                                        |
| `mysql_connection_string` | Database connection string. If you are on a **Windows VPS**, no need to change this - follow the installation guide instead.                                                                                          |

{% hint style="warning" %}
Do not modify anything below the `## DO NOT MODIFY BELOW` comment in `server.cfg`. Only change the settings listed above.
{% endhint %}

***

## permissions.cfg

Admin permissions are set in `permissions.cfg`. Use `group.admin` for the server owner and `group.mod` for staff admins.

```
add_principal identifier.license:YOUR_LICENSE_HERE group.admin
add_principal identifier.discord:YOUR_DISCORD_ID group.mod
```

You only need to add the owner here. The rest of your staff can be added in game from the admin menu with roles and permissions you pick. See the full guide: [How to Add Admins](/packages/meteo-v2-package/how-to/how-to-add-admins.md)

***

## meteo.cfg

### Server Settings

These control the core identity and behavior of your server across all meteo scripts.

```
setr meteo:name "Meteo V2 Package"
setr meteo:logo "https://your-logo-url.png"
setr meteo:currency "$"
setr meteo:speedunit "mph"
setr meteo:groupmaxMembers 4
```

| Setting                 | Description                                                                      |
| ----------------------- | -------------------------------------------------------------------------------- |
| `meteo:name`            | Display name shown across all meteo UIs (HUD, phone, tablet, etc.)               |
| `meteo:logo`            | URL to your server logo image - shown in menus and loading screens               |
| `meteo:currency`        | Currency symbol shown in shops, menus and HUDs - use `$`, `€`, `£` or any symbol |
| `meteo:speedunit`       | Speed unit in HUD and police radar - `mph` or `kmh`                              |
| `meteo:groupmaxMembers` | Max players allowed in a group for crime activities and civilian jobs            |

***

### Discord Rich Presence

Controls what players see in Discord when they are on your server. For full setup instructions see the [How to Change Discord RPC](/packages/meteo-v2-package/how-to/how-to-discord-rpc.md) guide.

```
set meteo:discord_enabled true
set meteo:discord_player_count true
set meteo:discord_app_id "your_app_id"
set meteo:discord_icon_large "your_large_icon_key"
set meteo:discord_icon_small "your_small_icon_key"
```

| Setting                      | Description                                                                    |
| ---------------------------- | ------------------------------------------------------------------------------ |
| `meteo:discord_enabled`      | Enable or disable Discord rich presence entirely - `true` or `false`           |
| `meteo:discord_player_count` | Show live player count in Discord status - `true` or `false`                   |
| `meteo:discord_app_id`       | Your Discord application ID - get this from the Discord Developer Portal       |
| `meteo:discord_icon_large`   | Key name of the large icon uploaded to your Discord app's Rich Presence assets |
| `meteo:discord_icon_small`   | Key name of the small icon uploaded to your Discord app's Rich Presence assets |

{% content-ref url="/pages/wHUAFImOzXGiN8hkQizs" %}
[How to Change Discord RPC](/packages/meteo-v2-package/how-to/how-to-discord-rpc.md)
{% endcontent-ref %}

***

### Meteo Phone - API Keys

The phone uses a few external API keys. Not all of them are required - it depends on which features you want to use. Set them in `meteo.cfg`:

```
set meteo:phone_fivemanage_token "YOUR_TOKEN"
set meteo:phone_cf_turn_token_id "YOUR_TOKEN_ID"
set meteo:phone_cf_turn_api_token "YOUR_API_TOKEN"
```

| Setting                         | Required?                | Used For                                                          | Where to Get It                                                                                                                                                           |
| ------------------------------- | ------------------------ | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `meteo:phone_fivemanage_token`  | Recommended              | Gallery and camera image hosting                                  | Go to [fivemanage.com](https://fivemanage.com/), create an account and generate an **image API key** (NOT the log API key - there are two types, make sure to pick image) |
| `meteo:phone_cf_turn_token_id`  | Required for video calls | Video calling via WebRTC. Without this, video calls will not work | Follow the [Cloudflare TURN setup guide](/packages/meteo-v2-package/how-to/how-to-cloudflare-turn.md) and copy the Token ID                                               |
| `meteo:phone_cf_turn_api_token` | Required for video calls | Video calling via WebRTC. Without this, video calls will not work | Same TURN token from the [setup guide](/packages/meteo-v2-package/how-to/how-to-cloudflare-turn.md) - copy the API Token                                                  |

{% hint style="info" %}
Need more help with any of these? Contact us on our [Discord](https://discord.meteofivem.net) and we will help you set it up.
{% endhint %}

***

### Meteo MDT - API Keys

The MDT needs its own Fivemanage image key for photo uploads. Set it in `meteo.cfg`:

```
set meteo:mdt_fivemanage_token "YOUR_KEY_HERE"
```

| Setting                      | Required?   | Used For                                                                                                                                                 | Where to Get It                                                                                                                                                           |
| ---------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `meteo:mdt_fivemanage_token` | Recommended | Every photo taken with the MDT camera - person, vehicle, report and court photos plus the photo reel. Without it, photo uploads in the MDT will not work | Go to [fivemanage.com](https://fivemanage.com/), create an account and generate an **image API key** (NOT the log API key - there are two types, make sure to pick image) |

{% hint style="info" %}
This is a separate setting from `meteo:phone_fivemanage_token`, so you can give the MDT its own image key if you want its uploads tracked separately.
{% endhint %}

***

### Meteo Crime

Crypto and crime tablet settings shared across all the crime scripts and the crime tablet.

```
setr meteo:cryptoname "METEO"
setr meteo:cryptosymbol "MTC"
setr meteo:walletprefix "MTEO-"
setr meteo:terminalprompt "~/meteo/"
```

| Setting                | Description                                                 |
| ---------------------- | ----------------------------------------------------------- |
| `meteo:cryptoname`     | Full coin name                                              |
| `meteo:cryptosymbol`   | Short ticker shown in UIs, rewards and logs                 |
| `meteo:walletprefix`   | Wallet address prefix, e.g. `MTEO-XXXX-XXXX` (max 11 chars) |
| `meteo:terminalprompt` | Prompt shown in the crime tablet terminal                   |

***

### Meteo Chat

The welcome message and rotating auto-messages shown in chat.

```
setr meteo:chat_welcome "Welcome to the Meteo Server! Press T to open chat and type / to see available commands."
setr meteo:chat_automessages "Don't Forget to join Meteo Discord!|Don't break the rules!|Have fun!"
```

| Setting                   | Description                                                 |
| ------------------------- | ----------------------------------------------------------- |
| `meteo:chat_welcome`      | Message shown to a player when they join the server         |
| `meteo:chat_automessages` | Rotating auto-messages - separate each one with a pipe `\|` |
