Ö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.MaxDayskadar. - 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 = trueolduğ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_vehiclesiç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.