blizzardry

Blizzardry

JavaScript library for mastering the wizardry that is Blizzard's game files.

Licensed under the MIT license, see LICENSE for more information.

Installation

Blizzardry is available via npm:

npm install blizzardry

Or for usage in the browser, soon™.

Usage

ADT

Usage coming soon.

BLP

Texture format holding up to 16 pre-rendered mipmaps.

Blizzardry uses BLPConverter to process BLPs, which on OSX can be installed using Homebrew:

brew install https://raw.githubusercontent.com/timkurvers/homebrew-games/formula/blp-converter/blp-converter.rb

For all other platforms, compile from source and ensure the library ends up on the load path.

BLP.open('RabbitSkin.blp', function(blp) {
  blp.version     // 2
  blp.mipmapCount // 8

  blp.largest.width  // 128
  blp.largest.height // 128
  blp.largest.data   // <Buffer a2 a2 a2 dd a2 ...>

  blp.smallest.width  // 1
  blp.smallest.height // 1
  blp.smallest.data   // <Buffer 7e 98 af ee>

  // Or directly:

  blp.mipmaps[3].width  // 16
  blp.mipmaps[3].height // 16
});

// Or alternatively:

blp = BLP.open('RabbitSkin.blp')
// ...
blp.close()

DBC

Usage coming soon.

M2

Usage coming soon.

MPQ

Generic archive format, used in most Blizzard games.

Blizzardry uses StormLib to handle MPQ archives, which on OSX can be installed using Homebrew:

brew install https://raw.githubusercontent.com/timkurvers/homebrew-games/formula/storm-lib/storm-lib.rb

For all other platforms, compile from source and ensure the library ends up on the load path.

Usage coming soon.

WDT

Usage coming soon.

Changelog

v0.1.0 - January 7, 2015

• MPQ.Files#extract allows extracting files easily.
• Newly supported formats: ADT, BLP, DBC, M2 and WDT.