Fehlerbehebung

Das Tool öffnet sich nicht

Das Öffnen führt eine vollständige Prüfpipeline aus. Wenn eine Prüfung fehlschlägt, erhältst du eine Benachrichtigung mit dem Grund. Gehe die folgenden Punkte durch:

• Berechtigung — wenn Config.Permission.Enabled = true, stelle sicher, dass der Spieler die Prüfung besteht. Für Type = 'ace', vergewissere dich, dass das ACE (animpos.use) mit add_ace vergeben wurde. Für Type = 'job', stelle sicher, dass der Job des Spielers in Config.Permission.Jobs eingetragen ist.
• Zustandsbeschränkung — du bist blockiert, während du in einem Fahrzeug bist, fällst/fallschirmspringst, schwimmst (falls aktiviert), tot, im letzten Gefecht (Last Stand) oder handsfesselt bist. Die Benachrichtigung teilt dir den jeweiligen Zustand mit. Passe das entsprechende Config.Restrictions-Flag an, wenn die Blockierung unerwünscht ist.
• Abklingzeit (Cooldown) — nach jeder Nutzung gibt es eine Wartezeit von Config.Cooldown (Standard 15 s). „Too fast! Please wait a moment.“ bedeutet, dass die Abklingzeit noch aktiv ist.
• CanUse-Hook — ein benutzerdefinierter Config.CanUse, der false zurückgibt, blockiert das Öffnen. Überprüfe dort die benutzerdefinierte Logik.

Es erscheinen keine Benachrichtigungen

Dies liegt fast immer an einem Backend-Mismatch. Config.Notify muss mit einem Benachrichtigungssystem übereinstimmen, das tatsächlich läuft:

• ox_lib — erfordert, dass ox_lib gestartet ist (die Konsole gibt eine Warnung aus, wenn es auf ox_lib eingestellt ist, aber ox_lib nicht läuft).
• qbcore — erfordert QB-Core und dessen QBCore:Notify-Event.
• esx — erfordert ESX und dessen esx:showNotification-Event.
• custom — erfordert einen funktionierenden Handler in Config.CustomNotify.

Ein ungültiger Wert greift auf ox_lib zurück und protokolliert eine Konsolenwarnung.

Die Tastenkombination bewirkt nichts

• Stelle sicher, dass Config.Keybind.Enabled = true und Config.Keybind.Default nicht leer ist – die Tastenbelegung wird nur registriert, wenn beides gesetzt ist.
• Die Tastenbelegung wird beim Start der Resource registriert; wenn du die Konfiguration geändert hast, starte die Resource neu.
• Überprüfe, ob der Spieler die Taste unter Einstellungen → Tastenbelegung → FiveM neu belegt (oder gelöscht) hat. Der Befehl /animpos funktioniert unabhängig von der Tastenbelegung immer.

Text ist in der falschen Sprache / auf Englisch

• Setze setr ox:locale "<code>" in der server.cfg (verwende setr, damit es an Clients repliziert wird).
• Verwende einen unterstützten Code: en, tr, de, fr, es, pt, ru.
• Ein fehlender Übersetzungsschlüssel greift auf Englisch zurück – stelle sicher, dass deine Sprachdatei diesen Schlüssel mit genau demselben Namen wie in en.json enthält.

Framework-Funktionen funktionieren nicht / werden nicht erkannt

• Setze Config.Framework so, dass es exakt zu deinem Server passt (qbox, qbcore, esx oder standalone). Ein ungültiger Wert protokolliert eine Konsolenwarnung.
• Die Beschränkungen für tot / letztes Gefecht (Last Stand) / Handschellen funktionieren nur bei qbox und qbcore. Bei esx und standalone werden diese Metadatenprüfungen konzeptionsbedingt übersprungen – es gelten nur Fahrzeug / Fall / Schwimmen.
• Wenn Metadatenbeschränkungen auf QBox/QB-Core weiterhin nicht ausgelöst werden, speichert dein Framework diese Felder möglicherweise unter anderen Schlüsseln – passe Config.Restrictions.MetaKeys an.

Charakter bleibt eingefroren oder transparent

Das Script setzt Alpha zurück, entfriert den Ped und stellt Ragdoll beim Stoppen der Resource wieder her, sodass ein Neustart von bupa-animpos einen festgehangenen Zustand behebt. Wenn eine Integration die Ped-Skalierung pausiert hat, wird der Fortsetzungs-Export ebenfalls beim Cleanup aufgerufen.