Entegrasyon

Envanter

FX Phone'un telefon item'ını ox_inventory veya QBCore envanterlerinden nasıl okuduğu ve başka bir envanteri nasıl bağlayacağın.

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

Item olmadan oyuncu telefonu açamaz, bildirim seslerini ve zil seslerini duymaz, script'lerden gelen onay istekleri de false yanıtını alır. Aramalar ve mesajlar yine de gelir; telefon geri geldiğinde onu beklerler. Telefon açıkken item kaybedilirse telefon kapanır.

#Adaptörler

Config.Inventory auto ne zaman seçer Neyi okur Kaybı nasıl fark eder
ox_inventory ox_inventory kuruluysa Search('count', item) ox_inventory:itemCount
qb-inventory qb-core veya qbx_core kuruluysa ve ox_inventory kurulu değilse PlayerData.items QBCore:Player:SetPlayerData
standalone Başka hiçbiri eşleşmediyse Hiçbir şey; herkesin telefonu vardır

qb-inventory, item'ları QBCore oyuncu verisinde tutan her envanterle çalışır (ps-inventory, lj-inventory, qs-inventory ve benzerleri). ox_inventory olmadan ESX, standalone'a düşer.

#Item tanımları

Her envanter için item kodu ve görseller Item kurulumu sayfasındadır.

  • ox_inventory'de phone item'ı telefonu kendi client.event'i üzerinden açar; SIM ve powerbank item'ları ise kullanımlarını fx-phone.useSimCard server export'u üzerinden bildirir.
  • QBCore envanterlerinde FX Phone phone item'ını, SIM item'larını ve powerbank'i kullanılabilir item olarak kendisi kaydeder.

Oyuncu başına bir item yeterlidir. Telefon item'a değil, karaktere aittir.

#Metadata taşıyan item'lar

SIM kartlar veri taşıyan item'lardır. Server tarafında FX Phone önce ox_inventory'yi, sonra QBCore veya Qbox oyuncu envanterini kullanır. İkisi de yoksa fiziksel SIM'ler kullanılamaz ve yalnızca eSIM satılır. Bkz. Sahipli mağazalar.

#Başka bir envanter

Config.Inventory = 'standalone', düzenlemeye açık olan client/integrations/inventory/standalone.lua dosyasını yükler. Üç fonksiyonunu kendi envanterinin çağrılarıyla değiştir:

luaIntegration.Inventory = { Name = 'my-inventory' }

function Integration.Inventory.Count(name)
    return exports['my-inventory']:GetItemCount(name) or 0
end

function Integration.Inventory.HasItem(name)
    return Integration.Inventory.Count(name) > 0
end

-- Call fn(hasPhone) when the player gains or loses Config.Item.
function Integration.Inventory.OnItemChanged(fn)
    AddEventHandler('my-inventory:itemChanged', function(item, count)
        if item == Config.Item then fn(count > 0) end
    end)
end

cylex uyumlu getQuantity ve hasEnoughOfItem export'ları da aynı adaptörü kullanır. Bkz. cylex_phone uyumluluğu.