pg.dat 1.0.0

.NET Core 2.1 This package targets .NET Core 2.1. The package is compatible with this framework or higher. 
dotnet add package pg.dat --version 1.0.0                

                    
                

            
NuGet\Install-Package pg.dat -Version 1.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="pg.dat" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add pg.dat --version 1.0.0                

                    
                

            
#r "nuget: pg.dat, 1.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install pg.dat as a Cake Addin
#addin nuget:?package=pg.dat&version=1.0.0

// Install pg.dat as a Cake Tool
#tool nuget:?package=pg.dat&version=1.0.0

Build Status

String File Format

Implements the Petroglyph *.DAT file type in C#.

Special thanks to @MikeLankamp for decoding the files and hosting them on Petrolution.

Introduction

String Files (extension: .DAT) in Petroglyph's games hold <key, value> string pairs and allow the game to be easily ported across different languages by having a separate String File for each language. In such a case, the sets of keys are typically identical for the different language string files while the sets of values differ for each language.

The keys are 8-bit ASCII strings and the values are 16-bit UTF-16LE strings.

Format Specification

Each string file begins with a header, followed by the string index table and finally the string data itself.

Note that all string data is stored back-to-back, without zero-termination. All value strings are stored first, followed by all key strings.

Offset Name Type Description
+0000h count uint32 Number of records in the String Index Table.
String Index Table Record
Offset Name Type Description
+0000h crc uint32 CRC-32 of the key.
+0004h nValChars uint32 Length of the value string, in characters.
+0008h nKeyChars uint32 Length of the key string, in characters.
String Data
Offset Type Description
+0000h unichar String_Index_Table[0].nValChars
+????h unichar ...
+????h unichar String_Index_Table[count-1].nValChars
+????h char String_Index_Table[0].nKeyChars
+????h char ...
+????h char String_Index_Table[count-1].nKeyChars

Sortedness

The String Index table is not necessarily sorted on the CRC. Typically, there are two usages for String Files: game strings and credits. In the former case, language-dependent values are located by doing a lookup based on the language-independent key. For those files, the String Index Table is usually sorted. For the latter case, the strings are displayed one by one and, in fact, cannot be sorted by key.

A solution is, when reading the file, to keep track of the sortedness of the index (the CRC of the previously read entry should always be less than the CRC of the currently read entry), and when it turns out the file is sorted, O(log n) lookups can be performed instead of O(n).

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed. 
.NET Core netcoreapp2.1 is compatible.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

  • .NETCoreApp 2.1

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.0 1,115 10/27/2019

Initial Release