Custom Models - Revision history

Maplestar: Get rid of bombch.us link

2023-11-18T23:22:37Z

Get rid of bombch.us link

← Older revision		Revision as of 23:22, 18 November 2023
Line 31:		Line 31:
	Custom models must not provide any additional benefit over using Link's standard models. Please carefully read the [https://wiki.ootrandomizer.com/index.php?title=Category:Racing_Rules#Universal_Rules Universal Rules section] before using any custom model in a race.		Custom models must not provide any additional benefit over using Link's standard models. Please carefully read the [https://wiki.ootrandomizer.com/index.php?title=Category:Racing_Rules#Universal_Rules Universal Rules section] before using any custom model in a race.

	For quick reference, a list of ~~race-legal~~ custom models can be found [~~http~~://~~bombch~~.us/~~DXm2~~ here] - only models ~~on this list are allowed~~.		For quick reference, a list of known custom models can be found [https://docs.google.com/spreadsheets/d/1xbJnYw8lGR_qAkpvOQXlzvSUobWdX6phTm1SRbXy4TQ/edit#gid=1223582726 here] - only models indicated as Race Legal may be used.

Maplestar: Add copyright concern note

2022-11-25T03:51:32Z

Add copyright concern note

← Older revision		Revision as of 03:51, 25 November 2022
Line 5:		Line 5:
	== Known Custom Models ==		== Known Custom Models ==

	The user [https://github.com/hylian-modding Hylian-modding] on GitHub has more information regarding .zobj files.		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 [https://github.com/hylian-modding Hylian-modding] on GitHub has more information regarding .zobj files.

	All models we are aware of have been categorized in this [https://docs.google.com/spreadsheets/d/1xbJnYw8lGR_qAkpvOQXlzvSUobWdX6phTm1SRbXy4TQ/edit?usp=sharing google sheet] for easy reference.		All models we are aware of have been categorized in this [https://docs.google.com/spreadsheets/d/1xbJnYw8lGR_qAkpvOQXlzvSUobWdX6phTm1SRbXy4TQ/edit?usp=sharing google sheet] for easy reference.
Line 18:		Line 18:
	=== Bundled Version or Offline Dev Builds ===		=== 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.		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.		This method also permits a random model to be selected from those placed in the folder.

Maplestar: Create Custom Models Page

2022-11-25T03:36:03Z

Create Custom Models Page

New page

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 ==

The user [https://github.com/hylian-modding Hylian-modding] on GitHub has more information regarding .zobj files.

All models we are aware of have been categorized in this [https://docs.google.com/spreadsheets/d/1xbJnYw8lGR_qAkpvOQXlzvSUobWdX6phTm1SRbXy4TQ/edit?usp=sharing 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 [https://wiki.ootrandomizer.com/index.php?title=Setup#Downloading_the_Randomizer this page].

== Racing with Custom Models ==

Custom models must not provide any additional benefit over using Link's standard models. Please carefully read the [https://wiki.ootrandomizer.com/index.php?title=Category:Racing_Rules#Universal_Rules Universal Rules section] before using any custom model in a race.

For quick reference, a list of race-legal custom models can be found [http://bombch.us/DXm2 here] - only models on this list are allowed.

== Creating Custom Models ==

A guide for creating custom models can be found [https://docs.google.com/document/d/14MzUYycFmWoctEQ9hDLC8RMXsxPcaCT4GhI31NxwkpA/edit?usp=sharing here]. For additional assistance, please ask in #dev-model-work in the [https://discord.gg/ootrandomizer discord].