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
Config.Framework = 'custom'ayarla.bridge/custom.luadosyasını aç. Zaten standalone'un bir kopyası olarak çalışır; ihtiyacın olan fonksiyonları değiştir.- 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.