Özellikler

Rental (fx-rentalapp)

Paketle gelen oyuncudan oyuncuya araç kiralama uygulaması; telefona nasıl kurulduğu ve ana ayarları.

#Nedir

fx-rentalapp bir araç kiralama uygulamasıdır. Oyuncular sahip oldukları araçları ilana koyar, diğerleri de onları günlük olarak kiralar. Ödeme kiralama bitene kadar bekletilir. Uygulamada araç sahibi onayı, hasar kesintili depozito, puanlar ve yorumlar, araç sahibi paneli, favoriler, filtreler ve ücretli öne çıkarma vardır.

Uygulamanın altı sekmesi vardır:

Sekme Ne için
Filo Şirketin kendi araçları (Config.DefaultListings). Hemen onaylanır
Pazaryeri Oyuncuların kendi ilanları: arama, sınıf, sıralama, favoriler
Kiralamam Açık kiralama adım adım (ödeme, onay, teslim alma, iade), geri sayım, uzatma ve geçmiş kiralamalar
İlanlarım Kendi aracını ilana koyma: oluşturma, düzenleme, duraklatma, silme, öne çıkarma, gelen istekler, kazançlar
Ofisler Kiralama ofisleri, en yakını önce; her birinde bir hedef noktası düğmesi
Rehber Kiralamanın nasıl işlediği, kurallar ve bir SSS. Kurallar config değerlerinden oluşturulur

Bir kiralama nasıl işler:

  • Kiralama süresi onay beklenirken değil, araç teslim alındığında başlar.
  • Süren bir kiralama, aynı günlük fiyata vergi eklenerek gün gün uzatılabilir; toplamda en fazla Config.MaxDays kadar.
  • Kiralanan araç, araç sahibinin gerçek aracı değildir. Aynı modelin geçici plakalı bir kopyası oluşturulur ve iadede ya da süre dolduğunda kaldırılır.
  • Yanıtlanmayan bir istek otomatik olarak iptal edilir ve tam iade yapılır. Süresi dolan bir kiralama otomatik olarak kapatılır.
  • Config.UsePickupPoints = true olduğunda teslim alma, iade ve aracı çağırma yalnızca bir kiralama ofisinde çalışır. Mesafe server tarafında kontrol edilir.

#Gereksinimler

Resource Zorunlu
fx-phone Evet (uygulama lb-phone ya da cylex_phone'a da kurulur)
oxmysql Evet
qb-core, qbx_core veya es_extended Biri; otomatik algılanır
Bir araç anahtarı resource'u İsteğe bağlı. Varsayılan olarak qb-vehiclekeys (Config.VehicleKeysResource)
Bir şirket bankası İsteğe bağlı: tgiann-bank, qb-banking, qb-management veya esx_society
fx-companyapp İsteğe bağlı: komisyon gelirini şirket geçmişine yazar

#Kurulum

cfgensure oxmysql
ensure fx-phone
ensure fx-rentalapp

Tablolar (rental_listings, rental_bookings, rental_reviews, rental_favorites, rental_held_vehicles) eksikse her başlatmada oluşturulur. Veritabanı kullanıcısının CREATE yetkisi olmalıdır; yoksa setup/sql/install.sql dosyasını elle içe aktar.

Konsol başlangıçta algılanan framework'ü, araç tablosunu ve hesabı yazdırır.

#Telefona nasıl kaydolur

Config.Phone.Resource = "auto" olduğunda uygulama çalışan telefona kurulur. FX Phone adaptörü (client/phone/fxphone.lua); identifier = Config.AppIdentifier (varsayılan rentalapp), ad, açıklama, geliştirici, defaultApp = Config.DefaultApp, kategori, boyut, price = Config.AppPrice, bir ekran görüntüsü, ui ve icon ile exports['fx-phone']:AddCustomApp çağırır.

Server tarafında bildirimler exports['fx-phone']:SendNotification üzerinden gider; Config.Phone.BankHistory = true olduğunda ödemeler AddTransaction ile telefonun banka geçmişine yazılır.

Uygulamanın hiç başlamamasını istiyorsan Config.BundledApps içinde ['fx-rentalapp'] = false ayarla. Bkz. Uygulamalar.

#Öne çıkan config ayarları

config.lua:

Ayar Anlamı
Config.Framework auto, qb, qbox, esx veya custom (bridge/adapters.lua)
Config.Locale tr veya en. Eksik anahtarlar İngilizceye düşer
Config.AppIdentifier, Config.AppName, Config.DefaultApp, Config.AppPrice Uygulamanın telefonda nasıl göründüğü
Config.Account, Config.Currency Kiracının ödeme yaptığı hesap (bank veya cash) ve para birimi simgesi
Config.PlatformFee, Config.TaxRate Ara toplamın oranı olarak platform komisyonu ve vergi
Config.MinDays, Config.MaxDays Kiralama süresi sınırları
Config.MaxActivePerRenter, Config.MaxListingsPerHost Oyuncu başına açık kiralama ve araç sahibi başına ilan sayısı
Config.RequireApproval Araç sahibinin bir isteği onaylaması gerekip gerekmediği
Config.DayRealMinutes Bir kiralama gününün gerçek dakika karşılığı
Config.AutoReturnOnExpire, Config.ExpireCheckMinutes Süresi dolan kiralamaların otomatik kapatılması
Config.UsePickupPoints, Config.PointRadius, Config.SlotRadius Yalnızca ofiste teslim alma ve iade
Config.SpawnPoints, Config.Offices, Config.Blip Ofisin park yerleri ya da birkaç ofisin listesi ve harita blip'leri. Haritana göre değiştir
Config.DepositEnabled, Config.DepositPercent, Config.DepositFlat, Config.DamageDeduct Depozito ve hasar kesintisi
Config.CancelFeePercent, Config.PendingExpireMinutes İptal ücreti ve bir isteğin araç sahibini ne kadar beklediği
Config.VehicleKeysResource, Config.RemoveKeysEvent Anahtar entegrasyonu
Config.VehicleClasses, Config.Tags, Config.BlacklistedModels İlan sınıfları, etiketler ve ilana konamayan modeller
Config.EnableDefaultListings, Config.DefaultListingName, Config.DefaultListings Her zaman kiralanabilen resmî araç kataloğu

config_server.lua yalnızca server tarafındadır. Config.FeeSociety, komisyon ve vergiyi alan hesabı belirtir; nil olduğunda bu para ekonomiden çıkar.

#Araç görselleri

Görseller ui/vehicles/<spawn name>.webp şeklindedir. Oyunun kendi araçlarının görselleri resource ile gelir. Görseli olmayan bir model genel bir araç simgesi gösterir. Eklenti bir araç için aynı adlandırmayla kendi .webp dosyanı ekle.

#Garajlarla ilgili notlar

  • Para kiracının kişisel hesabından alınır. Meslek ve şirket parası kullanılmaz.
  • fx-garages kuruluysa ilandaki araç sahibinin garaj kaydında kalır.
  • Diğer garaj sistemlerinde araç ilandayken garajdan çıkarılır ve rental_held_vehicles içinde yedeklenir. İlan silindiğinde geri konur.

#Export'lar

Export Taraf Amaç
GetVersionStatus() Server Güncelleme kontrolünün sonucu: { state, current, latest, behind }

Uygulamanın başka export'u yoktur.