A native PC port of Contra (NES, USA), built with NESRecomp. The game's own 6502 code is recompiled to C and runs natively, cycle-accurate, at the speed of the real console, with additions the NES could never do:
- 120 / 180 / 240 pictures a second. In-between pictures for high-refresh and FreeSync / G-Sync monitors, drawn at 4x resolution so things can move a quarter of a NES pixel at a time.
- Smooth scrolling, sideways and up. The camera glides between the game's positions, including the climb up the Waterfall (Stage 3), where the game's own uneven steps are evened out.
- Character glide. Bill, Lance, the soldiers, the bosses and falling power-ups glide between the game's positions instead of hopping in uneven steps. Flexing parts, like the Waterfall boss's arms, glide piece by piece.
- Steady shots. The game draws every player shot only every other frame (a see-through blink on a CRT, a smeared double image on a fast monitor). Shots are drawn in every frame and fly smoothly.
- No sprite flicker. Every sprite is drawn every frame (the NES can only draw 8 per line; up to 24 share a line in this game, more in 2-player).
- Two players on two controllers, an edge crop that hides the NES's scrolling garbage, an in-game settings menu, and save states with pictures.
Everything above changes only the picture; the game itself runs exactly as on a NES, slowdown included. Each feature can be switched off in the menu.
You need your own ROM. This repository contains no game data. You must supply a dump of Contra (USA); the program checks it is the right one before it runs.
Get the latest version from the Releases page:
- Windows:
ContraRecomp-Windows-x64.zip. Extract it, double-clickcontrarecomp.exe. - Linux:
ContraRecomp-x86_64.AppImage. Mark it executable (right-click, Properties, Permissions, orchmod +x), then double-click it.
The first time, the game asks for your ROM and checks it. No building needed.
High-refresh monitor? Set Pictures per second to 240 (or 180) and turn VSync Off (with FreeSync/G-Sync). VSync starts On, which suits 60 Hz monitors but makes the extra pictures stutter.
The game starts with these already on, except two you set yourself: Pictures per second starts at 60, because only high-refresh monitors benefit from more, and the game opens in a window (press F11 for fullscreen). In game, press Escape (or the right shoulder button) for the menu:
| Menu | Setting | Recommended |
|---|---|---|
| Smooth motion | Pictures per second | 240 or 180 on a 240 Hz FreeSync/G-Sync monitor; your monitor's rate or lower otherwise; 60 (off) on a 60 Hz monitor |
| Smooth motion | Character glide | On |
| Smooth motion | Steady shots | On |
| Smooth motion | Second core | On |
| Picture | No sprite flicker | On |
| Picture | Edge crop | Standard |
| Graphics | VSync | Off with FreeSync/G-Sync; On without |
| Display | Fullscreen | On (F11 toggles) |
Settings are saved in config.ini beside the program.
The cheat code works as on the NES: at the title screen press Up Up Down Down Left Right Left Right B A, then Start (or Select, Start for two players) for 30 lives.
- Stutter at 120/180/240: check that VSync is Off and your monitor's
FreeSync/G-Sync (on KDE: Adaptive sync Always) is on, and that
Second core is On. Close busy programs. On Linux the game keeps its
two busy threads on separate CPU cores by itself (
CYC_PIN=0turns that off); on Windows, try 180 if 240 isn't steady. - Player 2 doesn't move: check both controllers in the launcher's Controls page. A controller that was connected for a long time can stop sending input: unplug it and plug it back in.
- The sound comes out of a PS4 controller: a wired PS4 controller is also a sound card. Pick your speakers in your system's sound settings (Linux: set the controller's audio profile to Off).
- Windows SmartScreen warns about an unknown publisher: More info, then Run anyway.
- The AppImage won't start on an older Linux: install FUSE 2
(
sudo apt install libfuse2) or run it with--appimage-extract-and-run. - Wrong ROM: the game only accepts the USA release; other dumps are refused before the game starts.
Only needed if you want to change the code. You need Git, CMake 3.20+, a C/C++ compiler, Python 3.11+ and SDL2.
Linux (Arch/CachyOS: sudo pacman -S git cmake ninja sdl2 python;
Debian/Ubuntu: sudo apt install git cmake ninja-build build-essential libsdl2-dev python3):
git clone --recursive https://github.com/gabbycat4/ContraRecomp.git
cd ContraRecomp
cp /path/to/your/rom.nes contra.nes
cmake -S . -B build-play -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build-play --parallel
./build-play/contrarecomp contra.nes--recursive also downloads the engine and the menu (they are submodules).
If you cloned without it, run git submodule update --init --recursive.
The first configure takes a while: it builds the recompiler and translates
the game.
Keyboard and controllers are rebindable in the launcher's Controls page.
| Escape / right shoulder | Menu |
| F7 | Save states |
| F8 | Rewind (off by default; turn on in the menu) |
| F11 | Fullscreen |
| Tab | Fast forward |
| F12 | Screenshot |
Every menu setting also has an option for one run (it does not change
config.ini): --present-rate N, --char-glide 0|1, --steady-shots 0|1,
--emu-thread 0|1, --screen-shake 0|1, --no-sprite-limit 0|1,
--sprite-order 0|1, --overscan T,B,L,R. --plain 1 shows the engine's
own picture for comparing. Developer logs: --scroll-log FILE,
--oam-log FILE, --ppu-log FILE; CYC_PACING_LOG=FILE for picture timing.
The NESRecomp engine runs the recompiled game cycle by cycle. This project
adds a presentation layer (src/contra_extras.c) through the engine's
HOST_EXTRAS interface:
- each frame the screen is split into scroll bands from the PPU's per-line scroll; each band's movement, sideways and up/down, is averaged over 4 frames and the band is redrawn, from the background alone, at its smoothed position;
- sprites are matched frame to frame (by tile, flips and palette, then by position when a character changes its picture) and grouped into characters. A character moves only when most of its pieces agree; a chain whose pieces all move a little differently (a boss's arm) glides piece by piece. Sprites hidden for a frame or two are remembered, and shots the game blinks are drawn where they would be;
- with a picture rate above 60, the next NES frame runs on a second core while the in-between pictures are shown, so they stay evenly spaced.
notes.txt has the measurements behind each feature, and
tools/glide_harness.c replays the smoothing on recorded play without a
window, which is how every change was checked.
Emulating one NES frame takes about 8.6 ms on a Ryzen 7 2700, which is why the second core is needed above 60. Optimizations in the engine are welcome.
- NESRecomp and
recomp-ui by Matthew Stanley; their
own licences apply (see the
nesrecompandrecomp-uifolders). The engine submodule points at a fork with window additions (in-between pictures, the second-core option and its thread placement, display-sized windows, a VSync menu row). - This project's code is licensed under the PolyForm Noncommercial License
1.0.0 (
LICENSE): free to use, share and change; not to be sold. - Contra is © Konami. This project is not affiliated with Konami and includes none of the game.