Difference between revisions of "Xlogfile"

From NetHackWiki
Jump to navigation Jump to search
(→‎File format: xNetHack uses tabs as separators, not colons)
m (→‎File format: Grammar/style)
 
(3 intermediate revisions by 2 users not shown)
Line 8: Line 8:
 
}}
 
}}
  
−
'''xlogfile''', or the extended [[logfile]], is a [[compile-time option]] for NetHack that makes the game log more data at the end of a game.
+
'''xlogfile''', or the extended [[logfile]], is a [[compile-time option]] for NetHack that makes the game log more data at the end of a game than is stored by default in the regular [[logfile]]
  
−
The xlogfile began as a [[patch]] for [[NetHack 3.4.3]]. It was incorporated into the mainline in [[NetHack 3.6.0]]. It is an optional feature, and can be removed by commenting out the definition of XLOGFILE in include/config.h.
+
The xlogfile began as a [[patch]] for [[NetHack 3.4.3]]. It was incorporated into the mainline in [[NetHack 3.6.0]]. It is an optional feature, enabled by default, and can be removed by commenting out the definition of XLOGFILE in include/config.h.
  
 
== File format ==
 
== File format ==
  
−
The data is saved into a file named <code>xlogfile</code> in the same directory as the normal logfile. Each line contains several <tt>field=value</tt> pairs, separated by a colon (or a tab in some variants, which may also add extensions such as <code>conductX</code> and <code>achieveX</code> with text-format conducts and achievements). For example:
+
The data is saved into a file named <code>xlogfile</code> in the same directory as the normal logfile. Each line contains several <tt>field=value</tt> pairs, delimited by tabs. For example:
−
  version=3.4.3:points=55590:deathdnum=0:deathlev=7:maxlvl=12:hp=-14:maxhp=92:deaths=1:deathdate=20090502:birthdate=20090501:uid=5:role=Tou:race=Hum:gender=Fem:align=Neu:name=gibbas:death=killed by a mumak:conduct=0xf86:turns=16662:achieve=0x400:realtime=18452:starttime=1241195443:endtime=1241214565:gender0=Fem:align0=Neu
+
  version=3.6.3 points=972 deathdnum=0 deathlev=4 maxlvl=5 hp=0 maxhp=48 deaths=1 deathdate=20191206 birthdate=20191206 uid=5 role=Val race=Hum gender=Fem align=Law name=merpish death=killed by a water elemental conduct=0xf80 turns=3711 achieve=0x0 realtime=708 starttime=1575647272 endtime=1575647980 gender0=Fem align0=Law flags=0x4
 +
 
 +
In the original patch, fields are delimited by colons.
  
 
Most of the fields are self-explanatory, or are the same as in the normal [[logfile]]. Exceptions are:
 
Most of the fields are self-explanatory, or are the same as in the normal [[logfile]]. Exceptions are:
  
−
*conduct: A bitfield in hexadecimal format:
+
*[[conduct]]: A bitfield in hexadecimal format:
−
**0x001: Foodless
+
**0x001: [[Foodless]]
 
**0x002: Vegan
 
**0x002: Vegan
 
**0x004: Vegetarian
 
**0x004: Vegetarian
−
**0x008: Atheist
+
**0x008: [[Atheist]]
−
**0x010: Weaponless
+
**0x010: [[Never hit with a wielded weapon|Weaponless]]
−
**0x020: Pacifist
+
**0x020: [[Pacifist]]
−
**0x040: Illiterate
+
**0x040: [[Illiterate]]
 
**0x080: Polypileless
 
**0x080: Polypileless
 
**0x100: Polyselfless
 
**0x100: Polyselfless
−
**0x200: Wishless
+
**0x200: [[Wishless]]
 
**0x400: Artifact wishless
 
**0x400: Artifact wishless
 
**0x800: Genocideless
 
**0x800: Genocideless
Line 56: Line 58:
 
**0x2: [[Discover mode]]
 
**0x2: [[Discover mode]]
 
**0x4: Never loaded a [[Bones]] file
 
**0x4: Never loaded a [[Bones]] file
 +
 +
{{upcoming|NetHack 3.7.0|The fields <code>conductX</code> and <code>achieveX</code> are added that encode conducts and game achievements in text form, allowing for easier addition of new conducts and achievements and making the file easier to read by humans.}}
  
 
==References==
 
==References==
Line 62: Line 66:
 
[[Category:Annotations]]
 
[[Category:Annotations]]
 
[[Category:Patches]]
 
[[Category:Patches]]
−
{{nethack-360}}
+
{{nethack-366}}

Latest revision as of 18:23, 16 June 2021

This page is a stub. Should you wish to do so, you can contribute by expanding this page.
xlogfile
Author Aardvark Joe
Download unknown
NetHack PatchDB 289

xlogfile, or the extended logfile, is a compile-time option for NetHack that makes the game log more data at the end of a game than is stored by default in the regular logfile

The xlogfile began as a patch for NetHack 3.4.3. It was incorporated into the mainline in NetHack 3.6.0. It is an optional feature, enabled by default, and can be removed by commenting out the definition of XLOGFILE in include/config.h.

File format

The data is saved into a file named xlogfile in the same directory as the normal logfile. Each line contains several field=value pairs, delimited by tabs. For example: 

version=3.6.3	points=972	deathdnum=0	deathlev=4	maxlvl=5	hp=0	maxhp=48	deaths=1	deathdate=20191206	birthdate=20191206	uid=5	role=Val	race=Hum	gender=Fem	align=Law	name=merpish	death=killed by a water elemental	conduct=0xf80	turns=3711	achieve=0x0	realtime=708	starttime=1575647272	endtime=1575647980	gender0=Fem	align0=Law	flags=0x4

In the original patch, fields are delimited by colons.

Most of the fields are self-explanatory, or are the same as in the normal logfile. Exceptions are:

The following information pertains to an upcoming version (NetHack 3.7.0). If this version is now released, please verify that it is still accurate, then update the page to incorporate this information.

The fields conductX and achieveX are added that encode conducts and game achievements in text form, allowing for easier addition of new conducts and achievements and making the file easier to read by humans.

References

  1. ↑ encodexlogflags in topten.c
Retrieved from "https://nethackwiki.com/index.php?title=Xlogfile&oldid=140999"