Personalizzazione

Quasi tutto si trova in un unico file breve. Anche il resto del codice Lua è lasciato aperto, così puoi modificare il comportamento stesso se ne hai bisogno.

Quale file decide cosa

File o cartella	Cosa decide	Aperto?
`config.lua`	Framework, lingua, tasto e comando del menu, l’elenco degli uccelli	Aperto
`locales/*.lua`	I testi delle notifiche, un file per lingua	Aperto
`client/utils.lua`	Come viene mostrata una notifica, per ogni framework	Aperto
`client/client.lua`	Il tasto del menu, il comando `/parrot` e cosa fa ogni pulsante del menu	Aperto
`client/bird_management.lua`	Come l’uccello arriva in volo, atterra, si sposta, segue e se ne va	Aperto
`server/server.lua`	Registra ogni uccello come oggetto utilizzabile e mantiene sincronizzati gli altri giocatori	Aperto
`html/`	Il menu Bird Companion: `index.html`, `style.css`, `script.js` e le sue icone in `html/img/`	File normali
`stream/`	I nove modelli di uccelli personalizzati	Asset
`flight.meta`	I dati ped per i nove uccelli personalizzati	Dati
`inventory_images/`	Le quattordici icone degli oggetti	Asset
`readme.md`	Righe oggetti già pronte per ox_inventory, QBCore ed ESX	Riferimento

locales/main.lua è l’unico file Lua sotto escrow.

Impostazioni generali — `config.lua`

Opzione	Cosa fa	Predefinito
`Config.Framework`	`esx`, `qb-core` o `qbox`. Decide come vengono registrati gli oggetti e mostrate le notifiche	`esx`
`Config.Locale`	Lingua per le notifiche: `en`, `es`, `de`, `fr`, `it`, `pl`, `pt`, `ru`, `tr`	`en`
`Config.MenuKey`	Indice del controllo di gioco che apre il menu. `303` corrisponde a U	`303`
`Config.OpenMenuCommand`	Comando chat che apre il menu	`parrot`
`Config.NoActiveBirdNotification`	Mostra un messaggio quando qualcuno prova ad aprire il menu senza un uccello attivo	`false`

Config.MenuKey è un numero di controllo FiveM, non una lettera. L’elenco dei numeri si trova sulla pagina di riferimento dei controlli FiveM. Poiché viene letto direttamente, i giocatori non possono riassegnarlo nelle proprie impostazioni; il comando è sempre disponibile come alternativa.

Gli uccelli — `Config.BirdItems`

Un elenco di nome oggetto → modello ped. Ogni voce diventa un oggetto utilizzabile all’avvio.

Oggetto	Modello
`crow`	`a_c_crow`
`pigeon`	`a_c_pigeon`
`seagull`	`a_c_seagull`
`cormorant`	`a_c_cormorant`
`chickenhawk`	`a_c_chickenhawk`
`macaw`	`Macaw`
`parrot`	`Parrot`
`falcon`	`Falcon`
`vulture`	`Vulture`
`eagle`	`Eagle`
`owl`	`Owl`
`hornbill`	`Hornbill`
`sparrow`	`Sparrow`
`warbler`	`Warbler`

Aggiungere un uccello

Aggiungi una riga in Config.BirdItems con il nome del nuovo oggetto e il modello ped da generare.
Aggiungi l’oggetto al tuo inventario nello stesso modo degli altri (vedi Installazione) e assegnagli un’icona.
Un uccello del gioco base (qualsiasi modello di uccello a_c_…) non richiede altro.
Un uccello personalizzato richiede i file del modello in stream/ e una propria voce in flight.meta, accanto alle nove già presenti. Senza la voce in flight.meta il modello viene caricato ma non si comporta come un uccello.
Esegui refresh, poi restart mic_parrots.

Rimuovere un uccello

Elimina la sua riga da Config.BirdItems. L’oggetto smetterà di funzionare; rimuovilo anche dal tuo inventario in modo che nessuno rimanga con un oggetto inutilizzabile.

Il menu — `html/`

Le etichette del menu (Bird Companion, Shoulder, Head, Dismiss, Follow, Close) sono scritte in html/index.html, non nei file delle lingue. Traducile o rinominale lì. Colori e layout si trovano in html/style.css, mentre le icone dei pulsanti sono i file PNG in html/img/.

html/index.html contiene anche due pulsanti commentati, Dance e Sing. Non hanno alcuna azione associata nel codice Lua, quindi lasciali commentati.

Esc o il pulsante Close chiude il menu.

Lingue

Ne sono incluse nove, un file ciascuna in locales/: en, es, de, fr, it, pl, pt, ru, tr. Scegline una con Config.Locale.

Ogni file contiene sei righe: nessun permesso, hai già un uccello, nessun uccello sulla spalla, uccello già sulla spalla, uccello già sulla testa e serve un uccello attivo per aprire il menu.

Per aggiungere una lingua: copia locales/en.lua in un nuovo file (ad esempio locales/nl.lua), cambia la chiave della lingua in alto da en a nl, traduci i sei testi e aggiungi il nuovo file a entrambe le liste client_scripts e server_scripts in fxmanifest.lua. Poi imposta Config.Locale su nl, esegui refresh e riavvia.

Notifiche

client/utils.lua invia tutte le notifiche: ESX.ShowNotification su ESX, QBCore.Functions.Notify su QBCore, l’export di notifica QBox su QBox e il feed standard di GTA per tutto il resto. Sostituisci il corpo di quella singola funzione per instradare i messaggi verso la tua risorsa di notifiche.

Comandi

Comando o tasto	Cosa fa	Impostato in
`/parrot`	Apre il menu Bird Companion quando hai un uccello attivo	`Config.OpenMenuCommand`
U	Uguale al comando	`Config.MenuKey`