renut logo

Originally created with Rexglue-SDK

DISCORD -------------------------------------------- We have a discord, please join and direct any questions there. Myself or someone else will happily answer them.

https://discord.gg/D5Bz2ZsHdY

Credits ------------------------------------------------ Rexglue team for creating Rexglue-SDK
the Rexglue SDK discord for helping with any info they have
SolarCookies for midasm hooks and future use of CRT functions and the reNut Launcher
ValcomDrifty for the renut logo
.
.
.
.
.
.
you, the player?
.

REQUIREMENTS ------------------------------------------------------------------- US version of banjo-kazooie: nuts and bolts default.xex

HOW TO BUILD ------------------------------------------------------ NOTE: YOU MUST DELETE ALL INSTANCES OF .gitignore OTHERWISE WHATEVER YOU COMPILE WITH WONT SEE THE FILES IN THE AREAS THEY ARE IN.
NOTE: YOU MUST INSTALL GIT BEFORE INSTALLING THE REXGLUE-SDK, OR BUILDING THIS REPO.
NOTE: NOTE: YOU MUST BUILD AND INSTALL THE MAIN REPO OF Rexglue-SDK BEFORE CONTINUING

Clone the repository with ``git clone https://github.com/masterspike52/reNut.git`


Inside the assets folder you need to extract your banjo-kazooie: Nuts&Bolts iso's contents and the default.xex. I reccomend using iso extract. (I don't know what linux users use. I use Windows, however iso extract does work on linux through WINE.)

Inside your cloned git open a terminal and run `rexglue migrate --app_root .` This ensures that if anything with codegen changes on Rexglue, you can codegen properly.

3b. You must then either delete your out folder, or if your on Windows you can open VS, right click your cmakelists.txt, and delete cache and reconfigure so you codegen with the version your using.

You can now open a terminal and run `rexglue codegen renut_config.toml` which will give you the ppc files to recompile in the generated folder.

If you're on Windows, you can open the project in VS, change the build type to win-amd64-relwithdebinfo, then build all.

5b. If you're on Linux, and don't have access to VS, you will need to use a terminal and run `cmake --preset linux-amd64-relwithdebinfo` and then `cmake --build --preset linux-amd64-relwithdebinfo`. (You can do this on Windows as well, just replace linux with windows`.)

Once its compiled, you need to have the built exe in the same directory as the assets, otherwise the game won't open.

THERES A LINUX FORK ------------------------------------------------- if you wish to build for linux please use this fork of reNut made by etonedemid it requires using his fork of rexlgue and he has made a pr to rexglue so this stuff becomes part of main.

IF YOU DONT WANT TO BUILD -------------------------------------------- Building is mainly for those who either would rather build or want to help develop the game with myself and others. If you don't want to build;

Go to https://goopie.xyz/ and download the goopie launcher
In the launcher select banjo-kazooie: nuts and bolts
Click Select ISO and select your iso for banjo-kazooie: nuts and bolts (must be the north american release) and wait for extraction to finish
After extraction is finished click the update button, the launcher will then download the latest release of the windows version of renut
Click play

KNOWN ISSUES -----------------------------------------------

Animations are a little jank (there's jitter, banjo's and others bones break, some of the animations are half done, and some other little ancillaries) but they do not inhibit gameplay, it's just funny to see happen.

MAKING AN ISSUE -------------------------- The Issues tab is a place for things like crashes that happen in game that arent already noted, please refrain from making issues like "Game wont open" or "Have to use ISOs?". You must use the crash template for any issues that pertain to crashes (I'll probably make other templates), for I don't need it flooded with mostly user error posts. Please join the discord and use the #help channel if you have an issue unrelated to a crash.

--- Tranlated By Open Ai Tx | Last indexed: 2026-07-01 ---