TexStickers - Texture customizer

TexStickers is a script who add the ability to customize any entity with stickers. One of the most interesting applications of that is car customization.

See examples in thisvideo(v1.0.0).
See v1.2.0 "layer system" examples in thisvideo.
TexStickers gallery (steam)
Share your best car designs by adding#texstickersin the steam screenshot description, they will be added to the TexStickers gallery. If you have difficulties with the editor, click the "help" button to see an example video.

---

Version 1.2.0 out !
Don't use the v1.0.0 anymore, saved designs are migrated since the 1.1.0.
Features

• customization platform entity for cars (DarkRP)
  
• a tool gun near Material and Color for all gamemodes
  
• add your custom stickers
  
• TexStickers API
  
• materials layer system
  
• "!vcustomize" chat command for DarkRP (enter the vehicle or look at it)(deprecated)
  
• saved designs are located in "garrysmod/data/texstickers/designs/" (client-side)
  

Installation
Just place the "texstickers/" folder to the "addons/" folder.
How it works / Configuration
The stickers are generated client-side and synced for all clients, it should be fast. If you experience any troubles, you can modify the generated texture size to something lower or equal to 1024 (512,256,128...).
Add stickers
To add your own stickers to the list, you can create a workshop addon with the folder "materials/stickers/" containing .png images. Then, add the addon to "lua/autorun/server/stickers.lua" to make players download it.
You can also add .png images directly to the "materials/stickers/" folder of TexStickers, but this is slower and can cause the "phantom sticker" issue (a sticker not visible for some people because they had it on another server).
Add fonts
Fonts can't be added with a workshop addon, you need to manually add new fonts in the "texstickers/resource/fonts/" folder with this filename format :

The real font name can be found by opening the font under Windows or with any TTF font visualizer.
A set of premade free fonts from dafont.com can be downloadedhere, extract them in "texstickers/resource/fonts/".
Layer system
Since the 1.2.0, TexStickers can customize any entity submaterials.
This is defined by the layers definition string, who looks like this :
"index[:matcode_name][:resolution],index[:matcode_name][:resolution],..."
Example:"1:s,3:c:256"will edit submaterials 1 (shiny), 3 (chrome,resolution 256)
If no matcode_name is given, TexStickers willtryto copy the original material.
If no resolution is given, 1024 will be used.
You can add your own matcodes definitions to thetexstickers/lua/texstickers_config.luafile.
The layer system add a little more complexity to the script, but give more customization control.
DarkRP

• disable the TexStickers Customize and TexStickers CarConfig tool guns for players
  
• configure the layers definition for each vehicle by testing the indexes with the tool gun (it is recommended to not allow too many textures to prevent clients overload, or to limit their size; for a rim texture a resolution of 256 can be enough)
  
• spawn TexStickers customization platform entities
  
• as superadmin, type "!texstickers savemap" in chat to save the customization platform positions
  
• restart your server
  

You can probably PermaProps the customization plarforms instead.
The cars layers definition configuration step can take some time, but solve any car incompatibility issue and give you more control to define which parts of the car can be customized.
deprecated:For DarkRP servers who want to use the "!vcustomize" command, check the file "lua/autorun/server/vcustomize.lua" and add your own restrictions (car dealer minimal distance, car owner, restrict police jobs...).
For developers
The API is very simple if you want to add, for example, a designer job (someone who can apply stickers to props), or a clothes designer job.
Callbacks
Sticker custom check (client)

• player (Player)
  
• sticker_path (string): ex: "stickers/blank.png"
  
• return (bool): true to authorize a sticker, false to disable it, if no return value is given, the sticker will be authorized by default
  

This is a client-side only callback. You can also check the special sticker path "!text" to authorize or not textual stickers.
Functions
Apply stickers to an entity submaterial

• entity (Entity): the entity to customize
  
• mat_index (number): the submaterial index (starts at 1)
  
• resolution (number): the generated texture resolution (1024 for best results)
  
• stickers (table): stickers list, see the sticker structure
  
• mat_code (string): material creation code executed client-side, if nil, will try to copy the base material
  

Apply stickers to an entity submaterial (layers version)

• entity (Entity): the entity to customize
  
• layers (Layers): layers structure with stickers (if empty table "{}", will clear the entity)
  

Begin stickers editing for an entity submaterial

• player (Player): a player
  
• entity (Entity): the entity to customize
  
• mat_index (number): the submaterial index (starts at 1)
  
• resolution (number): the generated texture resolution (1024 for best results)
  
• stickers (table): stickers list, see the sticker structure
  
• mat_code (string): material creation code executed client-side, if nil, will try to copy the base material
  
• onvalid(layers) (function): called when the editing is valided, can return false to reject the modifications
  

Example:

Begin stickers editing for an entity submaterial (layers version)

• player (Player): a player
  
• entity (Entity): the entity to customize
  
• layers (Layers): layers structure without stickers
  
• onvalid(layers) (function): called when the editing is valided, can return false to reject the modifications
  

Structures
A sticker added to a sticker list (a table) is built like this :


will display two squares in the center of the texture with different rotations (red and green)
The layers structure is built like this (matcode can be nil) :

or

Matcode
The mat_code parameter is just lua code executed client-side to change material creation.
Since the 1.2.0, the matcode is required to set the material texture.
TexStickers.matcode structure:

• mat (in/IMaterial): the base material
  
• newname (in/string): the name of the created material, needs to be this one, and only this one
  
• tex (in/ITexture): the TexStickers generated texture
  
• newmat (out/IMaterial): the created material
  

Example:

For a clear example, check the file "lua/autorun/server/vcustomize.lua".
Warning: changing the in-game resolution while playing on the server will break the custom textures

Link is down, therefore the thread has been closed. OP if you wish to update your link please send me or anyone of the staff team a message.