Envanterler

4. Item'lar ve envanterler

Item'lar yalnızca framework'lü sunucularda gerekir. Dosyalar config/items/ içinde, resimler config/items/images/ içinde.

Telefonun kendiliğinden yaptıkları. Açılışta, açtığınız özelliklerin hangi item'lara ihtiyaç duyduğunu belirler (aşağıdaki tablo) ve ardından:

Açılış kontrolünde tek bir Items satırı vardır: her item mevcutsa [OK], değilse eksik adlar ve altında çözümüyle [FAIL]. Bir şeyi düzelttikten sonra phone:health onu yeniden yazdırır.

Bir item eksikse telefon yine de başlar. Mağaza kutuları kapatır veya o item'ı satıştan kaldırır ve konsol eklenmesi gereken item'ın adını verir.

Reserve'ler üst üste biner. Dolu paketler metadata taşımaz, bu yüzden 20 taneye kadarı tek slotu paylaşır. Kısmen kullanılmışken çıkarılan bir paket, şarjı metadata'sında olan ayrı bir item olur (ox_inventory, qb-inventory ve qs-inventory'de), bu yüzden boş bir slot gerektirir. Item metadata'sı olmadan (standalone, varsayılan ESX envanteri) yalnızca kullanımdaki paket takip edilir; karakter başına, boyut başına bir tane.

Config.Item.required = true ile (veya benzersiz telefonlarla) sunucu telefon item'ını envanteriniz üzerinden kontrol eder ve item'ı olmayan bir oyuncunun telefon isteklerini reddeder. Item'ı kaybetmek, acil aramalar dahil o oyuncunun aramalarını sonlandırır ve telefonu kapatır.

Mühürlü bir kutuyu başkasına vermek. ox_inventory, qb-inventory ve qs-inventory'de kutu item'ı satın alınan modeli ve kaplamayı kendisi taşır, bu yüzden onu kim açarsa o telefonu alır. Diğer tüm envanterlerde kutu sade bir item'dır ve model ile kaplama, alıcının kendi satın alma kaydında tutulur: başkasına verilen bir kutu, yeni sahibinin bir sonraki kendi satın alımı olarak ya da varsayılan model ve kaplamayla açılır. Config.Store.boxPerFinish = true ile kutu item'ının adı kaplamayı korur, ancak modeli korumaz.

Envanteriniz için yapıştırılacak tam metin

Bir item tanımını asla kendiniz çıkarmanız gerekmez. Bir item eksik olduğunda açılış kontrolü sizin envanteriniz için tam metni kutusunun altına yazdırır ve Settings > Server > Health Check aynı metni bir Copy düğmesiyle gösterir. Yapıştırın, envanteri ve telefonu yeniden başlatın ve phone:health komutunu tekrar çalıştırın.

Reserve için her birinin nasıl göründüğü:

-- ox_inventory/data/items.lua
['pulse_magpack'] = { label = "Pulse Reserve", weight = 110, stack = true, close = true, consume = 0, description = "Magnetic battery pack. Fills 70% of a phone.", client = { export = "phone.usePack", image = "pulse_magpack.png" } },

-- qb-core/shared/items.lua, qs-inventory and similar
['pulse_magpack'] = { name = "pulse_magpack", label = "Pulse Reserve", weight = 110, type = 'item', image = "pulse_magpack.png", unique = false, useable = true, shouldClose = true, description = "Magnetic battery pack. Fills 70% of a phone." },

-- TMC
['pulse_magpack'] = { ['label'] = "Pulse Reserve", ['weight'] = 110, ['type'] = 'item', ['image'] = "pulse_magpack.png", ['unique'] = false, ['stackable'] = true, ['useable'] = true, ['shouldClose'] = true, ['description'] = "Magnetic battery pack. Fills 70% of a phone." },

-- ESX default inventory
INSERT IGNORE INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`) VALUES
  ('pulse_magpack', 'Pulse Reserve', 1, 0, 1);

ox_inventory'nin kendi phone item'ı. ox_inventory, başka bir telefon scripti için yapılmış bir phone tanımıyla gelir. Değiştirmeniz gerekmez: kullanıldığında Pulse Phone'u açar. Açılış kontrolünde, tanımınızın nasıl bağlandığını söyleyen bir Phone item satırı vardır. Yalnızca bu satır başka bir scriptin export'unu gösterdiğinde ([WARN] ya da zorunlu veya benzersiz telefonlarla [FAIL]) yerine geçecek tanımı yazdırır. O tanımın yapıldığı telefon scripti hâlâ çalışıyorsa item onun yerine o scripti açar: Phone item satırı onun adını verir; onu server.cfg dosyasından kaldırın.

Envanteriniz için ne yapmalı

Bu tablodaki diğer envanterler için telefon item'ları kendisi kullanılabilir yapar. ox_inventory, dosyasında zaten bulunan client = { export = 'phone....' } satırlarını kullanır.

ox_inventory: daha önce başka bir telefon kullandıysanız, onun Item('phone', ...) hook'unu da ox_inventory/modules/items/client.lua dosyasından kaldırın.

ak47_inventory, item kullanımını her item'ın kendi tanımında tutar. Şunları ekleyin:

-- powerbank
server = { onUse = function(source) exports.phone:UsePowerbank(source) end },
-- pulse_magpack and pulse_magpack_max
server = { onUse = function(source, item) exports.phone:UseMagPack(source, item and item.slot, item and item.name) end },
-- pulse_cable
server = { onUse = function(source) exports.phone:UseChargingCable(source) end },
-- pulse_phone_box
server = { onUse = function(source, item) exports.phone:UseBox(source, item and item.slot) end },
-- pulse_router
server = { onUse = function(source) exports.phone:UseRouter(source) end },
-- pulse_burner
server = { onUse = function(source, item) exports.phone:UseBurner(source, item and item.slot) end },
-- pulse_case, pulse_case_clear, pulse_pouch, pulse_protector
server = { onUse = function(source, item) exports.phone:FitPhoneProtection(source, item and item.name) end },
-- pulse_buds
server = { onUse = function(source) exports.phone:UseBuds(source) end },
-- pulse_ringlight
server = { onUse = function(source) exports.phone:UseRingLight(source) end },
-- pulse_wallet
server = { onUse = function(source) exports.phone:UseCardWallet(source) end },

Benzersiz telefonlar (Config.Item.unique = true) telefon numarasını item'a koyar; böylece item'ı vermek telefonu vermek demektir. ox_inventory, qb-inventory, qs-inventory, core_inventory veya codem-inventory gerektirir.