# How to Configure Your The Isle Evrima Server (Game.ini) (/docs/the-isle-evrima/server-config)







import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
import { Step, Steps } from 'fumadocs-ui/components/steps';
import { Files, Folder, File } from 'fumadocs-ui/components/files';

The Isle Evrima uses Unreal Engine INI files for all configuration. The server must run **once** to generate the config files before you can edit them.

Server File Structure [#server-file-structure]

<Files>
  <Folder name="TheIsle" defaultOpen>
    <Folder name="Saved" defaultOpen>
      <Folder name="Config" defaultOpen>
        <Folder name="LinuxServer" defaultOpen>
          <File name="Game.ini" />

          <File name="Engine.ini" />
        </Folder>
      </Folder>

      <Folder name="Logs" />

      <Folder name="PlayerData" />
    </Folder>
  </Folder>
</Files>

| File         | Purpose                            |
| ------------ | ---------------------------------- |
| `Game.ini`   | All gameplay and server settings   |
| `Engine.ini` | **Required** EOS credentials block |

> **Critical:** Evrima requires the `evrima` Steam beta branch — App ID `412680` with `-beta evrima`. The Legacy branch is a completely separate game.

How to Edit Game.ini [#how-to-edit-gameini]

<Steps>
  <Step>
    Stop the server [#stop-the-server]

    In the [XGamingServer Panel](https://panel.xgamingserver.com), go to **Console** and stop your server.
  </Step>

  <Step>
    Open Game.ini [#open-gameini]

    Click **Files** in the sidebar. Navigate to `TheIsle/Saved/Config/LinuxServer/Game.ini`.

        <img alt="Game.ini open in the panel editor" src={__img0} placeholder="blur" />
  </Step>

  <Step>
    Edit and save [#edit-and-save]

    Make your changes (maintain valid INI syntax), click **Save Content**, then start from **Console**.
  </Step>
</Steps>

> Many of these settings are also exposed as **Startup** variables in the panel sidebar — use that for quick changes without editing the file.

<img alt="XGS panel Startup tab for The Isle Evrima" src={__img1} placeholder="blur" />

The panel exposes the most-used Game.ini settings as one-click toggles: **SERVER NAME**, **PLAYER COUNT**, **ALLOW REPLAY**, **HUMANS**, **ENABLE DYNAMIC WEATHER**, **RCON / RCON PORT / RCON PASSWORD**, **ENABLE QUEUE / QUEUE PORT**, **DISCORD**, **SERVER PASSWORD**, **AUTO UPDATE**.

Game.ini Reference [#gameini-reference]

Most settings live under `[/Script/TheIsle.TIGameSession]`:

```ini
[/Script/TheIsle.TIGameSession]
ServerName="My Evrima Server"
MaxPlayerCount=100
MapName=Gateway
```

> **Important:** `AdminsSteamIDs`, `WhitelistIDs`, and `VIPs` belong to a **separate section** — `[/Script/TheIsle.TIGameStateBase]`. If you put them in `TIGameSession` they will be silently ignored.

```ini
[/Script/TheIsle.TIGameStateBase]
AdminsSteamIDs=76561198012345678
WhitelistIDs=76561198000000001
VIPs=76561198099999999
```

<Tabs items={['Server Identity', 'Access Control', 'Gameplay', 'AI & World', 'Day/Night & Weather', 'Migrations']}>
  <Tab value="Server Identity">
    | Setting          | Default   | Description                                         |
    | ---------------- | --------- | --------------------------------------------------- |
    | `ServerName`     | `""`      | Name shown in the in-game server browser            |
    | `MaxPlayerCount` | `100`     | Maximum simultaneous players                        |
    | `MapName`        | `Gateway` | Active map (currently the only official Evrima map) |
    | `Discord`        | `""`      | Discord invite URL shown to players                 |
  </Tab>

  <Tab value="Access Control">
    | Setting            | Default             | Description                                                              |
    | ------------------ | ------------------- | ------------------------------------------------------------------------ |
    | `bServerPassword`  | `false`             | Enable join password                                                     |
    | `ServerPassword`   | `""`                | Join password                                                            |
    | `bServerWhitelist` | `false`             | Whitelist mode — only listed Steam IDs can join                          |
    | `WhitelistIDs`     | —                   | One SteamID64 per line. See [Whitelist](/docs/the-isle-evrima/whitelist) |
    | `VIPs`             | —                   | Steam IDs that bypass the join queue when full                           |
    | `AdminsSteamIDs`   | —                   | One SteamID64 per line. Required for admin/RCON recognition              |
    | `bQueueEnabled`    | `true`              | Enable join queue when server is full                                    |
    | `QueuePort`        | (auto, e.g. `2466`) | TCP port for queue connections — XGamingServer assigns this per instance |

    RCON [#rcon]

    | Setting        | Default             | Description                                             |
    | -------------- | ------------------- | ------------------------------------------------------- |
    | `bRconEnabled` | `false`             | Enable RCON. **Required** for admin actions on Evrima   |
    | `RconPassword` | `""`                | RCON password                                           |
    | `RconPort`     | (auto, e.g. `2465`) | RCON TCP port — XGamingServer assigns this per instance |

    > Evrima uses a **custom RCON protocol** — standard Source RCON clients won't work. See [RCON Setup](/docs/the-isle-evrima/rcon-setup).
  </Tab>

  <Tab value="Gameplay">
    | Setting                 | Default | Description                                                                      |
    | ----------------------- | ------- | -------------------------------------------------------------------------------- |
    | `GrowthMultiplier`      | `1`     | Dinosaur growth speed multiplier. **Keep below 20** — higher values break growth |
    | `CorpseDecayMultiplier` | `1`     | How fast corpses decay                                                           |
    | `bEnableHumans`         | `false` | Enable human characters (disabled by default)                                    |
    | `bEnableDiets`          | `true`  | Diet system (carnivore/herbivore food preferences)                               |
    | `bEnableMutations`      | `true`  | Mutation system                                                                  |
    | `bAllowReplay`          | `false` | Let players record server-side replays                                           |

    Playable Species [#playable-species]

    ```ini
    AllowedClasses=Carnotaurus
    AllowedClasses=Stegosaurus
    AllowedClasses=Tyrannosaurus
    AllowedClasses=Pteranodon
    ```

    Remove a line to block that species. Leave the entire section without `AllowedClasses` lines to allow all. See [Playable Dinosaurs](/docs/the-isle-evrima/playable-dinosaurs).
  </Tab>

  <Tab value="AI & World">
    | Setting                | Default | Description                                    |
    | ---------------------- | ------- | ---------------------------------------------- |
    | `bSpawnAI`             | `true`  | Spawn AI critters (carnivore food source)      |
    | `AIDensity`            | `1`     | AI spawn density multiplier                    |
    | `AISpawnInterval`      | `40`    | Seconds between AI spawn checks                |
    | `DisallowedAIClasses`  | —       | Block specific AI species from spawning        |
    | `bSpawnPlants`         | `true`  | Spawn plants (herbivore food source)           |
    | `PlantSpawnMultiplier` | `1`     | Plant density multiplier                       |
    | `bUseRegionSpawning`   | `false` | Restrict player spawns to specific map regions |
  </Tab>

  <Tab value="Day/Night & Weather">
    | Setting                       | Default | Description                                           |
    | ----------------------------- | ------- | ----------------------------------------------------- |
    | `ServerDayLengthMinutes`      | `45`    | Daytime duration in minutes                           |
    | `ServerNightLengthMinutes`    | `20`    | Nighttime duration in minutes (intentionally shorter) |
    | `bServerDynamicWeather`       | `true`  | Enable dynamic weather changes                        |
    | `MinWeatherVariationInterval` | `600`   | Min seconds between weather changes                   |
    | `MaxWeatherVariationInterval` | `900`   | Max seconds between weather changes                   |
  </Tab>

  <Tab value="Migrations">
    These are unique to Evrima — herbivore AI herds migrate across the map and patrol zones activate carnivore AI areas.

    | Setting                | Default | Description                         |
    | ---------------------- | ------- | ----------------------------------- |
    | `bEnableMigration`     | `true`  | Enable species migration zones      |
    | `MaxMigrationTime`     | `5400`  | Migration zone duration (1.5 hours) |
    | `bEnableMassMigration` | `true`  | Enable mass migration events        |
    | `MassMigrationTime`    | `43200` | Mass migration interval (12 hours)  |
    | `bEnablePatrolZones`   | `true`  | Enable carnivore AI patrol zones    |
  </Tab>
</Tabs>

Engine.ini (REQUIRED) [#engineini-required]

Evrima requires Epic Online Services (EOS) credentials in `Engine.ini` for the server to register with the matchmaker. Without this, your server won't appear in the in-game browser.

```ini
[EpicOnlineServices]
DedicatedServerClientId=xyza7891gk5PRo3J7G9puCJGFJjmEguW
DedicatedServerClientSecret=pKWl6t5i9NJK8gTpVlAxzENZ65P8hYzodV8Dqe5Rlc8
```

These are **public, shared credentials** — every Evrima server uses the same values. They're pre-configured on XGamingServer, but if you've reset your config files you'll need to add them back manually.

Ports [#ports]

XGamingServer allocates all ports automatically per server instance — you don't need to forward anything. The exact numbers vary, but the protocols and purposes are:

| Protocol | Purpose                                                                            |
| -------- | ---------------------------------------------------------------------------------- |
| UDP      | Game traffic                                                                       |
| UDP      | Steam query / beacon                                                               |
| TCP      | RCON (custom Evrima protocol — see [RCON Setup](/docs/the-isle-evrima/rcon-setup)) |
| TCP      | Join queue (when enabled)                                                          |

To see the exact port numbers for your server, check the **Startup** tab of the panel.

Common Issues [#common-issues]

| Problem                          | Fix                                                                                                      |
| -------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Server doesn't appear in browser | Verify Engine.ini has the EOS credentials block. Wait 2–5 minutes after start                            |
| RCON connection refused          | Confirm `bRconEnabled=true`, password is set, and TCP port 8888 is open. Use a custom Evrima RCON client |
| Players can't join               | Check whether `bServerWhitelist=true` and you forgot to add their SteamID                                |
| Config changes don't apply       | Always **stop** the server before editing — Evrima overwrites configs on shutdown                        |
| Growth rate broken               | `GrowthMultiplier` above \~20 breaks the growth system. Stay below 20                                    |

Related Guides [#related-guides]

* [Getting Started](/docs/the-isle-evrima/getting-started)
* [Admin Setup](/docs/the-isle-evrima/admin-setup)
* [RCON Setup](/docs/the-isle-evrima/rcon-setup)
* [Growth Speed](/docs/the-isle-evrima/growth-speed)
* [AI Settings](/docs/the-isle-evrima/ai-settings)
* [Whitelist](/docs/the-isle-evrima/whitelist)
* [Playable Dinosaurs](/docs/the-isle-evrima/playable-dinosaurs)