https://github.com/wowserhq/stormjs
StormLib for Javascript, powered by Emscripten
https://github.com/wowserhq/stormjs
mpq stormlib wow wowser
Last synced: 3 months ago
JSON representation
StormLib for Javascript, powered by Emscripten
- Host: GitHub
- URL: https://github.com/wowserhq/stormjs
- Owner: wowserhq
- License: mit
- Created: 2018-01-06T16:58:05.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2020-05-27T06:17:50.000Z (over 5 years ago)
- Last Synced: 2025-05-22T20:21:56.759Z (5 months ago)
- Topics: mpq, stormlib, wow, wowser
- Language: JavaScript
- Homepage:
- Size: 985 KB
- Stars: 16
- Watchers: 3
- Forks: 9
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
# StormJS
[](https://discord.gg/DeVVKVg)
[](https://www.npmjs.org/package/@wowserhq/stormjs)
[](LICENSE)
[](https://github.com/wowserhq/math/actions?query=workflow%3ACI)
[](https://codecov.io/gh/wowserhq/stormjs)
StormJS is [StormLib](http://www.zezula.net/en/mpq/stormlib.html) for Javascript, powered by
[Emscripten](http://emscripten.org).
[StormLib](http://www.zezula.net/en/mpq/stormlib.html) is copyright © Ladislav Zezula. It is
licensed under the [**MIT** license](https://github.com/ladislav-zezula/StormLib/blob/master/LICENSE).
See `src/vendor/StormLib/LICENSE` for more information.
## Usage
To install StormJS:
```sh
npm install @wowserhq/stormjs
```
To use StormJS in an ES2015 module environment:
```js
import { FS, MPQ } from '@wowserhq/stormjs';
// Mount the local filesystem path /home/wowserhq/example as /stormjs
// This approach is suitable for cases where StormJS is running under Node
FS.mkdir('/stormjs');
FS.mount(FS.filesystems.NODEFS, { root: '/home/wowserhq/example' }, '/stormjs');
const mpq = await MPQ.open('/stormjs/example.mpq', 'r');
const file = base.openFile('example.txt');
const data = file.read();
// Clean up
file.close();
mpq.close();
```
Note that StormJS loads in production mode if `NODE_ENV` is set to `production`. In all other cases, StormJS loads in debug mode.
## Compatibility
StormJS is tested against Node 10, 12, and 14.
Additionally, StormJS should work well in browsers with support for WASM. Note that use in browsers will require configuring an Emscripten filesystem type appropriate for the browser.
## Development
Development of StormJS requires git, CMake, and an Emscripten environment.
[emsdk](https://github.com/juj/emsdk) is the simplest way to get an Emscripten environment up and running.
StormJS is currently built using Emscripten 1.39.15.
After cloning the StormJS repo, ensure all submodules are also pulled down from remote by running:
```sh
git submodule update --init --recursive
```
To build StormJS after making changes locally, run:
```sh
npm run build
```
The test suites for StormJS can be run using:
```sh
npm run test
```