Using the Program and Patching Information

Website

It is highly recommended you use the website to generate your DK64 randomizer ROMs. The vast majority of players should have no need to run this locally. If you are interested with messing around with the code and starting your own build of DK64 randomizer, see the bottom of this article for instructions.

The ROM

The website requires your DK64 ROM to meet the following requirements:

• Must be an unmodified vanilla US (NTSC-U) ROM.
  • All other versions of the game (Japanese, European/Australian, Kiosk, Lodgenet) are not compatible with DK64 Randomizer
  • Likewise, any ROM Hacks of a DK64 ROM are not supported.
• The ROM must have a .z64, .n64 or .v64 file extension.
  • Renaming a file to have one of these extensions will almost certainly not work.

If you see a red ! mark next to the ROM input, there is something wrong with the ROM supplied and you will need to check your ROM against the above conditions outlined.

DK64randomizer.com does not contain, host or distribute any copyrighted material. You MUST provide your own DK64 ROM.

Running DK64 Randomizer Locally

Python 3.11 or above is needed to run DK64 Randomizer locally. It does not matter which version you install.

Once Python is installed, you can download the program from the main code page on GitHub, click the green "Code" button and then download the ZIP (or open one of the other listed methods if preferred). We'd also HEAVILY advise running the randomizer through VSCode

1. Place your US ROM (See The ROM for requirements) in the base directory of the repository (same directory as files like .gitignore, bps_maker.html and requirements.txt). Your ROM will need to be named EXACTLY dk64.z64. If your US ROM is not a .z64 file, pass it through the Hack64 Swapper to convert it to the correct endianness.
2. In VSCode, on the top tray, click Terminal > Run Task > Install Requirements. If you are not using VSCode, you will need to run python -m pip install -r ./requirements-dev.txt with python. This will install all the necessary requirements to run the website.
3. In VSCode, on the top tray, click Terminal > Run Task > Run Server. If you are not using VSCode, you will need to run ./runner.py with python. This will run the website locally.
4. Open a web browser and navigate to https://localhost:8000/, which will be your downloaded version of DK64 Randomizer.