HUD

Your HUD will need to contain some information. I created a very basic HUD with 6 buttons that will apply a texture set.

The black prim is the root prim of my HUD, it don't need to have a special name or description. The 6 blue button needs to be named apply this way, the HUD know he will needs to apply a texture set when your customers will click on one of the buttons. For now, leave their description empty.

After you're done with this, untick Edit linked to select your complete HUD and then, put the .config HUD script into your HUD. Open the script by double clicking on it.

If you are not familiar with what you see, please go read the Definitions, it's important.

Included out of the box, this .config HUD contains some basic instructions for you to start with. You can erase the data from line 20 to 39 included as we will create our own instructions.

Same as the object, edit the line 10 with your objectName you put earlier in your object and line 12, put your own key.

Line 13 is your secureKey. It is unique to your avatar and it is used to add more security to the system by encrypting your UUIDs. You can get your key by wearing the Kynno - User Secure Key (wear/add) and click on it.

Now, let's create our own instructions. On my cube, I only want to change one texture on one face, it's a pretty basic example. (More complex examples will be able in Examples)

First of all, we need to create a new texture set in our .config HUD, to do that, simply enter the name of your texture set with a - before it.

Then, I want my prim named Astre - Damaged Cube to be retexture on all faces and I can do that by adding a texture instruction.

Done! Before any save, I also want to add another set for another color, let's say black. I will repeat the same process that I did for the orange one.

We have now two texture sets and we will be able to use our HUD soon! Save your .config HUD

Now, put the script Kynno - EasyTextures HUD v3.0 into your HUD and read your local chat.

// You should see something similar.

[12:49:27] Object: Initializing HUD EasyTextures...
[12:49:28] Object: ⚠️ EasyTextures: Processing orange...
[12:49:28] Object: ⚠️ EasyTextures: Processing black...
[12:49:28] Object: ⚠️ EasyTextures: Object name detected: myObject
[12:49:28] Object: ⚠️ EasyTextures: Process complete ! We found a total of 2 textures pack(s) in your script. You can now delete the script if you are done with your configuration.
[12:49:28] Object: Memory free: 40740

Last step, we need to update our HUD. Select one of the apply button and in its description, enter the name of one of the color set, for example, orange. Then, on another button, enter the second texture set, black.

Once you did that, you should be able to use your HUD. Click on any of the button and tadam, your object is retextured!

Congratulations, this is the end of the step-by-step tutorial. This was a very basic tutorial to makes things work and I hope it goes well for you. You have more detailed informations in the Definitions page or in the Examples one. Be sure to check them out.

Once you are finished to configure your object and ready to release, you are able to delete both .config and .config HUD.

⚠️ ATTENTION: You must be aware that in some case, people might want to duplicate it using SHIFT + mouse. In this case, the EasyTexture will lost its configuration. (objectName and touchToApply option).

You have two choices:

  • Keep the .config script in the object.

  • Tell your customer to rez objects from their inventory and not using SHIFT + mouse.

If you can, I do recommend you to just keep the .config in the object. It doesn't contains any sensitive data and cost no usage of script.

If you still have issues with configuring your system, please be sure to contact Luke Rowley in-world, I will be more than pleased to help you with this.

Last updated