A .NET library written in C# for extracting game assets and reading game assets from Final Fantasy XIV, now with support for including the Libra Eorzea database.
System.Drawing.Image objects.*.exh and *.exd).*.scd).Note: When building an application using this library make sure to include a copy of SaintCoinach/SaintCoinach.History.zip in the application's directory. This should be done automatically if the project is included in the solution and referenced from there.
All important data is exposed by the class SaintCoinach.ARealmReversed, so setting up access to it is fairly straightforward.
The following is an example using the game's default installation path and English as default language:
const string GameDirectory = @"C:\Program Files (x86)\SquareEnix\FINAL FANTASY XIV - A Realm Reborn";
var realm = new SaintCoinach.ARealmReversed(GameDirectory, SaintCoinach.Ex.Language.English);It's that simple. It is recommended, however, to check if the game has been updated since the last time, which is accomplished like this, in this example including the detection of data changes:
if (!realm.IsCurrentVersion) {
const bool IncludeDataChanges = true;
var updateReport = realm.Update(IncludeDataChanges);
}ARealmReversed.Update() can also take one additional parameter of type IProgress<UpdateProgress> to which progress is reported. The returned UpdateReport contains a list of changes that were detected during the update.
Game files can be access directly through ARealmReversed.Packs, game data can be accessed through ARealmReversed.GameData.
XivCollection)Specific collections can be retrieved using the GetSheet<T>() method.
Note: This only works for objects whose game data files have the same name as the class. This applies for most classes directly inside the SaintCoinach.Xiv namespace, so there should be no need to worry about it in most cases.
Special cases are exposed as properties:
BNpcs: This collection contains objects of type BNpc that include data of both BNpcBase and BNpcName. Note: Only available when Libra Eorzea data is available.ENpcs: This collection contains objects of type ENpc that include data of both ENpcBase and ENpcResident.EquipSlots: There is no actual data for specific equipment slots in the game data, but having access to them makes things more convenient, so they're available here.Items: This collection combines both EventItem and Item.Shops: This collection contains all types of shops.The following is a simple example that outputs the name and colour of all Stain objects to the console:
var stains = realm.GameData.GetSheet<SaintCoinach.Xiv.Stain>();
foreach(var stain in stains) {
Console.WriteLine("#{0}: {1} is {2}", stain.Key, stain.Name, stain.Color);
}Only SaintCoinach contains documentation, and even that only in some places (anything directly in the SaintCoinach namespace as well as some things in SaintCoinach.Xiv.*), everything else is virtually void of documentation.
There should, however, be enough documentation available to know how to use the library for game data, but figuring out the internal workings might prove difficult.
The project SaintCoinach.Cmd is a very basic console application that can be used to extract various assets.
The following commands are currently supported:
lang: Displays or changes the language used for data files. Valid arguments are Japanese, English, German, French. If no argument is supplied the currently used language is shown.raw: Exports a file from the game assets without any conversions. The argument should be the friendly name of the file.image: Exports a file from the game assets as a PNG-image. The argument should be the friendly name of the image file.ui: Exports one or multiple UI icons as PNG-images. The argument can either be the number of a single UI icon, or the first and last number for a range of icons seperated by a space. Valid numbers are in the interval [0, 999999].exd: Exports all or a specified number of game data sheets as CSV-files. Arguments can either be empty to export all files, or a list of sheet names seperated by whitespace.rawexd: Exports all or a specified number of game data sheets as CSV-files without post-processing applied. Arguments can either be empty to export all files, or a list of sheet names seperated by whitespace.bgm: Exports all sound files referenced in the BGM sheet as OGG-files.Godbert is a simple application to display game data and 3D models from Final Fantasy XIV using the above-mentioned library.