> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r5r.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Restricted Servers

> Configure server access restrictions based on stats and whitelists.

# Restricted Server Settings

Configure restricted access in the [Control Panel Config tab](https://r5r.dev/cp/?tab=config) (or `r5rdev_config.json`). Playlist-based settings are deprecated and ignored.

<Info>
  If cc\_administration is enabled in `playlists_r5_patch.txt`, using command `cc restricted [1/0/true/false]` can enable and disable restricted status in realtime
</Info>

## Private Settings (Config Tab)

| Key                            | Type   | Description                                                |
| :----------------------------- | :----- | :--------------------------------------------------------- |
| `RESTRICTED_SERVER`            | Bool   | Enable restricted/private server mode.                     |
| `RESTRICTED_WHITELIST_ONLY`    | Bool   | Only allow whitelisted players to join.                    |
| `RESTRICTED_PLAYER_WHITELIST`  | String | Comma-separated player OIDs allowed to join.               |
| `RESTRICTED_JOIN_MESSAGE`      | String | Message shown when a player meets requirements.            |
| `RESTRICTED_WHITELIST_MESSAGE` | String | Message shown to whitelisted players.                      |
| `RESTRICTED_ADMIN_MESSAGE`     | String | Message shown to admins when joining.                      |
| `RESTRICTED_GAMESPLAYED`       | Int    | Minimum games played (requires `USE_GLOBAL_STATS`).        |
| `RESTRICTED_PLAYTIME`          | Int    | Minimum playtime in seconds (requires `USE_GLOBAL_STATS`). |
| `RESTRICTED_RANK`              | Int    | Minimum rank/score (requires `USE_GLOBAL_STATS`).          |
| `RESTRICTED_KILLS`             | Int    | Minimum kills (requires `USE_GLOBAL_STATS`).               |
| `RESTRICTED_KD`                | Float  | Minimum K/D ratio (requires `USE_GLOBAL_STATS`).           |
| `RESTRICTED_KICK_LOG`          | Bool   | Log kicks for restricted checks.                           |

## How to Configure

1. Open the [Control Panel Config tab](https://r5r.dev/cp/?tab=config).
2. Set the **Private** section fields above, then download/apply the updated `r5rdev_config.json`.
3. Ensure `USE_GLOBAL_STATS` is enabled if you rely on stat gates.

<Warning>
  `playlists_r5_patch.txt` can no longer enable restricted servers. Use the Config tab instead.
</Warning>