This repository contains a collection of Rust crates and cli tools to load, disassemble, decompile and analyze Hashlink bytecode.
![](/sig-a11y/hlbc/raw/master/crates/cli/screenshot.png)
![](/sig-a11y/hlbc/raw/master/crates/gui/screenshot.png)
Hashlink is a VM used as a compilation target for the Haxe language. Hashlink is successfully used to run popular games from developer Shiro Games like Northgard, Dune: Spice Wars and Wartales.
hlbc intends to help the motivated to develop mods and tools for those games.
Those games are packaged with the following model :
<game>.exe
: A very light executable that contains the Hashlink VMhlboot.dat
: The actual bytecode file Hashlink is configured to load on startup. This is the file you want to load in hlbc. It doesn't contain any game assets, this is just code.sdlboot.dat
: This is the same code, except it fallbacks to SDL.<lib>.hdll
: This is your average native code dll, except it can work with the VM.
data/
: Haxe source files to test the toolscrates/hlbc/
: Core library to load and disassemble bytecodecrates/cli/
: CLI frontend forhlbc
crates/decompiler/
: Decompiler librarycrates/derive/
: helper proc macros for hlbccrates/gui/
: GUI to explore bytecode visually
A wiki detailing the specifics of Hashlink bytecode is available here or by
using the command wiki
in the CLI.
- C API
Development of this project would not have been possible without the hashlink source code. Some algorithms are directly derived from the original C code reading bytecode files.