Ein Item besteht aus einer Liste von Funktionen, die von oben nach unten ausgeführt werden, sobald ein Spieler es benutzt, sowie einer Reihe von Einschränkungen, die vor der Ausführung geprüft werden.
- Der Spieler benutzt das Item aus seinem Inventar.
- Auf dem Server werden die Einschränkungen für Cooldown, benötigtes Item und Job geprüft. Schlägt eine fehl, erhält der Spieler einen Hinweis und nichts geschieht.
- Die serverseitigen Funktionen werden ausgeführt (Bundle).
- Die clientseitigen Funktionen laufen in der festgelegten Reihenfolge ab. Jede Funktion kann eine Verzögerung in Millisekunden besitzen, die vor dem Start abgewartet wird — so erstellst du Abläufe: Animation, 3 Sekunden später eine Nachricht, dann ein Prop.
- Wenn Remove on Use aktiv ist, wird die festgelegte Anzahl des Items verbraucht.
Länger andauernde Funktionen — Animationen, Szenarien, Gehstile, Geschwindigkeit, Superkräfte, befestigte Props — können vom Spieler mit der Abbruchtaste (standardmäßig X) beendet werden.
| Funktion | Was sie macht |
|---|
| Animation | Spielt eine Animation aus einem Dictionary ab. Loop läuft bis zum Abbruch; andernfalls wiederholt sie sich für die eingestellte Dauer. Movable lässt die Beine frei (nur Oberkörper); static spielt sie als Ganzkörper-Animation. Wird im Fahrzeug nicht abgespielt |
| Scenario | Startet ein GTA-Szenario an Ort und Stelle für eine bestimmte Dauer |
| Walking Style | Ändert den Gehstil des Spielers für eine bestimmte Dauer (15 Sekunden bei leerem Feld) |
| Speed | Beschleunigt (oder verlangsamt) die Bewegungsgeschwindigkeit des Spielers über einen Multiplikator für eine Dauer oder bis zum Abbruch |
| Superpower | Auswahl aus Teleport (zum Karten-Wegpunkt), Invisibility, Invincibility, Superjump und Stamina (unendlicher Sprint), jeweils mit eigener Dauer |
| Clothes | Zieht Kleidungsstücke und Accessoires (Props) an, separat für männliche und weibliche Freemode-Modelle einstellbar, mit passender Anzieh-Animation aus data/clothing.lua |
| Funktion | Was sie macht |
|---|
| Attach Prop | Heftet ein Objekt an einen Bone des Spielers, im Live-Editor positioniert. Für alle Umstehenden sichtbar. Loop behält es bis zum Abbruch; andernfalls wird es nach der Dauer entfernt. Nicht im Fahrzeug nutzbar |
| Placeable Prop | Der Spieler platziert ein Objekt in der Welt: Eine Vorschau folgt dem Blick, das Mausrad dreht es, ↑ / ↓ heben und senken es, E stellt es ab und X bricht ab. Das Objekt kann wieder aufgehoben werden — siehe unten |
| Particles | Ein Partikeleffekt am Spieler, definiert über Asset- und Effektnamen, mit Skalierung und Dauer |
| Visual Effect | Ein Vollbild-Effekt für eine bestimmte Dauer |
| Sound | Ein GTA-Sound aus Soundname und Sound-Set in gewünschter Lautstärke |
| Funktion | Was sie macht |
|---|
| Health/Armor | Erhöht Gesundheit und Rüstung, begrenzt durch das Maximum |
| Food/Thirst | Erhöht Hunger und Durst über esx_status bei ESX bzw. die Consumables-Events bei QBCore |
| Stress | Erhöht Stress oder baut ihn mit negativen Zahlen ab |
| Funktion | Was sie macht |
|---|
| Notification | Eine Benachrichtigung über dein Framework mit Typ (standardmäßig Success) |
| Progress Bar | Ein Fortschrittsbalken mit Beschriftung für eine bestimmte Dauer: integriert oder über ox_lib gemäß Config.ProgressBar |
| Webhook | Sendet an einen Discord-Webhook: Deine Nachricht, Spieler-Identifikatoren und optional einen Screenshot (benötigt screenshot-basic). Es werden nur Discord-URLs akzeptiert |
| Funktion | Was sie macht |
|---|
| Command | Führt einen Befehl als Spieler aus. Ein führender / wird unterstützt |
| Trigger | Löst ein Client-Event, Server-Event oder einen Export im Format resourceName:exportName aus. Jeder Aufruf erhält den Item-Namen als Parameter |
| Car | Spawnt ein Fahrzeugmodell an der Spielerposition mit gleicher Blickrichtung und setzt den Spieler optional direkt auf den Fahrersitz |
| Bundle | Gibt mehrere Items auf einmal — ein Sixpack Bier, ein Erste-Hilfe-Set. Läuft auf dem Server. In Kombination mit Remove on Use wird die Packung verbraucht; ein Bundle gibt nie sich selbst ab |
Platziert ein Spieler ein Placeable Prop, wird das Objekt für alle sichtbar erzeugt. Der Spieler, der es aufgestellt hat, kann es wieder aufheben — per 3D-Text und E oder über ox_target / qb-target, sofern in Config.Interaction konfiguriert. Beim Aufheben wird exakt die Menge zurückgegeben, die Remove on Use abgezogen hatte: Eine aufgestellte Leitbake wandert also wieder ins Inventar zurück.
Öffne die Einstellungen eines Items, um die Optionen zu finden. Jede besitzt einen eigenen Schalter.
| Einschränkung | Was sie bewirkt |
|---|
| Cooldown | Wartezeit in Millisekunden, die ein Spieler zwischen zwei Benutzungen dieses Items abwarten muss (60000 entspricht 1 Minute). Bleibt bis zum Serverneustart gespeichert |
| Job Restriction | Nur Spieler mit einem der gelisteten Jobs und mindestens dem angegebenen Mindestrang dürfen das Item verwenden |
| Required Item | Der Spieler muss eine bestimmte Menge eines anderen Items im Inventar tragen — etwa ein Feuerzeug für eine Zigarette |
| Remove on Use | Wie viele Einheiten des Items bei jeder Benutzung abgezogen werden |
| Always Attached Prop | Solange das Item im Inventar liegt, bleibt das Attach Prop am Spieler befestigt; es verschwindet erst, wenn das letzte Item das Inventar verlässt. Nur der Träger sieht dieses Prop |
- Save speichert das Item in der Tabelle
mic_itemcreator und macht es sofort für jeden Spieler benutzbar.
- Das Menü kann dir das Item zum Testen geben (jeweils ein Exemplar).
- Delete entfernt die Konfiguration: Das Benutzen des Items bewirkt ab diesem Moment nichts mehr. Das Framework behält die Registrierung als benutzbar bis zum nächsten Serverneustart bei, was harmlos ist.
