Başlangıç

Kurulum

FX Phone'u altı adımda kur: dosyaları kopyalamaktan yönetici rollerini vermeye kadar.

1'den 6'ya kadar olan adımlar zorunludur. Zaten bir framework, bir envanter ve bir ses resource'u çalıştıran bir sunucuda yaklaşık 15 dakika sürer.

#1. Dosyaları kur

fx-phone klasörünü resources/ içine kopyala. Klasörün adını değiştirme: export ad alanı (exports['fx-phone']), event adları ve sayfa adresi bu adı kullanır.

Telefon modellerini ve paketle gelen uygulamaları istiyorsan fx-phone-assets ve [fx-apps] klasörünü de yanına kopyala.

Resource'ları server.cfg dosyasına ekle. FX Phone, konuştuğu her şeyden sonra başlamalıdır. Sıranın tamamı Başlatma sırası sayfasında.

cfgensure oxmysql
ensure qb-core
ensure ox_inventory
ensure pma-voice
ensure fx-phone

#2. Veritabanı

Varsayılan olarak yapman gereken bir şey yok. Bütün tablolar tek bir dosyada, setup/install.sql içinde. Config.AutoSchema = true olduğunda FX Phone bu dosyayı her başlangıçta çalıştırır, ardından yeni sürümlerin ihtiyaç duyduğu sütun değişikliklerini uygular. Her ifade CREATE TABLE IF NOT EXISTS ya da kontrol edilen bir ALTER TABLE'dır ve yalnızca fx_phone_* tablolarındaki ifadeler çalıştırılır.

oxmysql'in bağlandığı veritabanı kullanıcısının veritabanında CREATE, ALTER ve INDEX yetkilerine ihtiyacı vardır.

Veritabanı kullanıcın tablo oluşturamıyorsa dosyayı kendin içe aktar ve otomatik çalıştırmayı kapat:

bashmysql -u user -p yourdb < setup/install.sql
luaConfig.AutoSchema = false

AutoSchema = false olduğunda bir güncellemenin sütun değişiklikleri de çalışmaz. Bkz. Güncelleme.

#3. Telefon item'ı

Varsayılan olarak bir oyuncunun telefonu kullanabilmesi için phone adlı bir item'a ihtiyacı vardır.

luaConfig.Item = 'phone'      -- false: everyone has a phone, no item needed
Config.Inventory = 'auto'  -- 'auto' | 'ox_inventory' | 'qb-inventory' | 'standalone'

Her envanter için item kodu ve item görselleri Item kurulumu sayfasında. Envanterin nasıl algılandığı Envanter sayfasında.

#4. Yüklemeler

Fotoğraflar, videolar, sesli mesajlar ve profil resimleri asla veritabanında değil, bir yükleme sağlayıcısında saklanır. config_server.lua içinde birini seç ve anahtarını orada ayarla:

luaServerConfig.Upload = {
    Provider = 'fivemanage',   -- 'fivemanage' | 'fmapi' | 'relay' | 'custom' | 'none'
    Fivemanage = {
        Image = 'your-v3-api-key',
    },
}

Oyuncunun oyunu dosyayı tek kullanımlık bir URL ile doğrudan sağlayıcıya yükler. Anahtar sunucudan hiç çıkmaz.

Provider = 'none' olduğunda kamera yine çalışır ama hiçbir şey kaydedilemez ya da gönderilemez.

config_server.lua anahtarlarını ve webhook'larını tutar. Onu asla paylaşma, asla bir destek talebine yapıştırma, asla herkese açık bir depoya koyma.

Her sağlayıcı Yükleme sayfasında anlatılıyor.

#5. Dil ve para birimi

luaConfig.Locale = 'tr'            -- language of new phones; the shipped config uses Turkish
Config.Locales = { 'en', 'tr' } -- what players can pick in Settings
Config.Currency = { Code = 'USD', Symbol = '$', Locale = 'en-US' }

İngilizce bir sunucu Config.Locale = 'en' ayarlar ve USD satırını olduğu gibi bırakır. Türk lirası kullanan bir sunucu:

luaConfig.Locale = 'tr'
Config.Currency = { Code = 'TRY', Symbol = '₺', Locale = 'tr-TR' }
Config.Crypto.Currency = 'try'

Currency.Locale, tutarların telefonda nasıl biçimlendirileceğini belirler (binlik ayracı, ondalık işareti, simgenin yeri). Crypto.Currency, CoinGecko'nun karşılık para birimidir, küçük harfle yazılır.

#Dil ekleme

locales/en.json dosyasını locales/<code>.json olarak kopyala, çevir ve kodu Config.Locales listesine ekle. Kodlar iki harflidir ya da xx-XX biçimindedir. Atladığın anahtarlar İngilizceye düşer. Aynı dosya konsol ve Discord log metinlerini (logs.), yönetim tabletini (tablet.) ve bütün uygulamaları da tutar.

Her şeyi çevirmeden değiştirmeye değer anahtarlar:

Anahtar Nedir
apps.<id> Simgelerin altındaki uygulama adları
phone.no_item, phone.dead, phone.disabled Telefonun neden açılmadığı
phone.keys.open, phone.keys.look GTA ayarlarındaki tuş ataması adları
mail.system_sender Gönderen adı olmayan script e-postalarının gönderen adı
admin.command., admin.backup. Komut yanıtları
logs.<event>.title, logs.<event>.summary Her event için Discord embed başlığı ve satırı

#6. Yönetici rolleri

Yönetim tableti ve yönetici komutları ACE yetkilerini kullanır. server.cfg dosyasına ekle:

cfgadd_ace group.admin fxphone.admin allow
add_ace group.moderator fxphone.mod allow
add_ace group.owner fxphone.god allow
add_ace group.owner fxphone.admin allow

Son satır, sahiplerin oyun içinde fxphone:number, fxphone:wipe ve fxphone:mail komutlarını da çalıştırabilmesini sağlar. Bu komutlar tablet rolüne değil, fxphone.admin yetkisine (ya da framework'ün kendi yönetici kontrolüne) bakar.

Roller Yönetim ve Yönetim tableti sayfalarında anlatılıyor.

Sunucuyu başlat, bir karakter yükle ve F1'e bas.

#Beklenen konsol çıktısı

FX Phone başlarken framework, envanter, ses, sound ve banka resource'larını arar. Sunucu konsolu bulduklarını yazdırır:

cfg[fx-phone:main] framework: qbcore
[fx-phone:bank] bank adapter: tgiann-bank
[fx-phone:schema] database ready: 39 statements, 0 migrations applied, 12 recorded, 0 skipped, 0 failed

Son satırdaki sayılar sürüme göre değişir. Framework'lü bir sunucuda ilk satır standalone diyorsa başlatma sırasını düzelt.

#Sunucu konsol komutları

Komut Kim Ne yapar
fxphone:number <identifier> <number> Konsol, fxphone.admin, framework yöneticileri Bir karaktere yeni bir numara verir
fxphone:wipe <identifier> Aynı Bir karakterin bütün telefon satırlarını siler
fxphone:mail <id or identifier or -1> <sender> <subject> <message> Aynı Bir e-posta gönderir. -1 herkes demektir. Boşluk içeren kelimeleri çift tırnak içine al
fxphone:backup Konsol, god rolü Hemen bir anlık yedek başlatır
fxphone:admin <id> Konsol Tableti o oyuncu için kendi rolüyle açar ya da rolü olmadığını bildirir
fxphone:migrate cylex dry / run / resume Konsol cylex_phone verilerini kopyalar. Bkz. Taşıma

Identifier, framework'ün karakter kimliğidir: QBCore ve Qbox'ta citizenid, ESX'te identifier, standalone'da license: identifier'ı.

fxphone:number, fxphone:wipe ve fxphone:mail, config_server.lua dosyasının en altında tanımlıdır; bu yüzden onları değiştirebilir ya da kaldırabilirsin.

#Yedekler ve çöp kutusu

FX Phone her gün sunucu saatiyle 04:30'da bütün fx_phone_* tablolarını bir manifest.json ile birlikte backups/<yyyy-mm-dd>/<table>.json dosyalarına yazar. Tablolar 500'er satır okunur, sayfalar arasında bir duraklama verilir. Config.Admin.BackupDays değerinden eski klasörler silinir. Elle başlatmak için fxphone:backup komutunu ya da tableti (god rolü) kullan.

Anlık yedekler veritabanı yedeklerinin yerini tutmaz. Silinmiş bir hesabın, bütün veritabanını geri yüklemeden kurtarılabilmesi için vardır.

setup/tools/restore.py, bir anlık yedek klasörünü SQL'e çevirir (Python 3, paket gerekmez):

bashpython setup/tools/restore.py backups/<date> -o restore.sql
python setup/tools/restore.py backups/<date> -o users.sql -t fx_phone_users -t fx_phone_contacts

Her satır INSERT ... ON DUPLICATE KEY UPDATE olur; bu yüzden dosyayı içe aktarmak, sonradan oluşturulan satırları silmeden anlık yedekteki değerleri geri koyar. Dosyayı içe aktarmadan önce oku.

Bir sosyal hesabı, gönderiyi, yorumu, hikâyeyi, ilanı ya da haberi silmek onu yalnızca silindi olarak işaretler. Config.Admin.TrashDays gün boyunca tabletten geri yüklenebilir. Bundan sonra günlük temizlik onu kaldırır.

#Content Security Policy

html/index.html, telefon sayfasının neleri yükleyebileceğini sınırlayan bir Content-Security-Policy taşır:

Tür İzin verilen
Script'ler Telefonun kendi dosyaları ve hash'iyle birlikte satır içi import map
Stiller, fontlar Telefonun kendi dosyaları
Görseller, ses, video, ağ istekleri https:, nui:, data:, blob:
Frame'ler (özel uygulamalar) Telefonun kendisi, nui:, https:
Worker'lar, eklentiler, base öğesi Hiçbiri

Bir özel uygulamanın ui değeri sonunda https:// olmalıdır: bir https:// sitesi ya da bir resource sayfası (my-app/html/index.html ve nui://my-app/..., https://cfx-nui-my-app/... olur). Başka bir adres boş bir sayfa olarak açılır.

Telefonun oyuncu medyası için hangi sunucuları kabul ettiğine server tarafında ServerConfig.Upload.AllowedHosts karar verir. Bkz. Yükleme.

Oyun içinde kontrol etmek için telefonu, Fotoğraflar'ı, Kamera'yı ve bir özel uygulamayı aç, sonra F8 konsoluna bak. Content Security Policy geçen bir satır olmamalı. Biri çıkarsa, ilgili direktifi ve engellenen adresi gösterir.