Fehlerbehebung

Typische Probleme mit dieser Ressource in der Reihenfolge, in der sie gewöhnlich auftreten.

Eine Änderung an der Ressource bewirkt nichts

Der Befehl restart liest die fxmanifest.lua nicht neu ein. Wenn du eine Datei hinzugefügt hast — eine neue Locale, ein neues Modell in stream/ —, führe zuerst refresh in der Serverkonsole aus und starte dann mit restart mic_parrots neu. Ohne den Refresh behält der Server die alte Dateiliste und die neue Datei wird schlichtweg ignoriert.

Die Benutzung des Vogel-Items bewirkt nichts

In dieser Reihenfolge prüfen:

Config.Framework passt nicht zu deinem Server. Der Wert muss exakt esx, qb-core oder qbox lauten. Die Items werden nur für das dort angegebene Framework registriert.
mic_parrots startet vor deinem Framework. Verschiebe ensure mic_parrots in der server.cfg unter dein Framework.
Der Item-Name steht nicht in Config.BirdItems. Nur dort geführte Namen sind als Items nutzbar.
Auf ESX mit dem Standardinventar fehlt das Item in der items-Tabelle. Führe den ESX-Block aus der readme.md der Ressource aus.

Die Konsole zeigt einen Fehler bezüglich `qbx-core` auf QBox an

Der QBox-Zweig in server/server.lua und client/utils.lua fragt nach einer Ressource namens qbx-core. Heißt dein Core qbx_core (mit Unterstrich), schlägt diese Abfrage fehl. Beide Dateien sind offen: Passe den Namen dort direkt an deine Ressource an oder eröffne ein Ticket im Discord, damit wir dir helfen können.

“You already have a bird companion!”

Nur ein Vogel pro Spieler gleichzeitig. Öffne das Menü, drücke Dismiss, warte bis er abgeflogen ist, und benutze erst dann das nächste Item.

Das Menü öffnet sich nicht

Das Menü lässt sich nur öffnen, solange ein Vogel aktiv draußen ist. Benutze zuerst ein Vogel-Item.

Falls Taste U nichts bewirkt, aber /parrot funktioniert, nutzt eine andere Ressource denselben Control. Ändere Config.MenuKey in config.lua auf eine andere Control-Nummer.

`/parrot` meldet “You don’t have permission to use this command”

Diese Meldung erscheint, wenn du keinen Vogel aktiv draußen hast und Config.NoActiveBirdNotification auf true steht. Es ist die Zeile no_permission in deiner Locale-Datei; die Taste U greift stattdessen auf no_active_bird_for_menu zurück. Rufe zuerst einen Vogel oder passe den Text von no_permission in locales/ an, falls dich die Formulierung stört.

Es gibt kein `sparrow`-Item

Der Spatz wird mitgeliefert (Modell, flight.meta-Eintrag und inventory_images/sparrow.png), fehlt jedoch in den drei fertigen Vorlagenblöcken in readme.md. Füge ihn zu deinem Inventar hinzu, indem du eine andere Vogelzeile kopierst und auf sparrow umbenennst.

Kormoran und Hühnerhabicht zeigen auf QBCore das Icon der Grasmücke

Die QBCore-Zeilen in readme.md für cormorant und chickenhawk verweisen fälschlicherweise auf warbler.png. Ändere sie zu cormorant.png und chickenhawk.png, die beide in inventory_images/ vorhanden sind.

Ein eigener Vogel ist unsichtbar oder fällt zu Boden statt zu fliegen

Die neun eigenen Modelle stammen aus stream/ und ihre Ped-Daten aus flight.meta. Prüfe, ob beides noch im Ressourcenordner vorhanden ist und keine andere Ressource auf deinem Server ein Modell gleichen Namens streamt (Parrot, Eagle, Owl…). Falls du einen ganz eigenen Vogel ergänzt hast, benötigt dieser einen eigenen Eintrag in flight.meta.

Das Menü ist auf Englisch, obwohl ich die Sprache geändert habe

Config.Locale steuert ausschließlich die Benachrichtigungen. Die Menüschaltflächen sind in html/index.html hinterlegt; übersetze sie direkt in dieser Datei.

“Locale [xx] does not exist”

Config.Locale verweist auf eine Sprache, zu der keine Datei existiert. Nutze eine aus en, es, de, fr, it, pl, pt, ru, tr oder lege eine eigene Sprachdatei an, wie unter Anpassung beschrieben.