Installation

Fünf Minuten. Es gibt keine eigene SQL-Datei und keine zweite Ressource: Das Einzige, was außerhalb des Ordners hinzugefügt wird, sind die Vogel-Items in deinem Inventar.

Bevor du beginnst

Was du brauchst	Warum
ESX, QBCore oder QBox, laufend	Die Vögel sind nutzbare Items, registriert über dein Framework
Zugriff auf die Item-Liste deines Inventars	Vierzehn Items müssen dort existieren
Zugriff auf den Bildordner deines Inventars	Damit die Items über passende Icons verfügen

1. Ordner einfügen

Kopiere mic_parrots in deine Ressourcen, zum Beispiel unter resources/[mic]/. Belasse den Ordnernamen wie er ist; das Menü kommuniziert mit der Ressource über deren Namen.

Die neun individuellen Vögel liegen im Ordner stream/ und ihre Flugdaten in flight.meta. Beide laden sich automatisch über das Manifest; du musst sie nirgendwo hin verschieben.

2. Nach deinem Framework starten

Setze in der server.cfg die Zeile ensure mic_parrots unter dein Framework (es_extended, qb-core oder qbx_core) und unter dein Inventar.

Erfolgreich, wenn: der Server mic_parrots ohne rote Fehlermeldungen startet.

3. Framework angeben

Öffne config.lua und setze Config.Framework auf einen der folgenden Werte:

Wert	Für
`esx`	ESX (dies ist der Standard)
`qb-core`	QBCore
`qbox`	QBox

Es gibt keine automatische Erkennung: Dieser Wert bestimmt, wie Items registriert und Benachrichtigungen dargestellt werden.

4. Die Datenbank

Für die Ressource selbst muss nichts importiert werden. Auf ESX mit dem Standardinventar liegen Items in der Tabelle items, daher fügst du sie dort hinzu (nächster Schritt).

5. Items hinzufügen

Jeder Item-Name ruft einen bestimmten Vogel. Die Item-Namen bilden die linke Seite von Config.BirdItems in config.lua.

Item	Vogel	Modell
`crow`	Krähe	Basisspiel
`pigeon`	Taube	Basisspiel
`seagull`	Möwe	Basisspiel
`cormorant`	Kormoran	Basisspiel
`chickenhawk`	Hühnerhabicht	Basisspiel
`macaw`	Ara	Eigener Stream
`parrot`	Papagei	Eigener Stream
`falcon`	Falke	Eigener Stream
`vulture`	Geier	Eigener Stream
`eagle`	Adler	Eigener Stream
`owl`	Eule	Eigener Stream
`hornbill`	Nashornvogel	Eigener Stream
`sparrow`	Spatz	Eigener Stream
`warbler`	Grasmücke	Eigener Stream

Wo die fertigen Definitionen liegen: Die Datei readme.md in der Ressource enthält drei Textblöcke, einen pro Inventar:

ox_inventory — der für ox_inventory/data/items.lua markierte Block. Füge ihn in diese Datei ein.
QBCore — der für qb-core/shared/items.lua markierte Block. Füge ihn in diese Datei ein.
ESX — der Block mit der Überschrift “ITEMS FOR ESX SQL”. Führe ihn einmalig in deiner Datenbank aus.

Bilder: Alle vierzehn Icons befinden sich im Ordner inventory_images/, benannt nach dem Item (crow.png, eagle.png…). Kopiere sie in den Bildordner deines Inventars — bei ox_inventory ist das ox_inventory/web/images/, bei qb-inventory qb-inventory/html/images/.

Erfolgreich, wenn: du dir parrot geben kannst und es mit Bild im Inventar zu sehen ist.

6. Erster Test

Gib dir einen Vogel und benutze das Item im Inventar.

Erfolgreich, wenn: dein Charakter pfeift, ein Vogel von hinten heranfliegt und auf deiner rechten Schulter landet. Drücke U (oder tippe /parrot) und das Bird-Companion-Menü öffnet sich mit Shoulder, Head, Dismiss und Follow. Dismiss schickt ihn fort und gibt dich frei, einen neuen Vogel zu rufen.

Bevor du deinen Server eröffnest

Config.Framework passt zu deinem Server. Ein falscher Wert ist der häufigste Grund, warum nichts geschieht.
Alle vierzehn Items existieren, einschließlich sparrow, und jedes hat sein Icon.
Config.Locale ist auf die gewünschte Sprache für die Benachrichtigungen eingestellt.
Taste U ist frei. Wenn ein anderes Skript U nutzt, ändere Config.MenuKey — siehe Anpassung.