seanrobinson1114 / blizzconv

This project aims to provide functionality for converting different proprietary formats into modern formats with open specifications.

blizzconv

This project aims to provide functionality for converting different proprietary formats into modern formats with open specifications.

Supported formats

• cel
• cl2
• min
• til

Partially supported formats

• dun
• trn

Usage

The following steps can be taken to convert all CEL, CL2, MIN, TIL and DUN files to PNG images.

1. Install Go from a binary distribution or from source.

2. Configure the GOPATH environment variable.

    $ mkdir $HOME/go
    $ export GOPATH=$HOME/go
    $ export PATH=$PATH:$GOPATH/bin
   

3. Extract DIABDAT.MPQ using Ladislav Zezula's MPQ Editor. Make sure to convert the file names in the listfile to lower case.

4. Download and compile the mpqfix, img_dump, min_dump, til_dump and dun_dump commands by running:

    $ go get github.com/mewrnd/blizzconv/cmd/mpqfix
    $ go get github.com/mewrnd/blizzconv/images/cmd/img_dump
    $ go get github.com/mewrnd/blizzconv/configs/cmd/min_dump
    $ go get github.com/mewrnd/blizzconv/configs/cmd/til_dump
    $ go get github.com/mewrnd/blizzconv/configs/cmd/dun_dump
   

5. Set up the environment required by img_dump, min_dump, til_dump and dun_dump:

    $ mkdir dump
    $ cd dump
    $ ln -s /path/to/extracted/diabdat_mpq/ mpqdump
    $ ln -s $GOPATH/src/github.com/mewrnd/blizzconv/mpq/mpq.ini mpq.ini
    $ ln -s $GOPATH/src/github.com/mewrnd/blizzconv/images/imgconf/cel.ini cel.ini
    $ ln -s $GOPATH/src/github.com/mewrnd/blizzconv/images/imgconf/cl2.ini cl2.ini
    $ ln -s $GOPATH/src/github.com/mewrnd/blizzconv/configs/dunconf/dun.ini dun.ini
    # Fixes the two faulty files `unravw.cel` and `banner2.dun`.
    # ref: https://github.com/mewrnd/blizzconv/issues/2#issuecomment-58065868
    $ mpqfix
   

6. Convert all CEL images to PNG images. The following command creates 12045 PNG images (57 MB) and takes about 1m20s to complete on my computer.

    $ time img_dump -imgini=cel.ini -a
   

7. Convert all CL2 images to PNG images. The following command creates 373967 PNG images (1.8 GB) and takes about 1h45m to complete on my computer.

    $ time img_dump -imgini=cl2.ini -a
   

8. Convert all MIN files to PNG images. The following command creates 3286 PNG images (19 MB) and takes about 1m to complete on my computer.

    $ time min_dump l1.min l2.min l3.min l4.min town.min
   

9. Convert all TIL files to PNG images. The following command creates 1001 PNG images (14 MB) and takes about 40s to complete on my computer.

    $ time til_dump l1.til l2.til l3.til l4.til town.til
   

10. Convert all DUN files to PNG images. The following command creates 45 PNG images (62 MB) and takes about 4m20s to complete on my computer.

    $ time dun_dump -a
    

Public domain

The source code and any original content of this repository is hereby released into the public domain.