Installation

Fünf Minuten. Keine SQL-Datei, keine Framework-Einstellung: eine Berechtigung und ein Neustart.

Vorbereitung

Du benötigst	Warum
ESX, QBCore oder QBox	Benutzbare Items, Jobs, Benachrichtigungen und Status stammen vom Framework
oxmysql	Item-Konfigurationen werden in der Tabelle `mic_itemcreator` gespeichert
Ein Inventar, das benutzbare Items des Frameworks ausführt	Nur so erreicht das Verwenden des Items diese Ressource
ox_lib, ox_target / qb-target, screenshot-basic	Optional; siehe Anpassung

1. Ordner ablegen

Lade mic_itemcreator aus deinen Cfx.re Granted Assets herunter und lege den Ordner in deinem resources-Verzeichnis ab, z. B. unter resources/[mic]/mic_itemcreator.

2. Nach den Abhängigkeiten starten

In der server.cfg gehört ensure mic_itemcreator unter oxmysql, dein Framework (es_extended, qb-core oder qbx_core) und dein Inventar.

Das Framework wird ermittelt, indem nach einem bereits gestarteten es_extended oder qb-core gesucht wird. Die Reihenfolge ist daher wichtig: Startet die Ressource zu früh, wird keines von beiden gefunden. QBox wird über seine QBCore-Kompatibilität erkannt (qbx_core stellt qb-core bereit), sodass keine manuelle Konfiguration nötig ist.

3. Die Datenbank — nichts zu tun

Beim ersten Start erstellt die Ressource die Tabelle mic_itemcreator selbstständig (eine Zeile pro konfiguriertem Item) und fügt eventuell fehlende Spalten älterer Versionen automatisch hinzu. Es muss keine SQL-Datei importiert werden.

Es hat funktioniert, wenn die Tabelle mic_itemcreator nach dem ersten Start in deiner Datenbank existiert.

4. Items

Der Item Creator fügt keine neuen Items zu deinem Inventar hinzu — er weist Items, die du bereits besitzt, bestimmte Aktionen zu. Jedes konfigurierte Item muss daher zuerst in deinem Inventarsystem existieren.

Es werden keine Item-Definitionen oder Bilder mitgeliefert. Für neue Items erstellt das Registry Tool im Menü die Definition für dich: Wähle OX, QBCORE oder ESX SQL, fülle die Felder aus und kopiere das Ergebnis in ox_inventory/data/items.lua, qb-core/shared/items.lua oder deine ESX-Tabelle items. Bilder gehören in den Bildordner deines Inventars, benannt nach dem Item-Namen.

5. Menüzugriff einrichten

Das Menü ist durch die ACE-Permission mic_itemcreator.open geschützt. Vergebe sie in der server.cfg über eine add_ace-Zeile — an einen einzelnen Spieler, z. B. add_ace identifier.discord:DEINE_DISCORD_ID mic_itemcreator.open allow, oder an eine Gruppe wie add_ace group.admin mic_itemcreator.open allow.

Die Berechtigung wird beim Beitreten des Servers geprüft. Hast du sie vergeben, während du bereits verbunden warst? Bitte neu verbinden.

Es hat funktioniert, wenn /itemcreator das Menü auf dem Dashboard öffnet. Ohne Berechtigung erhältst du eine entsprechende Benachrichtigung.

6. Erster Test

Gib /itemcreator ein → Usable Items und wähle ein Item, das in deinem Inventar existiert, z. B. water.
Füge eine Notification-Funktion mit einer Nachricht hinzu und eine Food/Thirst-Funktion mit Durststillung.
Öffne die Einstellungen des Items, aktiviere Remove on Use mit 1 und speichere ab.
Gib dir das Item (das Menü hat dafür einen Button, jeweils einzeln) und benutze es aus deinem Inventar heraus.

Es hat funktioniert, wenn die Benachrichtigung erscheint, dein Durstbalken steigt und ein Item aus dem Inventar entfernt wird.

Vor der Eröffnung deines Servers

Nur berechtigte Personen sollten mic_itemcreator.open besitzen. Damit lässt sich jedes Item mit beliebigen Aktionen belegen, inklusive Fahrzeug-Spawns, Konsolenbefehlen und Superkräften.
Jedes konfigurierte Item muss in deinem Inventar existieren, exakt gleich geschrieben.
Prüfe, ob Config.ImageInventoryPath auf den tatsächlichen Bilderordner deines Inventars zeigt, andernfalls fehlen die Vorschaubilder im Menü.
Informiere deine Spieler über die Abbruchtaste — standardmäßig X —, mit der sich durch ein Item gestartete Animationen, Szenarien, Gehstile, Geschwindigkeit, Superkräfte und Props abbrechen lassen.