# server.cfg

> Configuring a MY Multiplayer (MYMP) server with server.cfg: ensure and set directives, network, queue, event rate-limit and sync convars, and content.key encryption.

- **Platform**: MY Multiplayer (MYMP) — Lua 5.4
- **Sections**: Documentation › Server
- **Language**: English
- **URL**: https://docs.mymp.gg/en/docs/server-config

`server.cfg` configures a **MY Multiplayer** (**MYMP**) server instance. Each line is a console command: a convar name followed by its value, `set` to define custom convars or `ensure` to start [resources](https://docs.mymp.gg/en/docs/resources.md). Resources start in the order they appear in the file.

## Example configuration

```ini
players 64
net_port 27015
queue_size 200
server_key mymp_<id>_<secret>

set gamemode freeroam

ensure accounts
ensure [maps]
ensure shop
```

### Startup directives

- `ensure resource`: starts a single resource.
- `ensure [folder]`: starts every resource inside that subfolder, in alphabetical order.
- `set name value`: creates a custom convar that nothing declared. Scripts read it with `getConvar`.

## Core convars

| Convar                                     | Default     | Description                                                                                                                                                                          |
| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `resources_dir`                            | `resources` | Path to the server's resources folder.                                                                                                                                               |
| `players`                                  | `1`         | Maximum player slots on the server.                                                                                                                                                  |
| `net_port`                                 | `27015`     | Game port (UDP). The join queue uses the same port over TCP.                                                                                                                         |
| `http_port`                                | `22005`     | Built-in HTTP port that serves resource files to clients.                                                                                                                            |
| `http_url`                                 |             | External HTTP mirror URL for resource files. When set, `http_port 0` disables the built-in HTTP server.                                                                              |
| `queue_size`                               | `500`       | Maximum queue size when the server is full. `0` turns the queue off.                                                                                                                 |
| `join_rate`                                | `20`        | Rate at which queued players are let into the server.                                                                                                                                |
| `player_triggered_event_interval`          | `1000`      | Time window, in ms, for the per-player remote event rate limit.                                                                                                                      |
| `max_player_triggered_events_per_interval` | `100`       | Maximum [remote events](https://docs.mymp.gg/en/docs/custom-events.md) a player may trigger within the window before firing `onPlayerTriggerEventThreshold`.                                                         |
| `server_key`                               |             | MYMP key that lists the server in the launcher. Its name, languages and banner are set by the studio. Without it, the server is unlisted and anyone joins under the name they bring. |
| `min_launcher_version`                     |             | Refuses connections from launchers older than this version.                                                                                                                          |
| `steam_api_key`                            |             | Steam Web API key used to verify players' `steam` identifiers.                                                                                                                       |
| `password`                                 |             | Password required to join. Never logged or synced.                                                                                                                                   |

### Synchronisation convars

Network synchronisation has its own convars, whose default values are listed in the sample `server.cfg`:

- `sync_rate` and `sync_threads`
- `player_sync_interval`
- `unoccupied_vehicle_sync_interval`
- `ped_sync_interval`
- `far_state_interval`

## Resource encryption (content.key)

The first time the server starts, it generates a `content.key` file beside `server.cfg`. Client resource files are sent encrypted with this key.

- **Security**: never place `content.key` on a public HTTP mirror (`http_url`).
- **Shared cache**: servers running the same resources can share `content.key`; changing it forces every player to download all files again.