# Palworld Server Configuration Guide (/docs/palworld/server-settings)



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

All Palworld server settings live in a single file: `PalWorldSettings.ini`. Every setting is on **one line** inside the `OptionSettings=(...)` block.

File Location [#file-location]

<Files>
  <Folder name="Pal" defaultOpen>
    <Folder name="Saved" defaultOpen>
      <Folder name="Config" defaultOpen>
        <Folder name="LinuxServer" defaultOpen>
          <File name="PalWorldSettings.ini" />
        </Folder>
      </Folder>
    </Folder>
  </Folder>
</Files>

On Windows servers, replace `LinuxServer` with `WindowsServer`.

Editing the Settings [#editing-the-settings]

<Steps>
  <Step>
    Log in to the [XGamingServer Panel](https://panel.xgamingserver.com) and stop your server from **Console**.
  </Step>

  <Step>
    Click **Files** in the sidebar and navigate to `Pal/Saved/Config/LinuxServer/`.
  </Step>

  <Step>
    Open `PalWorldSettings.ini`. If the file is empty or missing, copy `DefaultPalWorldSettings.ini` from the server root and rename it.
  </Step>

  <Step>
    Edit the values inside the `OptionSettings=(...)` line, save, and start the server.
  </Step>
</Steps>

Format [#format]

```ini
[/Script/Pal.PalGameWorldSettings]
OptionSettings=(ServerName="My Server",AdminPassword="secret",ServerPlayerMaxNum=32,ExpRate=1.000000,...)
```

> ⚠️ **Critical:** All settings must be on a **single line** inside the parentheses. Line breaks will break the entire config. Use the panel's text editor carefully.

Server Identity [#server-identity]

| Setting                  | Default                                        | Description                                            |
| ------------------------ | ---------------------------------------------- | ------------------------------------------------------ |
| `ServerName`             | `"Default Palworld Server"`                    | Name in the server browser                             |
| `ServerDescription`      | `""`                                           | Server description                                     |
| `ServerPassword`         | `""`                                           | Join password (blank = public)                         |
| `AdminPassword`          | `""`                                           | Admin & RCON password (min 8 characters, alphanumeric) |
| `ServerPlayerMaxNum`     | `32`                                           | Maximum concurrent players                             |
| `PublicIP`               | `""`                                           | Public IP for community server listing                 |
| `PublicPort`             | `8211`                                         | Public game port                                       |
| `Region`                 | `""`                                           | Server region tag                                      |
| `bUseAuth`               | `True`                                         | Enable Steam authentication                            |
| `bShowPlayerList`        | `False`                                        | Show the player list on the ESC menu                   |
| `bAllowClientMod`        | `True`                                         | Allow players running mods to join                     |
| `bIsShowJoinLeftMessage` | `True`                                         | Announce joins/leaves in chat                          |
| `ChatPostLimitPerMinute` | `30`                                           | Max chat messages per player per minute (anti-spam)    |
| `BanListURL`             | `https://api.palworldgame.com/api/banlist.txt` | Ban list source URL                                    |
| `LogFormatType`          | `Text`                                         | Server log format (`Text` or `Json`)                   |

Gameplay Rates [#gameplay-rates]

All default to `1.000000` — higher = more/faster, lower = less/slower.

| Setting                            | Description                                 |
| ---------------------------------- | ------------------------------------------- |
| `ExpRate`                          | XP gain multiplier                          |
| `PalCaptureRate`                   | Pal capture success rate                    |
| `PalSpawnNumRate`                  | Wild Pal spawn density                      |
| `WorkSpeedRate`                    | Crafting and work speed                     |
| `CollectionDropRate`               | Resource gathering yield                    |
| `CollectionObjectHpRate`           | Gatherable HP (higher = more hits needed)   |
| `CollectionObjectRespawnSpeedRate` | Resource respawn speed                      |
| `EnemyDropItemRate`                | Enemy loot drop rate                        |
| `ItemWeightRate`                   | Item weight multiplier (lower = carry more) |
| `EquipmentDurabilityDamageRate`    | Gear degradation speed                      |

Day/Night [#daynight]

| Setting              | Default | Description                             |
| -------------------- | ------- | --------------------------------------- |
| `DayTimeSpeedRate`   | `1.0`   | Daytime speed (lower = longer days)     |
| `NightTimeSpeedRate` | `1.0`   | Nighttime speed (lower = longer nights) |

Death & Respawn [#death--respawn]

| Setting                                | Default | Description                                                                    |
| -------------------------------------- | ------- | ------------------------------------------------------------------------------ |
| `DeathPenalty`                         | `All`   | `None`, `Item`, `ItemAndEquipment`, `All`                                      |
| `bCanPickupOtherGuildDeathPenaltyDrop` | `False` | Allow looting other guild death drops                                          |
| `BlockRespawnTime`                     | `5.0`   | Base respawn cooldown in seconds                                               |
| `RespawnPenaltyDurationThreshold`      | `0.0`   | Seconds after respawn within which dying again applies the penalty (`0` = off) |
| `RespawnPenaltyTimeScale`              | `2.0`   | Cooldown multiplier when dying inside the threshold                            |

See [Respawn Penalty & Death Cooldown](/docs/palworld/respawn-penalty) for details.

PvP [#pvp]

| Setting                                           | Default          | Description                                         |
| ------------------------------------------------- | ---------------- | --------------------------------------------------- |
| `bIsPvP`                                          | `False`          | Enable PvP mode                                     |
| `bEnablePlayerToPlayerDamage`                     | `False`          | Allow player-to-player damage                       |
| `bEnableFriendlyFire`                             | `False`          | Friendly fire within guilds                         |
| `bEnableDefenseOtherGuildPlayer`                  | `False`          | Defend against other guild attacks                  |
| `bAdditionalDropItemWhenPlayerKillingInPvPMode`   | `False`          | Drop a special item when a player is killed in PvP  |
| `AdditionalDropItemWhenPlayerKillingInPvPMode`    | `PlayerDropItem` | Item ID dropped on a PvP kill (when enabled above)  |
| `AdditionalDropItemNumWhenPlayerKillingInPvPMode` | `1`              | Quantity of the item dropped on a PvP kill          |
| `bDisplayPvPItemNumOnWorldMap_Player`             | `False`          | Show dropped-item markers for players on the map    |
| `bDisplayPvPItemNumOnWorldMap_BaseCamp`           | `False`          | Show dropped-item markers for base camps on the map |

Base & Building [#base--building]

| Setting                              | Default | Description                             |
| ------------------------------------ | ------- | --------------------------------------- |
| `BaseCampMaxNum`                     | `128`   | Total base camps server-wide            |
| `BaseCampMaxNumInGuild`              | `4`     | Max bases per guild (max 10)            |
| `BaseCampWorkerMaxNum`               | `15`    | Pal workers per base (max 50)           |
| `MaxBuildingLimitNum`                | `0`     | Per-player building cap (0 = unlimited) |
| `BuildObjectHpRate`                  | `1.0`   | Structure HP multiplier                 |
| `BuildObjectDamageRate`              | `1.0`   | Damage to structures                    |
| `BuildObjectDeteriorationDamageRate` | `1.0`   | Structure decay rate (`0` = no decay)   |
| `bBuildAreaLimit`                    | `False` | Restrict building to base-camp areas    |

Guild [#guild]

| Setting                             | Default | Description                                           |
| ----------------------------------- | ------- | ----------------------------------------------------- |
| `GuildPlayerMaxNum`                 | `20`    | Max members per guild                                 |
| `bAutoResetGuildNoOnlinePlayers`    | `False` | Auto-delete inactive guild bases                      |
| `AutoResetGuildTimeNoOnlinePlayers` | `72.0`  | Hours offline before auto-reset                       |
| `GuildRejoinCooldownMinutes`        | `0`     | Cooldown before a player can rejoin a guild (minutes) |

Combat & Health [#combat--health]

| Setting                         | Default | Description                    |
| ------------------------------- | ------- | ------------------------------ |
| `PlayerDamageRateAttack`        | `1.0`   | Player damage dealt            |
| `PlayerDamageRateDefense`       | `1.0`   | Player damage taken            |
| `PalDamageRateAttack`           | `1.0`   | Pal damage dealt               |
| `PalDamageRateDefense`          | `1.0`   | Pal damage taken               |
| `PlayerAutoHPRegeneRate`        | `1.0`   | Player HP regen                |
| `PlayerStomachDecreaceRate`     | `1.0`   | Player hunger drain            |
| `PlayerStaminaDecreaceRate`     | `1.0`   | Player stamina drain           |
| `PalStomachDecreaceRate`        | `1.0`   | Pal hunger drain               |
| `PalStaminaDecreaceRate`        | `1.0`   | Pal stamina drain              |
| `PlayerAutoHpRegeneRateInSleep` | `1.0`   | Player HP regen while sleeping |
| `PalAutoHPRegeneRate`           | `1.0`   | Pal HP regen                   |
| `PalAutoHpRegeneRateInSleep`    | `1.0`   | Pal HP regen in Pal Box        |

Player Stat Enhancement (Feybreak) [#player-stat-enhancement-feybreak]

Toggle whether players can spend status points on each stat. All default to `True` — see [Stat Enhancement](/docs/palworld/stat-enhancement).

| Setting                       | Default | Description                    |
| ----------------------------- | ------- | ------------------------------ |
| `bAllowEnhanceStat_Health`    | `True`  | Allow points into HP           |
| `bAllowEnhanceStat_Attack`    | `True`  | Allow points into Attack       |
| `bAllowEnhanceStat_Stamina`   | `True`  | Allow points into Stamina      |
| `bAllowEnhanceStat_Weight`    | `True`  | Allow points into Carry Weight |
| `bAllowEnhanceStat_WorkSpeed` | `True`  | Allow points into Work Speed   |

Breeding [#breeding]

| Setting                     | Default | Description                                      |
| --------------------------- | ------- | ------------------------------------------------ |
| `PalEggDefaultHatchingTime` | `72.0`  | Hours for Huge Egg incubation (72 = 3 real days) |

Features [#features]

| Setting                         | Default | Description                                                  |
| ------------------------------- | ------- | ------------------------------------------------------------ |
| `bEnableFastTravel`             | `True`  | Enable fast travel                                           |
| `bEnableFastTravelOnlyBaseCamp` | `False` | Restrict fast travel to base camps only                      |
| `bIsStartLocationSelectByMap`   | `True`  | Let players choose a start location on the map               |
| `bEnableInvaderEnemy`           | `True`  | Enable base raids                                            |
| `EnablePredatorBossPal`         | `True`  | Enable roaming [Predator Pals](/docs/palworld/predator-pals) |
| `SupplyDropSpan`                | `180`   | Minutes between supply drops                                 |
| `bExistPlayerAfterLogout`       | `False` | Player body persists after logout                            |
| `bEnableNonLoginPenalty`        | `True`  | Apply a penalty to players who don't log in for a long time  |
| `bHardcore`                     | `False` | Permanent death mode                                         |
| `bPalLost`                      | `False` | Pals are lost permanently on death (hardcore Pals)           |
| `bCharacterRecreateInHardcore`  | `False` | Force character recreation on death in hardcore              |
| `bEnableAimAssistPad`           | `True`  | Controller aim assist                                        |
| `bEnableAimAssistKeyboard`      | `False` | Keyboard aim assist                                          |
| `bActiveUNKO`                   | `False` | Enable the "UNKO" easter-egg content                         |
| `DropItemMaxNum`                | `3000`  | Max dropped items in world                                   |
| `DropItemMaxNum_UNKO`           | `100`   | Max dropped UNKO items in world                              |
| `DropItemAliveMaxHours`         | `1.0`   | Hours before dropped items despawn                           |

Randomizer [#randomizer]

| Setting          | Default | Description                          |
| ---------------- | ------- | ------------------------------------ |
| `RandomizerType` | `None`  | `None`, `Region`, `All`              |
| `RandomizerSeed` | `""`    | Seed for deterministic randomization |

Crossplay [#crossplay]

| Setting              | Default                | Description       |
| -------------------- | ---------------------- | ----------------- |
| `CrossplayPlatforms` | `(Steam,Xbox,PS5,Mac)` | Allowed platforms |

Network & API [#network--api]

| Setting          | Default | Description                             |
| ---------------- | ------- | --------------------------------------- |
| `RCONEnabled`    | `False` | Enable RCON (deprecated — use REST API) |
| `RCONPort`       | `25575` | RCON port                               |
| `RESTAPIEnabled` | `True`  | Enable REST API                         |
| `RESTAPIPort`    | `8212`  | REST API port                           |

Performance [#performance]

| Setting                               | Default   | Description                                                         |
| ------------------------------------- | --------- | ------------------------------------------------------------------- |
| `ServerReplicatePawnCullDistance`     | `15000.0` | Pal sync range in cm (5000–15000)                                   |
| `bIsUseBackupSaveData`                | `True`    | Enable automatic save backups                                       |
| `AutoSaveSpan`                        | `30.0`    | Auto-save interval in seconds                                       |
| `ItemContainerForceMarkDirtyInterval` | `1.0`     | Force container re-sync interval while a chest UI is open (seconds) |
| `ItemCorruptionMultiplier`            | `1.0`     | Item corruption (spoilage) speed multiplier                         |

Technology Restrictions [#technology-restrictions]

| Setting              | Default   | Description                                                                                            |
| -------------------- | --------- | ------------------------------------------------------------------------------------------------------ |
| `DenyTechnologyList` | *(empty)* | Comma-separated Technology IDs to disable. See [Disable Technologies](/docs/palworld/deny-technology). |

Difficulty Preset [#difficulty-preset]

| Setting      | Default | Description                                                                                                                                                                                                                         |
| ------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Difficulty` | `None`  | Leave at `None` to use the individual `OptionSettings` values below/above. Setting a built-in difficulty preset instead can override individual rates, so most self-hosted servers keep this at `None` and tune the rates directly. |

***

> 💡 **Tip:** For the most popular setting changes, see our individual guides linked from the [index page](/docs/palworld).

Related Guides [#related-guides]

* [Admin Commands](/docs/palworld/admin-commands)
* [Performance Optimization](/docs/palworld/optimize-performance)
* [Ports Reference](/docs/palworld/ports-reference)