# 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).

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.

| Field                                    | Default           | What it does                                       |
| ---------------------------------------- | ----------------- | -------------------------------------------------- |
| `client.friendlyFire`                    | `true`            | Players can damage each other in raid.             |
| `client.useBtr`                          | `true`            | Enable the BTR shuttle.                            |
| `client.useInertia`                      | `true`            | Movement inertia (live-Tarkov feel).               |
| `client.sharedQuestProgression`          | `false`           | Share quest progress across the group.             |
| `client.canEditRaidSettings`             | `true`            | Let the host change raid settings before starting. |
| `client.enableTransits`                  | `true`            | Allow map-to-map transits.                         |
| `client.anyoneCanStartRaid`              | `false`           | Let any member start the raid, not just the host.  |
| `client.pmcFoundInRaid`                  | `false`           | Mark items brought in by PMCs as Found-in-Raid.    |
| `client.dynamicVExfils`                  | `false`           | Dynamic vehicle extracts.                          |
| `client.allowFreeCam`                    | `false`           | Allow free camera (spectating).                    |
| `client.allowNamePlates`                 | `true`            | Show teammate name plates.                         |
| `client.forceSaveOnDeath`                | `false`           | Save on death (discourages alt-F4 to dodge death). |
| `client.instantLoad` / `client.fastLoad` | `false` / `false` | Faster raid loading.                               |
| `client.blacklistedItems`                | `[]`              | Item tpl IDs banned from raids.                    |

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

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

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`    | `0`     | Revives per player (`0` = infinite).        |
| `bleedoutTime`  | `60`    | Seconds a downed player has before dying.   |
| `reviveTime`    | `5`     | Seconds it takes to revive someone.         |
| `headshotKills` | `false` | Headshots kill outright (no knockdown).     |
| `grenadesKills` | `false` | Grenades kill outright.                     |
| `allowLooting`  | `false` | Loot a downed player before they bleed out. |

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

| Field                            | Default | What it does                                                                                        |
| -------------------------------- | ------- | --------------------------------------------------------------------------------------------------- |
| `server.allowItemSending`        | `true`  | Allow the item-sending feature (used by [Fika Admin](/docs/escape-from-tarkov/manage-your-server)). |
| `server.itemSendingStorageTime`  | `7`     | Days a sent item waits in the mailbox.                                                              |
| `server.sentItemsLoseFIR`        | `true`  | Sent items lose Found-in-Raid status.                                                               |
| `server.launcherListAllProfiles` | `true`  | Show all profiles in the launcher list.                                                             |
| `server.sessionTimeout`          | `5`     | Minutes before an idle session times out.                                                           |
| `server.adminIds`                | `[]`    | Profile IDs treated as Fika admins (for the in-game admin bot).                                     |
| `server.SPT.disableSPTChatBots`  | `false` | Disable the SPT trader/chat bots.                                                                   |

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

```jsonc
"webhook": {
  "enabled": false,
  "name": "Fika Server",
  "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.setLevelToAverageOfLobby`  | `true`  | Match the headless character's level to the lobby average. |
| `headless.restartAfterAmountOfRaids` | `1`     | Restart the headless client after this many raids.         |

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

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)
