# UGH!: a C++ port of the 1992 DOS game

> UGH! ports the 1992 DOS game routine by routine from analysis of UGH.EXE into C++23 and SDL 3. It reads graphics, levels and sound from the user's executable, models VGA Mode X behavior and ports the AdLib driver. Project guidance records use of a REA plugin with Ghidra during analysis.

- Type: Case study
- Targets: Game
- Category: Community REA investigations
- Relationship: Author-reported mixed workflow
- Sources reviewed: 2026-11-09
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/janroz/ugh-port>
- Primary source: <https://github.com/janroz/ugh-port/blob/73221a389385a0883423b74df7d5f3e92cfc305d/README.md>
- Catalog page: <https://awesomerea.org/resources/ugh-port-case/>
- Record JSON: <https://awesomerea.org/resources/ugh-port-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/ugh-port-case/index.md)

## Requirements & limits

- **Prerequisites:** Requires the specified DOS UGH.EXE build with the documented SHA-256 hash.
- **Prerequisites:** Building requires a C++23 compiler, CMake 3.28+, Ninja and SDL 3.2+; first configuration fetches Nuked-OPL3.
- **Limits:** Joysticks are not ported; Windows is untested.
- **License:** MIT licence for the port source.

## Primary sources

1. <https://github.com/janroz/ugh-port/blob/73221a389385a0883423b74df7d5f3e92cfc305d/README.md>
2. <https://github.com/janroz/ugh-port/blob/73221a389385a0883423b74df7d5f3e92cfc305d/CLAUDE.md>

## More in Games

- [Ultima IV: a matching Master System rebuild and PC port](https://awesomerea.org/resources/ultima-iv-sms-recompiled-case/index.md) · Case study
- [Uncharted Collection PC: running the PS4 trilogy on Windows](https://awesomerea.org/resources/uncharted-collection-zorde23-case/index.md) · Case study
- [Uncharted: The Nathan Drake Collection — a native Windows port of the PS4 games](https://awesomerea.org/resources/uncharted-nathan-drake-collection-supermedo-case/index.md) · Case study
- [unturned-godot: porting Unturned maps and gameplay to Godot](https://awesomerea.org/resources/unturned-godot-case/index.md) · Case study
- [Vagrant Story Native: a Windows source port of the PlayStation game](https://awesomerea.org/resources/vagrant-story-native-case/index.md) · Case study
- [Valiant Hearts Vita: rehosting the Android game on PS Vita](https://awesomerea.org/resources/valiant-hearts-vita-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.