Installation

Zehn Minuten: eine SQL-Datei, eine Berechtigung und drei wichtige Zeilen in der config.lua.

Vorbereitung

Du benötigst	Warum
ESX, QBCore oder QBox	Geld, Jobs, Items und Benachrichtigungen stammen vom Framework
oxmysql	Alle Daten der Shops werden in deiner Datenbank gespeichert
ox_target oder qb-target	Optional. `ox_target` ist Standard; ohne Target erhalten Spieler einen Hinweistext und Taste E
screenshot-basic	Optional für Screenshots in den Discord-Logs. Nötig, wenn `Config.Screenshot` aktiv bleibt

1. Ordner ablegen

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

2. Nach den Abhängigkeiten starten

In der server.cfg gehört ensure mic_shopcreator unter oxmysql, dein Framework (es_extended, qb-core oder qbx_core), dein Inventar, deine Target-Ressource und screenshot-basic.

Es hat funktioniert, wenn die Ressource ohne rote Fehlermeldungen und ohne Locale file not found startet.

3. Die Datenbank

Importiere mic_shopcreator.sql einmalig. Dadurch werden neun Tabellen erstellt:

Tabelle	Inhalt
`mic_shopcreator`	Die Shops mit Blip-, Job-, Überfall-, Eigentums- und Webhook-Einstellungen
`mic_shopcreator_locations`	Standorte der Verkäufer, Ped-Modelle, Kleidung und Zeitstempel des letzten Überfalls
`mic_shopcreator_products`	Produkte der vom Server betriebenen Shops
`mic_shopcreator_owner_products`	Produkte spielereigener Shops inklusive Lagerbestand
`mic_shopcreator_jobs`	Welche Jobs und Ränge Zugriff auf einen Shop haben
`mic_shopcreator_rewards`	Beute bei einem Überfall
`mic_shopcreator_owners`	Besitzverhältnisse der Shops
`mic_shopcreator_employees`	Wer wo arbeitet, Provisionssätze und persönliche Tresore
`mic_shopcreator_vaults`	Guthaben an sauberem Geld und Schwarzgeld jedes Spieler-Shops

Update von einer älteren Version? Du benötigst update.sql nicht: Bei jedem Start prüft die Ressource auf neu hinzugekommene Spalten (clothes in locations, min_amount und max_amount in rewards) und fügt sie automatisch hinzu. Die Konsole bestätigt dies einmalig mit Added clothes column to mic_shopcreator_locations table..

4. Items

Keine eigenen. Ein Shop verkauft Items, die bereits in deinem Inventarsystem existieren — du trägst den Namen beim Erstellen des Produkts ein. Produktbilder stammen aus dem Bilderordner deines Inventars, siehe Schritt 5.

5. Framework, Target und Bilder

Öffne config.lua und prüfe folgende Optionen:

Option	Wert auf
`Config.Framework`	`'esx'` (Standard) oder `'qbcore'`. Keine automatische Erkennung. Bei QBox wähle `'qbcore'` (QBox betreibt QBCore-Ressourcen per Kompatibilitätslayer)
`Config.Interaction`	`'ox_target'` (Standard), `'qb-target'` oder `'default'` (Hinweistext und Taste E)
`Config.InventoryImagePath`	Pfad zu deinen Itembildern. Standardmäßig auf `nui://ox_inventory/web/images/` gesetzt
`Config.IdentifierType`	Wie Besitzer und Mitarbeiter identifiziert werden. Standardmäßig `'discord'`; siehe unten

Config.IdentifierType bestimmt, welcher Identifier in der Besitzer- und Mitarbeitertabelle gespeichert wird:

Wert	Spieler werden identifiziert über	Verwenden wenn
`'discord'`	Discord-ID, reine Nummer ohne `discord:`	Alle Spieler zwingend mit Discord verbunden sind
`'license'`	Rockstar-Lizenz, vollständiges `license:…`	Kein Discord vorausgesetzt wird
`'esx'`	ESX-eigener Identifier inklusive Charakterpräfix	ESX mit Multicharacter, damit Charaktere separat besitzen
`'citizenid'`	QBCore Citizen-ID	QBCore oder QBox, für getrennten Besitz pro Charakter

Lege dies fest, bevor Spieler Shops besitzen oder darin arbeiten. Eine spätere Änderung erfordert die Neueingabe aller Besitzer, und bestehende Mitarbeiter werden nicht mehr zugeordnet.

6. Berechtigung für das Panel vergeben

Das Panel ist durch die ACE-Permission mic_shop.open (nicht mic_shopcreator.open) geschützt. Vergib sie in der server.cfg per add_ace — an einen Spieler, z. B. add_ace identifier.discord:DEINE_DISCORD_ID mic_shop.open allow, oder an eine Gruppe wie add_ace group.admin mic_shop.open allow.

Es hat funktioniert, wenn /shopcreator den Shop Creator öffnet. Ohne Berechtigung erhältst du eine Fehlermeldung.

7. Erster Test

Gib /shopcreator ein, erstelle einen Shop und vergib einen Namen.
Füge einen Standort hinzu. Eine Vorschau des Verkäufers folgt deinem Blickfeld: Mausrad zum Drehen, ↑ / ↓ zum Heben und Senken, E zum Platzieren, X zum Abbrechen.
Füge ein Produkt hinzu: Ein existierendes Item aus deinem Inventar, Preis, Kategorie und Zahlungsart. Speichere ab.

Es hat funktioniert, wenn der Verkäufer an der gewählten Position steht, das Ansprechen den Shop mit Produkt und Bild öffnet und beim Kauf das Geld abgebucht und das Item übergeben wird.

Vor der Eröffnung deines Servers

Config.IdentifierType ist endgültig. Entscheide dich jetzt; Besitzer und Angestellte werden danach gespeichert.
Nur Administratoren sollten mic_shop.open besitzen. Damit lassen sich sämtliche Shops erstellen, bearbeiten und löschen.
Lasse Config.Screenshot nur aktiv, wenn screenshot-basic läuft. Andernfalls schlägt der Webhook-Versand fehl.
Überfall-Cooldowns werden pro Shop definiert (in Minuten) — trage bei jedem überfallbaren Shop einen Wert ein.
Teste den Kauf mit einem normalen Spieler-Charakter in jedem job-beschränkten Shop, um den Mindestrang zu überprüfen.