Інвентарі

4. Предмети та інвентарі

Предмети потрібні лише на серверах із фреймворком. Файли лежать у config/items/, а зображення — у config/items/images/.

Що телефон робить сам. Під час запуску він визначає, які предмети потрібні увімкненим вами функціям (таблиця нижче), а потім:

Перевірка під час запуску має один рядок Items: [OK], коли всі предмети на місці, або [FAIL] із назвами відсутніх і рішенням під ним. phone:health виводить його знову після того, як ви щось виправите.

Якщо предмета бракує, телефон усе одно запускається. Магазин вимикає коробки або знімає цей предмет із продажу, а консоль називає предмет, який треба додати.

Reserve складаються в стос. Повні батареї не мають метаданих, тож до 20 займають один слот. Частково використана батарея, яку зняли, стає окремим предметом із зарядом у метаданих (на ox_inventory, qb-inventory і qs-inventory), тож їй потрібен вільний слот. Без метаданих предметів (standalone, стандартний інвентар ESX) відстежується лише батарея, що використовується, — одна на персонажа на кожен розмір.

З Config.Item.required = true (або з унікальними телефонами) сервер перевіряє предмет телефона через ваш інвентар і відхиляє запити телефона від гравця без нього. Втрата предмета завершує дзвінки цього гравця, зокрема екстрені, і закриває телефон.

Передача запечатаної коробки іншому гравцеві. На ox_inventory, qb-inventory і qs-inventory сам предмет коробки містить куплені модель і оздоблення, тож той, хто її відкриє, отримає саме цей телефон. На всіх інших інвентарях коробка — звичайний предмет, а модель і оздоблення зберігаються в записі покупки покупця: подарована коробка відкривається як наступна покупка нового власника або як модель і оздоблення за замовчуванням. З Config.Store.boxPerFinish = true назва предмета коробки зберігає оздоблення, але не модель.

Точний текст для вставлення у ваш інвентар

Вам ніколи не доведеться складати запис предмета самостійно. Коли предмета бракує, перевірка під час запуску виводить точний текст для вашого інвентаря під своїм блоком, а Settings > Server > Health Check показує той самий текст із кнопкою Copy. Вставте його, перезапустіть інвентар і телефон і знову запустіть phone:health.

Як виглядає кожен варіант на прикладі 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);

Власний предмет phone в ox_inventory. ox_inventory постачається із записом phone, створеним для іншого скрипту телефона. Змінювати його не потрібно: його використання відкриває Pulse Phone. Перевірка під час запуску має рядок Phone item, який показує, як підключено ваш запис. Лише коли він називає export іншого скрипту ([WARN] або [FAIL] з обов'язковими чи унікальними телефонами), виводиться запис на заміну. Якщо скрипт телефона, для якого створено цей запис, досі запущений, предмет відкриває його: рядок Phone item називає його; приберіть його з server.cfg.

Що робити для вашого інвентаря

Для інших інвентарів у цій таблиці телефон сам робить предмети придатними до використання. ox_inventory використовує рядки client = { export = 'phone....' }, які вже є в його файлі.

ox_inventory: якщо раніше ви використовували інший телефон, також видаліть його хук Item('phone', ...) з ox_inventory/modules/items/client.lua.

ak47_inventory зберігає використання предмета у власному записі кожного предмета. Додайте ці:

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

Унікальні телефони (Config.Item.unique = true) зберігають номер телефона в предметі, тож передача предмета означає передачу телефона. Для них потрібен ox_inventory, qb-inventory, qs-inventory, core_inventory або codem-inventory.