Ö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)