DayZ Server Files Documentation

[ImpulZ 2491]

Hello Survivors,

today we are releasing the DayZ Server Files to open server hosting to all of you.

With the files, you will be able to run your own DayZ server and configure it to your liking.

You can download the files in the "Tools" section of your Steam library or via steam://rungameid/223350

Due to a small issue right now you only have access to the files if you own a copy of DayZ. This will be fixed soon.

in this post, we will go over the basics of how to configure your server:

• Config Parameters
• Launch Parameters
• BattlEye configuration
• Server Economy
• Hardware Requirements
• How to Ban
• Server Messages and How to Restart Automatically

[ImpulZ 2491]

Config Parameters

The server configuration is handled via serverDZ.cfg, a configuration file which you can use to configure various game server settings such as the player count, 3rd person view, and welcome messages. etc. The file usually is located in the root directory of the server but can be placed elsewhere with the startup parameter -config. To ensure, that Steam does not overwrite this file with an update, be sure to have a copy of this original file and rename it.

You can find a complete documentation of the server configuration file and its parameters on our Community Wiki

[ImpulZ 2491]

Launch Parameters

You can find a complete documentation of the launch parameters on our Community Wiki

[ImpulZ 2491]

BattlEye Configuration

The config file BEServer_x64.cfg needs to be in the same folder as BEServer_x64.dll.The location of this folder can be customized via the startup parameters -bePath and -profiles.

Parameters:

RConPassword MyPassword - Sets the password for the connection of the RCon tool (remote connection admin tool like BEC/Dart)

RestrictRCon 1 - Enables/Disables RCon functions (kick/ban/connection restrictions)

Edited September 18, 2018 by ImpulZ

[ImpulZ 2491]

Server Economy - Documentation

We are providing samples of relevant offline mission files on our Github

[ImpulZ 2491]

The minimum requirements (provisional) for running one server instance are:

• OS: Windows Server 12-16 or Windows 10 (Linux server hosting is not supported yet)
• Processor: Intel Dual-Core 2.4 GHz or AMD Dual-Core Athlon 2.5 GHz
• 6 GB RAM
• 2.5 GB space on the drive
• SSD for logs/install (highly recommended)

Edited September 18, 2018 by ImpulZ

[ImpulZ 2491]

How to Ban

There are currently two ways to ban players from a server:

1. Create a file ban.txt in the server root folder and add the player UID in a new line (44 characters long id that you can find in .adm or .rpt logs)
2. Create a file bans.txt in the serverRootDirectory\battleye folder and add the player BE GUID in a new line (32 characters long GUID which you can get from RCon tools like Dart or BEC).

The location of the BattlEye folder can be customized via the startup parameters -bePath and -profiles.

Some RCon tools like Dart offer the option to ban users directly via their UI which is then, written to bans.txt.

[ImpulZ 2491]

Server Messages and How to Restart Automatically

This section describes the functionality and administration of server messages, which can be used for automatic server termination.

To setup an automatic restart you will need some other app that will automatically start terminated server as Windows Scheduler, FireDaemon or similar application.

Messages for offline database

The server message is a message that is sent to clients from the server at a given point in time.

The server message can be sent in the following manners:

• every given number of minutes to all players,
• to one player after his connection with possible delay,
• and so called 'countdown' message that is sent to all players in predefined times before deadline is met on server ("--- Termination successfully completed ---" line will be written to the .rpt file when the termination is finished).

---

Flags

On connect

• Indicates that the server message will be sent once after a player connects to the server.

Repeat

• Indicates that the server message will be sending to all players repeatedly.

Countdown

• Indicates that the server message will be sent to all players in a countdown manner.
• The message will be sent 90 minutes before the deadline is met, then 60 minutes, 45, 30, 20, 15, 10, 5, 2 and finally 1 minute before the deadline is met.

Shutdown

• Indicates that the server will shutdown after countdown reaches zero.
• If the Countdown flag is not set, this flag is ignored.

---

Properties

The maximum length of the message is 160 characters.
User can place 3 different placeholders into the message's text:

• #name is replaced with the server's name
• #port is replaced with server's port
• #tmin is replaced with the number of minutes remaining in the countdown.
  • It is functional only when the Countdown flag is set.

Every property related to time in the server message is in minutes.

Delay

• Applied when the server message has On connect flag set.
• This value indicates how many minutes it will take before the message is sent to player.
• Value of zero means that the message will be sent immediately after the player connects to server.

Repeat

• Applied when the server message has the Repeat flag set.

• This value controls the frequency of the message repetition.

Deadline

• Applied when the server message has the Countdown flag set.
• Indicates how long it takes the countdown before it reaches zero.

---

Offline database

Server messages can be added, updated or deleted in the messages.xml file under the db folder placed inside mission's folder (server_root\mpmissions\dayzOffline.chernarusplus\db\messages.xml). It is not currently part of Steam server data package so you will have to create it yourself.

For automatic server termination set "deadline" and "shutdown" to enabled.

Example messages.xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages>

    <!-- This is example message for automatic server termination -->
    <message>

        <!-- no delay -->
        <delay>0</delay>

        <!-- if the value is larger than 0, then flag Repeat is enabled -->
        <repeat>0</repeat>

        <!-- if the value is larger than 0, then flag Countdown is enabled,
             countdown reaches zero in 10 hours --> 
        <deadline>600</deadline>

        <!-- disable On connect flag -->
        <onconnect>0</onconnect>

        <!-- enable Shutdown flag -->
        <shutdown>1</shutdown>

        <!-- message itself with placeholders -->
        <text>Hello, this server (#name) will shutdown in #tmin minutes.</text>

    </message>
</messages>

 

---

 

Taskkill

If you don't want to use messages.xml for the automatic server termination, you can go with taskkill instead (link to Microsoft documentation).

All you need to do is use Windows Scheduler, FireDaemon or similar application to send the taskkill command without /f parameter and you will invoke graceful shutdown of DayZ server application ("--- Termination successfully completed ---" line will be written to the .rpt file when the termination is finished).

taskkill /im DayZServer_x64.exe

To setup an automatic restart you will need some other application that will automatically start the terminated server as Windows Scheduler, FireDaemon or a similar application.