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

# Unturned Server Configuration Guide

> Detailed explanation of Unturned server configuration files and settings

# Introduction to Unturned Server Configuration

Properly configuring your Unturned server is essential for creating the best gameplay experience for your players. This guide walks you through the various configuration files and options available on the Wasabi Hosting Gamepanel.

## Core Configuration Files

Unturned servers use several key configuration files that control different aspects of the game:

<Accordion title="Configuration File Overview">
  | File                              | Location                          | Purpose                              |
  | --------------------------------- | --------------------------------- | ------------------------------------ |
  | **Commands.dat**                  | `/Servers/YourServerName/`        | Server startup commands              |
  | **Config.json**                   | `/Servers/YourServerName/Server/` | Main game settings                   |
  | **Admins.dat**                    | `/Servers/YourServerName/Server/` | Administrator list                   |
  | **Mods.dat**                      | `/Servers/YourServerName/Server/` | Moderator list                       |
  | **WorkshopItems.dat**             | `/Servers/YourServerName/Server/` | Workshop mod list                    |
  | **Welcome.txt**                   | `/Servers/YourServerName/Server/` | Welcome message                      |
  | **Rocket/Permissions.config.xml** | `/Servers/YourServerName/`        | Rocket permissions (if using Rocket) |
</Accordion>

## Basic Server Setup

### Commands.dat Configuration

The `Commands.dat` file contains startup commands for your server. Here's a template with recommended settings:

```
// Basic Settings
Name MyUnturnedServer
Map PEI
Port 27015
Password ""
MaxPlayers 24
Perspective Both
GameMode Normal

// Difficulty Settings
Difficulty Normal
Cheats Disabled
PVE Disabled
Decay Enabled
BattlEye Enabled

// Performance Settings
Log 3
FrameRate 30
Timeout 120
Tick_Delay 0.015
Max_Ping 1250
Max_Packets_Per_Second 800

// Gameplay Settings
Durability_Vehicles Enabled
Durability_Weapons Enabled
Durability_Clothing Enabled
Gold Disabled
Allow_Workshop Enabled

// Security Settings
Hide_Admins Enabled
HideAdminsLocal Enabled
Invite_Only Disabled
```

<Warning>
  Don't set the FrameRate higher than 30 unless you have a very powerful server, as higher values significantly increase CPU usage.
</Warning>

### Config.json Customization

The `Config.json` file in `/Servers/YourServerName/Server/` allows more detailed configuration. Here's a recommended setup:

```json theme={null}
{
  "Browser": {
    "Broadcast": true,
    "Password": false,
    "ListInMasterServerList": true,
    "Lan": false,
    "PvP": true,
    "Port": 27015,
    "Public": true
  },
  "Gameplay": {
    "Acid": {
      "Can_Damage_Buildables": true,
      "Can_Damage_Environment": true,
      "Can_Damage_Players": true,
      "Can_Damage_Resources": true,
      "Can_Damage_Vehicles": true,
      "Can_Start_Fire": true,
      "Gun_Bullets_Cause_Acid": false,
      "Melee_Causes_Acid": false
    },
    "Allow_Shoulder_Camera": true,
    "Allow_Statistic_Tracking": true,
    "Allow_Vote_For_Shutdown": false,
    "Allow_Workshop_Items": true,
    "Anti_Cheat": {
      "Allow_Battleye_Client": true,
      "Kicks_Per_Minute_Threshold": 10,
      "Max_Flagged_Packets_Before_Kick": 30,
      "Max_Invalid_Character_Packets_Before_Kick": 20,
      "Max_Invalid_Vehicle_Packets_Before_Kick": 10,
      "Max_Ping": 1250,
      "Max_Successful_Teleports_Before_Kick": 5,
      "Max_Unsuccessful_Teleports_Before_Kick": 5,
      "Max_Vehicle_Distance_Before_Kick": 60,
      "Max_Walk_Speed": 15
    },
    "Assault_Rifle_Burst_Shots_Per_Second": 7.5,
    "Auto_Save_Interval_Seconds": 900,
    "Bleeding_Damage": 5,
    "Broken_Legs_Damage": 10,
    "Bullets_Hurt_Barricades": true,
    "Bullets_Hurt_Plants": true,
    "Bypass_Buildable_Restrictions": false,
    "Decay_Time": 604800,
    "Decay_Vehicles": true,
    "Fall_Damage": true,
    "Food_Decrease_Multiplier": 1.0,
    "Gravity_Multiplier": 1.0,
    "Group_Limit": 0,
    "Hair_Grow_Time": 259200,
    "Item_Despawn_Seconds": 600,
    "Weapon_Jam_Quality_Threshold": 10,
    "Max_Items_Per_Container": 40,
    "Max_Items_Spawn": 96,
    "Max_Barrel_Drops": 5,
    "Max_Zombies_Spawned": 64,
    "Max_Animals_Spawned": 16,
    "Zombie_Spawn_Interval": 15,
    "Player_Height_Threshold": 12,
    "Player_Stance_Samples": 32,
    "Player_Sprinting_Grace": 0.75
  },
  "Login": {
    "Timeout_Queue": 60,
    "Timeout_Linking": 30,
    "Queue_Size": 10
  }
}
```

<Info>
  The settings in Config.json override those in Commands.dat if both specify the same option.
</Info>

## Welcome Message Setup

Create a `Welcome.txt` file in your `/Servers/YourServerName/Server/` directory to display a message when players join:

```
Welcome to our Unturned server!

📜 Server Rules:
1. No cheating or exploiting
2. Be respectful to other players
3. No spamming or advertising

🔗 Join our Discord: discord.gg/yourserver
```

<Tip>
  You can use basic formatting in your welcome message with color codes:

  * `<color=red>Text</color>` - Colored text
  * `<size=20>Text</size>` - Change text size
  * `<b>Text</b>` - Bold text
  * `<i>Text</i>` - Italic text
</Tip>

## Workshop Mod Configuration

To add Workshop mods to your server:

1. Create or edit `WorkshopItems.dat` in your `/Servers/YourServerName/Server/` directory:

```
// Format: One Workshop ID per line
2563837253
2183779444
1539621795
```

2. You can also specify Workshop mods in your startup parameters in Gamepanel:

```
+WorkshopDownloadConfig +InternetServer/YourServerName
```

<Warning>
  Too many Workshop mods can significantly increase server startup time and memory usage. Keep your mod list optimized.
</Warning>

## Admin and Moderator Setup

Set up administrators and moderators by editing the respective files:

### Admins.dat

```
// Place one Steam64 ID per line
76561198012345678
76561198087654321
```

### Mods.dat

```
// Place one Steam64 ID per line
76561198076543210
76561198076543211
```

<Tip>
  You can find a player's Steam64 ID by searching their username on [SteamID.io](https://steamid.io/).
</Tip>

## Game Mode Configuration

Unturned offers several game modes that can be set in `Commands.dat`:

<Tabs>
  <Tab title="Survival">
    The standard Unturned experience:

    ```
    GameMode Normal
    Difficulty Normal
    PVE Disabled
    Gold Disabled
    ```
  </Tab>

  <Tab title="PvE">
    For peaceful cooperative gameplay:

    ```
    GameMode Normal
    Difficulty Normal
    PVE Enabled
    Friendly_Fire Disabled
    Gold Disabled
    ```
  </Tab>

  <Tab title="Arena">
    For competitive PvP gameplay:

    ```
    GameMode Arena
    Difficulty Normal
    Arena_Teams 4
    Arena_Players_Per_Team 1
    Arena_Rounds 5
    Respawn_Time 10
    ```
  </Tab>

  <Tab title="Horde">
    Zombie wave defense mode:

    ```
    GameMode Horde
    Difficulty Hard
    Horde_Max_Zombies 100
    Horde_Num_Waves 10
    ```
  </Tab>
</Tabs>

## Difficulty Settings

Customize the server difficulty in `Commands.dat`:

```
// Easy difficulty (more loot, less damage)
Difficulty Easy
Item_Respawn_Time 20
Player_Health_Regen 60
Zombie_Damage_Multiplier 0.75
Loot_Quantity_Multiplier 1.5

// Hard difficulty (less loot, more damage)
Difficulty Hard
Item_Respawn_Time 45
Player_Health_Regen 30
Zombie_Damage_Multiplier 1.5
Loot_Quantity_Multiplier 0.75
```

## Economy Configuration (with Rocket)

If you're using the Uconomy plugin with Rocket, configure your economy in `/Rocket/Uconomy/Uconomy.configuration.xml`:

```xml theme={null}
<?xml version="1.0" encoding="utf-8"?>
<UconomyConfiguration xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <DatabaseAddress>localhost</DatabaseAddress>
  <DatabaseUsername>username</DatabaseUsername>
  <DatabasePassword>password</DatabasePassword>
  <DatabaseName>uconomy</DatabaseName>
  <DatabaseTableName>uconomy</DatabaseTableName>
  <DatabasePort>3306</DatabasePort>
  <PayDay>
    <Enabled>true</Enabled>
    <Interval>600</Interval>
    <Amount>20</Amount>
  </PayDay>
  <InitialBalance>100</InitialBalance>
  <CurrencyName>Credits</CurrencyName>
  <MessageColor>green</MessageColor>
</UconomyConfiguration>
```

## Custom Map Setup

To use a custom map on your server:

1. Upload the map files to `/Servers/YourServerName/Maps/YourMapName/`
2. Edit your `Commands.dat` to use the custom map:
   ```
   Map YourMapName
   ```

<Warning>
  Custom maps can cause server performance issues if they're large or poorly optimized. Test thoroughly before deployment.
</Warning>

## Rocket Configuration

If you're using Rocket to extend your server functionality:

### Basic Rocket Configuration

Configure your `/Rocket/Rocket.config.xml` file:

```xml theme={null}
<?xml version="1.0" encoding="utf-8"?>
<RocketConfiguration xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <WebPermissions>false</WebPermissions>
  <AutomaticShutdown>false</AutomaticShutdown>
  <Economy>
    <Enabled>true</Enabled>
    <ItemValueMultiplier>1.0</ItemValueMultiplier>
    <VehicleValueMultiplier>1.0</VehicleValueMultiplier>
  </Economy>
  <Flat>false</Flat>
  <RCON>
    <Enabled>true</Enabled>
    <Port>27020</Port>
    <Password>YourSecurePassword</Password>
  </RCON>
</RocketConfiguration>
```

### Rocket Permissions Setup

Configure `/Rocket/Permissions.config.xml` for user permissions:

```xml theme={null}
<?xml version="1.0" encoding="utf-8"?>
<RocketPermissions xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <DefaultGroup>default</DefaultGroup>
  <Groups>
    <Group>
      <Id>default</Id>
      <DisplayName>Player</DisplayName>
      <Color>white</Color>
      <Permissions>
        <Permission>rocket.kits</Permission>
        <Permission>rocket.tpa</Permission>
        <Permission>rocket.home</Permission>
      </Permissions>
    </Group>
    <Group>
      <Id>vip</Id>
      <DisplayName>VIP</DisplayName>
      <Color>yellow</Color>
      <ParentGroup>default</ParentGroup>
      <Permissions>
        <Permission>rocket.kits.vip</Permission>
        <Permission>rocket.warp</Permission>
        <Permission>rocket.sethome.multiple.3</Permission>
      </Permissions>
    </Group>
    <Group>
      <Id>moderator</Id>
      <DisplayName>Moderator</DisplayName>
      <Color>green</Color>
      <ParentGroup>vip</ParentGroup>
      <Permissions>
        <Permission>rocket.teleport</Permission>
        <Permission>rocket.teleport.other</Permission>
        <Permission>rocket.kick</Permission>
        <Permission>rocket.ban.short</Permission>
        <Permission>rocket.vanish</Permission>
      </Permissions>
    </Group>
    <Group>
      <Id>admin</Id>
      <DisplayName>Administrator</DisplayName>
      <Color>red</Color>
      <ParentGroup>moderator</ParentGroup>
      <Permissions>
        <Permission>rocket.*</Permission>
      </Permissions>
    </Group>
  </Groups>
</RocketPermissions>
```

## Plugin Configuration Examples

<Accordion title="Home Plugin">
  Configure `/Rocket/Plugins/Home/Home.configuration.xml`:

  ```xml theme={null}
  <?xml version="1.0" encoding="utf-8"?>
  <HomeConfiguration xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <HomeLimit>1</HomeLimit>
    <HomeEnabled>true</HomeEnabled>
    <CooldownMin>30</CooldownMin>
    <WarmupSec>5</WarmupSec>
    <HomeCost>15</HomeCost>
    <MaxHomesPerPlayer>3</MaxHomesPerPlayer>
  </HomeConfiguration>
  ```
</Accordion>

<Accordion title="Kit Plugin">
  Configure `/Rocket/Plugins/Kits/Kits.configuration.xml`:

  ```xml theme={null}
  <?xml version="1.0" encoding="utf-8"?>
  <KitsConfiguration xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Kits>
      <Kit>
        <Name>starter</Name>
        <Cooldown>86400</Cooldown>
        <Cost>0</Cost>
        <Items>
          <KitItem>
            <ItemId>13</ItemId>
            <Amount>1</Amount>
          </KitItem>
          <KitItem>
            <ItemId>14</ItemId>
            <Amount>1</Amount>
          </KitItem>
          <KitItem>
            <ItemId>15</ItemId>
            <Amount>1</Amount>
          </KitItem>
        </Items>
        <XP>0</XP>
        <Vehicle>0</Vehicle>
      </Kit>
      <Kit>
        <Name>vip</Name>
        <Cooldown>43200</Cooldown>
        <Cost>0</Cost>
        <Items>
          <KitItem>
            <ItemId>363</ItemId>
            <Amount>1</Amount>
          </KitItem>
          <KitItem>
            <ItemId>17</ItemId>
            <Amount>5</Amount>
          </KitItem>
        </Items>
        <XP>50</XP>
        <Vehicle>0</Vehicle>
      </Kit>
    </Kits>
  </KitsConfiguration>
  ```
</Accordion>

<Accordion title="TPA Plugin">
  Configure `/Rocket/Plugins/TPAlwaysAllowed/TPAlwaysAllowed.configuration.xml`:

  ```xml theme={null}
  <?xml version="1.0" encoding="utf-8"?>
  <TPAlwaysAllowedConfiguration xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <TPATimer>120</TPATimer>
    <TPACooldown>30</TPACooldown>
    <TPAEnabled>true</TPAEnabled>
    <TPAWarmup>5</TPAWarmup>
    <TPACost>15</TPACost>
  </TPAlwaysAllowedConfiguration>
  ```
</Accordion>

## Advanced Settings

### BattlEye Configuration

To configure BattlEye anti-cheat, edit `/BattlEye/Config/BEServer.cfg`:

```
RConPort 2310
RestrictRCon 0
MaxPing 1000
MaxPacketsize 1024
MinPacketLoss 0.0
MaxPacketLoss 0.2
MinPktRate 80
MinPktRateOnJoin 20
PacketFlood 2000
```

### Hosting Multiple Servers

If you want to host multiple Unturned servers on the same machine, each needs its own port:

```
// First server
Port 27015
Query_Port 27016
Rcon_Port 27017

// Second server
Port 27018
Query_Port 27019
Rcon_Port 27020
```

## Startup Parameters

Configure these in your Wasabi Hosting Gamepanel startup command:

```
+InternetServer/YourServerName -Port=27015 -Secure -Framerate=30 -Rolling=Minute -LogLevel=1 -PVP -NoWorkshopExplicitLoading
```

<Accordion title="Parameter Explanation">
  | Parameter                        | Description                | Recommended Value           |
  | -------------------------------- | -------------------------- | --------------------------- |
  | `+InternetServer/YourServerName` | Specifies server name      | Your server name            |
  | `-Port=27015`                    | Server port                | 27015 (default)             |
  | `-Secure`                        | Enables VAC                | Always use this             |
  | `-Framerate=30`                  | Server tick rate           | 30 (optimal balance)        |
  | `-Rolling=Minute`                | Save interval              | Minute (prevents data loss) |
  | `-LogLevel=1`                    | Detail level of logging    | 1 or 2                      |
  | `-PVP`                           | Enables player vs player   | Optional                    |
  | `-NoWorkshopExplicitLoading`     | More efficient mod loading | Recommended                 |
</Accordion>

## Map-Specific Configuration

Different maps may require specific settings:

<Tabs>
  <Tab title="Russia">
    Large map with many zombies:

    ```
    Map Russia
    Max_Zombies_Spawned 64
    Max_Items_Spawn 128
    Max_Vehicles 32
    ```
  </Tab>

  <Tab title="PEI">
    Smaller map for better performance:

    ```
    Map PEI
    Max_Zombies_Spawned 48
    Max_Items_Spawn 96
    Max_Vehicles 24
    ```
  </Tab>

  <Tab title="Washington">
    Balanced medium-sized map:

    ```
    Map Washington
    Max_Zombies_Spawned 56
    Max_Items_Spawn 112
    Max_Vehicles 28
    ```
  </Tab>

  <Tab title="Yukon">
    Snow map with survival focus:

    ```
    Map Yukon
    Max_Zombies_Spawned 48
    Max_Items_Spawn 80
    Max_Vehicles 20
    Temperature_Min -15
    Temperature_Max 5
    ```
  </Tab>
</Tabs>

## Database Configuration

If your server or plugins use MySQL, configure your database in the relevant plugin configuration files:

```xml theme={null}
<DatabaseAddress>localhost</DatabaseAddress>
<DatabaseUsername>username</DatabaseUsername>
<DatabasePassword>password</DatabasePassword>
<DatabaseName>database</DatabaseName>
<DatabasePort>3306</DatabasePort>
```

<Warning>
  Store database passwords securely and never share your database credentials.
</Warning>

## Security Best Practices

Follow these security recommendations on your Wasabi Hosting Unturned server:

1. **Use strong passwords** for RCON and server access
2. **Enable BattlEye** for anti-cheat protection
3. **Regularly update** your server and plugins
4. **Back up configurations** before making changes
5. **Monitor logs** for suspicious activity
6. **Implement permission restrictions** carefully

## Troubleshooting Common Issues

<Accordion title="Server Won't Start">
  1. Check for errors in the Gamepanel console
  2. Verify proper syntax in configuration files
  3. Ensure no duplicate entries exist in Commands.dat
  4. Check for corrupted configuration files
  5. Try starting with a minimal configuration and add features gradually
</Accordion>

<Accordion title="Players Can't Connect">
  1. Verify the server is running
  2. Check firewall settings
  3. Ensure the correct port is open (default: 27015)
  4. Verify the server is publicly listed
  5. Check for BattlEye compatibility issues
</Accordion>

<Accordion title="Plugin Issues">
  1. Ensure plugin versions are compatible with your server version
  2. Check for plugin conflicts
  3. Verify proper XML syntax in configuration files
  4. Check `/Rocket/Logs/` for specific error messages
  5. Try disabling and re-enabling plugins one by one
</Accordion>

By following this guide, you should be able to configure your Unturned server on Wasabi Hosting to provide an excellent gameplay experience. If you need additional assistance, contact our support team.

<Card title="Get your own Unturned server" icon="rocket" href="https://wasabihosting.com/game-servers/unturned">
  Deploy a DDoS-protected Unturned server on AMD Ryzen hardware in about two minutes. Plans start at €7.49/month.
</Card>