> 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/hookah-system.md).

# Hookah 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=zJzEQQWivFQ>" %}

## What it is

**mic\_hookah** lets players carry a hookah out of their inventory, set it down wherever they like, fill it with charcoal, water and a flavour, light it and smoke it through a hose. Tables and chairs come with it, so a group can set up a proper lounge anywhere on the map.

The hookah is set up through a small menu and used through your target resource. Every puff comes out in the flavour's colour for everyone around, and burns down the charcoal and the water until it has to be refilled.

***

### Key features

* **Ten hookahs** 🎨\
  Black, blue, green, grey, orange, pink, purple, red, sky blue and yellow, as custom models in the companion resource `mic_hookah_prop`.
* **Place it anywhere** 📍\
  The player carries it on a tray, then places a preview: mouse wheel to turn it, arrow keys to raise or lower it, **E** to set it down, **X** to cancel.
* **A setup menu** 🧰\
  Charcoal and water as percentages, the current flavour, and buttons to add charcoal, add water, change the flavour and light or stop the hookah.
* **Sixty flavours** 🍓\
  Each one an item with its own smoke colour and icon. The menu only offers the flavours the player is carrying.
* **A real hose** 🪢\
  Grabbing the hose draws a rope from the hookah to the player. Walk too far and it snaps.
* **Supplies that run down** 🔥\
  One `hookah_coal` and one `hookah_water` each fill the hookah; every puff uses some of both, and when either runs out the hookah goes out.
* **Coloured smoke for everyone** 🌫️\
  Each puff is shown to every player nearby. A flavour can also give the smoker a screen effect.
* **Tables and chairs** 🪑\
  Five tables and six chairs as placeable items. Chairs can be sat on and stood up from.
* **Owners and admins** 🔐\
  Only the player who placed a hookah can open its menu or pick it up — unless you leave admin access open, which is the default. Menu access can also be limited to jobs.
* **Eleven languages** 🗣️\
  English, Spanish, French, German, Italian, Portuguese, Russian, Chinese, Dutch, Polish and Turkish — the menu, the target labels and the messages.

***

### What you need

| You need                                | Why                                                                          |
| --------------------------------------- | ---------------------------------------------------------------------------- |
| **ESX**, **QBCore** or **QBox**         | Usable items, callbacks, owners and jobs. Chosen with `Config.Framework`     |
| **ox\_target** or **qb-target**         | Every interaction with a placed hookah or chair. Chosen with `Config.Target` |
| **`mic_hookah_prop`**                   | Ships with your purchase. Streams the ten hookah models                      |
| An inventory that supports usable items | Ready-made definitions ship for ESX, QBCore and ox\_inventory                |

No database tables of its own.

***

### Where to go next

| Page                                                                      | What is in it                                                    |
| ------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| [🪛 Installation](/mic/documentation/hookah-system/installation.md)       | Both folders, start order, items, images, the first hookah       |
| [🎒 Items](/mic/documentation/hookah-system/items.md)                     | Hookahs, furniture, supplies and the sixty flavours              |
| [🎨 Customization](/mic/documentation/hookah-system/customization.md)     | Which file decides what, every option, languages, the open files |
| [🩺 Troubleshooting](/mic/documentation/hookah-system/troubleshooting.md) | The problems buyers actually hit, and the fix for each           |