Entegrasyon

Framework

FX Phone'un QBCore, Qbox, ESX veya standalone'u nasıl algıladığı ve kendi framework'ünü nasıl bağlayacağın.

FX Phone framework ile tek bir bridge üzerinden konuşur. Geri kalan her şey (uygulamalar, banka, faturalar, hizmetler) yalnızca bridge'i çağırır; bu yüzden başka bir framework'ü desteklemek tek bir dosyayı doldurmak demektir.

#Algılama

Config.Framework = 'auto', şu sırayla çalışan ilk framework'ü seçer:

Sıra Ad Neyle algılanır Karakter identifier'ı
1 custom Yalnızca Config.Framework = 'custom' olduğunda bridge/custom.lua ne döndürürse
2 qbox qbx_core başlamışsa citizenid
3 qbcore qb-core başlamışsa citizenid
4 esx es_extended başlamışsa identifier
5 standalone Her zaman license: identifier'ı

FX Phone framework'ten sonra başlamalıdır. Bir framework kurulu ama henüz başlamamışken standalone'a geri dönerse konsol bunu söyler:

cfg[fx-phone] qb-core is installed but not started yet. Ensure fx-phone after your framework.

Adıyla belirtilen bir framework çalışmıyorsa bir uyarıyla auto'ya geri döner.

#Her adaptör ne yapar

QBCore Qbox ESX standalone
Ad charinfo.firstname/lastname Aynı firstName/lastName, yoksa getName() FiveM adı, ilk boşluktan bölünür
Meslek PlayerData.job, mesai durumu onduty'den Aynı getJob(), meslek onDuty = false demedikçe mesaide unemployed
Patron isboss Aynı Rütbe adı boss Hayır
Para PlayerData.money.bank/cash Aynı bank ve money hesapları Bellekte: 5000 banka, 500 nakit, yeniden başlatmada kaybolur
Çevrimdışı para Çevrimdışı oyuncu nesnesi, yoksa money JSON sütunu Aynı accounts JSON sütunu Desteklenmez
Numara senkronu charinfo.phone'a yazar Aynı Yok Yok
Admin admin veya god yetkisi group.admin ACE'si admin veya superadmin grubu group.admin ACE'si
Ölüm metadata.isdead / inlaststand Aynı esx:onPlayerDeath / esx:onPlayerSpawn Oyunun hasar event'i

Her framework'te fxphone.admin ACE'si de konsol komutları için admin sayılır.

#Kendi framework'ün

  1. Config.Framework = 'custom' ayarla.
  2. bridge/custom.lua dosyasını aç. Zaten standalone'un bir kopyası olarak çalışır; ihtiyacın olan fonksiyonları değiştir.
  3. Sildiğin her şey standalone davranışına geri döner.

Identifier, her telefon satırının birincil anahtarıdır. Girişler arasında sabit kalmalı, karakter başına benzersiz olmalı (birden fazla karakterin varsa oyuncu başına değil) ve en fazla 80 karakter olmalıdır.

#Server fonksiyonları

Fonksiyon Dönüş Notlar
GetPlayer(src) Senin oyuncu nesnen veya nil Yalnızca nil olup olmadığına bakılır
GetIdentifier(src) string Karakter kimliği
GetSourceFromIdentifier(identifier) Server id veya nil Yalnızca çevrimiçi
GetCharacterName(src) firstname, lastname
GetJob(src) Meslek tablosu Biçimi aşağıda
GetJobs() { [name] = { name, label, grades = { { grade, label, isBoss } } } } Hizmetler ve tablet tarafından kullanılır
GetPlayers() Server id listesi Yüklenmiş karakterler
GetMoney(src, account) number account, 'bank' veya 'cash' olur
AddMoney(src, account, amount, reason) boolean
RemoveMoney(src, account, amount, reason) boolean Bakiye yetersizse false döndür
AddOfflineMoney(identifier, account, amount, reason) boolean Yalnızca para kaydedildiyse true. Bu olmadan çevrimdışı oyunculara yapılan ödemeler bir sonraki girişlerine kadar bekler
IsAdmin(src) boolean
Notify(src, text, kind) Senin bildirim resource'un
OnPlayerLoaded(fn) Karakter hazır olduğunda fn(src) çağır
OnPlayerDropped(fn) Bağlantı kesildiğinde ve karakterden çıkışta fn(src, identifier) çağır
OnJobUpdate(fn) Meslek veya mesai değişikliklerinde fn(src, job) çağır
SetPhoneNumber(identifier, number) Framework'ünün kendi telefon alanı varsa onu senkron tut
GetOfflineCharacterName(identifier) firstname, lastname veya nil Çevrimdışı oyunculara yapılan banka transferlerinde gösterilir
GetBirthdate(src), GetIdentity(src) Cüzdan kimlik kartı ve Sağlık Kimliği tarafından kullanılır
SetBloodType(src, value) İsteğe bağlı: yalnızca framework kan grubu tutuyorsa

Meslek tablosu her zaman şöyledir:

lua{ name = 'police', label = 'LSPD', grade = 2, gradeLabel = 'Sergeant', onDuty = true, isBoss = false }

#Client fonksiyonları

Fonksiyon Notlar
IsLoaded() Karakter seçildiğinde true
OnLoaded(fn) Karakter hazır olduğunda fn() çağır
OnUnloaded(fn) Karakterden çıkışta fn() çağır
GetJob() Aynı meslek biçimi
OnJobUpdate(fn) fn(job) çağır
IsDead() boolean
OnDeath(fn) Oyuncu yere düştüğünde fn(true), canlandırıldığında fn(false) çağır
Notify(text, kind) Senin bildirim resource'un
GetNeeds() İsteğe bağlı: 0 ile 100 arasında { hunger, thirst, stress }, Sağlık uygulamasında gösterilir

#Örnek

Export'ları olan bir framework için bir GetJob:

luafunction adapter.GetJob(src)
    local job = exports['my-core']:GetJob(src)
    if not job then return Utils.Copy(CIVILIAN) end
    return {
        name = job.id, label = job.title, grade = job.rank, gradeLabel = job.rankTitle,
        onDuty = job.duty == true, isBoss = job.boss == true,
    }
end

Bridge'i düzenledikten sonra sunucuyu yeniden başlat, ardından konsolda framework: custom satırını kontrol et.

#İlgili sayfalar