There's a website to use the VARIA Randomizer, Solver, Tracker, Plandomizer: http://varia.run/
The current work in progress version is available on the beta website http://beta.varia.run/
You can join the VARIA discord too: http://discord.varia.run/
You need a git client:
dude@computer:~$ git clone git@github.com:theonlydude/RandomMetroidSolver.git
dude@computer:~$ cd RandomMetroidSolver
The current work in progress version is in the master branch (the default one, accessible on beta website (http://beta.varia.run/), if you want the version running on the production website (http://varia.run/) you have to checkout the production branch:
dude@computer:~/RandomMetroidSolver (master)$ git checkout production
Basculement sur la branche 'production'
Votre branche est à jour avec 'origin/production'.
dude@computer:~/RandomMetroidSolver (production)$
You need Python >= 3.6, it has been tested on Linux and CYGWIN.
As VARIA Randomizer has a lot of options, the easiest way to use it is with a Randomizer preset (--randoPreset), you also need a skill preset to tell the Randomizer which tricks he can use to acces the locations (--param) and a vanilla ROM (-r), you can optionally give a seed number (--seed), if not a random one is chosen:
dude@computer:~/RandomMetroidSolver (master)$ python3.7 ./randomizer.py -r ~/metroid/SuperMetroid.sfc --param standard_presets/Season_Races.json --randoPreset rando_presets/default.json --seed 1097821
You can start with an existing Randomizer preset and create a temporary one to update the parameters you want to change in the json, you can also set the parameters by hand but there's many many parameters (see web/controllers/solver_web.py for the call to randomizer.py using parameters)
For startLocation, majorsSplit, progressionSpeed, progressionDifficulty, morphPlacement and energyQty if you set them to random you can add a second parameter to give the list of possible values (see haste Randomizer preset for an example).
To list all the Randomizer parameters and their description:
dude@computer:~/RandomMetroidSolver (master)$ python3.7 ./randomizer.py -h
--param PARAMSFILENAME [PARAMSFILENAME ...], -p PARAMSFILENAME [PARAMSFILENAME ...]
the input parameters
--seed [SEED], -s [SEED]
randomization seed to use
--rom [ROM], -r [ROM]
the vanilla ROM
--randoPreset [RANDOPRESET]
rando preset file
There's less options for the Solver, it needs a seed (-r), a skill preset (--preset) and optionally a difficulty limit (--difficultyTarget) and a pickup stragegy (--pickupStrategy). You can display the spoiler log with -g.
dude@computer:~/RandomMetroidSolver (master)$ python3.7 ./solver.py -r VARIA_Randomizer_FX1097821_Season_Races_medium.sfc --preset standard_presets/Season_Races.json --difficultyTarget 10 --pickupStrategy all -g
The difficulty values:
easy = 1
medium = 5
hard = 10
harder = 25
hardcore = 50
mania = 100
see web/controllers/solver_web.py for the call to solver.py using parameters.
To list all the Solver parameters and their description:
dude@computer:~/RandomMetroidSolver (master)$ python3.7 ./solver.py -h
--romFileName [ROMFILENAME], -r [ROMFILENAME]
the input rom
--preset [PRESETFILENAME], -p [PRESETFILENAME]
the preset file
--difficultyTarget [DIFFICULTYTARGET], -t [DIFFICULTYTARGET]
the difficulty target that the solver will aim for
--pickupStrategy [{minimal,all,any}], -s [{minimal,all,any}]
Pickup strategy for the Solver
--displayGeneratedPath, -g
display the generated path (spoilers!)
You can call a VARIA website to generate your seed (a local one, beta or production) using the webservice client, it can be used for example on a Raspberry Pi with limited CPU power.
dude@computer:~/RandomMetroidSolver (master)$ python3.7 ./randomizer_webservice.py --rom ~/metroid/SuperMetroid.sfc --skillPreset standard_presets/Season_Races.json --randoPreset rando_presets/where_am_i.json --seed 1356988 --remoteUrl beta
VARIA_Randomizer_AFX1356988_Season_Races_VARIAble.sfc generated succesfully
To list all the Randomizer webservice client parameters and their description:
dude@computer:~/RandomMetroidSolver (master)$ python3.7 randomizer_webservice.py
--skillPreset [SKILLPRESET]
skill preset file
--rom [ROM] vanilla ROM file
--randoPreset [RANDOPRESET]
rando preset file
--seed [SEED] seed number (optional)
--remoteUrl [{local,beta,production}]
remote url to connect to
To apply colors randomization to an existing seed you can use the palettizer.
dude@computer:~/RandomMetroidSolver (master)$ python3.7 ./palettizer.py -r VARIA_Randomizer_FX1097821_Season_Races_medium.sfc
The parameters:
--individual_suit_shift
--individual_tileset_shift
--no_match_ship_and_power
--seperate_enemy_palette_groups
--no_match_room_shift_with_boss
--no_shift_tileset_palette
--no_shift_boss_palettes
--no_shift_suit_palettes
--no_shift_enemy_palettes
--no_shift_beam_palettes
--no_shift_ship_palette
--seed [SEED], -s [SEED]
randomization seed to use
--min_degree [MIN_DEGREE]
min hue shift
--max_degree [MAX_DEGREE]
max hue shift
--no_global_shift
--invert invert color range
To change Samus sprite or apply patches on an existing seed you have to call the Randomizer with the --patchOnly parameter. It'll generate a new ROM: VARIA.sfc
To add a sprite use --sprite, the available sprites are in itemrandomizerweb/patches/sprites/:
dude@computer:~/RandomMetroidSolver (master)$ ls itemrandomizerweb/patches/sprites/
alucard.ips fed_trooper.ips hack_ascent.ips hack_escape2.ips hack_nature.ips hack_redesign.ips hitbox_helper.ips marga.ips samus.ips win95_cursor.ips
bailey.ips hack_ancient_chozo.ips hack_decision.ips hack_hyper.ips hack_phazon.ips hack_szm.ips luigi.ips megaman.ips super_controid.ips
To add one or more patches use --patch, the available patches listed in the same order as on the Customizer page:
itemsounds.ips
elevators_doors_speed.ips
spinjumprestart.ips
rando_speed.ips
No_Music
random_music.ips
Example:
dude@computer:~/RandomMetroidSolver (master)$ python3.7 ./randomizer.py -r VARIA_Randomizer_FX1097821_Season_Races_medium.sfc --patchOnly --sprite megaman.ips --patch itemsounds.ips --patch No_Music
startAP:Landing Site
Apply patch itemsounds.ips
Apply patch No_Music
Apply patch megaman.ips
Rom generated: VARIA
Note: if you want both colors randomization and custom sprite you can't use the palettizer, you have to add the colors randomization parameters to the randomizer on top of --patchOnly.
The parameters:
--palette Randomize the palettes
--individual_suit_shift
--individual_tileset_shift
--no_match_ship_and_power
--seperate_enemy_palette_groups
--no_match_room_shift_with_boss
--no_shift_tileset_palette
--no_shift_boss_palettes
--no_shift_suit_palettes
--no_shift_enemy_palettes
--no_shift_beam_palettes
--no_shift_ship_palette
--min_degree [MIN_DEGREE]
--max_degree [MAX_DEGREE]
--no_global_shift
--invert invert color range
Example:
dude@computer:~/RandomMetroidSolver (master)$ python3.7 ./randomizer.py -r VARIA_Randomizer_AFX8258621_Season_Races_VARIAble.sfc --patchOnly --sprite megaman.ips --patch itemsounds.ips --palette --min_degree -75 --max_degree 25 --invert
startAP:Landing Site
Apply patch itemsounds.ips
Apply patch megaman.ips
Rom generated: VARIA