# Def Jam: Fight for NY — Recompiled [![CI](https://github.com/vyanhursky/DefJamFFNY-recomp/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/vyanhursky/DefJamFFNY-recomp/actions/workflows/ci.yml) [![Release](https://img.shields.io/github/v/release/vyanhursky/DefJamFFNY-recomp)](https://github.com/vyanhursky/DefJamFFNY-recomp/releases) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) [![Discord](https://img.shields.io/badge/Discord-Join%20the%20community-5865F2?logo=discord&logoColor=white)](https://discord.gg/xNvBs23ZBw) Bring **Def Jam: Fight for NY** to Windows, macOS and Linux, including the Steam Deck. This unofficial native port recompiles the original Xbox game for your computer, with higher rendering resolution, modern controller support, extensive mod support, and other PC-specific enhancements. **This is the definitive port of the game.** All game functionality is working and we are continuously optimizing, enhancing, and bugfixing based on player feedback. The project's roadmap now focuses on expanding game moddability, gameplay, and presentation. You need **your own supported USA Xbox dump**. Setup checks your dump and builds the game on your machine. PS2 and GameCube copies cannot be used. **[Get the latest installer for your platform](https://github.com/vyanhursky/DefJamFFNY-recomp/releases/latest)** · [Install guide](docs/setup-installer.md) · [Documentation](docs/README.md) · [Report a problem](https://github.com/vyanhursky/DefJamFFNY-recomp/issues/new/choose) · [Join the Discord](https://discord.gg/xNvBs23ZBw) **v1.0.0 release candidate:** the integrated app, graphics, cheats and compatibility changes are on [`release/v1.0.0`](https://github.com/vyanhursky/DefJamFFNY-recomp/tree/release/v1.0.0), awaiting three-platform regression and install/play-test acceptance. See the [candidate test instructions](docs/regression-v1.0.0.md). **[v0.13.0 — Language, audio and controller input](https://github.com/vyanhursky/DefJamFFNY-recomp/releases/tag/v0.13.0)** adds language mods, the game's French interface, English Story subtitles, audio heap fixes and ordered controller transitions. It is the latest stable release. See the [release notes](docs/releases/v0.13.0.md) for cross-platform regression qualifications and the memory-growth investigation. [v0.12.3](https://github.com/vyanhursky/DefJamFFNY-recomp/releases/tag/v0.12.3) improved fight pacing and C++20 setup compatibility; earlier releases added Mod Support Beta, display options and platform fixes. ## Gameplay ![Blaze and Doc face-off: original 4:3 framing versus wider 16:9, with faithful HD textures on both sides](docs/media/widescreen-comparison.png) **4:3 versus 16:9 widescreen:** the same fight moment, with faithful HD textures and native macOS rendering at 2× scale. The wider view reveals more of the arena while keeping the fighters and HUD in proportion. ![Three-second fight preview showing strikes and a knockdown](docs/media/gameplay-preview-compact.gif) Silent three-second preview exported at 20 fps; its cadence is not a game performance measurement. [Download the longer 60-fps MP4](docs/media/hd-16x9-gameplay.mp4). **[Compare 4:3 and widescreen, original and HD textures, and see the launcher and overlay](docs/media/README.md)** ## Launcher ![New launcher Home screen with quick display settings and Advanced, Mods, logs, folder and Update / Repair buttons](docs/media/launcher.png) **Improved Game Launcher (v0.10.6)** brings a focused Home screen, with detailed options in [Advanced settings](docs/launcher-and-overlay.md). The brickwork and torn-paper style uses the game's charcoal, ivory, red and gold palette. [Get the latest setup](https://github.com/vyanhursky/DefJamFFNY-recomp/releases/latest). ## Features - **Native across three platforms.** Windows x64 uses Direct3D 11; Apple Silicon Macs and x86-64 Linux use Vulkan. Steam Deck runs the Linux version natively. - **60-fps gameplay.** The port targets 60 frames per second, with performance depending on your hardware, chosen settings and the scene. Steam Deck hits steady 60FPS in all game modes at 2x render resolution and all HD texture mods enabled. - **Sharper rendering.** Choose 1×–4× internal resolution, a resizable window or borderless full screen. - **Widescreen.** Windows, macOS and Linux/Steam Deck support traditional 16:9 and 16:10 ratios, as well as ultrawide up to 32:9. Download HD Widescreen Menus Mod from the game launcher to transform every menu and background to support widescreen ratios. - **Create HD textures locally.** Setup can generate faithful 4× texture packs from your dump on Windows, macOS and Linux using a local upscaling model. Further restored textures can be downloaded via mod support. - **Controllers and keyboard play.** Xbox, DualSense, Switch Pro and other supported gamepads, with remapping, hot-plug and rumble. Keyboard and mouse buttons can supply gameplay bindings; the launcher and settings support a pointer. - **Up to four local players.** Play with gamepads and a keyboard player. Network multiplayer is not supported. - **Settings before and during play.** The launcher has a focused Home screen, Advanced settings and direct Mods/files/logs/setup actions. Open the in-game overlay with F1 or a configured controller shortcut. - **EA's developer menu, restored.** The game's own debug menu, cut off in the retail build, opens from the overlay (Diagnostics tab): set up any match with any fighters, venue and match type, play any Story scene, or look at a venue in the stage viewer. See [The developer menu](docs/developer-menu.md). ## Get started 1. Have your own USA Xbox disc image or extracted dump matching the [supported dump manifest](config/dump-manifest.json). 2. Download the setup for your platform from the [latest release](https://github.com/vyanhursky/DefJamFFNY-recomp/releases/latest). 3. Choose your dump, install folder and data folder. Enable HD texture generation if you want it, then let setup verify, recompile and build the game. 4. Open the launcher, choose your display and input settings, and select **Play**. | Platform | Setup download | Guide | |---|---|---| | Windows x64 | `DefJamSetup--windows-x64.exe` | [Windows setup](docs/setup-installer.md) | | macOS, Apple Silicon | `DefJamSetup--macos-arm64.dmg` | [macOS setup](docs/setup-installer.md#macos-setup-apple-silicon) | | Linux x86-64 / Steam Deck | `DefJamSetup--linux-x64.tar.gz` | [Linux setup](docs/setup-installer.md#linux-setup) | Setup builds from your dump rather than downloading a precompiled game. The [install guide](docs/setup-installer.md) covers platform requirements, unsigned-app prompts, disk space, updates and repairs. HD generation needs additional disk space and install time. Prefer a manual source build? Use [Build and play](docs/build-and-play.md) for Windows or [Build on macOS and Linux](docs/build-macos-linux.md). ## Customize your game Use the launcher or F1 overlay to change display settings, controls and texture packs. The same options are stored in `settings.ini` in your data folder. - [Launcher and overlay](docs/launcher-and-overlay.md) - [Controllers, keyboard and mouse](docs/10-input.md) - [Settings reference](docs/settings-reference.md) - [Texture Modding — Getting Started](docs/texture-modding-getting-started.md) - [HD texture packs: generate, install and enable](docs/hd-textures.md) ### Texture packs and mod support **Available now:** local texture replacement packs, including Recomp HD generated by setup, and reviewed catalogue downloads such as HD Widescreen Menus. Enable packs and set their priority through the launcher's Mods page. Want to make a pack? Start with **[Texture Modding — Getting Started](docs/texture-modding-getting-started.md)**: find an original texture, edit it, write a manifest, test the result and share it. The [format reference](docs/hd-textures.md) and [mod-manager reference](docs/mod-manager.md) cover the technical details. Broader data/code overrides remain a [design proposal](docs/research/mod-system-design.md). Language mods have a separate, released [delta format](docs/language-packs.md). New fighters, stages, music replacements and code/gameplay mods are not released modding capabilities. ## Where the project is heading The project aims to preserve the original game's experience while making it easier to play and customize on modern computers. | Direction | Goal and current stage | |---|---| | Engine optimizations | Improve performance on low-spec machines, stay up to date with [xboxrecomp](https://github.com/sp00nznet/xboxrecomp), and contribute improvements upstream. | | Port accuracy | Keep the visuals, tone and gameplay feel faithful to the original Xbox game. | | Fully unlocked frame rates | Support frame rates above 60 fps while preserving game speed, timing and gameplay feel. Future work; not supported by the current release. | | Widescreen refinement | Beta released in [v0.9.0](https://github.com/vyanhursky/DefJamFFNY-recomp/releases/tag/v0.9.0) on Windows, macOS and Linux/Steam Deck. Improve edge cases and broader aspect/venue coverage; 21:9 and 32:9 remain experimental. | | Broader mod support | Enable modified game modes, difficulty changes and restored cut content. The [mod-system design](docs/research/mod-system-design.md) is not scheduled; texture packs work today. | | Build and release automation | Improve automation and the gameplay test harness so shipping builds have reliable, repeatable validation. | | Deeper gameplay decompilation | Long-term stretch goal. | These are directions, not promised release dates. [GitHub Issues](https://github.com/vyanhursky/DefJamFFNY-recomp/issues), [milestones](https://github.com/vyanhursky/DefJamFFNY-recomp/milestones) and [open PRs](https://github.com/vyanhursky/DefJamFFNY-recomp/pulls) track concrete work. The unified-app and graphics PRs are proposals/in progress, not released capabilities. ## Compatibility and known limits The released build targets Windows x64, Apple Silicon macOS and x86-64 Linux. Steam Deck has automated regression coverage and maintainer playtesting; Proton is untested. Performance varies with hardware, settings and scenes. Release-specific test qualifications are recorded with the release; open reports and follow-up work are tracked in GitHub Issues. Check both [GitHub Issues](https://github.com/vyanhursky/DefJamFFNY-recomp/issues) and the [latest release notes](https://github.com/vyanhursky/DefJamFFNY-recomp/releases/latest). Some release-specific fixes and validation limits appear in the notes first. ## Community This project is in very active development, and the **[Def Jam: Fight for NY Recomp Discord](https://discord.gg/xNvBs23ZBw)** is where we collaborate and talk it through. Join to: - follow and discuss development as it happens; - share player feedback and ask for help getting set up; - suggest enhancements and ideas for the port; - talk about mods and texture packs. Discord is for conversation. Please still file bugs as [GitHub issues](https://github.com/vyanhursky/DefJamFFNY-recomp/issues/new/choose) so they are tracked, and never share game files or dumps there either. ## Help improve the port [Report a problem](https://github.com/vyanhursky/DefJamFFNY-recomp/issues/new/choose) with your version, operating system, CPU/GPU, controller, reproduction steps and relevant log lines. Remove personal paths and keep game files, saves and memory dumps out of reports. With the [play-test recorder](docs/playtest-recorder.md) on, F9 (or View + left stick click) saves a bundle for local analysis. Keep the raw bundle local; share only permitted textual diagnostics. See [Contributing](CONTRIBUTING.md) for reporting guidance, development setup and the tests a change needs. Bug fixes, platform testing and documentation improvements are welcome. The [gameplay test harness](docs/09-testing-harness.md) explains automated game checks and their limits. GitHub CI also runs checks that need no game data; a passing CI badge does not establish full campaign compatibility. ## How it works The [xboxrecomp](https://github.com/sp00nznet/xboxrecomp) toolchain translates the Xbox executable into C, which is compiled ahead of time. The game's code runs through an Xbox compatibility runtime, with graphics, audio and input supplied by your computer. This is a static recompilation port; deeper gameplay decompilation remains future work. The repository distributes maintained port code, build tools and documentation. It does not distribute a disc image, playable game data, translated game source or a compiled game executable. The repository does include selected approved screenshots and branding artwork; those retain their original ownership. ## Credits and licensing Maintained by **vyanhursky**, with development assistance from Claude Code and Codex. Built on **sp00nz's xboxrecomp** and work from the Xbox emulation community, including xemu hardware references and attributed toolkit components. [Burnout 3](https://github.com/sp00nznet/burnout3) and [Mercenaries Recompiled](https://github.com/KraftMacAndChee/Mercenaries-Recompiled) are related projects that helped shape the documentation. The project's code is [MIT licensed](LICENSE). Toolkit components retain their own licenses; see the [toolkit NOTICE](https://github.com/vyanhursky/xboxrecomp/blob/d569ca10811cef67ec4e9fa2173088c2f9fd0580/NOTICE) and [license texts](https://github.com/vyanhursky/xboxrecomp/tree/d569ca10811cef67ec4e9fa2173088c2f9fd0580/LICENSES). The license grants no rights to the game or its artwork. This is an unofficial fan project, not affiliated with Electronic Arts, AKI or Def Jam. Def Jam: Fight for NY and its assets belong to their respective owners.