Installation

Fünfzehn Minuten. Zwei Ordner, ein paar Einstellungen und die Items. In der Datenbank wird nichts gespeichert, daher muss für die Ressource selbst nichts importiert werden.

Vorbereitung

Du benötigst	Warum
ESX, QBCore oder QBox, betriebsbereit	Items, Besitzer und Jobs laufen darüber
ox_target oder qb-target, betriebsbereit	Jede Interaktion mit einer platzierten Shisha oder einem Stuhl
Beide Ordner aus deinem Kauf: `mic_hookah` und `mic_hookah_prop`	Das Skript und die Shisha-Modelle
Zugriff auf die Itemliste und den Bilderordner deines Inventars	Shishas, Möbel, Zubehör und Geschmacksrichtungen sind Items

1. Beide Ordner ablegen

Platziere mic_hookah und mic_hookah_prop in deinem resources-Ordner, zum Beispiel in resources/[mic]/.

mic_hookah_prop enthält die zehn Shisha-Modelle (mic_hookah_black … mic_hookah_yellow) und deren mic_hookah.ytyp. Es enthält keinen Code; es streamt ausschließlich Assets. Tische und Stühle sind Basisspiel-Modelle und benötigen nichts Zusätzliches.

2. Startreihenfolge

In der server.cfg, unter deinem Framework, deinem Inventar und deiner Target-Ressource, füge ensure mic_hookah_prop und anschließend ensure mic_hookah ein.

Es hat funktioniert, wenn beide Ressourcen ohne rote Fehlermeldungen in der Konsole starten.

3. Framework und Target

Öffne config.lua:

Option	Wert auf	Standard
`Config.Framework`	`esx`, `qbcore` oder `qbox`	`esx`
`Config.Target`	`ox_target` oder `qb-target`	`ox_target`
`Config.ESXResourceName`	Der Ordnername von ESX, falls umbenannt	`es_extended`
`Config.QBResourceName`	Der Ordnername von QBCore, falls umbenannt	`qb-core`
`Config.QBoxResourceName`	Der Ordnername von QBox, falls umbenannt	`qbx_core`
`Config.QBTargetResourceName`	Der Ordnername von qb-target, falls umbenannt	`qb-target`

Hier wird nichts automatisch erkannt: Diese Werte bestimmen, welches Framework und welches Target verwendet werden.

4. Die Datenbank

Für die Ressource selbst ist nichts nötig: Platzierte Shishas und Möbel bleiben im Arbeitsspeicher des Servers und nicht in einer Tabelle. Bei ESX mit Standard-Inventar kommen die Items in die items-Tabelle — siehe nächster Schritt.

5. Items hinzufügen

Die vollständige Liste findest du unter 🎒 Items. Kurz zusammengefasst:

Item	Was es macht
`hookah_black`, `hookah_blue`, `hookah_green`, `hookah_grey`, `hookah_orange`, `hookah_pink`, `hookah_purple`, `hookah_red`, `hookah_skyblue`, `hookah_yellow`	Benutze es, um diese Shisha zu tragen und aufzustellen
`hookah_table` … `hookah_table5`	Benutze es, um einen Tisch zu platzieren
`hookah_chair` … `hookah_chair6`	Benutze es, um einen Stuhl zum Hinsetzen zu platzieren
`hookah_coal`	Füllt Kohle über das Einrichtungsmenü nach
`hookah_water`	Füllt Wasser über das Einrichtungsmenü nach
`hookah_<flavour>_flavor`	Sechzig Geschmacksrichtungen, auswählbar im Menü

Wo die fertigen Definitionen liegen, in inventory_items/ innerhalb von mic_hookah:

Datei	Für	Was zu tun ist
`esx_items.sql`	ESX mit Standard-Inventar	Einmalig in deine Datenbank importieren
`ox_items.md`	ox_inventory	Zeilen in `ox_inventory/data/items.lua` einfügen
`qb_items.md`	QBCore / QBox mit qb-inventory	Zeilen in `qb-core/shared/items.lua` einfügen

Bilder: Die Icons liegen in inventory_images/, jeweils eine PNG-Datei pro Item mit identischem Namen. Kopiere sie in den Bildordner deines Inventars — ox_inventory/web/images/ oder qb-inventory/html/images/.

Stelle anschließend Config.InventoryImagePath auf genau diesen Pfad ein, damit die Aromen-Icons im Menü angezeigt werden. Standardmäßig steht dort nui://ox_inventory/web/images/; für qb-inventory nutzt du nui://qb-inventory/html/images/.

Es hat funktioniert, wenn du dir hookah_red geben kannst und das Item mit Bild in deinem Inventar erscheint.

6. Erster Test

Gib dir hookah_red, hookah_coal, hookah_water und hookah_mint_flavor.

Benutze hookah_red. Dein Charakter hält sie auf einem Tablett. Drücke E.
Eine Vorschau folgt deinem Blickfeld. Drehe sie mit dem Mausrad, hebe oder senke sie mit den Pfeiltasten und drücke E, um sie abzustellen.
Visiere die Shisha mit dem Target an und wähle Open Setup Menu. Füge Kohle hinzu, fülle Wasser ein, wähle Mint und klicke auf Light Hookah.
Schließe das Menü, visiere die Shisha erneut an und wähle Grab Hose. Drücke E.

Es hat funktioniert, wenn ein Schlauch von der Shisha zu deinem Charakter verläuft und du bei Druck auf E einen Zug nimmst, woraufhin hellgrüner Rauch aufsteigt. Kohle und Wasser im Menü sinken mit jedem Zug ein wenig.

Vor der Eröffnung deines Servers

Entscheide, wer Shishas verwalten darf. Config.AdminGroups steht standardmäßig auf false. Das erlaubt jedem Spieler, das Menü jeder Shisha oder jedes Möbelstücks zu öffnen und einzupacken. Trage deine Admin-Gruppen ein, um dies auf Besitzer und Teammitglieder zu beschränken. Siehe Anpassung.
Config.InventoryImagePath zeigt auf den tatsächlich verwendeten Bilderordner.
Stress: Config.Stress ist aktiviert, aber ReduceStress in server_functions.lua ist leer, bis du deinen eigenen Funktionsaufruf dort einfügst.
Informiere deine Spieler darüber, dass Shishas und Möbel nicht persistent gespeichert werden: Bei einem Neustart der Ressource oder des Servers werden sie entfernt.