AfroSamuraiRecomp v0.2.0 – Fully playable up to 4K@60FPS

AfroSamuraiRecomp v0.2.0 – Fully playable up to 4K@60FPS

Source-only release. The downloadable program is the setup installer. It builds
the game on your PC from your own Europe disc. No game executable and no game
files are included.

HDD installation can take a long time; SSD/NVMe recommended.

Download

afrosetup-v0.2.0.exe

SHA-256 a8fb0e72e859878d051c90b96522a83c201e1d77a9cca4d2a995f3ab0f1db4d3

1362450 bytes.

Already on 0.1.x: run it, choose Update and pick your install folder.
Your extracted game, saves and launcher settings stay.

Improvements

60 FPS, the whole game

• 60 is a normal frame-rate option now, not experimental. The default stays
  the original Xbox 360 experience: 720p at 30 FPS.
• Gameplay, cutscenes and in-level dialogue scenes all run at 60 at the right
  speed. Focus slow motion and pauses still work.
• Game speed follows real time, not the frame rate: a scene that drops below 60
  does not turn into slow motion.

Faster

• The GPU translation does less work per frame: no register lookup per write,
  register blocks written in one batch, and no sleeping in whole milliseconds while
  waiting on the game.
• Unchanged data is no longer sent to the graphics card again every frame, and
  rendered images are no longer copied back to the CPU.
• Tested result: steady 60 at native resolution and at 2x on the test PC
  (i7-10700F, RX 9060 XT).

Launcher

• The main window has the language and three buttons: Play,
  Settings... and Manage saved games....
• Settings has three tabs:
  • Graphics: display, internal resolution, frame rate, VSync.
  • Gameplay: controls, mouse sliders, invulnerability.
  • Experimental (not fully tested): sepia filter, blood effect, depth of
    field, bloom, focus effect, render path.
• Choosing 60 also sets VSync to Off; with VSync on, a frame that misses 60
  shows at 30.
• Skip this window at launch is in Settings. Settings are saved each time you
  press Play. Hold Shift at launch to show the launcher again.
• If you saved 60 in 0.1.x, it stays 60 (with VSync off).

Keyboard and mouse

• In fullscreen, the mouse cursor no longer stays on screen until you alt-tab.

Setup

• Shows its details (the install log) by default.
• Applies the updated ReXGlue patch zzzzzz-afro-gpu-fast-path and the new
  zzzzzzz-afro-mouse-recapture on install and on update.

Tested

• Played on the test PC at 60: gameplay, the intro cutscene and in-level
  dialogue scenes at normal speed, at 1x and 2x internal resolution.
• Update from a 0.1.2 install to 0.2.0, then a session at the 30 FPS default.
• New launcher windows checked in English and Spanish.
• Clean install into a new folder with a 0.2.0 release candidate, then Update
  of that folder with this afrosetup-v0.2.0.exe: language on the main window, the
  hidden cursor in fullscreen with keyboard and mouse, and 60 FPS all checked in game.
• Button prompts (A, B, X, Y, LB, LT, RT and the D-pad prompt) checked in game
  with Xbox, DualSense, Switch and generic controllers.
• The whole patch stack applies to a clean ReXGlue bd833a2.

Still not claimed

• At 60, scenes that show two camera views at once can still drop below 60.
• RB, Start, Back and the stick-click prompts keep the Xbox icon.
• Steam icons were not checked in game.
• Keyboard icons show the default keys, not keys you rebind.
• No install time is guaranteed on HDD, SSD, or NVMe. Update rebuilds the whole
  game even when little changed, so it takes about as long as the build part of a
  fresh install.

Next (0.2.1)

• Borderless window.
• Key rebinding.

AfroSamuraiRecomp v0.1.2 – Controller button prompts + keyboard and mouse

AfroSamuraiRecomp v0.1.2 – Controller button prompts + keyboard and mouse

Source-only release. The downloadable program is the setup installer. It builds
the game on your PC from your own Europe disc. No game executable and no game
files are included.

HDD installation can take a long time; SSD/NVMe recommended.

Download

afrosetup-v0.1.2.exe

SHA-256 bf5127c1a9b52324739db5cf791e2d5f7c7aa677f09c095106964cc16dd469a1

1419348 bytes.

Already on 0.1.0 or 0.1.1: run it, choose Update and pick your install folder.
Your extracted game, saves and launcher settings stay.

Improvements

Button prompts that follow your controller

• The on-screen button icons change to match the device you are using:
  PlayStation (cross, circle, square, triangle, L1/L2...), Switch
  (B/A/Y/X in Nintendo positions, ZL/ZR...), Steam Deck / Steam Controller,
  and keyboard and mouse (key caps and a mouse).
• Xbox controllers keep the game's original icons.
• They switch live, mid-game, as soon as you press a button on another device.
• Replaced so far: A, B, X, Y, LB, LT, RT and the D-pad prompt.
• The icons are original art made for this project (tools/make_glyphs.ps1).
  --afro_button_glyphs=playstation|nintendo|steam|keyboard|xbox forces a set.

Keyboard and mouse are playable

• Fixed the crash that closed the game 25 to 110 seconds after turning on
  the keyboard (heap corruption from two threads rebuilding the input device list).
• Action-game default keys: left click attack, right click second attack, Space
  jump, E kick (and menu back), Q block, R focus, Esc menu, arrows D-pad, mouse
  camera (Shift + arrows also move the camera).
• The mouse camera follows mouse speed and starts moving right away, whatever the
  game's polling rate. Sensitivity, dead zone and smoothing are sliders in the
  launcher.

Launcher

• New Control row: Auto (default: keyboard and mouse on, a controller
  takes over when it connects or is used), Controller, Keyboard.
• Advanced settings... now holds the tested options: render path, the three
  mouse sliders and Invulnerability (a checkbox, still for that launch only).
• Its Experimental... button holds the options that are not fully tested,
  with the warning: frame rate and the sepia filter.
• Labels say (default) instead of (original).

Setup

• Copies the button icons to game\glyphs.
• Applies the two new ReXGlue patches (zzzz-afro-button-glyphs,
  zzzzz-afro-input-lock) on install and on update.

Tested

• Played on the test PC: PlayStation (DualSense) and keyboard icons, switching
  between controller and keyboard mid-game; the LB, LT and D-pad icons; keyboard and
  mouse play with the mouse camera and the arrow-key D-pad.
• Switch icons were checked in the main menu with the icon set forced.
• Keyboard play ran about 6 minutes, 2.5 of them in gameplay, with no crash. Before
  the fix it crashed in 3 runs out of 3.
• Update from a 0.1.1 install to 0.1.2, run with the install.ps1 command this
  setup uses and the source unpacked from this exact afrosetup-v0.1.2.exe:
  finished in 7 minutes, applied the two new patches, copied the icons, and the
  game started.
• Clean install of 0.1.2 into a new folder with the published
  afrosetup-v0.1.2.exe, through the graphical setup: finished in 14 minutes,
  applied all nine patches, copied the icons, and the game ran correctly.
• The whole patch stack applies to a clean ReXGlue bd833a2.

Still not claimed

• RB, Start, Back and the stick-click prompts have not been found yet and keep the
  Xbox icon.
• Switch icons were checked only with the icon set forced, and Steam icons were not
  looked at in game. No real Switch or Steam Deck controller was tested.
• Keyboard icons show the default keys, not keys you rebind.
• Experimental (60) can still run cutscenes fast and drop frames.
• No install time is guaranteed on HDD, SSD, or NVMe.

AfroSamuraiRecomp v0.1.1 – Minor Texture Fixes + Fresh installation bug fix

AfroSamuraiRecomp v0.1.1 – Minor Texture Fixes + Fresh installation bug fix

Source-only release. The downloadable program is the setup installer. It builds
the game on your PC from your own Europe disc. No game executable and no game
files are included.

HDD installation can take a long time; SSD/NVMe recommended.

Download

afrosetup-v0.1.1.exe

SHA-256 3336ce0378a369f953476896bb091fb457f010fcacc1b5b77968c4a9e07da1c1

1731355 bytes. This is the file that was installed and played. It is not rebuilt for this release.

Highlights

• The setup program contains this 0.1.1 source. Install and Update do not clone public main.
• Original (30) stays the default. Experimental (60) stays opt-in and incomplete.
• Quad-list depth offset defaults to half. The Advanced setting for that offset is removed. An expert override can still set it.
• An ISO whose SHA-1 does not match the Europe pin is logged and the install continues. The pin is unchanged. A missing or unreadable ISO still stops the install.
• A failure to write install.log does not stop the install. The same lines go to install-fallback.log beside it, or to the temp file if that folder cannot be written. A real install failure is still shown and still stops the run.
• Resume keeps finished tools, verified downloads, extracted game data, and a completed SDK. The step that did not finish is not marked done.
• The patched GPU plugin links. LLVM extraction does not show a full bar before tar has a total. Git directory exceptions stay limited to the repos this installer creates.

Tested

• HDD installations works, but can take x4/x5 time that SSD/NVMe ones.
• Cancelled installations can be restarted keeping the progress.
• The headband texture looked correct in play of this build.
• Invulnerability cheat works in the tested build and remains experimental.

Still not claimed

• Invulnerability is not a guarantee for the whole game. It stays off unless enabled for that launch, and it is not saved.
• Other black textures are not claimed fixed.
• Experimental (60) can still run cutscenes fast and drop frames.
• No install time is guaranteed on HDD, SSD, or NVMe. It depends on hardware and internet speed.

Headband comparison

Development rendering comparison: original (left), full (middle), and half (right). Half is the default in 0.1.1.

AfroSamuraiRecomp v0.1.0 – Fully playable

AfroSamuraiRecomp v0.1.0 – Fully playable

Source-only release. The downloadable program is the setup installer. It builds
the game on your PC from your own Europe disc. No game executable and no game
files are included.

Highlights

• Original (30) is the default. On the machines tested, the game starts from the installer and is playable.
• A graphical setup program, afrosetup-v0.1.0.exe, in English, Español, Français, and Italiano. It can install, or update an existing 0.1.0 folder, without administrator rights and without changing PATH or the registry.
• install.bat remains the console installer.
• Launcher choices use the labels 30 (original), 60 (experimental), RTV (original), and ROV (experimental).
• Cheats are a separate dialog. Invulnerability is off unless you turn it on for that session, and it is not saved.

Changes

• Setup asks for language, then Install or Update, then the folder, your Europe ISO or an already extracted game, and the Microsoft Build Tools license (the box starts unchecked).
• Update keeps the extracted game, saves, and launcher settings. It rebuilds even when the version is still 0.1.0, reuses build tools that are still on disk, and downloads again only the tools that cleanup removed.
• The installed game\Play.bat is what Jugar starts, and only after you click it.
• Experimental (60) remains opt-in.
• Invulnerability (experimental) is still in the tree as a session cheat. It is not a fix.

Known issues

• Frame rate dips, especially above native internal resolution.
• Black textures, including the headband.
• Occasional odd audio.
• Experimental (60) can accelerate cutscenes and still drop frames. It is not a finished 60 FPS mode.
• Invulnerability (experimental) does not currently prevent death. Leave it off unless you are testing that cheat.

Building

Run afrosetup-v0.1.0.exe, or install.bat from a source checkout. Both compile from your own Afro Samurai (Europe) ISO. The setup program already contains this 0.1.0 source. It does not download a prebuilt game.

Tested on

• One Windows PC: a clean install with the first 0.1.0 setup program. The game works there.
• The same PC: a same-version update with the later setup program. Jugar starts the game, and the result seemed fine.
• This is one tester's use, not an independent check of the whole game.
• The Cheats warning text and the shorter installer progress line in this package were not run again on Windows after they were added.

Legal

Fan project, not affiliated with Namco Bandai, GONZO, Microsoft, or other rights holders. No game code or assets are distributed. GPL-3.0 for this repository except patches/rexglue/ (BSD-3). You need your own original game.

AfroSamuraiRecomp v0.0.16 – Experimental 60 FPS

AfroSamuraiRecomp v0.0.16 – Experimental 60 FPS

Source-only prerelease. No binaries or game files. Build from your own Europe ISO.

Highlights

• Original (30) remains the default and is the recommended play mode.
• New opt-in Experimental (60) in Advanced settings for public testing and log collection.
• All previously released voice / black-screen / language / saves / installer work from 0.0.12–0.0.15 is kept.
• Safer update path: codegen refreshes when afro_hooks.toml changes.

Changes

• Launcher FPS choices reduced to Original (30) and Experimental (60) only (removed misleading host-only caps and any unmapped tick-mode UI).
• Experimental sets afro_present_interval=1 + host cap 60 and enables gated guest dt / 1/30→1/60 hooks. Original keeps present interval default 2 and skips those Experimental patches.
• Bounded ~2s FPS/dt/present-interval logging for testers (afro_fps_log, overwritable log file).
• Docs: README tester guide, truthful log paths (installer vs run_win.bat), GitHub issue template.
• Pre-0.0.16 remembered FPS values map back to Original (they were only a host cap on still-30 gameplay).

Known issues

• Intermittent black bands can appear on some surfaces, especially Afro’s moving white headband tails. This is a visual issue; the cause is still under investigation.
• Experimental (60): intro and cinematics can still be accelerated; other gameplay / Focus / combat timing may be wrong and is largely unverified. Not claimed fixed or “smooth 60”.
• FPS dips can still happen (including below 30, and dual-camera stretches near ~30). Cause is not proven without profiling — do not assert a single GPU root cause.
• Stuck double tutorial prompt (original game behaviour).
• (No muffled-audio issue is listed as confirmed.)

Building

Use install.bat (fetches this revision from GitHub after publish) or a source checkout + tools\build_gpu_plugin.bat then tools\build_win.bat. See README. Requires your own Europe disc/ISO.

Tested on

• Original (30): exercised repeatedly on one Windows PC (AMD Radeon RX 9060 XT) after the 0.0.16 timing rollback — boots, menus, gameplay, voices, and the RTV path without the problems seen on Experimental (60). Recommended default.
• Experimental (60): incomplete. Expect accelerated intro/cinematics and possible other timing issues; performance dips (including below 30 / dual-camera ~30) still occur and are not claimed fixed. Opt-in for tester logs only — not a stable 60 FPS mode.

Legal

Fan project, not affiliated with Namco Bandai, GONZO, Microsoft, or rights holders. No game code/assets distributed. GPL-3.0 for this repo except patches/rexglue/ (BSD-3). Own the original game.

AfroSamuraiRecomp v0.0.15 – One-click installer

Highlights

• Plug-and-play installer. Download the repository ZIP (or just install.bat), double-click install.bat, and it builds and installs the game from your own ISO:
  • language first (English, Español, Français, Italiano), then all questions up front (install folder, ISO, Microsoft license, shortcuts); after that it runs unattended with an overall % progress;
  • portable toolchain (Git, CMake, Ninja, LLVM/Clang, Python, MSVC + Windows SDK) from official sources, SHA-256-pinned; no admin rights, no PATH, registry or system-wide changes;
  • ISO SHA-1 check, fast tar extraction, light (blobless) ReXGlue clone;
  • resumable: re-running continues where it stopped, refreshes the source and rebuilds when it changed;
  • self-contained game\ folder with Play.bat, desktop and Start menu shortcuts, launcher preset to the chosen language;
  • optional cleanup of build files at the end (default No, frees about 8 GB).
• Launcher: "Manage saved games..." – open saves folder, back up, restore a backup, open backups folder, delete. Restore and delete first make a safety backup and are refused while the game is running.
• Closing the launcher (X, Esc, Alt+F4) no longer starts the game.
• README rewritten for new players: short Quick start at the top, technical content under Advanced.

Changes

• New install.bat and tools/install.ps1 (translated messages in en/es/fr/it, -Language, -InstallDir, -Iso, -CleanupAfterInstall/-KeepBuildFiles and more; see the README).
• Launcher: saved-games dialog; fixed an empty gap in the layout.
• .gitattributes: CRLF for .bat / .ps1.
• No changes to the game code, GPU plugin or runtime patches since v0.0.14.

Known issues

• FPS drops when objects break or the camera splits.
• If two tutorial prompts appear at once, the first one can stay stuck on screen. This is the original game's behaviour; restarting the level clears it.
• The FPS cap option is experimental; the game is designed for 30 FPS.
• The installer always builds the latest main from GitHub (also when started from a release source zip).
• Only the Europe disc is supported. Windows x64 (Direct3D 12) only.
• Tested on one PC only.

Building

Source only, bring your own disc: make an ISO of your Europe disc, download the repository ZIP and run install.bat (see the README Quick start). Manual build: tools\build_win.bat, then tools\build_gpu_plugin.bat.

Tested on

One PC (Windows, AMD Radeon RX 9060 XT): clean installs from a git clone and from the GitHub ZIP, 17-19 minutes each, then played.

Legal

Source only – no binaries, no game data. You need your own original Afro Samurai disc (Xbox 360, Europe, Redump 17884). Afro Samurai is a trademark of its respective owners; this project is not affiliated with them. Code under GPL-3.0; patches/rexglue/ under BSD-3-Clause.

AfroSamuraiRecomp v0.0.14 – all cutscene voices fixed + experimental advanced settings

Highlights

• All cutscene voices fixed. Lines that went silent after a camera cut, along with everything after them (e.g. the second boss cutscene), now play in full.
• New "Advanced settings (experimental)" dialog in the launcher: FPS cap (default Original (30 capped), the game's own pacing) and a sepia filter toggle.
• The launcher now defaults to native internal resolution (1x).

Changes

• Cause of the silent lines: cinematic audio is multi-stream XMA (three interleaved streams). When a stream's next packet holds no frame start (the frame spans the whole packet), the decoder jumped to packet 0 of the next 32 KB block, which belongs to another stream, so the voice stream was lost from that point on.
• New runtime patch patches/rexglue/afro-xma-frameless-chain.patch (in rexruntime.dll): cvar afro_xma_frameless_chain (default on) follows each stream's own packet chain, also into the next block. Checked offline against every cutscene dialogue and sfx file.
• Launcher: the FPS cap has moved to the Advanced settings dialog. "Original (30 capped)" passes no override to the game; 30 / 60 are experimental. The sepia filter can be turned off there.
• Launcher: resolution, FPS and sepia are kept only when "remember" is ticked; otherwise they return to their defaults (1x, Original, sepia on).
• New diagnostics patch patches/rexglue/zz-afro-perf-log.patch (GPU plugin): afro_perf_log per-second / slow-frame stats and an experimental afro_occlusion_async. Both are off by default.
• Build scripts: tools\build_gpu_plugin.bat reliably detects already-applied patches, even when later patches touch the same lines. It uses a scratch git index check and stamp files. tools\build_win.bat restores the patched DLLs at the end, so the two scripts can be run in either order.

Known issues

• FPS drops when objects break or the camera splits.
• If two tutorial prompts appear at once, the first one can stay stuck on screen. This is the original game's behaviour; restarting the level clears it.
• The FPS cap option is experimental and may not behave as expected; the game is designed for 30 FPS.
• Only the Europe disc is supported.

Building

Source only, bring your own disc: make an ISO of your Europe disc, then follow the README (tools\build_win.bat, then tools\build_gpu_plugin.bat).
Tested on one PC (Windows, AMD Radeon RX 9060 XT).

---

Source only – no binaries, no game data. You need your own original Afro Samurai disc (Xbox 360, Europe, Redump 17884). Afro Samurai is a trademark of its respective owners; this project is not affiliated with them. Code under GPL-3.0; patches/rexglue/ under BSD-3-Clause.

AfroSamuraiRecomp v0.0.13 – cinematic voices fixed

Highlights

• Cinematic voices fixed. Dialogue lines in cutscenes that were silent or cut off (often at camera cuts) now play in full. Still a stable 30 FPS on the default RTV path.

Changes

• Cause: cinematic dialogue is stored as multi-stream (5.1) XMA – three interleaved stereo streams, with the voice only in the centre stream. The XMA decoder restarted at packet 0 on every new 32 KB input block, so streams 1-2 decoded stream 0's packets and the centre channel was lost.
• New runtime patch patches/rexglue/afro-xma-fix-log.patch (in rexruntime.dll): cvar afro_xma_substream (default on) continues each stream at its next packet in the next block.
• Same patch: backport of Xenia-canary's XMA Work() loop and output-valid handling (cvar afro_xma_fix, default on), plus optional diagnostics (afro_xma_log, off by default).
• tools/build_gpu_plugin.bat now builds and installs both rexgpu-xenos.dll and rexruntime.dll (stock DLLs kept as *.dll.stock).

Known issues

• Some tutorial pop-ups advance too fast (before the voice line ends).
• Only the Europe disc is supported.

Building

Source only, bring your own disc: make an ISO of your Europe disc, then follow the README (tools\build_win.bat, then tools\build_gpu_plugin.bat).
Tested on one PC (Windows, AMD Radeon RX 9060 XT).

---

Source only – no binaries, no game data. You need your own original Afro Samurai disc (Xbox 360, Europe, Redump 17884). Afro Samurai is a trademark of its respective owners; this project is not affiliated with them. Code under GPL-3.0; patches/rexglue/ under BSD-3-Clause.

AfroSamuraiRecomp v0.0.12 – RTV black frames fixed, stable 30 FPS

Highlights

• RTV black frames fixed – stable 30 FPS. The black frames in combat and at cutscene camera cuts are gone. The game now runs at a stable 30 FPS on the default RTV path (host render targets), with a correct image.

Changes

• Cause of the black frames: EDRAM range wraparound in the render target cache. An end-of-frame depth-only pass (at EDRAM tile 736, estimated 2048 tiles long) wrapped round to tile 0 and took ownership of the colour image (tiles 0-720). The lossy colour→depth→colour transfer then blacked out the frame whenever the game skipped the pass that normally restores it. The new GPU plugin patch patches/rexglue/afro-edram-no-wrap.patch (cvar afro_edram_no_wrap, default on) clamps the range instead of letting it wrap.
• Default GPU render path is RTV again (correct image, stable 30 FPS).
• ROV is still available as a fallback: Advanced options (--advanced) or --render_target_path_d3d12=rov.
• tools/build_gpu_plugin.bat applies every patches/rexglue/*.patch, skipping those already applied.

Known issues

• Some gameplay voice lines are silent or cut off (music and sound effects are fine).
• Only the Europe disc is supported.

Building

Source only, bring your own disc: make an ISO of your Europe disc, then follow the README (tools\build_win.bat, then tools\build_gpu_plugin.bat).
Tested on one PC (Windows, AMD Radeon RX 9060 XT).

---

Source only – no binaries, no game data. You need your own original Afro Samurai disc (Xbox 360, Europe, Redump 17884). Afro Samurai is a trademark of its respective owners; this project is not affiliated with them. Code under GPL-3.0; patches/rexglue/ under BSD-3-Clause.

AfroSamuraiRecomp v0.0.11 – first public preview (source only)

Highlights

• First public preview – source only.
• Native Windows x64 build through the ReXGlue SDK (nightly 0.10.0.24-dev.gbd833a2).
• The default GPU path is ROV: the image is correct but it's slow on some GPUs (can drop below 15 FPS). The faster RTV path still shows black frames and is under investigation.

Changes

• Launcher (EN/ES/FR/IT): language, frame-rate cap, fullscreen or window, internal resolution 1x/2x/3x, and "remember". Diagnostic options are hidden; start with --advanced to show them.
• tools/build_win.bat extracts everything it needs (PE image, switch tables, icon) from your own default.xex; tools/build_gpu_plugin.bat builds the patched GPU plugin.

Known issues

• RTV path: black frames in combat and at cutscene camera cuts.
• Some voice lines are silent or cut off.
• Only the Europe disc is supported.

Building

Source only, bring your own disc: make an ISO of your Europe disc, then follow the README (tools\build_win.bat, then tools\build_gpu_plugin.bat).
Tested on Windows 11 with an AMD RX 9060 XT, building from a clean folder by following the README.

---

Source only – no binaries, no game data. You need your own original Afro Samurai disc (Xbox 360, Europe, Redump 17884). Afro Samurai is a trademark of its respective owners; this project is not affiliated with them. Code under GPL-3.0; patches/rexglue/ under BSD-3-Clause.