Crate assembly_fdb

The database (*.fdb) file format used for the core database (CDClient)

Among the resource files distributed with the LEGO® Universe game client is a copy of the core database. This database includes information on all zones, objects, components, behaviors, items, loot, currency, missions, scripts, …

This (unpacked) name of this file is /res/CDClient.fdb. The file uses a custom database format which is essentially a sorted list of hash maps.

Terminology

• Database: The whole file, a collection of tables
• Table: A collection of rows, implemented as an array of buckets
• Column: A name and default type for the fields in every row
• Bucket: A linked-list of rows for one value of the primary-key hash
• Row: A list of fields, corresponding to the columns of the table definition
• Field: A value with a type marker

File format

The file format is constructed from a bunch of structs made out of 32-bit words that may reference other structs by offset from the start of the file. These structs form a tree without circular references.

These basic structs are implemented in the assembly_fdb_core crate.

Using this library

You can use the mem module to load a database from an in-memory buffer:

use assembly_fdb::mem::Database;

let file: &[u8] = &[0,0,0,0,8,0,0,0];
let db = Database::new(file);
let tables = db.tables().unwrap();

assert_eq!(0, tables.len());

Modules

• core
  The data structures for representing the file/database.
• file
  The structures, as they are serialized
• io
  Code for use with std::io::{Read, Write}
• mem
  Low-Level API that is suitable for non-little-endian machines
• query
  Query the database
• ro
  Read-Only low level access to a database file
• sqlite
  SQLite conversions and tooling
• store
  Arena-Store & Writer
• value
  Types that are common to most FDB-APIs

Traits

• FdbHash
  This trait is implemented on all types that represent a field value