Özellikler
My Vehicles (fx-garageapp)
Vale, uzaktan anahtar, kilometre ve sigorta içeren paketle gelen garaj uygulaması; telefona nasıl kurulduğu, ana ayarları ve export'ları.
#Nedir
fx-garageapp, garaj script'in için telefon uygulamasıdır. Oyuncunun araçlarını, nerede olduklarını ve durumlarını listeler. Vale, garajdaki bir aracı yakındaki bir yoldan alır ve oyuncuya kadar sürer.
Ekstralar:
- Uzaktan anahtar. Dışarıda ve menzil içindeki bir aracı telefondan kilitleyebilir, kilidini açabilir, yerini bulabilir (korna, farlar ve yanıp sönen bir harita işareti) ve motorunu çalıştırıp durdurabilirsin. Sahiplik ve mesafe server tarafında kontrol edilir.
- Anahtar verme. Aracın anahtarlarını anahtar script'in üzerinden yakındaki bir oyuncuya verir.
- Kilometre. Sahibi aracı sürerken sayılır.
- Sigorta. Araç başına, bankadan ödenen bir poliçe; vale indirimi ya da ücretsiz vale sağlar.
Uygulama telefon olmadan da, bir komutla açılan tablet olarak çalışır.
#Gereksinimler
| Resource | Zorunlu |
|---|---|
ox_lib |
Evet |
oxmysql |
Evet |
| Bir garaj script'i | Evet: fx-garages, QBCore/Qbox player_vehicles garajı, ESX owned_vehicles garajı ya da bridge/garages/custom.lua üzerinden kendi garajın |
fx-phone |
Hayır. Telefon yoksa uygulama tablet olarak açılır |
#Kurulum
Uygulamayı ox_lib, oxmysql, garaj script'in ve telefondan sonra başlat:
cfgensure fx-phone
ensure fx-garageapp
Uygulama garaj script'inin tablolarını kullanır. Kilometre ve sigorta için kendi tablosu olan fx_garageapp_vehicles ilk başlatmada oluşturulur.
Config.Garage.System = 'qb' ya da 'esx' olduğunda, haritada gösterilen garaj ve otopark konumlarını Config.Garage.Locations ve Config.Garage.Impounds içine yaz.
#Telefona nasıl kaydolur
Config.Phone.Resource = 'auto' olduğunda ilk başlatılan telefon kullanılır: önce fx-phone, sonra lb-phone, sonra cylex_phone.
FX Phone adaptörü (client/phone/fxphone.lua), Config.Phone'daki identifier = Config.Phone.AppIdentifier (varsayılan fx_garage), name, description, developer, defaultApp, size, ui ve icon değerleriyle exports['fx-phone']:AddCustomApp çağırır. Sayfaya giden mesajlar SendCustomAppMessage üzerinden gider.
Uygulamanın hiç başlamamasını istiyorsan Config.BundledApps içinde ['fx-garageapp'] = false ayarla. Bkz. Uygulamalar.
#Öne çıkan config ayarları
| Ayar | Anlamı |
|---|---|
Config.Locale |
tr veya en |
Config.Garage.System |
auto, fx-garages, qb, esx veya custom |
Config.Garage.ShowUnregistered |
Yalnızca fx-garages: framework'ün oyuncuya ait dediği ama fx-garages'ın henüz almadığı araçları salt okunur olarak listeler |
Config.Garage.Locations, Impounds, Labels, VehicleTypes |
qb / esx için: garaj konumları, çekilmiş araç otoparkları, görünen adlar ve model türleri |
Config.Phone |
Telefon seçimi, AppIdentifier, AppName, Title, Description, Icon, DefaultApp |
Config.Standalone |
Tablet modu: Enabled, Command (varsayılan araclarim), Key, AllowWithPhone |
Config.Valet.Price |
Hizmet ücreti; 0 ücretsizdir |
Config.Valet.Payment |
Nakit ve bankanın kabul edilip edilmediği |
Config.Valet.Types |
Valenin getirebileceği araç türleri |
Config.Valet.SpawnDistance |
Aracın oyuncudan ne kadar uzakta bir yolda belireceği (Min, Max) |
Config.Valet.InstantDelivery |
true, aracı sürüş olmadan oyuncunun yanına koyar |
Config.Valet.DriveSpeed, DrivingStyle, StuckSeconds, MaxDriveSeconds |
Valenin nasıl sürdüğü ve sıkışan aracın ne zaman taşınacağı |
Config.Valet.CheckFines, CheckBilling |
Ödenmemiş araç cezaları ya da faturalar valeyi engeller |
Config.Billing |
Fatura kilidi: Resource (auto, çalışıyorsa fx-billingapp'i kullanır), Export, MinUnpaidTotal |
Config.Keys.Resource |
Anahtar script'i; auto, qb-vehiclekeys, qbx_vehiclekeys, wasabi_carlock, qs-vehiclekeys ve MrNewbVehicleKeys'i algılar |
Config.Extras |
Remote (açık/kapalı, menzil), ShareKeys, Odometer, Insurance planları |
Config.Map3D |
Çalışıyorsa valeyi ve "aracımı bul"u fx-3dmap'e bildirir |
Garaj bağlantısı bridge/garage.lua içinde, her sistem için bir adaptör de bridge/garages/ içindedir. Bu dosyalar şifreli değildir.
#Vale garajla nasıl tutarlı kalır
- Sahiplik, model ve plaka garaj script'inin kaydından doğrulanır.
- "Garajda"dan "dışarıda"ya durum değişikliği koşullu yazılır, böylece iki kişi aynı aracı aynı anda çıkaramaz.
- Araç kayıtlı plakayla oluşturulur ve plaka server tarafında doğrulanır.
- Vale yolda başarısız olursa araç silinir ve garaja geri yazılır. Teknik bir hata olursa ücret iade edilir.
#Export'lar
| Export | Taraf | Amaç |
|---|---|---|
OpenApp() |
Client | Uygulamayı tablet olarak açar |
CloseApp() |
Client | Tableti kapatır |
GetMileage(plate) |
Server | Aracın kilometresini tam kilometre olarak döndürür |
GetInsurance(plate) |
Server | Aktif poliçeyi { plan, untilAt } olarak ya da nil döndürür |
HasUnpaidInvoices(identifier, notify) |
Server | Config.Billing'de ayarlanan resource'u kullanarak, fatura kilidi bu oyuncuyu engelliyorsa true döndürür |
lualocal km = exports['fx-garageapp']:GetMileage(plate)
local policy = exports['fx-garageapp']:GetInsurance(plate)