Administration Logs – DayZ

From Bohemia Interactive Community
Jump to navigation Jump to search
(Created page with "{{Stub}}")
 
No edit summary
Line 1: Line 1:
{{Stub}}
==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.
 
 
 
==Logged events==
Each message in the log is prefixed by a time stamp in a HH:MM:SS format
 
{| class="wikitable" style="width:100%;"
|-
! Event !! Description !! Example
|-
| rowspan="2" | Connect/Disconnect || rowspan="2" | 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
|-
|  rowspan="2" | Unconscious state || rowspan="2" | 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
|-
| 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  || Player "Survivor A"(id=DAYZGUID, (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
|-
|  Player "Survivor A"(id=DAYZGUID, (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
|-
|  Player "Survivor" (id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) suffered FallDamage
|-
|  Player "Survivor" (id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) hit by Bear Trap into LeftFoot
|-
| 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. || 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
|-
| 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
|-
| Trap placement || Log when player places a trap in the world || Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) placed Bear Trap
|}
 
 
==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''' here you can override specific events or change the message output.
 
 
Following events are currently handled in the executable and so they are not moddable:
 
Connect/Disconnect
 
Chat
 
Player report

Revision as of 15:18, 6 February 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.


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 players, traps and falls - includes source of damage, hitzone, ammunition used and range if the source was a ranged weapon Player "Survivor A"(id=DAYZGUID, (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
Player "Survivor A"(id=DAYZGUID, (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
Player "Survivor" (id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) suffered FallDamage
Player "Survivor" (id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) hit by Bear Trap into LeftFoot
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
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
Trap placement Log when player places a trap in the world Player "Survivor"(id=DAYZGUID, pos=<13212.8, 10124.8, 6.0>) placed Bear Trap


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 here you can override specific events or change the message output.


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

Connect/Disconnect

Chat

Player report