Making Decal Addons

Decals are colored textures that are applied on top of HD-chan's skin material.

Elements of a Decal Addon

Decals consist of two/three elements:

Diffuse texture
Mask texture (optional)
Config file

Textures

Diffuse

The diffuse texture contains the decal color information in the RGB channels, and the decal alpha (opacity) in the alpha channel.

Mask

The mask texture uses the red and green color channels to encode information used for decal customization in-game:

R: Blend between color_1 (R value of 0) and color_2 (R value of 255)
G: Blend between dynamic color (the result of blending color_1 and color_2) (G value of 0) and the diffuse texture RGB color (G value of 255)

Texture Mapping

Internally, decals are all composed together into one big texture before being applied to HD-chan's skin material. Decals all share a single UV map and are composed into a single 4k texture.

Decal mapping guide

The obvious downside of composing decals this way is that all decals, even a tiny little beauty spot on HD-chan's cheek, will need a huge 4k texture covering HD-chan's entire body. In order to overcome this, Hyperdeep has a remapping feature that allows users to supply a cropped decal that is then moved into the correct location on the decal texture using an offset supplied in the config file.

The value of this pixel offset is the pixel location of the top left of the cropped diffuse texture, when it is placed on the full decal map texture linked above.

Config File

eyeshadow_hearts.json

{
    "display": "Hearts", // (1)!
    "parameter": "eyeshadow", // (2)!
    "color_1": [52, 52, 52], // (3)!
    "color_2": [0, 0, 0], // (4)!
    "opacity": 1.0, // (5)!
    "mod_color_1": true, // (6)!
    "mod_color_2": false, // (7)!
    "mod_opacity": false, // (8)!
    "depth": 0.0, // (9)!
    "offset": [342, 1200] // (10)!
}

The name displayed in-game for this decal
Which customization parameter this decal will be added to. The available options are:
- eyeshadow
- pubichair
- tattoos
- freckles
- lipstick
- blush
The default primary color for this decal, RGB 0-255
The default secondary color for this decal
The default opacity for this decal
Whether the primary color can be customized in game
Whether the secondary color can be customized in game
Whether the opacity can be customized in game
Used to determine the order in which decals overlap each other. The higher the value, the later in the stack the decal is applied (and so appears on top of other decals).
The pixel offset