Fehlerbehebung

Häufige Probleme, auf die Nutzer stoßen, ungefähr in der Reihenfolge ihres Auftretens.

Eine Dateiänderung bewirkt nichts

restart liest fxmanifest.lua nicht neu ein. Wenn du eine Datei hinzugefügt hast — z. B. eine neue Sprache —, tippe zuerst refresh in die Server-Konsole und danach restart mic_shopcreator.

Fehler zu `es_extended` oder `qb-core` beim Start

Config.Framework wird nicht automatisch erkannt. Trage 'esx' oder 'qbcore' passend zu deinem Server ein und starte mic_shopcreator in der server.cfg nach deinem Framework.

Unter QBox lautet der Wert 'qbcore' (QBox betreibt QBCore-Ressourcen über seinen Kompatibilitätslayer), und qbx_core muss vor mic_shopcreator starten.

/shopcreator meldet fehlende Berechtigung

Die ACE-Permission lautet mic_shop.open — nicht mic_shopcreator.open. Prüfe die Schreibweise in deiner add_ace-Zeile und vergewissere dich, dass sie einen Identifier nutzt, mit dem du dich tatsächlich anmeldest, oder eine Gruppe, in der du wirklich bist.

Alle Texte zeigen „Translation not found“

Config.Locale verweist auf eine Datei, die nicht in locales/ liegt oder in fxmanifest.lua unter shared_scripts fehlt. In diesem Fall meldet die Konsole Locale file not found for ….

Der Verkäufer ist nicht da

Du bist zu weit entfernt. Verkäufer existieren nur innerhalb von Config.PedSpawnDistance (standardmäßig 20 Meter).
Der Standort wurde überfallen. Ein überfallener Standort schließt für die Dauer seines Cooldowns: Verkäufer und Blip verschwinden für alle Spieler. Siehe unten.
Config.SpawnNPC ist deaktiviert. Dann wird absichtlich kein Verkäufer erzeugt, sondern nur ein Marker oder ein Target-Punkt.
Das Modell ist ungültig. Kann das Modell eines Standorts nicht geladen werden, springt Config.DefaultPed ein und die Konsole meldet Using default.. Schlägt auch das Laden des Standard-Peds fehl, erscheint CRITICAL: Could not load default ped model und es spawnt kein Verkäufer — hinterlege ein gültiges Modell in Config.DefaultPed.

Ich sehe den Verkäufer, kann den Shop aber nicht öffnen

Config.Interaction stimmt nicht mit deiner Server-Konfiguration überein. Standardmäßig ist 'ox_target' eingestellt. Wähle 'qb-target' für qb-target oder 'default', um heranzutreten und innerhalb von Config.RadiusInteract die Taste E zu drücken.

Bei QBCore mit 'default' wird kein Hinweistext angezeigt — ShowHelpNotification in bridge/client.lua ist für QBCore leer. Die Taste E funktioniert dennoch; befülle diese Funktion mit deinem Help-Text-Aufruf, um den Text anzuzeigen.

„This shop is currently on cooldown“ / ein Shop bleibt stundenlang geschlossen

Ein überfallener Standort bleibt für die Dauer von Cooldown (minutes) geschlossen. Ist kein Wert hinterlegt, gilt Config.RobberyCooldown — was ebenfalls in Minuten gezählt wird (die standardmäßigen 300 entsprechen 5 Stunden). Trage bei jedem überfallbaren Shop im Panel einen Cooldown ein oder reduziere den Standardwert.

Produktbilder fehlen

Das Shop-Fenster sucht nacheinander in allen Ordnern aus Config.InventoryImagePath nach <item_name>.png. Standardmäßig zeigt der Pfad auf ox_inventory. Bei anderen Inventaren trage deren Bilderverzeichnis als nui://-Pfad ein. Stimmen Item-Name und Dateiname des Bildes nicht überein, wird kein Bild geladen.

Kauf mit Schwarzgeld schlägt bei QBCore fehl

Schwarzgeld wird von einem Konto namens black_money abgebucht. QBCore besitzt standardmäßig kein solches Konto. Wähle für Produkte bei QBCore Cash, Bank oder All (Cash + Bank) — oder lege das Konto an und passe GetAccount in bridge/server.lua an deine Schwarzgeld-Verwaltung an.

Ein Besitzer öffnet den Shop ohne Zahnrad-Symbol

In der Besitzerliste muss der Identifier hinterlegt sein, den Config.IdentifierType erwartet:

`Config.IdentifierType`	Was als Besitzer eingetragen werden muss
`'discord'`	Nur die reine Discord-ID-Nummer, ohne `discord:`
`'license'`	Die vollständige Rockstar-Lizenz inklusive `license:`
`'esx'`	Der ESX-Identifier aus `users` inklusive möglichem `char1:`-Präfix
`'citizenid'`	Die QBCore Citizen-ID

Hast du Config.IdentifierType nachträglich geändert, müssen die Besitzer erneut eingetragen werden.

Spieler können nicht eingestellt werden

Bei 'discord' muss der Spieler ein verknüpftes Discord-Konto haben, andernfalls wird er aufgefordert, dieses zu verbinden.
Der Spieler muss sich im Umkreis von 10 Metern befinden, wenn der Besitzer die Liste öffnet.
Der Spieler muss bei der Abfrage Y drücken. Bei QBCore läuft die Abfrage über ShowHelpNotification in bridge/client.lua (dort standardmäßig leer) — ergänze die Funktion oder weise den Spieler manuell an, Y zu drücken.

Der Überfall startet nicht

Überfälle müssen für diesen Shop aktiviert sein und der Spieler muss eine Waffe — keine Fäuste — aus maximal 5 Metern Entfernung auf den Verkäufer richten. Ein bereits laufender Überfall oder ein aktiver Cooldown blockieren den Vorgang.

Discord-Logs kommen nicht an

Webhooks müssen für den Shop aktiv sein und eine gültige Discord-Webhook-URL hinterlegt haben.
Config.Screenshot ist aktiv, aber screenshot-basic läuft nicht. Der Log-Versand ist an das Bildschirmfoto gekoppelt: Fehlt die Ressource, wird nichts versendet. Starte screenshot-basic vor diesem Skript oder setze Config.Screenshot = false.

Die Polizei erhält keinen Alarm

Config.PoliceAlert = "default" benachrichtigt Spieler, deren Job in Config.RobberyNotifyJobs aufgeführt ist. Bei "custom" wird nichts gesendet, solange du deinen Dispatch-Aufruf nicht in TriggerPoliceAlert in bridge/server.lua hinterlegst (standardmäßig leer).