Özelleştirme

Her eşyanın ne yaptığı menüde oluşturulur ve veritabanına kaydedilir. Dosyalar geri kalanı belirler: komut, tuşlar, şeylerin nasıl gösterildiği ve kaynağın framework’ünüzle nasıl konuştuğu.

Hangi dosya neyi belirler

Dosya	Neyi belirler	Açık mı?
`config.lua`	Dil, komut, iptal tuşu, yerleştirilmiş prop etkileşimi, görsel yolu, ilerleme çubuğu	Evet
`bridge/client_bridge.lua`	Bildirimler, can, zırh, stres, yemek ve susuzluk, eşya sayıları, meslekler, target, ilerleme çubuğu	Evet
`bridge/server_bridge.lua`	Framework algılama, kullanılabilir eşyalar, eşya ekleme ve çıkarma, meslekler, bildirimler, eşya listesi	Evet
`locales/*.lua`	Oyun içi ve menüdeki her metin parçası	Evet
`data/*.lua`	Menünün seçicilerinin arkasındaki listeler	Evet
`html/`	Menü (HTML, CSS, JS)	Okunabilir
`client/`, `server/`	Eşya mantığı	Şifreli

config.lua

Seçenek	Ne işe yarar	Varsayılan
`Config.Locale`	Menünün ve mesajların dili. Bkz. Diller	`'en'`
`Config.Command`	Menüyü açan ve kapatan komut	`'itemcreator'`
`Config.CommandDescription`	Bu komutun FiveM’in tuş atamalarındaki adı; orada ona bir tuş atanabilir. Varsayılan olarak tuşu yoktur	`'Open Item Creator Menu'`
`Config.CancelKey`	Bir eşyanın başlattığı şeyi iptal etmek için varsayılan tuş. Aşağıya bakın	`'X'`
`Config.Interaction`	Yerleştirilmiş bir prop’un nasıl geri toplanacağı: `'drawtext'`, `'ox_target'` veya `'qb-target'`. Her iki target değerinde de bridge, `ox_target` veya `qb-target`’tan hangisi çalışıyorsa onu kullanır	`'drawtext'`
`Config.ImageInventoryPath`	Menünün eşya resimlerini bulduğu yer, `<path><item name>.png` olarak	`'nui://ox_inventory/web/images/'`
`Config.ProgressBar`	Yerleşik çubuk için `'custom'`, ox_lib’inki için `'ox_lib'`. ox_lib çalışmıyorsa yerleşik çubuk kullanılır	`'custom'`

ox_inventory kullanmıyor musunuz? Config.ImageInventoryPath değerini envanterinizin görsel klasörüne ayarlayın, örneğin nui://qb-inventory/html/images/.

Tuşlar ve komutlar

Komut	Varsayılan tuş	Ne işe yarar
`/itemcreator`	yok	Menüyü açar veya kapatır. ACE `mic_itemcreator.open` gerekir
`/cancelitemanim`	`Config.CancelKey` (X)	Bir eşyanın başlattığı animasyonu, senaryoyu veya yürüyüş stilini durdurur, hızı sıfırlar, süper güçleri bitirir ve takılı bir prop’u kaldırır

Bir Attach Prop konumlandırılırken bu tuşlar geçerlidir. Her biri FiveM’in tuş atamalarında “Placement:” adıyla listelenir, böylece oyuncular bunları değiştirebilir:

Tuş	Ne yapar
← → ↑ ↓	Prop’u sola, sağa, ileri, geri hareket ettirir
Page Up / Page Down	Yukarı veya aşağı hareket ettirir
Nümerik 4 / 6	Yaw
Nümerik 8 / 5	Pitch
Nümerik 7 / 9	Roll
X	Animasyonu önizler
E	Onaylar
Backspace	İptal eder

Veri listeleri

Menüde bir listeden seçebileceğiniz her şey data/ içinden gelir ve hepsine ekleme yapabilirsiniz:

Dosya	Ne listeler
`data/animations.lua`	Animasyonlar
`data/scenarios.lua`	Senaryolar
`data/walkingstyles.lua`	Yürüyüş stilleri
`data/bones.lua`	Bir prop’un takılabileceği kemikler
`data/particles.lua`	Partikül efektleri
`data/screeneffects.lua`	Ekran efektleri
`data/sounds.lua`	Sesler
`data/cars.lua`	Arabalar, etiket ve modele göre
`data/peds.lua`	Ped modelleri
`data/clothing.lua`	Bir kıyafet parçası veya prop giyildiğinde oynatılan animasyonlar

Her girdiyi çevresindekilerle aynı biçimde tutun. Menü bu dosyaları açıldığında okur; düzenledikten sonra kaynağı yeniden başlatın.

Diller

locales/ içinde dokuz dosya gelir:

`Config.Locale`	Dil
`en`	İngilizce
`es`	İspanyolca
`de`	Almanca
`fr`	Fransızca
`it`	İtalyanca
`pt`	Portekizce
`ru`	Rusça
`ch-zn`	Çince
`jp`	Japonca

config.lua içindeki yorum tr ve ch değerlerinden de söz eder; ikisi de mevcut değildir. Yukarıdaki kodları kullanın.

Aynı dosya hem oyun içi mesajları hem de menüyü çevirir, dolayısıyla düzenlenecek tek bir yer vardır.

Bir dil eklemek için:

locales/en.lua dosyasını yeni bir dosyaya kopyalayın, örneğin locales/pl.lua.
İçinde Locales['en'] değerini kendi kodunuza çevirin ve her satırın sağındaki metni çevirin. Anahtarları ve varsa %s ifadelerini koruyun.
Dosyayı fxmanifest.lua içindeki shared_scripts listesine, locales/lib.lua üstüne ekleyin.
Config.Locale değerini kodunuza ayarlayın, refresh yapın ve yeniden başlatın.

Eksik bir anahtar konsolda Translation key "…" not found yazdırır ve ekranda anahtarın kendisini gösterir.

Bridge

bridge/ içinde iki açık dosya vardır. Fonksiyon adlarını koruyun — kaynağın geri kalanı onları adıyla çağırır.

bridge/server_bridge.lua

Fonksiyon	Ne işe yarar
(algılama)	`es_extended` başlatılmışsa ESX’i, aksi halde `qb-core` başlatılmışsa QBCore’u kullanır. QBox, QBCore uyumluluğu üzerinden `qb-core` olarak bulunur
`Bridge.RegisterUsableItem`	Yapılandırılmış her eşyayı framework’ünüze kullanılabilir olarak kaydeder
`Bridge.AddItem`, `Bridge.RemoveItem`, `Bridge.GetItemCount`	Eşyalar: paketler, toplamalar, gerekli eşyalar, Remove on Use
`Bridge.GetPlayerJob`, `Bridge.GetPlayerJobGrade`	Meslek kısıtlaması
`Bridge.Notify`	Sunucu tarafı bildirimler
`Bridge.GetAllItems`	Menüdeki eşya listesi: önce ox_inventory’den, sonra ESX’in kayıtlı eşyalarından, sonra QBCore’un paylaşılan eşyalarından

bridge/client_bridge.lua

Fonksiyon	Ne işe yarar
`Bridge.Notify`	Her bildirim. Framework yoksa GTA akışına geri döner
`Bridge.AddHealth`, `Bridge.AddArmor`	Health/Armor
`Bridge.AddFoodThirst`	Food/Thirst: ESX’te `esx_status`; QBCore’da `consumables:server:addHunger` ve `addThirst` olayları
`Bridge.AddStress`	Stress: ESX’te `esx_status`; QBCore’da `consumables:server:addStress`
`Bridge.GetItemCount`	Always Attached Prop: çalışıyorsa ox_inventory’nin sayısı, aksi halde oyuncu verisi
`Bridge.AddTargetEntity`	Yerleştirilmiş bir prop üzerindeki toplama seçeneği, ox_target veya qb-target için
`Bridge.ProgressBar`	İlerleme çubukları: ox_lib veya yerleşik olan. Başka bir ilerleme çubuğu kaynağı eklemek için yorum satırı örneği olan işaretli bir yer vardır

HUD’unuz açlık, susuzluk veya stres için farklı olaylar mı kullanıyor? Bunları Bridge.AddFoodThirst ve Bridge.AddStress içinde değiştirin. Başka bir bildirim kaynağı mı? Bridge.Notify gövdesini değiştirin. Başka bir framework veya envanter mi? Her iki dosyada da aynı fonksiyonları onun için doldurun.

Topluluk ağı

Menüdeki Network, diğer sunucuların paylaştığı eşya yapılandırmalarını listeler. Import, bu yapılandırmayı kendi eşyalarınızdan hangisinin alacağını sorar, ardından ayarlayıp kaydetmeniz için onu açar. Kendinizinkilerden birini paylaşmak için, eşya listenizden herkese açık bir ad, bir açıklama ve bir yazar adıyla dışa aktarın — ağı kullanan her sunucuda görünür hale gelir.

Liste GitHub’dan indirilir, dolayısıyla dolması için sunucunuzun dışarıya internet erişimine sahip olması gerekir.