Skip to content

kaldown/db2-parser

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

db2-parser

License: All Rights Reserved

WoW DB2 data fetcher for crafting-related tables from wago.tools.

Overview

Downloads raw DB2 CSV files from wago.tools and stores them in versioned directories. Designed to be used as a git submodule by consuming projects (like CraftLib).

Adding as Submodule

cd your-project
git submodule add <repo-url> vendor/db2-parser
git submodule update --init --recursive

Usage

Fetch Specific Version

make -C vendor/db2-parser fetch VERSION=2.5.5.65463

Fetch Latest for Expansion

# 2 = TBC, 3 = WotLK, 4 = Cata, etc.
make -C vendor/db2-parser latest EXPANSION=2

Validate Schema

make -C vendor/db2-parser validate VERSION=2.5.5.65463

Clean Artifacts

make -C vendor/db2-parser clean

Data Location

After fetching, CSVs are at:

vendor/db2-parser/artifacts/{version}/{Table}.csv

Example:

vendor/db2-parser/artifacts/2.5.5.65463/Spell.csv
vendor/db2-parser/artifacts/2.5.5.65463/SpellName.csv
vendor/db2-parser/artifacts/2.5.5.65463/Item.csv
...

Available Tables

Table Description
Spell Spell descriptions and subtexts
SpellName Spell/recipe display names
Item Core item properties
ItemSparse Extended item data with names
ItemEffect Recipe item to spell mapping
SkillLine Profession metadata
SkillLineAbility Recipe-to-profession mapping
SpellReagents Crafting reagent requirements
SpellEffect Spell effects (crafted items, yields)
Faction Faction names for reputation vendors

Schema Documentation

See schema/{Table}.md for column definitions and relationships.

Known Limitations

Recipe Difficulty (SkillLineAbility)

DB2 does not contain the orange difficulty value (skill required to learn):

Difficulty DB2 Field Available
Orange (not stored)
Yellow TrivialSkillLineRankLow
Green (not stored)
Gray TrivialSkillLineRankHigh

The MinSkillLineRank field is often 1 for all recipes and cannot be relied upon.

Solution: Consuming projects must fetch difficulty from Wowhead. See schema/SkillLineAbility.md for details.

Expansion Version Mapping

Major Version Expansion
1.x Classic Era (Vanilla)
2.x TBC
3.x WotLK
4.x Cataclysm
5.x MoP

Requirements

  • Python 3.10+
  • No external dependencies (stdlib only)

License

All Rights Reserved - See LICENSE for details.

About

WoW DB2 data fetcher for crafting-related tables from wago.tools and WowHead.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors