Texture Script Installation

How to set up texture change buttons in your hud. I will use in my example a HUD named Poncho Hud. It is part of this product on marketplace: XXXXXXXXXXXXXX

Installing the Texture DB Script in the HUD

Rez the HUD on the ground and add the script “AH Texture DB” to HUD. It will chat some instructions on how to set it up. Taking the instructions one at a time, here’s what they mean in detail:

[17:06] Poncho Hud: The script “AH Texture DB 3.9.7” needs a passphrase in order to work. Please edit the script and set a passphrase at the top. You will also need to set this same passphrase in the Color Receiver script you add to the worn items. Here’s a random suggestion:
string passphrase = “AtMjKWuAGbxWziz6 Poncho Hud EIkRsODIFNPrB60L”;

Passphrase is a piece of text used to encrypt your texture uuid’s so that they cannot be stolen by a simple LSL script.

  1. Edit the HUD, and go to Contents tab
  2. Double-click the script “AH Texture DB 3.9.7” to open it
  3. Copy the suggested random passphrase into line 1 of the script, replacing the empty passphrase that is there, for instance: 
    string passphrase = "AtMjKWuAGbxWziz6 Poncho Hud EIkRsODIFNPrB60L";
  4. Save the script

The passphrase also needs to be copied to the receiver script; I will describe that process in detail in the next section

[17:06] Poncho Hud: Script “AH Texture DB 3.9.7” must have next owner permissions of no modify

  1. Edit the HUD, and go to Contents tab
  2. Right-click the script “AH Texture DB 3.9.7”, and choose “Properties”
  3. Uncheck the checkbox labeled “Modify”

[17:06] Poncho Hud: chat /74finalize when you are done setting up all texture buttons, and before selling the hud, to protect your textures

/74finalize is described in more detail in this article: XXXXXXXX

[17:06] Poncho Hud: Set this prim to no transfer

  1. Edit the HUD, and go to General tab
  2. Uncheck the checkbox labeled “Transfer”

[17:06] Poncho Hud: AH Texture DB 3.9.7: Security check failed. Disabling script. Fix the issues and re-rez to try again

If you followed all the instructions above this line, you have fixed the issues. Right click the HUD and Take it. Then, rez it again from inventory. This time it should not say “Security check failed”. If it does, repeat the above instructions. If the script is installed properly, it should say something like this:

[17:34] Poncho Hud: chat /74finalize when you are done setting up all texture buttons, and before selling the hud, to protect your textures
[17:34] Poncho Hud: AH Texture DB 3.9.7 refreshed inventory; 0 textures loaded. 60.712600% memory available

If so, you are ready to proceed with installing the receiver script in the clothing prims, then we can start adding the textures

Installing the Color Receiver Script in the Clothing

Every clothing item to be used with this kit needs to have the script “AH Color Receiver” inside. The script can be used unmodified if you are only using the hud as a color changer. However, it needs additional setup if it is used for texture changing. To protect your textures from casual theft by a simple LSL script, they are encrypted during transit from hud to clothing. This encryption needs to be set up.

If you have multiple attachments to configure, configure one of them fully. Once the script is set up, you can copy the configured script to every other attachment

Start by dropping the script “AH Color Receiver 3.9.6 (Unlocked)” into your clothing item. In my examples, my clothing item is named “Teegle Horse Poncho”. Now edit it as follows:

  1. Edit the Clothing item, and go to Contents tab
  2. Drop the script “AH Color Receiver 3.9.6 (Unlocked)” from inventory into the clothing contents
  3. Double-click the script “AH Color Receiver 3.9.6 (Unlocked)” in the clothing contents to open it
  4. Copy the same passphrase you used in Texture DB script into line 1 of the script, replacing the empty passphrase that is there, for instance: 
    string passphrase = "AtMjKWuAGbxWziz6 Poncho Hud EIkRsODIFNPrB60L";
  5. Save the script

The script will now chat additional setup instructions, like so:

[18:16] Teegle Horse Poncho: The script “AH Color Receiver 3.9.6 (Unlocked)” needs to save your account key in order to work. Please edit the script and set your key as creator at the top, like this:
key creator = “a98362e9-bb71-45d0-aebe-3f0184f934fc”; // Tapple Gao

  1. Edit the Clothing item, and go to Contents tab
  2. Double-click the script “AH Color Receiver 3.9.6 (Unlocked)” in the clothing contents to open it
  3. Copy your avatar key onto line 4 of the script, exactly as instructed, for instance: 
    key creator = "a98362e9-bb71-45d0-aebe-3f0184f934fc"; // Tapple Gao
  4. Save the script

The script will now chat yet more setup instructions. If it does not, you probably mistyped your creator key. Copy and paste it exactly as the script instructed. Don’t use my creator key.

I will walk thru the remaining setup instructions one by one:

[18:23] Teegle Horse Poncho: This object must have next owner permissions of no transfer. Please rez me on the ground and change my next owner permissions

  1. Edit the Clothing item, and go to General tab
  2. Uncheck the checkbox labeled “Transfer”

[18:23] Teegle Horse Poncho: Please set the next owner permissions of script “AH Color Receiver 3.9.6 (Unlocked) ” to no modify. This protect the encryption passphrase, which helps protect the textures

  1. Edit the Clothing item, and go to Contents tab
  2. Right-click the script “AH Color Receiver 3.9.6 (Unlocked)”, and choose “Properties”
  3. Uncheck the checkbox labeled “Modify”

Prim x is not created by you

  • Either remove the prims if they are there by mistake or
  • In the receiver script, line 26, change TRUE to FALSE, like
    integer FAIL_IF_CREATOR_MISMATCH = FALSE;

Prim x is not mesh

  • Either remove the prims if they are there by mistake or
  • In the receiver script, line 23, change TRUE to FALSE, like
    integer FAIL_IF_NOT_MESH= FALSE;

[18:23] Teegle Horse Poncho: Security check failed. Shutting down script “AH Color Receiver 3.9.6 (Unlocked)”. Fix the issues and re-rez or reset the script to try again. For more information on the security checks, or to disable some of them, please open the script and read the top section

If you followed all the instructions above this line, you have fixed the issues. Right click the Clothing item and Take it. Then, rez it again from inventory. This time it should not say “Security check failed”. If it does, repeat the above instructions. If the script is installed properly, it should not chat anything.

I advise renaming the receiver script to indicate that it’s no longer unlocked, but is keyed to your hud. I renamed mine to: “AH Color Receiver 3.9.6 (Tapple Poncho)”:

  1. Edit the Clothing item, and go to Contents tab
  2. Right-click the script “AH Color Receiver 3.9.6 (Unlocked)”, and choose “Rename”
  3. Type in a new name, for instance, “AH Color Receiver 3.9.6 (Tapple Poncho)”

Now, copy the renamed script from the clothing item back into your inventory. If you have further clothing items to set up, simply drop the renamed script into each one. The script may ask you to set the other attachments to no transfer, but that should be the only setup needed on the rest of the clothing items.

Next Steps

The scripts are now installed and in your HUD and clothing items. You can proceed to either add the textures to your HUD, and then configure where each one goes on the prims:

Leave a Reply