Administration Logs – DayZ

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
No edit summary
Line 7: Line 7:
The log file is named '''server_exe_name.ADM''' and it is created in the profiles folder, specified by the -profiles launch parameter.
The log file is named '''server_exe_name.ADM''' and it is created in the profiles folder, specified by the -profiles launch parameter.


 
The page is updated for patch '''1.02'''


==Logged events==
==Logged events==
Line 28: Line 28:
|  <tt>Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) regained consciousness</tt>
|  <tt>Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) regained consciousness</tt>
|-
|-
| rowspan="4" | Player damage source || rowspan="4" | Players receiving hits from other players, traps and falls - includes source of damage, hitzone, ammunition used and range if the source was a ranged weapon  || <tt>Player "Survivor A"(id=DAYZUID, pos=<13212.8, 10124.8, 6.0>) damaged by "Survivor B"(id=DAYZGUID, pos=<13242.8, 10124.8, 6.0>) into Torso with Bullet_45ACP from 30 meters</tt>
| rowspan="4" | Player damage source || rowspan="4" | Players receiving hits from other entities and falls - includes current global health, source of damage, hitzone(+component), ammunition used and range if the source was a ranged weapon  || <tt>Player "Survivor A"(id=DAYZGUID pos=<3605.9, 2296.0, 6.0>)[HP: 74] hit by "Survivor B"(id=DAYZGUID pos=<3605.9, 2296.0, 6.0>) into Head(0) for 26 damage (Bullet_45ACP) with FX-45 from 1.12831 meters</tt>
|-
|-
|  <tt>Player "Survivor A"(id=DAYZUID, pos=<13212.8, 10124.8, 6.0>) damaged by "Survivor B"(id=DAYZGUID, pos=<13242.8, 10124.8, 6.0>) into LeftArm with WoodAxe</tt>
|  <tt>Player "Survivor" (id=DAYZGUID pos=<3605.9, 2296.0, 6.0>)[HP: 76.7] hit by Wolf into LeftArm(18) for 20 damage (MeleeWolf)</tt>
|-
|-
| <tt>Player "Survivor" (id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) suffered FallDamage</tt>
| <tt>Player "Survivor" (id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>)[HP: 96.7] hit by FallDamage</tt>
|-
|-
|  <tt>Player "Survivor" (id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) hit by Bear Trap into LeftFoot</tt>
|  <tt>Player "Survivor" (id=DAYZGUID pos=<3605.9, 2296.0, 6.0>)[HP: 96.7] hit by Fireplace with FireDamage</tt>
|-
|-
| rowspan="3" | Player death log || rowspan="3" | Player cause of death. Will print generic death message with additional status information to help determine the cause if it's unclear. || <tt>Player "Survivor A"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) killed by "Survivor B"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) with M4-A1</tt>
| rowspan="3" | Player death log || rowspan="3" | Player cause of death. Will print generic death message with additional status information to help determine the cause if it's unclear. || <tt>Player "Survivor A"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) killed by "Survivor B"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) with M4-A1 from 42 meters</tt>
|-
|-
| <tt>Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) killed by Infected</tt>
| <tt>Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) killed by Infected</tt>
Line 46: Line 46:
| Bleeding out || Player dying to lack of blood || <tt>Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) bled out</tt>
| Bleeding out || Player dying to lack of blood || <tt>Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) bled out</tt>
|-
|-
| Trap placement || Log when player places a trap in the world || <tt>Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) placed Bear Trap</tt>
| rowspan="2" | Placement || rowspan="2" | Log when player places an item in the world using the placement action. Requires '''adminLogPlacement=1;''' || <tt>Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) placed Bear Trap</tt>
|-
| <tt>Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) placed Fireplace</tt>
|-
| rowspan="2" | Base building actions || rowspan="2" | Log when player executes a base building action. Requires '''adminLogBuildActions=1;''' || <tt>Player "Survivor" (id=DAYZGUID pos=<3605.9, 2296.0, 6.0>) built Fence with Shovel</tt>
|-
| <tt>Player "Survivor" (id=DAYZGUID pos=<3605.9, 2296.0, 6.0>) dismantled Fence with Hammer</tt>
|-
| Player list print || Prints a list of players on the server and their current positions every 5 minutes. Requires '''adminLogPlayerList=1;''' || <tt>PlayerList log: 2 players</tt>
 
<tt>Player "Survivor A" (id=DAYZGUID pos=<3533.2, 2256.4, 6.8>)</tt>
 
<tt>Player "Survivor B" (id=DAYZGUID pos=<3533.2, 2256.4, 6.8>)</tt>
|}
|}
==Configuration==
Some of the logging can be filtered in '''serverDZ.cfg''' depending on the server owner's needs
'''adminLogPlayerHitsOnly = 1;''' // log player hits only (no infected/animal hits)
'''adminLogPlacement = 1;''' // log placement ( traps, tents, ... )
'''adminLogBuildActions = 1;''' // log basebuilding actions ( build, dismantle, destroy, ... )
'''adminLogPlayerList = 1;''' // log periodic player list with position every 5 minutes


==Modding==
==Modding==


You can easily add your own messages to the admin log file from your mod using the script function '''CGame::AdminLog( string text )'''
You can easily add your own messages to the admin log file from your mod using the script function '''CGame::AdminLog( string text )'''


If you would like to modify the existing logging, all of the logic can be found in \Scripts\4_World\Plugins\PluginBase\'''PluginAdminLog.c''' where you can override specific events or change the message output.
If you would like to modify the existing logging, all of the logic can be found in \Scripts\4_World\Plugins\PluginBase\'''PluginAdminLog.c''' where you can override specific events or change the message output.

Revision as of 16:36, 25 March 2019

Introduction

This article details Administration Log, a file which records key gameplay events such as chat, player hits and deaths. It's main purpose is to help server administrators identify exploiters, cheaters or spot breaches of any custom rules the server might have set up.

To enable the logging, server must run with the launch parameter -adminlog

The log file is named server_exe_name.ADM and it is created in the profiles folder, specified by the -profiles launch parameter.

The page is updated for patch 1.02

Logged events

Each message in the log is prefixed by a time stamp in a HH:MM:SS format

Event Description Example
Connect/Disconnect Connect and disconnect message for each player joining/leaving the server Player "Survivor" is connected (id=DAYZGUID)
Player "Survivor"(id=DAYZGUID) has been disconnected
Chat Chat log Chat("Survivor"(id=DAYZGUID): hello log
Player report Report message activated by typing "#toadmin yourmessage" into the in game chat PLAYER REPORT: <2019-1-23_11-23-26> <DAYZGUID>: yourmessage
Unconscious state Player falling into and regaining consciousness Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) is unconscious
Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) regained consciousness
Player damage source Players receiving hits from other entities and falls - includes current global health, source of damage, hitzone(+component), ammunition used and range if the source was a ranged weapon Player "Survivor A"(id=DAYZGUID pos=<3605.9, 2296.0, 6.0>)[HP: 74] hit by "Survivor B"(id=DAYZGUID pos=<3605.9, 2296.0, 6.0>) into Head(0) for 26 damage (Bullet_45ACP) with FX-45 from 1.12831 meters
Player "Survivor" (id=DAYZGUID pos=<3605.9, 2296.0, 6.0>)[HP: 76.7] hit by Wolf into LeftArm(18) for 20 damage (MeleeWolf)
Player "Survivor" (id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>)[HP: 96.7] hit by FallDamage
Player "Survivor" (id=DAYZGUID pos=<3605.9, 2296.0, 6.0>)[HP: 96.7] hit by Fireplace with FireDamage
Player death log Player cause of death. Will print generic death message with additional status information to help determine the cause if it's unclear. Player "Survivor A"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) killed by "Survivor B"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) with M4-A1 from 42 meters
Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) killed by Infected
Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) died. Stats> Water: 489.53 Energy: 594.765 Bleeding Sources: 2
Suicide Player death caused by the suicide gesture Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) committed suicide
Bleeding out Player dying to lack of blood Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) bled out
Placement Log when player places an item in the world using the placement action. Requires adminLogPlacement=1; Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) placed Bear Trap
Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) placed Fireplace
Base building actions Log when player executes a base building action. Requires adminLogBuildActions=1; Player "Survivor" (id=DAYZGUID pos=<3605.9, 2296.0, 6.0>) built Fence with Shovel
Player "Survivor" (id=DAYZGUID pos=<3605.9, 2296.0, 6.0>) dismantled Fence with Hammer
Player list print Prints a list of players on the server and their current positions every 5 minutes. Requires adminLogPlayerList=1; PlayerList log: 2 players

Player "Survivor A" (id=DAYZGUID pos=<3533.2, 2256.4, 6.8>)

Player "Survivor B" (id=DAYZGUID pos=<3533.2, 2256.4, 6.8>)

Configuration

Some of the logging can be filtered in serverDZ.cfg depending on the server owner's needs


adminLogPlayerHitsOnly = 1; // log player hits only (no infected/animal hits)

adminLogPlacement = 1; // log placement ( traps, tents, ... )

adminLogBuildActions = 1; // log basebuilding actions ( build, dismantle, destroy, ... )

adminLogPlayerList = 1; // log periodic player list with position every 5 minutes

Modding

You can easily add your own messages to the admin log file from your mod using the script function CGame::AdminLog( string text )

If you would like to modify the existing logging, all of the logic can be found in \Scripts\4_World\Plugins\PluginBase\PluginAdminLog.c where you can override specific events or change the message output.


Following log prints are currently handled in the executable and so they are not moddable:

Connect/Disconnect

Chat

Player report