$ show hedge-dev/UnleashedRecomp
UnleashedRecomp is a PC port of *Sonic Unleashed* (Xbox 360) achieved through static recompilation. It replaces the original console's kernel, GPU, audio, and input APIs with native implementations, then applies a large set of behavioral patches to the recompiled game code for modern PC features like high resolutions, high frame rates, ultrawide support, and configurable controls. The application includes a full installer that extracts and validates game files from an ISO or directory dump, a custom achievement system, mod loading compatible with existing mod managers, and an ImGui-based UI for settings, achievements, and the installation wizard. The architecture is monolithic but modular: the kernel layer (memory, threading, file I/O) is separated from the GPU backend (with dedicated render thread), audio system, input handling, and OS abstraction for Windows, Linux, and macOS. The project relies on proprietary recompiled code (UnleashedRecompLib) and the original game assets, which are not distributed. The codebase demonstrates high engineering craftsmanship in areas such as deterministic memory allocation, virtual file systems, configuration templates, and cross-platform build orchestration, though it contains hardcoded game-specific addresses and auto-generated data that limit extensibility to other titles.
The LLM identified 5 files worth highlighting for reuse:
Provides a pure abstract interface for file system loading (load, getSize, exists). Concrete implementations exist for ISO, XContent, and directory sources. This is a clean, self-contained abstraction that can be extracted to any project requiring polymorphic file access.
A standalone, deterministic memory allocator with O(1) worst-case allocation/deallocation. Uses a Treap data structure for free-list management. Ideal for real-time or predictable-memory systems; fully extractable with no internal dependencies.
Defines a generic ConfigDef template that maps configuration keys to typed values, supports TOML serialization/deserialization, locale-dependent display strings, callbacks on value changes, and enum templates for selection lists. This is a well-crafted, reusable config system that could power settings in any C++ application.
A reusable UI component that displays controller/keyboard button prompts using ImGui. It maps logical actions (e.g., 'Confirm', 'Cancel') to the correct physical button label based on the current input device. Fully self-contained and easily extracted for any project needing dynamic button guides.
A custom open-addressing hash map implementation with power-of-two sizing, likely using XXH64 for hashing. Offers fast lookups and is used extensively in the GPU pipeline cache. While tightly tuned for the project's use case, the pattern itself is a clean, non-STL hash map that can be extracted for performance-critical scenarios.