# Fika Configuration Reference (fika.jsonc) (/docs/escape-from-tarkov/fika-config-reference)



import { Step, Steps } from 'fumadocs-ui/components/steps';

`fika.jsonc` is the main configuration file for Fika co-op behaviour — friendly fire, the revive system, shared quests, item sending, required client mods, and more. This page explains every field worth changing, and — importantly — which fields the panel **manages for you** (editing those by hand does nothing, because they're rewritten on every boot).

> **Want to skip the hand-editing?** Build your file with the free [Fika config generator](https://xgamingserver.com/tools/escape-from-tarkov/fika-config-generator) — presets, the revive system and a "changed from defaults" list.

Where It Lives [#where-it-lives]

```
SPT/user/mods/fika-server/assets/configs/fika.jsonc
```

It's generated on the server's first boot. Edit it in the [XGamingServer panel](https://panel.xgamingserver.com) **File Manager** with the server **stopped**, then start the server to apply.

<Callout type="warn">
  Some fields are overwritten automatically every time the server starts (see below). Set those through the **Startup** tab instead — editing them in the file has no effect.
</Callout>

Panel-Managed Fields — Don't Edit These [#panel-managed-fields--dont-edit-these]

On every boot, your server sets these for you so networking and headless just work. Change them via the **Startup** tab, not the file:

| Field                                  | Managed value       | Set it via                                  |
| -------------------------------------- | ------------------- | ------------------------------------------- |
| `server.SPT.http.ip` / `backendIp`     | `0.0.0.0`           | (automatic)                                 |
| `server.SPT.http.port` / `backendPort` | your server port    | (automatic)                                 |
| `natPunchServer.enable`                | `true`              | (automatic)                                 |
| `natPunchServer.port`                  | your NAT punch port | **Fika NAT Punch Port** startup variable    |
| `headless.profiles.amount`             | `0`                 | **Fika Headless Profiles** startup variable |

Also **do not clear `server.apiKey`** — it powers the [Fika Admin](/docs/escape-from-tarkov/manage-your-server) tab in the panel.

Co-op Gameplay (client section) [#co-op-gameplay-client-section]

These control how raids play for everyone. Defaults shown are the official Fika defaults.

| Field                           | Default | What it does                                                               |
| ------------------------------- | ------- | -------------------------------------------------------------------------- |
| `client.useBtr`                 | `true`  | Whether the BTR spawns.                                                    |
| `client.friendlyFire`           | `true`  | Players can damage each other in raid.                                     |
| `client.dynamicVExfils`         | `false` | Scale vehicle extracts with the number of players.                         |
| `client.allowFreeCam`           | `false` | Let living players use free camera.                                        |
| `client.allowSpectateFreeCam`   | `false` | When dead, allow free movement instead of forcing you to spectate players. |
| `client.allowSpectateBots`      | `true`  | Allow spectating bots in free cam.                                         |
| `client.blacklistedItems`       | `[]`    | Item IDs that **cannot be sent** to other players.                         |
| `client.forceSaveOnDeath`       | `false` | Force-save inventory on death (stops alt-F4 to dodge a death).             |
| `client.useInertia`             | `true`  | Movement inertia (live-Tarkov feel).                                       |
| `client.sharedQuestProgression` | `false` | Share quest progress across the group — also affects shared XP.            |
| `client.canEditRaidSettings`    | `true`  | Let players change raid settings before starting.                          |
| `client.enableTransits`         | `true`  | Allow map-to-map transits.                                                 |
| `client.anyoneCanStartRaid`     | `false` | Let any member click START RAID, not just the host.                        |
| `client.allowNamePlates`        | `true`  | Let players enable teammate name plates.                                   |
| `client.randomLabyrinthSpawns`  | `true`  | Randomise spawn points in The Labyrinth.                                   |
| `client.pmcFoundInRaid`         | `true`  | Make all AI PMC gear Found-in-Raid.                                        |
| `client.instantLoad`            | `false` | Refill magazines **instantly** in raid.                                    |
| `client.fastLoad`               | `true`  | Refill magazines **faster** in raid (ignored if `instantLoad` is on).      |

Required & optional client mods [#required--optional-client-mods]

```jsonc
"client": {
  "mods": {
    "required": [],   // mods every player MUST have to join
    "optional": []    // mods allowed but not required
  }
}
```

This is how "required client mods" are enforced — see [Server vs Client Mods](/docs/escape-from-tarkov/server-vs-client-mods). Prefer the panel's **Client Mod Sync** (in the SPT Mods tab) so players are kept in step automatically — see [Install Mods](/docs/escape-from-tarkov/install-mods).

Revive system (client.reviveConfig) [#revive-system-clientreviveconfig]

Off by default. Turn it on to let downed players be revived instead of instantly dying.

| Field           | Default | What it does                                           |
| --------------- | ------- | ------------------------------------------------------ |
| `enabled`       | `false` | Enable the revive/knockdown system.                    |
| `maxRevives`    | `3`     | Revives per player (`0` = infinite, max `10`).         |
| `bleedoutTime`  | `30`    | Seconds a downed player has before dying (`10`–`600`). |
| `reviveTime`    | `3`     | Seconds it takes to revive someone (`3`–`30`).         |
| `headshotKills` | `false` | Headshots always kill (no knockdown).                  |
| `grenadesKills` | `false` | Grenades always kill.                                  |
| `allowLooting`  | `false` | Allow looting a downed player.                         |

Server Behaviour (server section) [#server-behaviour-server-section]

| Field                            | Default | What it does                                                                                                   |
| -------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------- |
| `server.allowItemSending`        | `true`  | Let players send items to each other (also used by [Fika Admin](/docs/escape-from-tarkov/manage-your-server)). |
| `server.itemSendingStorageTime`  | `7`     | Days before sent-item mail expires.                                                                            |
| `server.sentItemsLoseFIR`        | `true`  | Sent items lose Found-in-Raid status.                                                                          |
| `server.launcherListAllProfiles` | `true`  | List all profiles in the launcher.                                                                             |
| `server.sessionTimeout`          | `5`     | Minutes without a response before a player's raid is considered lost.                                          |
| `server.showDevProfile`          | `true`  | Show the developer profile type.                                                                               |
| `server.showNonStandardProfile`  | `true`  | Show non-standard EFT profile types.                                                                           |
| `server.adminIds`                | `[]`    | Profile IDs allowed to use the in-game "Mr Fika" admin bot commands.                                           |
| `server.SPT.disableSPTChatBots`  | `false` | Disable the SPT chat bots.                                                                                     |

Discord webhook (server.webhook) [#discord-webhook-serverwebhook]

```jsonc
"webhook": {
  "enabled": false,
  "name": "Fika Server",
  "avatarUrl": "",  // optional image for the bot
  "url": ""         // paste a Discord webhook URL and set enabled: true
}
```

Posts server events to a Discord channel.

Headless (headless section) [#headless-headless-section]

Beyond the panel-managed `profiles.amount`, these tune headless behaviour:

| Field                                | Default | What it does                                                      |
| ------------------------------------ | ------- | ----------------------------------------------------------------- |
| `headless.profiles.aliases`          | `{}`    | Map of headless profile ID → display name.                        |
| `headless.scripts.generate`          | `true`  | Generate headless launch scripts.                                 |
| `headless.setLevelToAverageOfLobby`  | `true`  | Use the lobby's average level when spawning bots on the headless. |
| `headless.restartAfterAmountOfRaids` | `1`     | Restart the headless client after this many raids (`0` disables). |

See [Headless Client](/docs/escape-from-tarkov/headless-client).

Launcher Background (background section) [#launcher-background-background-section]

| Field               | Default | What it does                           |
| ------------------- | ------- | -------------------------------------- |
| `background.enable` | `true`  | Use Fika's custom launcher background. |

<Callout type="info">
  Defaults on this page are verified against the official [Project Fika configuration wiki](https://wiki.project-fika.com/fika-configuration/server). Fika updates can add new keys — your server's generated `fika.jsonc` is always the source of truth for your version.
</Callout>

JSONC Syntax [#jsonc-syntax]

`fika.jsonc` allows `//` comments, but it's still structured JSON — a stray comma or missing bracket will stop the server from starting. Back the file up before editing, and if the server won't boot after a change, revert it (see [Troubleshooting](/docs/escape-from-tarkov/troubleshooting)).

Related [#related]

* [Configure Your Server](/docs/escape-from-tarkov/configure-your-server)
* [Manage Your Server (Fika Admin)](/docs/escape-from-tarkov/manage-your-server)
* [Play with Friends](/docs/escape-from-tarkov/play-with-friends)