Beta 1.4.5

Beta 1.4.5

Minor Fixes/Adjustments

• Slowdown and crash after long play. The game kept every texture it had ever loaded in graphics memory, even
  after the game had let go of them. On graphics cards with little memory this slowly made the game slower and could
  end with a crash ("vkQueueSubmit failed" in the log), sometimes taking the desktop with it. Textures the game has
  freed or replaced are now released.
• Confusing resolution in the log. The log's first lines showed the settings from before the start screen, so a
  resolution changed there looked like it was ignored. The resolution line is now written once, after you press
  Play, and the two settings lines say "at start" and "chosen on the start screen".

If you built the game with Beta 1.3 or 1.4

Nothing to do: your build, saves, settings and shader cache stay valid.

Beta 1.4

Beta 1.4

Fixes

• Crash when linking Bowser's island. The game stopped with "not implemented yet" in the log as soon as you entered
  the island. It now carries on.
• Blurry picture at 1080p. At the 1080p setting, textures looked smeared and outlines ragged, worse than at
  720p. The game is made for 720p, and 1080p is 1.5 times that, so the game's own effects landed between pixels.
  1080p is now drawn at 1440p and shrunk to your screen, which gives a clean, sharp picture. This uses about as much
  graphics power as the 1440p setting; if your PC can't keep up, choose 720p. "Auto" on a 1080p screen picks this
  too.

If you crash without an error

If the game ever closes by itself and nxrt.log ends without a "CRASH" or "FATAL" line, please send the log
together with Windows' own record of the crash: open Event Viewer, go to Windows Logs > Application, and
look for an "Application Error" entry for BrothershipRecomp.exe at that time. Its text names the error code.

If you built the game with Beta 1.3

Nothing to do: your build, saves, settings and shader cache stay valid.

Beta 1.3

Beta 1.3

New

• Language. Settings > Language picks the game's language: English (US or UK), French (France or Canada),
  German, Italian, Spanish (Spain or Latin America), Dutch, Portuguese (Brazil), Japanese, Korean, or Chinese
  (Simplified or Traditional). Every dump has all of them, whatever its region.
• Linux and Steam Deck: an AppImage instead of the Flatpak. BrothershipRecomp-Linux.zip now holds
  BrothershipRecomp-x86_64.AppImage: no install and no runtime download. Make it executable if needed, run it,
  then Build and Play as before. On the Steam Deck, add the AppImage to Steam as a non-Steam game for Game Mode.
  Coming from the Flatpak? See "If you played Beta 1.2 on Linux" below.

Fixes

• Battle timing at 60 fps. Some action commands were much harder at 60 fps than at 30: the Red Shell Bros.
  Attack's final kick missed most presses, and certain boss battle Luigi Logic actions were harder too. Some battle
  events were running on only every other frame at 60 fps. They now run on every frame, so the timing matches
  30 fps. This also fixes the Red Shell moving at half speed and the enemies jumping around after a hit.
• A crash on some graphics (cube-map array textures): the game no longer stops there.
• Save dates showed 12/31/1969. They now show the real date and time.
• Building from an eShop dump: the build no longer fails at the unpack with "Unable to match rights id to
  titlekey". The base game's own ticket is now read as well as the update's. A dump whose ticket is tied to one
  console now gets a clear message: dump it again with your dumper's option to remove console-specific data.

Changes

• Smaller log: nxrt.log lists only the first system calls of each kind instead of every one, so it stays much
  smaller (a 30-minute session's log was 165 MB before).
• The build log now records the unpacker's exit code, and says so when it crashed, instead of giving a blank reason.

If you built the game with Beta 1.2 (Windows)

Nothing to do: your build, saves, settings and shader cache stay valid.

If you played Beta 1.2 on Linux (the Flatpak)

The AppImage keeps its files in ~/.config/brothership-recomp and ~/.local/share/brothership-recomp, not in the
Flatpak's folder. To keep your saves and prepared shaders, copy them over before the first start (the commands are
in the zip's README.txt), then choose Game files and Keys again and Build once. After that you can uninstall the
Flatpak.

Beta 1.2

Beta 1.2

New

• Linux and Steam Deck. BrothershipRecomp-Linux.zip holds a Flatpak (BrothershipRecomp-Linux.flatpak):
  install it, then Build and Play from the start screen as on Windows. Tested on a Steam Deck; it runs at a steady 30 fps
  at 720p. See the zip's README.txt for installing, Game Mode and where the files live.

Fixes

• AMD graphics cards: the game no longer stops at the first frame with "the Vulkan device cannot sample or copy
  format 129". AMD has no 24-bit depth format; a 32-bit one is used instead.
• Colours on Linux desktops that manage colour: the game now always presents in standard sRGB, so the picture is
  not shown brightened or washed out.

Changes

• Linux: nxrt.log is written when the game is started from the desktop or Steam (before, only from a terminal).

If you built the game with 1.1 (Windows)

After updating, press Build once more on the start screen: Play stays unavailable until then (the start screen
says why). Your saves, settings and shader cache stay.

Beta 1.1

Beta 1.1

Fixes

• Keys from newer dumps work. Some key dumpers write a few keys (master_kek_source_*, mariko_master_kek_source_*)
  with one byte too many, and unpacking stopped with "Unpacking failed". The builder now reads them correctly. Your
  prod.keys file is not changed.
• No more shader stutter in new areas. In 1.0 the shader cache built during Build came out mostly empty, so the
  game compiled shaders the first time it met them. The shader cache is now complete.
• The program no longer closes at start when the settings name your game files but the build folder is missing
  (for example after an interrupted first Build).

Changes

• Build now prepares the shaders in a window of its own: the program restarts itself for that step and comes back
  to the start screen when it is done. This is expected - nothing has crashed.
• Bug reports: build\unpack.log now shows why unpacking failed (key values are hidden, key names are kept), and
  nxrt.log covers the whole Build. To report a build problem, attach nxrt.log, build\build.log and
  build\unpack.log from %LOCALAPPDATA%\brothership-recomp - they never contain your keys. Never send your keys.
• Source: the builder's code (runtime/src/build) is now in the repository; it was missing from 1.0's source.

If you finished a Build with 1.0

Delete the cache folder in %LOCALAPPDATA%\brothership-recomp, then press Build again on the start screen
(your saves and settings stay).

Beta 1.0

Brothership Recomp – Windows beta preview

A native Windows port of Mario & Luigi: Brothership (version 1.0.1), made by static recompilation: the game's code is translated into C and compiled on your own PC, with the Switch's system services and NVN graphics provided by our own runtime on Vulkan. This download contains no part of the game. You build it from your own dump.

What you need

• Your own dump of the game as .nsp files: the base game and the 1.0.1 update
• Your console's prod.keys
• Windows 10/11 (64-bit) with a Vulkan-capable GPU and up-to-date drivers
• About 25 GB of free disk space while installing (about 15 GB afterwards)

Installing

1. Download BrothershipRecomp-Windows.zip and unzip it anywhere outside Program Files.
2. Start BrothershipRecomp.exe.
3. In Settings, set Game files to the folder with your .nsp files and Keys to the folder with prod.keys.
4. Press Build. The launcher unpacks your dump, translates and compiles the game's code, and prepares its shaders. This takes about 15 minutes on a fast PC, and only has to happen once.
5. Press Play.

Known issues

• Only tested on one PC so far (NVIDIA RTX 3090 Ti); other GPUs and drivers are untested.
• The first Play after an install restarts the program once.
• A small number of shaders are still prepared the first time they're needed, which can cause a brief stutter.
• No Steam Deck / Linux build yet, and no button remapping. Planned for next release.

Reporting a problem

Please open an issue and attach nxrt.log (and build\build.log if the build failed) from %LOCALAPPDATA%\brothership-recomp. These logs never contain your keys.

Credits

Frame-rate patch by Fl4sh_#9174. Built on drippu, SDL, Dear ImGui, hactool, ooz and LLVM; see NOTICE.md for all components and licences.

Not affiliated with or endorsed by Nintendo. Mario & Luigi and Nintendo Switch are trademarks of Nintendo.