0.0.3 • Published 6 years ago

stormlib v0.0.3

Weekly downloads
3
License
ISC
Repository
github
Last release
6 years ago

JStormLib

NodeJS wrapper for StormLib. see(https://github.com/ladislav-zezula/StormLib).

I just use it to generate StarCraft1 maps, so no more options. Currently, just only working on windows.

Installation

You need to compile StormLib(ReleaseAS|x64) first.

You also need to install node-gyp(https://github.com/nodejs/node-gyp)

install Nan(https://github.com/nodejs/nan)

npm install

Build

node-gyp build

TODO

Support MacOSX, Linux

API

JStormLib.open

Open a MPQ archive, return a Promise.

JStormLib.open(filepath).then(arcive => {
    //archive.
}, err => {
    console.log(err)
});

JStormLib.create

Create a new MPQ archive.

JStormLib.create(filepath, flags, maxFileCount).then(arcive => {
    //archive.
}, err => {
    console.log(err)
});
NameTypeDescription
filepathstringArchive file name
flagsintAdditional flags to specify creation details. see CreateArchiveFlags
maxFileCountintLimit for file count
CreateArchiveFlags

Specifies additional flags for MPQ creation process. This parameter can be combination of the following flags:

ValueDescription
0x00100000The newly created archive will have (listfile) present.
0x00200000The newly created archive will have additional attributes in (attributes) file.
0x00400000The newly created archive will be signed with weak digital signature (the "(signature) file).
0x00000000The function creates a MPQ version 1.0 (up to 4 GB). This is the default value
0x01000000The function creates a MPQ version 2.0 (supports MPQ of size greater than 4 GB).
0x02000000The function creates a MPQ version 3.0 (introduced in WoW-Cataclysm Beta).
0x03000000The function creates a MPQ version 4.0 (used in WoW-Cataclysm).

StormArchive.getLocale

JStormLib.open(filepath).then(arcive => {
    archive.getLocale();
}, err => {
    console.log(err)
});

Returns current locale ID for adding new files

StormArchive.setLocale

archive.setLocale(lcid);

Changes default locale ID for adding new files

what is LCID?

StormArchive.getFileList

archive.getFileList();
// ['a.txt', 'b.txt]

get a list of all files in the current archive

StormArchive.readFile

archive.readFile(filename).then(fileBuffer => {
    //save the buffer;
}, err => {
    console.log(err);
})

read file data by the specified file name.

StormArchive.writeFile

archive.writeFile(buffer, filename, lcid, flags, compression).then(fileBuffer => {
    //save the buffer;
}, err => {
    console.log(err);
})

writes data to the archive.

NameTypeDescription
bufferBufferdata to be written
filenamestringfile name
lcidintlanguage Code Identifier
flagsintSee WriteFileFlags
compressionintSee Compression
WriteFileFlags

Specifies additional options about how to add the file to the MPQ. The value of this parameter can be a combination of the following values:

StarCraft1 Map(.scx, .scm) use 0x00010200

ValueDescription
0x00000100The file will be compressed using IMPLODE compression method.
0x00000200The file will be compressed
0x00010000The file will be stored as encrypted.
0x00020000The file's encryption key will be adjusted according to file size in the archive.
0x02000000The file will have the deletion marker.
0x04000000The file will have CRC for each file sector. Ignored if the file is not compressed or if the file is stored as single unit.
0x01000000The file will be added as single unit. Files stored as single unit cannot be encrypted, because Blizzard doesn't support them.
0x80000000If this flag is specified and the file is already in the MPQ, it will be replaced.
WriteFileCompression

Compression method of the first file block. This parameter is ignored if MPQ_FILE_COMPRESS is not specified in dwFlags. This parameter can be a combination of the following values:

StarCraft1 Map(.scx, .scm) use 0x08

ValueDescription
MPQ_COMPRESSION_HUFFMANN(0x01)Use Huffman compression. This bit can only be combined with MPQ_COMPRESSION_ADPCM_MONO or MPQ_COMPRESSION_ADPCM_STEREO.
MPQ_COMPRESSION_ZLIB (0x02)Use ZLIB compression library. This bit cannot be combined with MPQ_COMPRESSION_BZIP2 or MPQ_COMPRESSION_LZMA.
MPQ_COMPRESSION_PKWARE(0x08)Use Pkware Data Compression Library. This bit cannot be combined with MPQ_COMPRESSION_LZMA.
MPQ_COMPRESSION_BZIP2(0x10)Use BZIP2 compression library. This bit cannot be combined with MPQ_COMPRESSION_ZLIB or MPQ_COMPRESSION_LZMA.
MPQ_COMPRESSION_SPARSE(0x20)Use SPARSE compression. This bit cannot be combined with MPQ_COMPRESSION_LZMA.
MPQ_COMPRESSION_ADPCM_MONO(0x40)Use IMA ADPCM compression for 1-channel (mono) WAVE files. This bit can only be combined with MPQ_COMPRESSION_HUFFMANN. This is lossy compression and should only be used for compressing WAVE files.
MPQ_COMPRESSION_ADPCM_STEREO(0x80)Use IMA ADPCM compression for 2-channel (stereo) WAVE files. This bit can only be combined with MPQ_COMPRESSION_HUFFMANN. This is lossy compression and should only be used for compressing WAVE files.
MPQ_COMPRESSION_LZMA(0x12)Use LZMA compression. This value can not be combined with any other compression method.