Custom Models

As of randomizer version 7.0, the Link player models can be replaced with custom creations via the use of .zobj files. This is the only file type compatible with the randomizer.

These custom model files may additionally replace all item models which are connected to Link, such as the bottle, bow, and boomerang. However, item models will not change when disconnected from Link, for example free-standing items and the boomerang while it's in flight. The only exceptions to this are the Keaton Mask, Spooky Mask, and Bunny Hood which will also show the changed item on their respective NPCs (Not Skull Mask because the eyes glow on skull kid and is thus a separate item in the code).

Known Custom Models

In order to protect the project as a whole, the rando discord community does not share any models which may contain copyrighted assets. The user Hylian-modding on GitHub has more information regarding .zobj files.

All models we are aware of have been categorized in this google sheet for easy reference.

Using Custom Models

Online Generator

Models cannot be included in the initial generation, only added during patching. Thus, to use custom models first generate the seed, then on the patching page enable "Override Original Cosmetics" and set your Cosmetics and SFX tab options. One custom model for each age may be selected in the Cosmetics tab.

Bundled Version or Offline Dev Builds

Navigate to the randomizer folder, then data\Models. Place the .zobj files in the corresponding age folder. Open Gui.py and the model file names will be added to the Models dropdown options in the Cosmetics tab. Please be cautious of the age folders as a .zobj for the wrong age will patch, but will crash the rom upon load.

This method also permits a random model to be selected from those placed in the folder.

Please note that patch files generated will not include custom models, only .z64 rom files will have the change.

For assistance installing the randomizer, please see this page.

Racing with Custom Models

Custom models must not provide any additional benefit over using Link's standard models. Please carefully read the Universal Rules section before using any custom model in a race.

For quick reference, a list of race-legal custom models can be found here - only models on this list are allowed.

Creating Custom Models

A guide for creating custom models can be found here. For additional assistance, please ask in #dev-model-work in the discord.