DIVERSITY

Documentation

Textures

This guide will walk you through changing or replacing the tape texture with a custom or premade texture.

Adding a new texture

Obtain a Texture
Download or prepare your custom texture. The texture must be saved in a supported .dds format and appropriately sized to fit in the tape material.
If you're using a premade texture, ensure it is included in the example folder for best results.

Install Texture Toolkit
If you don't already have Texture Toolkit installed, download it from GTA5-Mods.

Navigate to the Texture File

  1. Open Texture Toolkit and click on File > Import at the top left corner.
  2. Navigate to the neko_tape_txd.ytd file in the tape script folder.
    Typically, this would be located in:
    /div_tape/stream/neko_tape_txd.ytd

You can also watch this Texture Toolkit tutorial.

Add the Texture

  1. Once you have the file opened in the Texture Toolkit, select the option Edit > Import.
  2. Browse to your new texture file and select it.

Save the Changes

  1. After adding the texture, click on File > Save in Texture Toolkit.
  2. Now you can close Texture Toolkit.

Configuring the New Texture
To configure a new texture, follow one of these two methods, depending on whether the texture has a gaffer variant:

  1. Texture without a Gaffer Variant
    If the new texture, for example, 'CAUTION_TAPE', does not have a gaffer variant, simply change the value of TAPE_TEXTURE to the new texture's name.

    TAPE_TEXTURE = 'CAUTION_TAPE',

    The TAPE_TEXTURE variable holds the name of the currently used texture.

  2. Texture with a Gaffer Variant
    If the new texture, for example, 'CAUTION_TAPE', does have a gaffer variant, you need to add an entry for it in the TAPE_WITH_GAFFER_VARIANT table.

    The TAPE_WITH_GAFFER_VARIANT table is a list of textures that have a matching gaffer (tape held in hand) variant. To add a new texture, you add the tape name as a key and set its value to true. The script will automatically look for the '_GAFFER' variant, for example 'CAUTION_TAPE_GAFFER'.

    TAPE_TEXTURE = 'CAUTION_TAPE',
    
    TAPE_WITH_GAFFER_VARIANT = {
        ['FIRE_TAPE'] = true,
        ['WORK_TAPE'] = true,
        ['CAUTION_TAPE'] = true,  -- Add the new texture here
    },

Restart Your Server

  1. Restart your FiveM server to ensure the new texture is applied.
  2. Test the tape system to confirm the texture works correctly.

Notes

  • If your texture isn't displayed correctly, double-check the size and format of your file. Recommended format is .dds with appropriate dimensions (e.g., 940x30).
  • Premade textures provided with this script are designed to fit seamlessly and require no additional editing.