Installation

Zehn Minuten, der Großteil davon für das Einfügen von Item-Definitionen. Die Resource hat keine eigenen Tabellen und keine Begleit-Resource: Die Vape-Modelle werden aus dem eigenen stream/-Ordner gestreamt.

Vorab

Was du brauchst	Warum
ESX (`es_extended`), QBCore (`qb-core`) oder QBox (`qbx_core`), laufend	Wird automatisch erkannt; es gibt keine Framework-Einstellung
Zugriff auf die Item-Liste deines Inventars	Die Vapes sind Items
Zugriff auf den Bilderordner deines Inventars	Damit jede Vape ihr Icon hat

1. Ordner platzieren

Platziere mic_vape in deinen Resources, zum Beispiel in resources/[mic]/. Behalte den Ordnernamen bei: Der Fortschrittsbalken kommuniziert mit der Resource über ihren eigenen Namen.

Die zehn Vape-Modelle und ihre def_props.ytyp befinden sich in stream/ und laden aus dem Manifest; du musst sie nicht verschieben.

2. Nach deinem Framework starten

Füge in der server.cfg ensure mic_vape unter es_extended, qb-core oder qbx_core und unter deinem Inventar ein. QBox wird über seine QBCore-Kompatibilität erkannt – qbx_core stellt qb-core bereit –, es muss also nichts konfiguriert werden.

Dies ist wichtiger als gewöhnlich: mic_vape sucht in genau dem Moment, in dem es startet, nach einem gestarteten Framework. Wenn es zuerst startet, findet es nichts, registriert keine Items und gibt keine Meldung dazu aus.

Es hat geklappt, wenn mic_vape ohne rote Zeilen darunter startet.

3. Die Datenbank

Nichts für die Resource selbst. Auf ESX mit dem Standardinventar kommen die Vape-Items in die Tabelle items – das ist der nächste Schritt.

4. Items hinzufügen

Jeder Schlüssel in Config.Vapes (in config.lua) ist ein Item-Name, und jeder wird als nutzbar registriert. Die vollständige Liste mit den jeweiligen Funktionen findest du unter 🎒 Items. Zusammengefasst:

Gruppe	Items
Normal	`vape`
Power-Vapes	`invisibility_vape`, `speed_vape`, `superjump_vape`, `teleport_vape`, `invincibility_vape`, `health_vape`, `armor_vape`, `carspeed_vape`, `random_vape`
Geschmäcker	`vape_watermelon`, `vape_mango`, `vape_blueberry` … vierzig insgesamt, alle benannt als `vape_<flavour>`

Wo die fertigen Definitionen liegen, im Ordner inventory_items/ der Resource:

Datei	Für	Was zu tun ist
`esx_sql_items.sql`	ESX mit Standardinventar	Einmalig in deine Datenbank importieren
`ox_inventory_items.md`	ox_inventory	Zeilen in `ox_inventory/data/items.lua` einfügen
`qb_items.md`	QBCore	Zeilen in `qb-core/shared/items.lua` einfügen

Bilder: Die Icons liegen in inventory_images/, eine PNG-Datei pro Item mit entsprechendem Namen. Kopiere sie in den Bilderordner deines Inventars – ox_inventory/web/images/ oder qb-inventory/html/images/. Drei Items aus den obigen Listen haben kein Icon (transform_vape, freeze_vape, gravity_vape) und vape_grape ebenfalls nicht; erstelle dafür ein eigenes, falls du es nutzt.

Es hat geklappt, wenn du dir vape_watermelon geben kannst und es mit seinem Bild im Inventar erscheint.

5. Erster Test

Gib dir vape und benutze es aus dem Inventar.

Es hat geklappt, wenn eine schwarze Vape in der Hand deines Charakters erscheint. Drücke E: Dein Charakter führt sie zum Mund und einen Moment später tritt weißer Rauch aus. Benutze das Item erneut oder tippe /vape, und sie wird weggesteckt.

Probiere dann speed_vape: Nach einem Zug sprintest du fünfzehn Sekunden lang spürbar schneller.

Vor der Servereröffnung

mic_vape startet nach deinem Framework in der server.cfg.
Stress: Config.Stress ist aktiviert und gibt im Auslieferungszustand bei jedem Zug nur eine Zeile in der Serverkonsole aus. Platziere entweder deine Stress-Logik in bridge/server_bridge.lua oder setze Config.Stress = false. Siehe Anpassung.
Benachrichtigungen sind standardmäßig deaktiviert (Config.ShowNotifications = false). Aktiviere sie, wenn Spieler „Cooldown aktiv“, „Vape leer“ und die Power-Nachrichten sehen sollen.
Entscheide über die Power-Vapes. Unsichtbarkeit, Unverwundbarkeit und Teleportation sind mächtig. Vergib Preise, Shops oder Jobs dafür, bevor sie in den Taschen beliebiger Spieler landen.