wow-cdbc

Parser for World of Warcraft DBC (client database) files.

Features

🔍 Parse DBC files with runtime schema definition
📊 Type-safe field access with proper value types
🔤 Efficient string block handling with caching support
🗂️ Indexed lookups by key field for fast access
🔬 Schema discovery for unknown DBC formats
📝 DBD (Database Definition) file support for WoWDBDefs compatibility
🚀 Lazy loading support for large files
🛠️ Export to common formats (CSV, JSON, YAML)

Installation

Add to your Cargo.toml:

[dependencies]
wow-cdbc = "0.3.0"

Or use cargo add:

cargo add wow-cdbc

Usage

use wow_cdbc::{DbcParser, Schema, SchemaField, FieldType};

// Define a schema for the Map.dbc file
let mut schema = Schema::new("Map");
schema.add_field(SchemaField::new("ID", FieldType::UInt32));
schema.add_field(SchemaField::new("Directory", FieldType::String));
schema.add_field(SchemaField::new("InstanceType", FieldType::UInt32));
schema.add_field(SchemaField::new("Flags", FieldType::UInt32));
schema.add_field(SchemaField::new("MapType", FieldType::UInt32));
schema.add_field(SchemaField::new("MapName", FieldType::String));
schema.set_key_field("ID");

// Parse the DBC file
let data = std::fs::read("Map.dbc")?;
let parser = DbcParser::parse_bytes(&data)?
    .with_schema(schema)?;

let records = parser.parse_records()?;

// Access records by index
if let Some(record) = records.get_record(0) {
    if let Some(name) = record.get_value_by_name("MapName") {
        println!("Map name: {}", name);
    }
}

// Or lookup by key
if let Some(record) = records.get_record_by_key(0) {  // Eastern Kingdoms
    println!("Found map: {:?}", record);
}

Supported Versions

✅ Classic (1.12.1) - WDBC format
✅ The Burning Crusade (2.4.3) - WDBC format
✅ Wrath of the Lich King (3.3.5a) - WDBC format
✅ Cataclysm (4.3.4) - WDBC format
✅ Mists of Pandaria (5.4.8) - WDB2/WDB5 formats

DBD Support

This crate supports WoWDBDefs Database Definition files for automatic schema generation. DBD files provide community-maintained schema definitions for various WoW versions.

use wow_cdbc::dbd::parse_dbd_file;

// Parse a DBD file
let dbd = parse_dbd_file("definitions/Map.dbd")?;

// Convert to schemas for different versions
let schemas = convert_to_yaml_schemas(&dbd, "Map", Some("3.3.5"), false);

Tools

The crate includes several command-line tools:

dbc_tool - Info, list, export, and validate DBC files
dbc_schema_discovery_tool - Analyze DBC files to discover their schema
dbd_to_yaml - Convert DBD definition files to YAML schemas

License

Licensed under either of

Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

wow-cdbc 0.3.1