> For the complete documentation index, see [llms.txt](https://mic-scripts.gitbook.io/mic/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mic-scripts.gitbook.io/mic/documentation/chameleon.md).

# Chameleon Painting System

{% hint style="info" %}
💬 **Need help?** Support, updates and changelogs are on the [**Mic Scripts Discord**](https://discord.gg/86FPzAV73B). Open a ticket with your Tebex transaction ID and the console error.
{% endhint %}

<a href="https://discord.gg/86FPzAV73B" class="button primary">💬 Join the Discord</a> <a href="https://mic.tebex.io/" class="button secondary">🛒 Get it on Tebex</a>

{% embed url="<https://www.youtube.com/watch?v=NvyYfgE_0u0>" %}

## What is mic\_chameleon?

**mic\_chameleon** puts 82 chameleon paints on your server — the colour-shifting finishes that change with the angle you look at them from. Players sit in a car, open a menu of swatches, click one and the car changes on the spot. Twenty of those paints are added by the resource itself, with their own paint ramps streamed alongside it.

You decide who gets to use it: a list of players you grant by command, a list of jobs, or everybody. Each paint can also be an inventory item that anybody can use, so paint cans can be sold, looted or crafted instead of handed out.

### Key features

* **82 paints in one menu**\
  Every chameleon colour from ID 161 to 242 as a clickable swatch. Click, and the car is painted; no preview step, no confirmation screen.
* **A way back**\
  The first time a car is painted, its original colour is written down against its model and plate. The **Reset** button, the `/chameleonreset` command or the `chameleon_reset` item put it back.
* **Paint as items**\
  83 ready-made items — one per colour plus a reset — for ox\_inventory, QBCore and the ESX items table. Use one while sitting in a car and it is consumed and applied.
* **Who may paint**\
  A permission list you manage with `/chameleongive` and `/chameleonremove`, a list of jobs, or neither.
* **Paint shops on the map**\
  Markers you place in `config.lua`. Drive into one and press **E** to open the menu.
* **ESX, QBCore or QBox, found on its own**\
  `Config.Framework = "auto"` looks for `es_extended` and `qb-core` and uses whichever is running. QBox is found through its QBCore compatibility — `qbx_core` provides `qb-core`.
* **Nine languages**\
  English, Spanish, French, German, Italian, Portuguese, Polish, Russian and Turkish.
* **Open where it matters**\
  The config, the locales, the bridge, the item definitions and both JSON data files are left unencrypted.

### What you need

|                |                                                                                   |
| -------------- | --------------------------------------------------------------------------------- |
| **Framework**  | ESX (`es_extended`), QBCore (`qb-core`) or QBox (`qbx_core`), detected on its own |
| **Database**   | None — the resource keeps its data in two JSON files                              |
| **Inventory**  | Any that honours the framework's usable items, only if you use the paint items    |
| **Game build** | A recent one: the paints are part of the newer vehicle colour set                 |

### Where to go next

| Page                                                                  | What is in it                                                           |
| --------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| [🪛 Installation](/mic/documentation/chameleon/installation.md)       | Folder, start order, items, and the first paint job                     |
| [🎨 Customization](/mic/documentation/chameleon/customization.md)     | Every option, the locations, the commands, the languages and the bridge |
| [🩺 Troubleshooting](/mic/documentation/chameleon/troubleshooting.md) | The menu will not open, the paint looks flat, reset forgot the colour   |