Skip to content

Overlay Textures

Overlay textures are used for attires in Create-A-Wrestler.

Custom overlay textures must be placed in a directory named OverlayTextures inside your content pack. The only supported file format is JPG. Overlay textures consist of a diffuse and optionally a normal map. An accompanying JSON file can be used to set some default parameters.

Normal Maps

The normal map must be in OpenGL format and have the same name as the corresponding diffuse map with the additional suffix _n. For example, if you have a diffuse map named texture.jpg, then the normal map must have the filename texture_n.jpg.

JSON Parameters

You can provide default parameters in a JSON file with the same name of the diffuse map. For example, if you have a diffuse map named texture.jpg, then the JSON file must have the filename texture.json.

The following JSON contains all supported parameters with their default values:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
{
    "DefaultColorHue": 0.0,
    "DefaultColorSaturation": 1.0,
    "DefaultColorValue": 1.0,
    "DefaultTexShift": {
        "x": 0.0,
        "y": 0.0,
    },
    "DefaultTexRotation": 0.0,
    "DefaultTexTiling": {
        "x": 1.0,
        "y": 1.0,
    },
    "DefaultSmoothness": 0.125
}

The parameters work as follows:

  • DefaultColorHue: The hue (between 0 and 1) to set when the texture is selected. See Coloring Notes below for more details.
  • DefaultColorSaturation: The default color saturation (between 0 and 2) to set for when the texture is selected.
  • DefaultColorValue: The default color value (between 0 and 2) to set when the texture is selected.
  • DefaultTexShift: The default texture shift (in relative coordinates) to set per axis when the texture is selected.
  • DefaultTexRotation: The default texture rotation (in degrees) to set per axis when the texture is selected.
  • DefaultTexTiling: The default texture tiling (in relative coordinates) to set per axis when the texture is selected. Note that this is a tiling value and not a scale value like in the attire editing menu – scales are the negated base-2 logarithm of the tiling, which is more intuitive for editing.
  • DefaultSmoothness: The default smoothness (0 to 1) to set when the texture is selected.

Coloring Notes

To ensure that your texture's colors are in sync with the color wheel in the attire editing menu, your diffuse map's primary color should be red (e.g., correspond to a hue value of zero). It may be a good idea to recolor your texture to a red hue and use the DefaultColor* parameters to adjust the default.

For example, take the Denim texture that is shipped with the game: the original texture is actually red denim, but the DefaultColorHue is set to 0.6 to makes it blue when the player selects it.

Additional Notes

  • Filenames must have the .jpg extension (lowercase).
  • Accompanying normal maps must have the same file name with the additional suffix _n (e.g., texture_n.jpg).
  • Accompanying JSON files must have the same file name but with a .json extension (e.g., texture.json). If it does not exist, it is automatically generated on startup.
  • Overlay textures files must not be larger than four mebibytes (4 MiB, diffuse and normal each) and must have a maximum dimension of 2048x2048. Larger textures are not imported.
  • If a stamp is not being loaded, please check the logfile for any relevant messages regarding the file.