Star on GitHubStar2.4k stars

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
Copy as MarkdownView JSONCite

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.

Report an outdated entry Suggest a translation fix

Primary sources

  1. https://gitlab.com/bwrsandman/blackhack/-/blob/d4f2a517f52d174cf5429b304797d01c3221e1b6/README.md
  2. https://gitlab.com/bwrsandman/blackhack/-/blob/d4f2a517f52d174cf5429b304797d01c3221e1b6/launcher.c
  3. https://gitlab.com/bwrsandman/blackhack/-/blob/d4f2a517f52d174cf5429b304797d01c3221e1b6/Libs/SetupThing/src/SetupButton.cpp
  4. https://gitlab.com/bwrsandman/blackhack/-/blob/d4f2a517f52d174cf5429b304797d01c3221e1b6/src/Game.h

More in Games

All 2975 entries in GamesGames case studies (2831)

↑↓ move↵ open⌘↵ new tab