Case study
blackhack: runblack.exe UI widget decompilation
blackhack rebuilds the SetupControl UI widget classes of runblack.exe as hand-decompiled C, covering buttons, big and tab buttons, check boxes, lists, sliders, edit fields, colour pickers, pictures and graph widgets, along with parts of Lionhead's lhlib. A Detours launcher checks the executable's md5, injects a DLL and swaps original functions for the rebuilt ones through per-version tables of function and data addresses. It also patches the fullscreen setter so runblack.exe always runs windowed.
- Targets
- Binary · Game
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
Requirements & limits
- Prerequisites: Requires runblack.exe version 1.41 with the no-CD patch (md5 174b1a64e74b2321f3c38ccc8a511e78); other versions need new function and global address tables.
- Prerequisites: Builds with CMake 3.14 or later and the Detours library.
- Limits: The SetupControl implementation is almost complete.
- License: No licence file in the repository.
Cite
BibTeX
@misc{blackhack-case,
title = {{blackhack: runblack.exe UI widget decompilation}},
howpublished = {\url{https://gitlab.com/bwrsandman/blackhack}},
url = {https://gitlab.com/bwrsandman/blackhack},
urldate = {2026-11-09},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/blackhack-case/}}
}Plain text
blackhack: runblack.exe UI widget decompilation. https://gitlab.com/bwrsandman/blackhack (accessed 2026-11-09). Awesome REA entry: https://awesomerea.org/resources/blackhack-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- https://gitlab.com/bwrsandman/blackhack/-/blob/d4f2a517f52d174cf5429b304797d01c3221e1b6/README.md
- https://gitlab.com/bwrsandman/blackhack/-/blob/d4f2a517f52d174cf5429b304797d01c3221e1b6/launcher.c
- https://gitlab.com/bwrsandman/blackhack/-/blob/d4f2a517f52d174cf5429b304797d01c3221e1b6/Libs/SetupThing/src/SetupButton.cpp
- https://gitlab.com/bwrsandman/blackhack/-/blob/d4f2a517f52d174cf5429b304797d01c3221e1b6/src/Game.h
More in Games
- Blast Corps: Nintendo 64 decompilation · Case study
- Blitz_MasterVer22-Decomp: a Splatoon 2 version 3.1.0 decompilation · Case study
- Blood Omen 2: functional decompilation toward a Switch port · Case study
- Boku Doraemon: Dreamcast executable and model reconstruction · Case study
- Bomberman 64: The Second Attack!: partial N64 decompilation · Case study
- Boom Street: a Wii decompilation in progress · Case study