Özelleştirme

Neredeyse her şey tek bir kısa dosyadadır. Lua’nın geri kalanı da açık bırakılmıştır; gerekirse davranışın kendisini değiştirebilirsiniz.

Hangi dosya neye karar verir

Dosya veya klasör	Neye karar verir	Açık mı?
`config.lua`	Framework, dil, menü tuşu ve komutu, kuşların listesi	Açık
`locales/*.lua`	Bildirim metinleri, dil başına bir dosya	Açık
`client/utils.lua`	Bir bildirimin framework’e göre nasıl gösterildiği	Açık
`client/client.lua`	Menü tuşu, `/parrot` komutu ve her menü butonunun ne yaptığı	Açık
`client/bird_management.lua`	Kuşun nasıl uçarak geldiği, konduğu, hareket ettiği, takip ettiği ve ayrıldığı	Açık
`server/server.lua`	Her kuşu kullanılabilir eşya olarak kaydeder ve diğer oyuncuları senkronize tutar	Açık
`html/`	Bird Companion menüsü: `index.html`, `style.css`, `script.js` ve `html/img/` içindeki ikonları	Düz dosyalar
`stream/`	Dokuz özel kuş modeli	Asset’ler
`flight.meta`	Dokuz özel kuşun ped verisi	Veri
`inventory_images/`	On dört eşya ikonu	Asset’ler
`readme.md`	ox_inventory, QBCore ve ESX için hazır eşya satırları	Referans

locales/main.lua tek escrow’lu Lua dosyasıdır.

Genel ayarlar — `config.lua`

Seçenek	Ne işe yarar	Varsayılan
`Config.Framework`	`esx`, `qb-core` veya `qbox`. Eşyaların nasıl kaydedileceğine ve bildirimlerin nasıl gösterileceğine karar verir	`esx`
`Config.Locale`	Bildirimlerin dili: `en`, `es`, `de`, `fr`, `it`, `pl`, `pt`, `ru`, `tr`	`en`
`Config.MenuKey`	Menüyü açan oyun kontrol indeksi. `303`, U tuşudur	`303`
`Config.OpenMenuCommand`	Menüyü açan sohbet komutu	`parrot`
`Config.NoActiveBirdNotification`	Kuşu çıkarmadan menüyü açmaya çalışan birine mesaj gösterir	`false`

Config.MenuKey bir harf değil, bir FiveM kontrol numarasıdır. Numaraların listesi FiveM controls referans sayfasındadır. Doğrudan okunduğu için oyuncular onu kendi ayarlarından yeniden atayamaz; alternatif olarak komut her zaman vardır.

Kuşlar — `Config.BirdItems`

Eşya adı → ped modeli listesi. Her girdi, başlangıçta kullanılabilir bir eşya olur.

Eşya	Model
`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`

Kuş eklemek

Config.BirdItems içine yeni eşya adınız ve spawn edeceği ped modeli ile bir satır ekleyin.
Eşyayı envanterinize diğerleriyle aynı şekilde ekleyin (Kurulum sayfasına bakın) ve ona bir ikon verin.
Ana oyundan bir kuş (herhangi bir a_c_… kuş modeli) başka bir şeye ihtiyaç duymaz.
Özel bir kuş, model dosyalarının stream/ içinde olmasını ve oradaki dokuzun yanında flight.meta içinde kendi girdisini gerektirir. flight.meta girdisi olmadan model yüklenir ama bir kuş gibi davranmaz.
refresh, sonra restart mic_parrots.

Kuş kaldırmak

Satırını Config.BirdItems içinden silin. Eşya hiçbir şey yapmaz olur; kimsenin elinde ölü bir eşya kalmaması için onu envanterinizden de kaldırın.

Menü — `html/`

Menü etiketleri (Bird Companion, Shoulder, Head, Dismiss, Follow, Close) locale dosyalarında değil, html/index.html içinde yazılıdır. Onları orada çevirin veya yeniden adlandırın. Renkler ve yerleşim html/style.css içindedir ve buton ikonları html/img/ içindeki PNG’lerdir.

html/index.html ayrıca yorum satırına alınmış iki buton barındırır: Dance ve Sing. Lua’da arkalarında bir eylem yoktur, bu yüzden yorum satırı olarak bırakın.

Esc veya Close butonu menüyü kapatır.

Diller

Dokuz dil gelir, locales/ içinde her biri için bir dosya: en, es, de, fr, it, pl, pt, ru, tr. Birini Config.Locale ile seçin.

Her dosya altı satır içerir: izin yok, zaten bir kuşunuz var, omzunuzda kuş yok, omzunuzda zaten kuş var, başınızda zaten kuş var ve menüyü açmak için aktif bir kuşa ihtiyacınız var.

Dil eklemek için: locales/en.lua dosyasını yeni bir dosyaya kopyalayın (örneğin locales/nl.lua), en üstteki dil anahtarını en yerine nl yapın, altı metni çevirin ve yeni dosyayı fxmanifest.lua içindeki client_scripts ve server_scripts listelerinin ikisine de ekleyin. Sonra Config.Locale değerini nl yapın, refresh edin ve yeniden başlatın.

Bildirimler

Her bildirimi client/utils.lua gönderir: ESX’te ESX.ShowNotification, QBCore’da QBCore.Functions.Notify, QBox’ta QBox notify export’u ve diğer her şey için düz GTA akışı. Mesajları kendi notify kaynağınıza yönlendirmek için o tek fonksiyonun gövdesini değiştirin.

Komutlar

Komut veya tuş	Ne işe yarar	Ayarlandığı yer
`/parrot`	Bir kuşunuz çıkarılmışken Bird Companion menüsünü açar	`Config.OpenMenuCommand`
U	Komutla aynı	`Config.MenuKey`