Installazione

Cinque minuti. Non c’è alcun file SQL dedicato né una seconda risorsa: l’unica cosa da aggiungere fuori dalla cartella sono gli oggetti degli uccelli nel tuo inventario.

Prima di iniziare

Ti serve	Perché
ESX, QBCore o QBox, in esecuzione	Gli uccelli sono oggetti utilizzabili, registrati tramite il tuo framework
Accesso alla lista oggetti del tuo inventario	Devono esserci quattordici oggetti
Accesso alla cartella immagini dell’inventario	Per dare le icone agli oggetti

1. Posiziona la cartella

Inserisci mic_parrots nelle tue risorse, ad esempio dentro resources/[mic]/. Mantieni il nome della cartella così com’è; il menu comunica con la risorsa usando il suo nome.

I nove uccelli personalizzati si trovano nella cartella stream/ e i loro dati di volo sono in flight.meta. Entrambi vengono caricati automaticamente dal manifest; non devi spostarli da nessuna parte.

2. Avviala dopo il tuo framework

Nel server.cfg, inserisci ensure mic_parrots sotto il tuo framework (es_extended, qb-core o qbx_core) e sotto il tuo inventario.

Ha funzionato quando il server avvia mic_parrots senza righe rosse di errore.

3. Indica quale framework utilizzi

Apri config.lua e imposta Config.Framework su uno dei seguenti valori:

Valore	Per
`esx`	ESX (questo è il predefinito)
`qb-core`	QBCore
`qbox`	QBox

Non c’è rilevamento automatico: questo valore decide come vengono registrati gli oggetti e come vengono mostrate le notifiche.

4. Il database

Non c’è nulla da importare per la risorsa in sé. Su ESX con l’inventario predefinito gli oggetti risiedono nella tabella items, quindi dovrai aggiungerli lì (passaggio successivo).

5. Aggiungi gli oggetti

Ogni nome oggetto richiama un uccello. I nomi degli oggetti si trovano sul lato sinistro di Config.BirdItems in config.lua.

Oggetto	Uccello	Modello
`crow`	Corvo	gioco base
`pigeon`	Piccione	gioco base
`seagull`	Gabbiano	gioco base
`cormorant`	Cormorano	gioco base
`chickenhawk`	Poiana	gioco base
`macaw`	Ara	personalizzato, in streaming
`parrot`	Pappagallo	personalizzato, in streaming
`falcon`	Falco	personalizzato, in streaming
`vulture`	Avvoltoio	personalizzato, in streaming
`eagle`	Aquila	personalizzato, in streaming
`owl`	Gufo	personalizzato, in streaming
`hornbill`	Bucero	personalizzato, in streaming
`sparrow`	Passero	personalizzato, in streaming
`warbler`	Silvia	personalizzato, in streaming

Dove si trovano le definizioni pronte: il file readme.md all’interno della risorsa contiene tre blocchi, uno per ciascun inventario:

ox_inventory — il blocco contrassegnato per ox_inventory/data/items.lua. Incollalo in quel file.
QBCore — il blocco contrassegnato per qb-core/shared/items.lua. Incollalo in quel file.
ESX — il blocco contrassegnato “ITEMS FOR ESX SQL”. Eseguilo una volta sul tuo database.

Immagini: tutte le quattordici icone si trovano nella cartella inventory_images/, nominate come l’oggetto (crow.png, eagle.png…). Copiale nella cartella immagini del tuo inventario — per ox_inventory è ox_inventory/web/images/, per qb-inventory è qb-inventory/html/images/.

Ha funzionato quando puoi darti l’oggetto parrot e questo appare nel tuo inventario con la sua immagine.

6. Primo test

Datti un uccello e usalo dall’inventario.

Ha funzionato quando il tuo personaggio fischia, un uccello arriva in volo da dietro e atterra sulla tua spalla destra. Premi U (o digita /parrot) e si aprirà il menu Bird Companion con Shoulder, Head, Dismiss e Follow. Dismiss lo manda via e ti permette di chiamarne un altro.

Prima di aprire la tua città

Config.Framework corrisponde al tuo server. Un valore errato è il motivo più comune per cui non succede nulla.
Tutti i quattordici oggetti esistono, incluso sparrow, e ciascuno ha la propria icona.
Config.Locale è impostato sulla lingua desiderata per le notifiche.
Il tasto U è libero. Se un altro script usa U, modifica Config.MenuKey — vedi Personalizzazione.