Başlangıç

Item kurulumu

FX Phone'un kullandığı envanter item'ları ve desteklenen her envanter için item tanımı.

#Item'lar

Görseller fx-phone/setup/items/ içinde.

Item Görsel Gerekli mi
phone phone.png Evet, Config.Item = false değilse (o zaman herkesin telefonu olur)
sim_card sim_card.png Config.Sim.Enabled = true olduğunda; paketle gelen değer budur
ghost_sim ghost_sim.png Yalnızca Config.SecondSim.Enabled = true olduğunda. Adı Config.SecondSim.Item
powerbank powerbank.png Yalnızca powerbank istiyorsan. Adı Config.Battery.PowerBankItem; nil kapatır
  1. Görselleri envanterinin görsel klasörüne kopyala.
  2. Envanterine ait bloğu onun item dosyasına yapıştır.
  3. Envanteri ya da sunucuyu yeniden başlat.

Görsel dosyasının adı item'ın image değeriyle (ox_inventory'de item adıyla) eşleşmelidir.

Envanter Item dosyası Görsel klasörü
ox_inventory (QBCore, Qbox, ESX) ox_inventory/data/items.lua ox_inventory/web/images/ ya da inventory:imagepath ile ayarlanan klasör
qb-inventory, ps-inventory, lj-inventory qb-core/shared/items.lua <inventory>/html/images/
qs-inventory qs-inventory/shared/items.lua qs-inventory/html/images/

#Telefon item'ı nasıl davranır

  • Item yoksa telefon açılmaz. Oyuncu bunun yerine kısa bir uyarı görür.
  • Item yoksa oyuncu zil ve bildirim seslerini duymaz, script'lerden gelen onay istekleri false döner. Aramalar ve mesajlar yine gelir ve telefon geri geldiğinde onu bekler.
  • Item'ı kaybetmek (yere atmak, birine vermek, elinden alınması) telefonu hemen kapatır.
  • Item'ı envanterden kullanmak, açma tuşu gibi telefonu açar.
  • Oyuncu başına bir item yeterlidir. Telefon item'a değil karaktere aittir; birden fazla telefon item'ı birden fazla telefon vermez.

#ox_inventory

lua['phone'] = {
    label = 'Phone',
    weight = 190,
    stack = false,
    consume = 0,
    client = {
        event = 'fx-phone:client:openPhone',
    },
},

['sim_card'] = {
    label = 'SIM Card',
    weight = 10,
    stack = false,
    close = true,
    description = 'Insert it from Settings > SIM.',
    server = {
        export = 'fx-phone.useSimCard',
    },
},

['ghost_sim'] = {
    label = 'GhostNet SIM',
    weight = 10,
    stack = true,
    close = true,
    description = 'An off-the-books line. Insert it from Settings > SIM; it works for 3 days from then.',
    server = {
        export = 'fx-phone.useSimCard',
    },
},

['powerbank'] = {
    label = 'Power Bank',
    weight = 250,
    stack = true,
    close = true,
    description = 'Charges your phone anywhere. Single use.',
    server = {
        export = 'fx-phone.useSimCard',
    },
},

Telefonun item'ın kullanıldığını görmesini sağlayan satır server.export = 'fx-phone.useSimCard' satırıdır. Üç item da aynı export'u kullanır; export, işleyiciyi item adına göre bulur.

#qb-inventory, ps-inventory, lj-inventory

QBCore zaten bir phone item'ıyla gelir. Yalnızca eksik olanları ekle:

luaphone = {
    name = 'phone', label = 'Phone', weight = 700, type = 'item', image = 'phone.png',
    unique = true, useable = true, shouldClose = true, description = 'A smartphone',
},

sim_card = {
    name = 'sim_card', label = 'SIM Card', weight = 10, type = 'item', image = 'sim_card.png',
    unique = true, useable = true, shouldClose = true, description = 'Insert it from Settings > SIM.',
},

ghost_sim = {
    name = 'ghost_sim', label = 'GhostNet SIM', weight = 10, type = 'item', image = 'ghost_sim.png',
    unique = true, useable = true, shouldClose = true, description = 'An off-the-books line. Insert it from Settings > SIM; it works for 3 days from then.',
},

powerbank = {
    name = 'powerbank', label = 'Power Bank', weight = 250, type = 'item', image = 'powerbank.png',
    unique = false, useable = true, shouldClose = true, description = 'Charges your phone anywhere. Single use.',
},

QBCore envanterlerinde FX Phone bunları kullanılabilir item olarak kendisi kaydeder.

#qs-inventory

lua['phone'] = {
    ['name'] = 'phone', ['label'] = 'Phone', ['weight'] = 700, ['type'] = 'item', ['image'] = 'phone.png',
    ['unique'] = true, ['useable'] = true, ['shouldClose'] = true, ['description'] = 'A smartphone',
},

['sim_card'] = {
    ['name'] = 'sim_card', ['label'] = 'SIM Card', ['weight'] = 10, ['type'] = 'item', ['image'] = 'sim_card.png',
    ['unique'] = true, ['useable'] = true, ['shouldClose'] = true, ['description'] = 'Insert it from Settings > SIM.',
},

FX Phone, qs-inventory'yi de qb-inventory gibi QBCore oyuncu verisi üzerinden okur.

#Her item'ı kullanmak ne yapar

Item Etkisi
phone Telefonu açar
sim_card, ghost_sim Ayarlar > SIM'i, o kart SIM 1'e ya da SIM 2'ye takılmaya hazır şekilde açar. Kart orada boş bir yuvadan da seçilebilir
powerbank Telefonu Config.Battery.PowerBankMinutes dakika boyunca şarj eder. Item tükenir

FX Phone powerbank'ı kendisi satmaz; onu kendi mağazalarından herhangi birinde sat.

İki kart da geri gelir. Telefondan çıkarılan bir sim_card, üzerinde numarasıyla envantere döner. Süresi bitmeden çıkarılan bir ghost_sim, üzerinde hat kimliği ve bitiş tarihiyle döner ve başkasına verilebilir (Config.SecondSim.Returnable, varsayılan true); süresi dolmuş olan atılır.

Kullanılmış bir kart kendi verisini taşıdığı için QBCore bloğunda ghost_sim, unique = true olarak tanımlıdır: unique olmayan bir item yeni kartların yığınına karışır ve bu veriyi kaybeder. ox_inventory'de farklı veriye sahip kartlar üst üste yığılmaz, bu yüzden orada stack = true sorun olmaz.

Fiziksel SIM kartlar için sunucuda ox_inventory ya da bir QBCore / Qbox oyuncu envanteri gerekir. İkisi de yoksa yalnızca eSIM'ler kullanılabilir.

#Diğer envanterler

  • ox_inventory olmadan ESX: ox_inventory'yi kur ya da Config.Item = false ayarla.
  • Başka bir envanter: Config.Item = false ayarla ya da envanterini Envanter sayfasında gösterildiği gibi bağla.

SIM kartlar hakkında daha fazlası: SIM kartlar ve Sahipli mağazalar. Powerbank'lar hakkında daha fazlası: Pil ve sinyal.