Instalacja

Pięć minut. Skrypt nie posiada własnego pliku SQL ani drugiego zasobu: jedyna rzecz, którą dodajesz poza jego folderem, to przedmioty ptaków w Twoim ekwipunku.

Zanim zaczniesz

Potrzebujesz	Dlaczego
Działający ESX, QBCore lub QBox	Ptaki są używalnymi przedmiotami rejestrowanymi przez Twój framework
Dostęp do listy przedmiotów Twojego ekwipunku	Musi się tam znaleźć czternaście przedmiotów
Dostęp do folderu z obrazkami Twojego ekwipunku	Aby przedmioty miały swoje ikony

1. Umieść folder na miejscu

Wrzuć mic_parrots do swoich zasobów, na przykład do resources/[mic]/. Zachowaj oryginalną nazwę folderu; menu komunikuje się z zasobem, używając jego nazwy.

Dziewięć niestandardowych ptaków znajduje się w folderze stream/, a ich dane lotu w pliku flight.meta. Oba elementy ładują się automatycznie z manifestu; nie musisz ich nigdzie przenosić.

2. Uruchom skrypt po swoim frameworku

W pliku server.cfg umieść ensure mic_parrots poniżej swojego frameworka (es_extended, qb-core lub qbx_core) oraz poniżej ekwipunku.

Działa poprawnie, gdy serwer uruchamia mic_parrots bez żadnych czerwonych linii z błędami.

3. Wskaż używany framework

Otwórz config.lua i ustaw Config.Framework na jedną z wartości:

Wartość	Dla
`esx`	ESX (wartość domyślna)
`qb-core`	QBCore
`qbox`	QBox

Skrypt nie korzysta z automatycznego wykrywania: ta wartość decyduje o sposobie rejestracji przedmiotów i wyświetlania powiadomień.

4. Baza danych

Sam zasób nie wymaga importowania niczego. W przypadku ESX z domyślnym ekwipunkiem przedmioty znajdują się w tabeli items, więc dodajesz je właśnie tam (kolejny krok).

5. Dodaj przedmioty

Każda nazwa przedmiotu przywołuje jednego ptaka. Nazwy przedmiotów znajdują się po lewej stronie tabeli Config.BirdItems w config.lua.

Przedmiot	Ptak	Model
`crow`	Wrona	podstawowa gra
`pigeon`	Gołąb	podstawowa gra
`seagull`	Mewa	podstawowa gra
`cormorant`	Kormoran	podstawowa gra
`chickenhawk`	Myszołów	podstawowa gra
`macaw`	Ara	niestandardowy, streamowany
`parrot`	Papuga	niestandardowy, streamowany
`falcon`	Sokół	niestandardowy, streamowany
`vulture`	Sęp	niestandardowy, streamowany
`eagle`	Orzeł	niestandardowy, streamowany
`owl`	Sowa	niestandardowy, streamowany
`hornbill`	Dzioborożec	niestandardowy, streamowany
`sparrow`	Wróbel	niestandardowy, streamowany
`warbler`	Gajówka	niestandardowy, streamowany

Gdzie znajdują się gotowe definicje: plik readme.md wewnątrz zasobu zawiera trzy bloki, po jednym dla każdego ekwipunku:

ox_inventory — blok oznaczony dla ox_inventory/data/items.lua. Wklej go do tego pliku.
QBCore — blok oznaczony dla qb-core/shared/items.lua. Wklej go do tego pliku.
ESX — blok oznaczony jako “ITEMS FOR ESX SQL”. Wykonaj go jednorazowo w swojej bazie danych.

Obrazki: wszystkie czternaście ikon znajduje się w folderze inventory_images/, nazwanych dokładnie tak jak przedmioty (crow.png, eagle.png…). Skopiuj je do folderu z obrazkami Twojego ekwipunku — dla ox_inventory jest to ox_inventory/web/images/, a dla qb-inventory qb-inventory/html/images/.

Działa poprawnie, gdy możesz nadać sobie przedmiot parrot i pojawia się on w ekwipunku razem z obrazkiem.

6. Pierwszy test

Nadaj sobie ptaka i użyj go z poziomu ekwipunku.

Działa poprawnie, gdy Twoja postać gwiżdże, ptak nadlatuje zza pleców i ląduje na Twoim prawym ramieniu. Naciśnij U (lub wpisz /parrot), a otworzy się menu Bird Companion z opcjami Shoulder, Head, Dismiss oraz Follow. Opcja Dismiss odsyła ptaka i pozwala przywołać kolejnego.

Zanim otworzysz serwer dla graczy

Config.Framework zgadza się z Twoim serwerem. Błędna wartość to najczęstszy powód, przez który nic się nie dzieje.
Wszystkie czternaście przedmiotów istnieje, włącznie ze sparrow, i każdy z nich posiada swoją ikonę.
Config.Locale jest ustawiony na język, w którym chcesz wyświetlać powiadomienia.
Klawisz U jest wolny. Jeśli inny skrypt używa klawisza U, zmień Config.MenuKey — zobacz Personalizacja.