alttpr-launcher

Overview

The Legend of Zelda: A Link to the Past (ALttP for short) is an early 90s video game released for the Super Nintendo Entertainment System (aka. SNES). It is a popular game for speedrunning with an active community, from which eventually The ALTTP Randomizer project (ALttPR for short) has emerged.

The Randomizer is a web page where you specify game options, upload a version of the unmodified (vanilla) game ROM and then download a patched ROM version which can be used either on actual hardware (like a SNES using a SD cartridge) or inside an emulator such as Snes9x or RetroArch. A specific patched ROM is sometimes called a rando seed (as from seeding a pseudo random number generator). Seed generation has been automated further using SahasrahBot, powered by the Python module pyz3r. SahasrahBot also provides presets (YAML files containing randomizer settings) such as the famous Casual Boots.

For keeping track of the items collected and the plays they enable (aka. the routing), a map tracker such as the ALTTP Randomizer Community Tracker by Dunka (hence often called the Dunka tracker) is used. The Dunka tracker also supports auto tracking, where the tracker updates automatically by reading out the console's memory using an interface such as QUsb2Snes. This significantly reduces the cognitive load on the player and is highly recommended.

Making it a one-click-experience

alttpr-launcher brings it all together by orchestrating a complete Rando session:

Everything is controlled via a single configuration file, plus the unmodified presets from SahasrahBot. This allows a setup where the user's only task is to double-click a desktop icon, wait a few seconds and then start playing Rando. The browser view containing the Dunka tracker even features a simple timer with start / stop / reset functionality so that you can watch your Rando skills increase over time.

Screenshot of a typical ALttPR Session

References