Инвентари

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

Предметы нужны только на серверах с framework. Файлы лежат в 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, которая показывает, как подключена ваша запись. Запись на замену печатается, только если строка называет экспорт другого скрипта ([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.