Inventories

4. Items och inventories

Items behövs bara på servrar med framework. Filerna finns i config/items/ och bilderna i config/items/images/.

Vad telefonen gör själv. Vid start räknar den ut vilka items de funktioner du slagit på behöver (tabellen nedan), och sedan:

Startkontrollen har en rad Items: [OK] när varje item finns, eller [FAIL] med de saknade namnen och lösningen under. phone:health skriver ut den igen efter att du fixat något.

Om ett item saknas startar telefonen ändå. Butiken stänger av kartonger eller tar bort det itemet från försäljning, och konsolen namnger itemet att lägga till.

Reserves staplas. Fulla batteripaket har ingen metadata, så upp till 20 delar på en plats. Ett paket som tas av delvis använt blir ett eget item med sin laddning i sin metadata (på ox_inventory, qb-inventory och qs-inventory), så det behöver en ledig plats. Utan item-metadata (standalone, ESX standard-inventory) spåras bara paketet som används, ett per karaktär och storlek.

Med Config.Item.required = true (eller unika telefoner) kontrollerar servern telefon-itemet via ditt inventory och nekar telefonförfrågningar från en spelare utan det. Att tappa itemet avslutar den spelarens samtal, nödsamtal inräknade, och stänger telefonen.

Ge en förseglad kartong till någon annan. På ox_inventory, qb-inventory och qs-inventory bär själva kartong-itemet den modell och finish som köptes, så den som öppnar den får den telefonen. På alla andra inventories är kartongen ett vanligt item och modell och finish ligger i köparens egen köphistorik: en kartong som ges bort öppnas som den nya ägarens eget nästa köp, eller som standardmodell och standardfinish. Med Config.Store.boxPerFinish = true behåller kartong-itemets namn finishen, men inte modellen.

Exakt text att klistra in, för ditt inventory

Du behöver aldrig själv räkna ut en item-post. När ett item saknas skriver startkontrollen ut exakt text för ditt inventory under sin ruta, och Settings > Server > Health Check visar samma text med en Copy-knapp. Klistra in den, starta om inventoryt och telefonen, och kör phone:health igen.

Så här ser var och en ut, för Reserve:

-- 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_inventorys egna item phone. ox_inventory levereras med en post phone gjord för ett annat telefonscript. Du behöver inte ändra den: att använda den öppnar Pulse Phone. Startkontrollen har en rad Phone item som säger hur din post är kopplad. Bara när den namnger ett annat scripts export ([WARN], eller [FAIL] med obligatoriska eller unika telefoner) skriver den ut ersättningsposten. Om telefonscriptet som posten gjordes för fortfarande körs öppnar itemet det i stället: raden Phone item namnger det; ta bort det från server.cfg.

Vad du gör för ditt inventory

För de andra inventories i den här tabellen gör telefonen själv items användbara. ox_inventory använder raderna client = { export = 'phone....' } som redan finns i dess fil.

ox_inventory: om du använde en annan telefon tidigare, ta också bort dess hook Item('phone', ...) från ox_inventory/modules/items/client.lua.

ak47_inventory lägger användning av items i varje items egen post. Lägg till dessa:

-- 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 },

Unika telefoner (Config.Item.unique = true) lägger telefonnumret på itemet, så att lämna över itemet är att lämna över telefonen. De kräver ox_inventory, qb-inventory, qs-inventory, core_inventory eller codem-inventory.