FiveM sunucusuna addon aralar nasıl eklenir: stream ve data dosyaları

Sunucunuza istediğiniz bir oto paketi var ve klasör .yft, .ytd ve birkaç .meta dosyası gibi dosyaları içeriyor. Bu rehber, her dosyanın nereye gittiğini, fxmanifest.lua'nın neye ihtiyacı olduğunu ve otomobili nasıl oluşturacağınızı, addon ve değiştirme otomobilleri arasındaki farkı açıklar.

#Bir addon oto paketi neler içerir

Bir oto iki tür dosyada gelir:

• Model ve doku dosyaları, stream klasörüne gider: mycar.yft (model), mycar_hi.yft (yüksek detaylı model), mycar.ytd (dokular) ve bazen .ydr veya .ytyp dosyaları.
• Veri dosyaları, data klasörüne gider: vehicles.meta, carvariations.meta, carcols.meta ve handling.meta, ve bazen vehiclelayouts.meta.

İlk set otomobilin nasıl göründüğü, ikinci set ne olduğu: adı, renkleri, handling'i ve koltuklar.

#Klasör yapısı

Oto için bir kaynak oluşturun veya tüm bir paket için bir kaynak:

resources/[cars]/mycar/
  fxmanifest.lua
  stream/
    mycar.yft
    mycar_hi.yft
    mycar.ytd
  data/
    vehicles.meta
    carvariations.meta
    carcols.meta
    handling.meta

stream içindeki dosyalar otomatik olarak oyunculara gönderilir. Bunları manifestte listelemezsiniz. data içindeki dosyalar streamed değildir ve manifest bunları bildirmelidir.

#fxmanifest.lua

fx_version 'cerulean'
game 'gta5'

files {
    'data/vehicles.meta',
    'data/carvariations.meta',
    'data/carcols.meta',
    'data/handling.meta',
}

data_file 'HANDLING_FILE' 'data/handling.meta'
data_file 'VEHICLE_METADATA_FILE' 'data/vehicles.meta'
data_file 'CARCOLS_FILE' 'data/carcols.meta'
data_file 'VEHICLE_VARIATION_FILE' 'data/carvariations.meta'

files {} bloğu dosyaları oyun istemcisinin kullanımına açar. Her data_file satırı oyuna bir dosyanın ne tür olduğunu söyler. İki kural önemlidir:

• Her dosyaya her ikisi de ihtiyaçları vardır: files içinde bir giriş ve doğru türde bir data_file satırı.
• Birçok otomobili olan bir paket genellikle oto başına bir data klasörüne sahiptir. files {} içinde 'data/**/*.meta' gibi bir desen kullanabilirsiniz, ancak bu dosyaların data_file satırları yine de yazılmalıdır, türü başına bir tane ve tür satırları aynı deseni kabul eder.

files { 'data/**/*.meta' }

data_file 'HANDLING_FILE' 'data/**/handling.meta'
data_file 'VEHICLE_METADATA_FILE' 'data/**/vehicles.meta'
data_file 'CARCOLS_FILE' 'data/**/carcols.meta'
data_file 'VEHICLE_VARIATION_FILE' 'data/**/carvariations.meta'

Paket ayrıca vehiclelayouts.meta içeriyorsa, data_file 'VEHICLE_LAYOUTS_FILE' 'data/vehiclelayouts.meta' ile bunu da bildirin.

#Başlatın ve oluşturun

server.cfg içinde kaynağı ekleyin:

ensure mycar

Kaynak klasörü adı ve ensure adı eşleşmelidir. [cars] gibi bir köşeli parantez klasörü kullanırsanız, ensure [cars] içindeki her şeyi başlatır.

Oluşturma adı vehicles.meta içindeki modelNamedir:

<Item>
  <modelName>mycar</modelName>
  <txdName>mycar</txdName>
  <handlingId>MYCAR</handlingId>
  ...
</Item>

Burada bunu mycar ile oluşturursunuz. Bir betik içinde:

local model = joaat('mycar')
lib.requestModel(model)
local veh = CreateVehicle(model, coords.x, coords.y, coords.z, heading, true, false)

lib.requestModel, ox_lib'den gelir. Olmadan, RequestModel(model) çağırın ve HasModelLoaded(model) doğru olana kadar bekleyin. Çoğu admin menüsü ve txAdmin menüsü aynı addan bir oto oluşturur.

İpucu: modelName, .yft/.ytd dosya adları ve txdName hepsi uyumlu olmalıdır. Bir oto görünmediğinde kontrol etmesi gereken ilk şey bir uyuşmazlıktır.

#Addon otolar ve değiştirme otomobilleri

Bir addon oto, temel oyunun kullanmadığı yeni bir ada sahiptir, örneğin mycar. Yukarıda yer alan veri dosyalarına ihtiyacı vardır ve listeye bir oto ekler. Hem yeni otomobiliniz hem de orijinal otolar var. Bu neredeyse tüm otomobiller için doğru seçimdir.

Bir değiştirme otomobili, sultan.yft gibi temel oyundaki bir otomobilin dosya adlarını kullanır ve bunları stream klasörüne koyar. FiveM daha sonra orijinalin yerine sizinkini yükler, o otomobilin görünmesi de dahil olmak üzere her yerde, trafikte bile. Genellikle model için vehicles.meta gerekmez, çünkü oyun zaten adı bilir. Değiştirme otomobili yalnızca görünümü değiştirir. Başka bir handling istiyorsanız, orijinal handling id'siyle eşleşen handling.meta'ya ihtiyacınız vardır.

İki fikri bir klasörde karıştırmayın. Değiştirme ve addon dosyalarını karıştıran bir paket, kafa karıştırıcı hataların yaygın kaynağıdır.

#Sonucu kontrol edin

• Sunucuyu başlatın ve konsolu okuyun. Kaynak hataları, files içinde listelenen eksik dosya gibi, başlangıçta görünür. Kaynak hiç başlamazsa, bkz. kaynağı başlatılamadı.
• Katılın ve otomobili oluşturun. Bir oto bulunamazsa, ad modelName ile eşleşmez veya kaynak başlatılmadı.
• carcols.meta ve handling.meta dosyalarının kullanımda olup olmadığını kontrol etmek için oyun içinde otomobilin renklerini ve handling'ini açın.

#Yaygın sorunlar

• Oto yok. ensure, files girişlerini ve modelName kontrol edin. Bir yoldaki yazım hatası files kaynağı durdurur.
• Oto görünmez veya beyazdır veya yanlış dokular içerir. .ytd eksik veya modelden farklı adlandırılmıştır. Ayrıca streaming uyarıları görüyorsanız, bkz. aşırı boyutlu varlıklar.
• Oto stok bir oto gibi handling yapıyor. handling.meta bildirilmedi veya onun handlingId'si vehicles.meta içindeki olanla eşleşmiyor.
• Bir DLC tabanlı oto bozuk olarak gösterilir. Bazı otolar daha yeni bir oyun derlemesine ihtiyaç duyar. server.cfg içinde sv_enforceGameBuild ile ayarlayın: bkz. sv_enforceGameBuild ve DLC.

#Kontrol Listesi