FNAF Recomp — the classic FNAF series for Xbox 360

Warning

Use a separate/offline Xbox 360 profile for this project. This is an unofficial homebrew/clean-room reconstruction and recompilation project. Do not use Xbox Live with it.

"Crash" during Golden Freddy's kill is a FEATURE. After his full-screen face appears, the game intentionally closes the title the same abrupt way the ORIGINAL PC release does — it looks like a crash but is a safe easter egg: only the game quits in to BSOD, the console is never harmed, and it is avoidable by raising the Monitor in time. All other exits (incl. missing pak and the save import restart) go to the dashboard through XLaunchNewImage.

What started as a from-scratch reimplementation of FNAF1 on raw Xbox 360 XDK (D3D9 + XAudio2, VS2010/PPC, C++03 — no lambdas, no nullptr) is now a MULTI-GAME shell: one codebase hosts the whole classic series as plug-in modules, each with its own assets bundle, renderer and game logic — all dump-driven and tested on real hardware:

Game	Ready	Implemented
FNAF 1	100 % (the most well-tested one of all, can be completed)	everything: nights 1–7 + Custom Night, full dump-mirrored AI (three-pass audit), cameras/doors/lights, jumpscares with the dump's exact timings, power-out (the real music box jingle + the dark-Freddy kill), Golden Freddy, hallucinations, phone call, pad rumble, all rare easter eggs (cove "IT'S ME", 1/10000 creepy, door jam). The death pipeline is dump-exact: scare → the "died" screen (fullscreen static + the one-pass white blip flash + the static loop on ch1, 10 s) → the backroom "gameover" (10 s, the 1/10000 creepy roll re-fires every second) → title. Controls match the official console port: LS pan, LB/RB lights, LT/RT doors, A raises the monitor and confirms the highlighted cam, D-pad moves the cam pre-selection, B exits camera mode / mutes the call, Y honks the nose. Saves (XContent + loose import) and achievements (official XLAST spa) are HW-verified on a signed-in profile. Left: nothing — only the documented deliberate deviations (Golden Freddy's shortened creepy screen + force-close, the power-out "steps" window; the EERIE/robotvoice room test is documented as exactly equivalent to the dump's vol-zone overlap)
FNAF 2	100 % (code, no game flow)	the complete frame flow: dump-exact title, New Game → the HELP WANTED newspaper → the night card (the REAL per-night art cells, rare 1/1000) → the office, 6 AM (the REAL 18-cell 5→6 roll + the save) → the panning dream → "it's me"/"err" → the next night; the endings (paycheck/pink slip/robots-scrapped) writing beatgame; the custom night setup with the ten verbatim challenge presets (the sliders BECOME the office AI); death → the Game Over face → (1/1000) the 8-bit chain: the SAVETHEM overworld (5x5 wrap grid), TAKE CAKE, GIVE GIFTS GIVE LIFE, Foxy's party, the turn rotation loader. The freddy2 save (level/cine/turn/beatgame/beat6/beat7/c1..c10, XContent + fallback, X-hold wipe) and the add-on achievements (slots 0-9 → spa ids 11..20, fnaf2_ach.ini, profile-write ready). The minigames' movement engine (grid-step + gate + sensors) is the reusable 8-bit model for FNAF3/4/SL. Left: NOTHING in code — the one-time .xlast task (enter the 10 add-on entries per docs/FNAF2_DLC_ACHIEVEMENTS.md §3b) and the Mangle office-crawl visual stub (labeled; her kill works)
FNAF 3	100 % (code)	disclaimer (2 s, the 1/1000 rare boot), title (Springtrap scene + static bursts + titlemusic), the full night loop (FNaF3Game): hour clock (40 s night 1 / 60 s), the Springtrap room graph (10 rooms + 5 vents + monitor-gated attack stages), vent sealing (with the progress bar), the audio lure with the adjacency table, the five phantoms + Golden/Shadow Freddy, the maintenance panel (meters, reboots, the vent-error blackout + hallucinations + the 204 office foreground state), 15 cams with the dump feed table, jumpscares 778/792, the GOT YOU 2 window scare. v2.63 — the whole dump flow, slot-resolved: the jump values turned out to be STORYBOARD-SLOT indexed (the dumped names were file-indexed and wrong; resolved through the chunk-8747 handle list) — death now → the static frame (stare + flash, 5 s) → the Game Over screen (5 s / A → title, 1/1000 → rare2), the 6 AM win → next-day → the load glitch screen (cutscene+1, 5 s) → the retro cutscenes frame (the 5x5 pizzeria room grid: 250 ms / 30 px steps, the per-room barrier table, Shadow Freddy figures leading the way, rain/rat/scanline ambience, and the Purple Guy who hunts you down and takes the scene's animatronic apart — scene N after night N; scene 5 opens the back room where he hides in the Springtrap suit and dies) → the end chooser (cutscene != 5 → the next night card; == 5 → bad end / good end by the Marion trigger). The six Atari minigames (frames 19-24) on one platformer engine (100 ms walk/fall ticks, 60 ms rise, jump counters 7/9/10, feel-sensors vs the rect kit, balloon bounce floors, the 1024x768 viewport over the 3072x2304 world): BB's Air Adventure (the CAM 08 toy; the balloon pickup unlocks balloons everywhere), Mangle's Quest (the arcade cabinet, night 2; the cake pickup + four follower kids), Chica's Party (collect → feed four guests), Stage01 (the keypad; zip pads), the Glitch Minigame (the night-5 dark room; the S-view teleports + the 1-in-2 glitch re-roll), Happiest Day (the CAM 03 puppet toy; all four kids fed → the goodend trigger → the float finale); the extras menu (animatronics viewer, minigame replays gated by goodend, the jumpscare player gated by beat6, the four cheats fast/ventproof/hyper/nocams that the office obeys). The freddy3 save carries the full dump key set (level/cine/beat6/4thstar/goodend/bb/cake/k1..k4/cheats). Console: X on the right cam starts a secret. Labeled deviations: pixel-perfect backdrop collision → the rect kit (coarse per piece), the arcade/cupcake/keypad cam picks are approximations (the BB/puppet cams are dump-pinned), a few minigame item positions (marked ~) come from the room kit
FNAF 4	100 % (code)	disclaimer, title (red sky + heading + menu with the tint selector), and the full night loop (FNaF4Game): five positions with the walk darks, the four threat lanes (Bonnie/Chica doors + breathing listen + shut-door visits + linger bedroom attacks; Foxy's closet with the forced flashlight and the bite; Freddy's bed counter with minis), Fredbear from night 5, the paranoia black-flash pipeline, 60 s hours with the per-night AI tables. v2.64 — the whole dump flow, slot-resolved (the same storyboard-slot discovery as FNAF3): the real what night card (INI night, the shadow pick forces nights 7/8, ambience + the 2.1 s clock beat), the real night win (the "6 AM" digits settle 2/2.5/3/3.5 s with the flicker, the fn4 writes, the 10 s route: night ≤ 5 → Cutscenes, 6 → the ending, 7 → the lockbox, ≥ 7 challenge/8 → title), death → game over (7 s → title), Fun with Plushtrap (the 9-position hall graph: in chair → stage 1 → far left/right → stage 2 → close left/right → stage 3 → got you; the A-hold flash; the darkness accumulator drives the 2 s move rolls; flash at stage 1 = he jumps back to the chair; flash at stage 3 = the win; the per-night clocks 90/60/45/30 s; the view anims are the dump's own tables incl. the 21-cell jumpscare), Fun with Balloon Boy (the same engine: 45 s clock, the bb1b-3b voice roll, the 500 ms stage-3 extra move, exits to the extras), the lockbox (after night 7; A = the unlock), the extras (10 rows: animatronics/making-of/jumpscares viewers, the Plushtrap and BB replays ("minigame play"), the shadow nights 7/8, the cheat toggles (house map/fast nights/radar/blind mode/insta foxy/mad freddy/all nightmare — the fast-nights cheat shortens the hours), exit), the house cutscenes (the walkable 5120x3840 world with the boy follower and the screen-follow pages; scene = the night, 0 → the card, 1-4 → the Plushtrap intro, > 4 → title), the ending typewriter hold, the test/demo skip screens. The fn4 save carries the dump key set (night/scene/beat5..beat8/s1..s6/test + the cheats). Labeled stop-gaps: the cutscene/ending dialogue letters are sprite images whose strings did not survive the dump (the talk box renders without invented text), the minigame timer/lockbox/captions ride debug font, the cutscene scene scripts run as a timed walk (the dump's 202 per-scene trigger groups simplified)
Sister Location	~25 %	the streaming loader streams the 1.5 GB pak room-to-room; v2.65 wave 1 live: the dump flow plays on the slot semantics (Warning/Legal splash → title → the Elevator ride → the Circus Control hub per night ⇒ vent hops → the walk rooms) with the real W-hold movement model (the crawl latch, the walk/quick walk speeds, the step sounds), the Ballora Gallery dance (walk = noise: distance builds, walking > 5 s puts her in the approach, flash side pan of her music, kill over 600), the Funtime Auditorium flash beacon (2 s refill, attracts Foxy, silhouettes by distance bands), the vent crawl 100-tick notches × 10, Baby's Room night end (Jingle_4b + INI write + tv show + Girl Voice chain), the per-night Script Event presets and the death-resume presets (n2=81/n3=111/n4=57/n5=512), the fnaf_sl save ("sl": current/intro/beat1/beat3/keycard/endsceneno/104). Left for wave 2: the HandUnit scripted beats per room, the P&S face-button task, the breaker task, Under Desk, the scooping chain, the extras/custom night (frame 31), the 8-bit minigame, the Perspective-eased room tween curve port, the real room art pins

One boot shows a game selector when more than one bundle is present. Every game ships its own .spa (Xbox identity/achievements, not yet) and its own *.pak (textures + sounds, built by our tool from that game's own dump).

Русская версия: README.ru.md.

Note

Project rule: the only source of truth is the game dump, taken with our own clean-room tool CTFAK-CPP. Wikis, third-party ports and "I remember it being this way" are not sources — they are checklists of what to look up in the dump. Every deliberate deviation from the dump is labelled as such in the code and in the changelog.

Status (v2.71)

• FNAF1 — 100 %, playable 1:1 (see the table above): XContent saves and achievements are verified on hardware with a signed-in profile; only the documented deliberate deviations remain.
• FNAF2/3/4 — 100 % code-complete: the entire frame flow slot-resolved from the dumps (v2.63/2.64), minigames, saves, endings, the customize screen; all text and counters ride the dump's own sprites (v2.67–2.69).
• Sister Location — ~25 %: the streaming loader handles the 1.5 GB pak, wave 1 is live (elevator → hub → vents/walk rooms, Ballora/Funtime, the fnaf_sl save).
• Visual parity (v2.66–2.71): the offline harness tools/offline renders every screen from the dumps on PC; the --pak mode pushes textures through the console-identical DXT chain (a pak render is 1:1 with the reference). From console HDMI-capture reports the invented layers were removed: the F2 office carries no hand tint or permanent static; the F3 title is completed to the dump (fade rules / footer / progress stars gated per the title events, the nightmare/extras rows hidden until beat5); the F3 office dropped the invented static bursts; the F3 HUD is pinned screen-fixed; the F4 night card got its fullscreen bed backdrop.
• The XDK Release build is green: the vc100 traps are closed — no braced-init-lists as call arguments, and cross-TU helpers are declared at namespace scope (MSVC 2010 binds a block-scope extern to the global namespace → LNK2019; proven with the real XDK cl.exe from WSL2 via dumpbin).
• The dumps sit next to the tool: FNAF1/2/3/4 + SL (17/27/26/19/36 event frames, paks 0.1…1.5 GB).

Full session history: CHANGELOG.en.md / CHANGELOG.ru.md.

Full history: CHANGELOG.en.md / CHANGELOG.ru.md.

Architecture

CORE (app shell — main.cpp + shared systems)
  D3D9 60 Hz loop · SpriteBatch/render targets · TextRenderer
  PakLoader (eager + streaming) · AudioSystem (XAudio2 dB mixer)
  InputSystem (XInput) · fades · XContent saves · achievements · debug console
────────────────────────────────────────────────────────────
AppModule (contract: Name/PakName/Load/Tick/Render/WantsExit)
────────────────────────────────────────────────────────────
FNaF1Module (active)   FNaF2Module   FNaF3Module   … (FNAF4/SL/UCN)

• The core never includes game headers; a module never owns the device — it receives AppServices{audio, pak, batch, text}.
• Registry: include/AppRegistry.h. The full stage-by-stage migration plan: docs/ARCHITECTURE.md.

Building and running

1. Toolchain: XDK build — VS2010 + Xbox 360 XDK (FNAF1-Recomp-proj.vcxproj). Cross-platform is not a goal; the PC paths in the code are stubs.
2. New files must be added to the .vcxproj manually (the project tree is synced between machines; the file list is simply src/ + include/).
3. Assets: fnaf1.pak must sit next to the XEX (see "Asset pipeline"). Without it you get the system "Missing fnaf1.pak" message box.
4. Running: Xenia for fast iteration, or a console (RGH/JTAG — the game runs from HDD). When several *.pak bundles are present, boot shows a game selector (D-pad select, A launch, B = FNAF1). Command-line arguments: 1..7 picks the starting night, fnaf2/fnaf3/fnaf4/sl force a module (dev).
5. Two builds: default — system (saves/achievements in XContent); FNAF_LIVE_SAFE — the live-safe variant (save at game:\save\freddy, local achievements).

Controls (console scheme)

Action	Button
Look around the office	Left stick ←→
Door lights	LB / RB
Doors	LT / RT (analog)
Camera tablet	A
Camera navigation	D-Pad
Pause	Start
Back	B
Freddy's nose (office)	Y
DEV menu	Start+B
Sprite browser	LB+RB (in menus)
Perspective tuner	L3+R3 (Y — reset knob)

Asset pipeline (CTFAK-CPP) (Temporarily available)

Tool: ctfak-cpp — a clean-room C++ reimplementation of a Clickteam Fusion runtime dumper/repacker. The full cycle for any game in the series:

# 1) dump assets (images/sounds/packed data):
./build/ctfak-cpp  <game>.exe 
Type "1" for dump assets 
# 2) GPU-ready pak + asset table (DXT textures + PCM, big-endian 'FNAF'):
./build/ctfak-cpp  <game>.exe 
Enter what appears next to “Recomp Pack”

Results land in build/Dumps/<Game>/:

• Events/*.txt + ALL_EVENTS.txt — the event program (conditions/actions/ parameters);
• JSON/application.json — objects/frames/animations;
• Images/, Sounds/, Packed Data/ — raw assets;
• RecompPack/<game>.pak + pak_manifest.json + asset_mapping_<game>.hpp.

Asset tables (include/assets/asset_mapping_*.hpp): each lives in its own namespace (fnaf1::assets, fnaf2::assets, …, sisterlocation::assets) with ASSET_COUNT; a game module includes only its own table — no symbol collisions. They are the ground-truth {index, filename, w, h, alpha} used for verification and for the per-game asset tables of stage 4.

Streaming: PakLoader::LoadStreaming() ("sliding over the file" — only tables stay resident, blobs are read at their dataOff on first use, and PreloadAsync pulls the next room in the background) will be activated by the SL module; SL's pak is ~1.5 GB, which cannot fit the 512 MB UMA pool eagerly. FNAF1/2/3/4 stay on the eager Load(). The games run from HDD, so the XDK's DVD stack (XFileCache, ReadFileScatter, physical sort keys) does not apply.

Saves

• The save file is the original extension-less freddy (INI: [freddy] with level/beatgame/beat6/beat7). The system build uses an XContent content named freddy; Live Safe uses game:\save\freddy.
• At boot the system build detects a loose freddy next to the XEX and offers to import it into XContent ("Do you want to import the save found in the game folder?" → "Import complete. Please restart the game." + exit).
• Achievements are separate (fnaf_ach.ini); by default they go through XUserWriteAchievements.

Documentation (docs/)

File	Contents
ARCHITECTURE.md	core+modules, dumps of every game, migration stages
AI_MECHANICS.md	the animatronic AI, 1:1 with the dump's event groups
CAMERA_FINDINGS.md	the canonical camera-feed table
AUDIO.md	sound bank, channels, action numbers
OVERLAY_MAP.md	overlays/statics of every screen
PERSPECTIVE.md, PERSPECTIVE_TUNER.md	the office parabola and its tuner
TABLET_FLIP.md	the tablet raise/lower animation
RESTORE.md, XDK_NOTES.md, pak_format.md	restoration, XDK notes, pak format

Versioning

v2.XX is bumped in the banners of src/main.cpp and in both changelogs at the same time. Rule for behavior disputes: read the event groups in Events/*.txt, not the wiki; a deviation from the dump gets its own "deliberate deviation" entry.

Disclaimer

Unofficial fan reimplementation for personal console use. A legally purchased copy of the original game is required — all assets are extracted from it. Do not distribute the assets or built images. (In other words, Build it yourself)