Hootless: Added wiki navigator

2019-04-17T19:14:20Z

Added wiki navigator

Hootless: How to create custom materials/dyes

2019-04-17T17:17:05Z

How to create custom materials/dyes

New page

Materials (or dyes) alter the color of various parts of the players sprite. They can be added to the game fairly easily, requiring adding only a simple file. If you haven't yet, make sure you [[Mod base|create the base for the mod first]].

== Making Materials ==

In this example, we'll add a pink skin dye.

In your mod folder, create a folder called <code>tweak</code>. In there, you have to create a new sval file. You can for example call this <code>extra_dyes.sval</code>, or something else. '''Keep in mind''': the assets between base and mods are shared! This means you should use a unique filename here that no other mod is going to use. (You could also put it in a separate (or different) folder if you want to be extra cautious.)

Sval files is the main serializable data structure used throughout the engine, and sval files describe a single SValue object. Sval files however have a special property; you can specify a <code>loader</code> tag to tell the engine which script function to load the sval with. These are called [[SValue Loaders]]. Using this loader, we can make the file load material definitions. For example, we can make an sval file containing this to add a new pink skin dye.

<loader>Materials::LoadDyes</loader>
<dict>
<array name="skin">
<dict>
<string name="id">pink</string>
<string name="name">Pink</string>
<array name="shades"><string>#350010</string><string>#e646c3</string><string>#ffa2fa</string></array>
<string name="quality">rare</string>
<bool name="default">true</bool>
</dict>
</array>
</dict>

Here's a breakdown of the information included here:
* <code>array name="skin"</code>: This is what the material applies to. Other options besides <code>skin</code> are <code>hair</code>, <code>cloth</code>, <code>metal</code>, <code>leather</code>, and <code>wood</code>
* <code>string name="id"</code>: This is the ID used to refer to the skin.
* <code>string name="name"</code>: The name displayed in-game.
* <code>array name="shades"</code>: The three values here correspond to the hex values for the three colors used in the material. Each can be anywhere from <code>#000000</code> to <code>#ffffff</code>.
* <code>string name="quality"</code>: The quality of the material, can be <code>common</code>, <code>uncommon</code>, or <code>rare</code>.
* <code>bool name="default"</code>: Determines whether you start with the material or have to find it like the other materials. Can be either <code>true</code> or <code>false</code>.

If you've done it all right, you should be able to enable the mod in-game and see your new material available in the tailor (if you have it set to default)! Unfortunately due to limits of the game engine it currently (as of writing this page) is not possible to have custom materials show up in the character creation screen.

[[File:Pink_picture.PNG]]

← Older revision		Revision as of 19:14, 17 April 2019
Line 36:		Line 36:

	[[File:Pink_picture.PNG]]		[[File:Pink_picture.PNG]]
		+
		+
		+	{{Template:BaseNav}}

Custom Materials (Dyes) - Revision history

Hootless: Added wiki navigator

Hootless: How to create custom materials/dyes