VinceIP / fci-recomp

# fci-recomp
A native Windows port of **Far Cry Instincts** (2005, original Xbox), built by statically recompiling
the code from a disc image. Code is translated to C ahead of time and compiled into a Windows program, 
which runs alongside a reimplementation of the Xbox kernel, Direct3D and audio.
Note: this repository contains no original copyrighted game code, data, assets, or executables. An original
game disc is required for the recompilation to run.
### AI Use Disclosure
This project was made using extensive AI assistance and LLM-related tools. A human with a programming background is in the loop throughout development, and I review as much code and documentation as I can. Every effort has been made by me and my human brain to ensure the contents of this repository are of the highest quality, maintainability, and free of AI slop-isms. This project is the result of many long days of building, testing, researching, documenting, and debugging.
Regardless of your stance on AI in software development, it's my hope that this project brings value to fans of this game and to those who care about game preservation. This project will be an ongoing development effort. It is not a "one-shot", and not intended to be a quick and dirty, low-quality effort. Please feel free to raise an issue if you spot any aspects of this project that could be refactored, improved, or de-slopped.
## Status
**Version 0.1.2** - story mode and the map editor are fully functioning, as well as saving/loading custom maps
and story mode progress. Enhanced visual features powered by a DirectX 12 renderer are implemented.
Mouse and keyboard controls have been implemented and are customizable.
## Features
- Single player story mode as it was on the original Xbox.
- Modern visual enhancements via a modified version of Xbox XBE Recomp
tailored for Far Cry Instincts. Anisotropic filtering, anti-aliasing, screen-space ambient occlusion, scalable
internal rendering resolution, soft shadows, scalable sun shadow resolution, borderless fullscreen, increased 
draw distances, 16:9 widescreen, and more. Display & graphics options can be adjusted by modifying fci.ini.
- Map editor mode included as an optional feature. It can be built alongside the main game or omitted for those who
aren't interested in making custom maps.
- Mouse and keyboard support. Keybinds and mouse settings can be adjusted by modifying fci.ini.
## Requirements
- Windows 10 or 11 64-bit, and a GPU that supports Direct3D 12
- About 10 GB of free space
- An internet connection, or access to Git, Python, Windows SDK, and MSVC
- A dump of your own Far Cry Instincts disc (original Xbox, title ID `55530008`, version 1),
as an ISO or extracted files
## Setup
1. Download the zip of the latest release and extract.
2. Drag your disc image (or the folder with the disc's files) onto `BuildGame.cmd`.
3. Wait for it to finish: expect 15-25 minutes depending on your hardware, plus downloads for required
Python and SDK runtimes. You may be