Getting Started - TheG-Meister/pkc-mms-rando Wiki

A detailed guide on how to set up pkc-mms-rando! Follow this guide through from top to bottom to setup the program and start making randomisers.

Windows 10 & 11 - Windows Subsystem for Linux (WSL)

Windows Subsystem for Linux (WSL) allows an instance of Linux to run on a Windows machine. Linux is necessary to turn disassemblies into ROMs, so this process is adapted to carry out the whole randomisation process through Linux.

Full setup instructions for WSL can be found here.

Using a command prompt

This section will provide a brief introduction to using a command line. These commands and tips will get you started using pkc-mms-rando, but for a more well rounded introduction, check out the following guide from Ubuntu.

If this is your first time encountering a command prompt, they aren't as scary as they look!

An essential part of using a command prompt is changing your working directory.

Commands default to operation within your working directory. Here are some helpful examples:

Ubuntu Setup

Now you have a functional instance of Ubuntu, you'll need to follow all the steps below to install the rest of the dependencies within it and run pkc-mms-rando.

Ubuntu

Now whether you're on a Windows computer or an Ubuntu computer, you have access to a Bash command line. This will be used for the majority of the remaining instructions.

The following sections combine instructions for installing a pokecrystal disassembly, installing RGBDS and pkc-mms-rando specific setup.

Dependencies

In order to perform the remaining steps below, you'll need some additional programs. These are:

If you've just installed WSL, you'll need all of these! Thankfully it's easy to install all of them with a single command:

sudo apt-get install make gcc git bison pkg-config libpng-dev openjdk-17-jre-headless

Working directory setup

Next, we'll make a directory and download some extra necessary files.

Running pkc-mms-rando

The final step is running the randomiser!

Congrats! Test your ROM to make sure the randomiser worked - sometimes it spits out an error before running, and subsequently just creates a vanilla ROM. The next time you want to make another randomiser, just follow the steps in this section.