Başlangıç
FX Phone
FX Phone nedir, neye ihtiyaç duyar, pakette neler var ve sonra nereye bakmalısın.
#Nedir
FX Phone (fx-phone), FiveM sunucuları için bir akıllı telefon resource'udur. Kilitli Ekran'ı, araç takımlı (widget) bir Ana Ekran'ı, Dynamic Island'ı, Denetim Merkezi'ni, bildirimleri ve aramalar, mesajlar, medya, bankacılık, faturalar, şirket hatları, ilanlar, haberler ve sosyal ağlar için bir dizi yerleşik uygulaması vardır.
QBCore, Qbox, ESX üzerinde ya da framework olmadan çalışır, verilerini kendi fx_phone_* veritabanı tablolarında tutar; bir yönetim tableti, konsol, dosya ve Discord loglaması, günlük anlık yedekler ve cylex_phone verileri için bir taşıma komutuyla gelir.
Diğer resource'lar ona client ve server export'ları, event'ler, state bag'ler ve iframe özel uygulamaları üzerinden bağlanır. Export'lar lb-phone ve cylex_phone adlarıyla yapılan çağrılara da yanıt verir.
#Gereksinimler
| Gereksinim | Notlar |
|---|---|
| oxmysql | Zorunlu. Manifest'teki tek bağımlılık |
| MySQL 5.7+ veya MariaDB 10.3+ | Zorunlu. Tablolar başlangıçta oluşturulur |
| Framework | QBCore, Qbox, ESX ya da hiçbiri. Otomatik algılanır; diğer framework'ler bridge/custom.lua üzerinden |
| Envanter | ox_inventory, qb-inventory (ya da item'ları QBCore oyuncu verisinde tutan herhangi bir envanter) veya hiçbiri |
| Ses | pma-voice, mumble-voip veya SaltyChat; arama sesi için gerekir |
| Yükleme sağlayıcısı | Fivemanage, Fixitfy relay'i ya da kendi HTTP sunucun; fotoğraflar, videolar ve sesli mesajlar için gerekir |
İsteğe bağlı resource'lar:
| Resource | Ne katar |
|---|---|
| fx-phone-assets | Oyuncunun elinde, oyuncunun renginde telefon modeli, kılıflar ve aksesuarlar, mağaza vitrini |
| fx-sound veya xsound | Yakındaki oyuncuların duyduğu zil ve bildirim sesleri |
| Bir banka resource'u | IBAN'lar ve meslek hesapları: tgiann-bank, qb-management, Renewed-Banking ya da esx_addonaccount ile esx_society |
| Bir hava durumu senkronu | Hava Durumu uygulaması sunucunun havasını okur: Renewed-Weathersync, qb-weathersync, cd_easytime |
| ox_target | Çalışıyorsa telefon mağazası tezgâhı bunu kullanır |
| fx-3dmap | Telefon mağazaları ve Anon izleri 3D haritada |
| GIPHY veya Tenor anahtarı | Mesajlar'da GIF arama |
#Pakette neler var
| Klasör | Nedir |
|---|---|
fx-phone |
Telefonun kendisi: client, server, arayüz, config'ler, dil dosyaları, kurulum dosyaları |
fx-phone-assets |
Yalnızca stream edilen modeller (telefon gövdeleri, kılıflar, aksesuarlar). İçinde script yoktur |
[fx-apps] |
Paketle gelen Fixitfy uygulama resource'ları; her biri telefona kendini kaydeden ayrı bir resource'tur |
Paketle gelen uygulama resource'ları:
| Resource | Uygulama | Sayfa |
|---|---|---|
fx-billingapp |
Billing: faturalar | Billing |
fx-companyapp |
Company: çalışanlar, kasa, rehber | Company |
fx-garageapp |
My Vehicles: garaj ve vale | Garage |
fx-metubeapp |
MeTube: videolar ve TV ekranları | MeTube |
fx-musicapp |
Music: müzik akışı, hoparlörler, Dynamic Island | Music |
fx-mapsapp |
Maps: arkadaşların canlı konumları | Maps |
fx-orderapp |
Order: işletmeler, menüler, teslimat, kuryeler | Order |
fx-rentalapp |
Rental: oyuncudan oyuncuya araç kiralama | Rental |
fx-fansapp |
Fans: içerik üreticisi abonelikleri | Fans |
fx-casinoapps |
Fixitfy Play: telefon oyunları | Casino |
fx-sound |
Zil sesleri ve hoparlörler için kullanılan 3D ses motoru | Sound |
Paketle gelen her uygulamanın başlamasını Config.BundledApps ile engelleyebilirsin. Bkz. Uygulama ayarları.
#Düzenleyebileceğin dosyalar
| Dosya | İçerdikleri |
|---|---|
config.lua |
Genel ayarlar: dil, tuş, item, framework, envanter, ses, numaralar, para birimi |
configs/config_<topic>.lua |
Her uygulama ya da konu için bir dosya |
config_server.lua |
Yükleme anahtarları, webhook'lar, GIF ve fiyat API anahtarları, numara ve IBAN üreticileri, konsol komutları. Yalnızca server |
locales/*.json |
Log metinleri dahil bütün metinler |
bridge/*.lua |
Framework adaptörleri ve kendi framework'ün için bir şablon olan custom.lua |
client/integrations/, server/integrations/ |
Envanter, ses, ekran görüntüsü, banka, yükleme ve GIF adaptörleri |
setup/** |
SQL, araçlar, item tanımları, uyumluluk katmanları |
#Sonraki adımlar
- Kur: Kurulum, Başlatma sırası, Item kurulumu.
- Oyuncuların neye sahip olduğunu öğren: Uygulamalar ve telefon kurulumu ve Aramalar ile başla.
- Ayarları değiştir: config.lua ve diğer Yapılandırma sayfaları.
- Sunucunu bağla: Framework, Envanter, Banka, Ses, Yükleme.
- Ona karşı script yaz: Tüm export'lar, Client event'leri, Özel uygulamalara genel bakış.
- Başka bir telefondan geliyorsan: lb-phone, cylex_phone, Taşıma.