wolftools is a command line tool for WOLF RPG Editor games. It can check game files, unpack supported archives, pack folders into archives, and create a website with Browser Woditor.
Use wolftools only with games you own or have permission to work with.
inspectshows the game version and archive details it can detect.unpackextracts archive files into a new folder.packcreates archives from folders.modesshows all supported pack modes.webcreates a Browser Woditor website.servestarts a local web server for testing/playing.
wolftools needs Node.js 22 or newer and pnpm 10 or newer.
Install dependencies:
pnpm installMake the wolftools command available on your computer:
pnpm link -gUse --help to see available commands and --version to check the installed
wolftools version.
wolftools --help
wolftools --versionThe short forms are -h and -v.
Check a game folder, Game.exe, GamePro.exe, or an archive:
wolftools inspect "/path/to/Game"The report shows the versions, archive types, and encryption modes it can detect. It also shows whether wolftools supports the archive format.
By default, web creates a new folder and does not change the original game:
wolftools web "/path/to/Game" --out "./output/Web Game"The default is --separate true. If you omit --out (-o), the tool adds
web to the game folder's name.
wolftools finds Game.exe or GamePro.exe and extracts supported archives.
It accepts a game with a Data/ folder or a Data.wolf archive.
For exports with unpacked assets, wolftools puts existing files named by literal
GET_FILE_EXIST checks into the browser's startup Data.wolf. Paths assembled at runtime or stored in
encrypted event data may need to be packed manually.
If Game.ini is missing, the tool creates a default one for the website.
When a requested font is missing, the exporter automatically tries to download it. Downloads and licenses are
checked against SHA-256 hashes and cached under ~/.cache/wolftools/fonts/ for
reuse across games. The export bundles the font, registers its internal names in
FontList.ini, and includes its license under assets/font-licenses/.
Supported families and variants:
| Family | Variants |
|---|---|
| ロゴたいぷゴシック Condense | 07ロゴたいぷゴシックCondense |
| ねむけ | NemukeMedium |
| 梅ゴシック | 梅ゴシック, |
| IPA明朝・ゴシック | IPA明朝, IPAゴシック, IPA P明朝, IPA Pゴシック |
| IPAex明朝・ゴシック | IPAex明朝, IPAexゴシック |
| 刻明朝 | 刻明朝 Regular |
| やさしさアンチック | 07やさしさアンチック |
| やさしさゴシック | Original Regular/Bold (07… names), legacy OpenType names, and やさしさゴシックボールドV2 |
| 源暎ラテゴ・ラテミン | Original and v2 families, including 源暎ラテゴ 詰 v2, 源暎ラテミン 詰 v2 |
Use --separate false or -s false to keep the Windows EXE and website in the
same game folder.
wolftools web "/path/to/Game" --separate false
wolftools serve "/path/to/Game"This adds a web/ folder. The EXE and browser both use the existing Data/
folder. If you pass --out in when --separate false, it must point to the game's
web/ folder.
Combined mode needs unpacked archives in Data/. If the game still uses archives,
wolftools asks if you want to extract them. The default answer is no.
If you answer yes, wolftools extracts the files into the original game folder and removes the packed archives. This changes the original game. It may break some games, especially Pro games and games with custom protection. Make a backup before you agree. Automatic extraction stops if it would overwrite an existing file or folder.
Use --migrate to update an existing export in place.
wolftools web "/path/to/Web Game" --migrateFor a combined export, pass either the game folder or its web/ folder:
wolftools web "/path/to/Game" --migrateExisting browser saves remain accessible in the same browser profile at the same website origin (protocol, hostname and port) and page path.
See update detail here
The default version is 0.6.3.0. Supported pins are 0.6.3.0, 0.6.2.0, and
0.4.1.0. Use --runtime-version when a game needs a specific version:
wolftools web "/path/to/Game" --separate false --runtime-version 0.4.1.0
wolftools web "/path/to/Existing Game" --migrate --runtime-version 0.4.1.0Future migrations keep an export's pin. To clear it and install the tool's
default version, use --migrate --runtime-version default.
Switching to or from 0.4.1.0 replaces the runtime's HTML template and applies
the wolftools layout and asset loader to the new template. Keep a copy of any
custom changes to index.html. The export keeps its browser save identity.
An older engine may be unable to read a save created by a newer engine.
New wolftools exports using 0.4.1.0 fetch and decode eligible loose audio
asynchronously. Run --migrate to update the loader on an older export pinned
to 0.4.1.0.
Pass --runtime (-r) to use a local copy of the selected version's ZIP.
wolftools verifies its checksum.
wolftools web "/path/to/Existing Game" --migrate --runtime-version 0.4.1.0 --runtime "/path/to/BrowserWoditor_0_4_1_0.zip"For a web export:
wolftools serve "./output/Web Game"The server prints the link to open and uses port 4177 by default. Use
--port (-p) to choose a different port.
Click or tap the game screen once to let the browser start audio and the game.
Unpack one archive:
wolftools unpack "/path/to/BasicData.wolf" --out "./output/BasicData"Unpack the archives found through a game executable:
wolftools unpack "/path/to/Game.exe" -o "./output/Unpacked Game"If you omit --out, wolftools creates a sibling folder named after the input
with unpacked appended.
These standard WOLF archive formats are supported. This table does not mean that Pro packing is supported.
| Standard editor family | Archive format | Pack | Unpack |
|---|---|---|---|
| 2.00-2.10 | DX5 | Yes | Yes |
| 2.20 | DX6 | Yes | Yes |
| 2.225-2.296 | DX8 classic | Yes | Yes |
| 3.00-3.139 | DX8 classic | Yes | Yes |
| 3.14-3.30 | DX8 classic | Yes | Yes |
| 3.31-3.49 | DX8 modern encryption | Yes | Yes |
| 3.50+ archive family | DX8 modern encryption | Yes | Yes |
| ChaCha2 variants | DX8 ChaCha20 encryption | Yes | Yes |
Support includes encrypted archive tables, file keys, LZ compression, Huffman compression, and partial Huffman compression.
Pro archives need their matching key archive beside them. wolftools supports
legacy Pro, Pro ChaCha2, and supported Pro 3.x key formats. You can pass a game
folder, GamePro.exe, or a data archive with its key file nearby. Common key
archive names include Game, List, Data2, GameFile, and BasicData2.
Pro archive packing is not available. wolftools can unpack the archive layer of supported Pro releases when the matching key archive is present. It cannot remove separate protection from files stored inside a Pro archive. A custom or new Pro format may not work.
Pack one folder into one archive:
wolftools pack "/path/to/BasicData" --out "./output/BasicData.wolf"Choose another pack mode with --mode (-m). Run wolftools modes to list
supported modes.
wolftools pack "/path/to/BasicData" --mode 3.50Pack the folders inside a game's Data/ folder:
wolftools pack "/path/to/Game Project"For a standard game folder, the tool needs Game.exe and a Data/ folder with
subfolders. It makes one archive for each subfolder. The original game is not
changed. wolftools reads the editor version from Game.exe and chooses the
matching pack mode when possible. If the version cannot be read, it uses
2.20. A plain folder without Game.exe also uses 2.20 unless you give a
mode. If you omit --out, a plain folder produces a sibling .wolf archive
and a game project produces a sibling folder with packed appended.
Packing a Pro game is not supported. The tool stops if the game uses
GamePro.exe.
Game files stay on your computer. wolftools does not upload them.
Browser Woditor is a separate project with its own license and usage rules. Its runtime files are not included in this repository.
- This is an unofficial player for user provided web game exports. It is not affiliated with or endorsed by SmokingWOLF.
- This project is a work in progress. The source code structure, features, and supported formats may change over time. The approach to privacy will remain unchanged.
2026.11.19.2: Marks UTF-8 font lists with a BOM so Japanese font names are recognized.2026.11.19.1: Fetches the asset manifest and startup preloads asynchronously, loads preloads concurrently.2026.11.19: Adds a new font migration for fonts bundled inside standaloneData.wolfweb ports and individual faces from.ttcand.otccollections.2026.11.18.2: Registers supplied TrueType and OpenType fonts by name in Browser Woditor'sFontList.ini.2026.11.18.1: Makes asset directories visible to Browser Woditor before their files are loaded.2026.11.18: Preserves the original bytes of assets with a Unicode byte-order mark in browser exports.2026.11.17.4: Packs assets found by literalGET_FILE_EXISTchecks into the browser startup archive.2026.11.17.3: Enables asynchronous audio loading on Browser Woditor 0.4.1.0.2026.11.17.2: Supports selecting and retaining a Browser Woditor version.2026.11.17.1: Updates Browser Woditor to 0.6.3.0.2026.11.17: Keeps the canvas at native size or smaller in a normal window.2026.11.04: Fix Chromium MP3 loading failures with asynchronous.