Ekwipunki

4. Przedmioty i ekwipunki

Przedmioty są potrzebne tylko na serwerach z frameworkiem. Pliki są w config/items/, a obrazki w config/items/images/.

Co telefon robi sam. Przy starcie ustala, których przedmiotów potrzebują włączone funkcje (tabela poniżej), a potem:

Sprawdzenie startowe ma jedną linię Items: [OK], gdy wszystkie przedmioty są na miejscu, albo [FAIL] z brakującymi nazwami i rozwiązaniem pod spodem. phone:health wypisuje je ponownie, gdy coś naprawisz.

Jeśli brakuje przedmiotu, telefon i tak startuje. Sklep wyłącza pudełka albo zdejmuje ten przedmiot ze sprzedaży, a konsola podaje przedmiot do dodania.

Reserve'y się stackują. Pełne powerbanki nie mają metadanych, więc do 20 mieści się w jednym slocie. Częściowo zużyty powerbank po zdjęciu staje się osobnym przedmiotem z naładowaniem zapisanym w metadanych (na ox_inventory, qb-inventory i qs-inventory), więc potrzebuje wolnego slotu. Bez metadanych przedmiotów (standalone, domyślny ekwipunek ESX) śledzony jest tylko używany powerbank, jeden na postać na rozmiar.

Z Config.Item.required = true (albo unikalnymi telefonami) serwer sprawdza przedmiot telefonu przez twój ekwipunek i odrzuca zapytania telefonu od gracza, który go nie ma. Utrata przedmiotu kończy połączenia gracza, łącznie z alarmowymi, i zamyka telefon.

Oddawanie zaplombowanego pudełka komuś innemu. Na ox_inventory, qb-inventory i qs-inventory sam przedmiot pudełka niesie kupiony model i wykończenie, więc ten, kto je otworzy, dostaje ten telefon. Na każdym innym ekwipunku pudełko to zwykły przedmiot, a model i wykończenie są zapisane w rekordzie zakupu kupującego: oddane pudełko otwiera się jako kolejny zakup nowego właściciela albo jako domyślny model i wykończenie. Z Config.Store.boxPerFinish = true nazwa przedmiotu pudełka zachowuje wykończenie, ale nie model.

Dokładny tekst do wklejenia dla twojego ekwipunku

Nigdy nie musisz sam rozpracowywać wpisu przedmiotu. Gdy brakuje przedmiotu, sprawdzenie startowe wypisuje pod ramką dokładny tekst dla twojego ekwipunku, a Settings > Server > Health Check pokazuje ten sam tekst z przyciskiem Copy. Wklej go, zrestartuj ekwipunek i telefon i uruchom ponownie phone:health.

Jak wygląda każdy z nich, na przykładzie 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);

Własny przedmiot phone w ox_inventory. ox_inventory ma wpis phone zrobiony dla innego skryptu telefonu. Nie musisz go zmieniać: jego użycie otwiera Pulse Phone. Sprawdzenie startowe ma linię Phone item, która mówi, jak jest podpięty twój wpis. Tylko gdy wskazuje eksport innego skryptu ([WARN] albo [FAIL] przy wymaganych lub unikalnych telefonach), wypisuje wpis zastępczy. Jeśli skrypt telefonu, dla którego zrobiono ten wpis, dalej działa, przedmiot otwiera zamiast tego jego: linia Phone item go wymienia; usuń go z server.cfg.

Co zrobić dla twojego ekwipunku

Dla pozostałych ekwipunków w tej tabeli telefon sam czyni przedmioty używalnymi. ox_inventory używa linii client = { export = 'phone....' }, które już są w jego pliku.

ox_inventory: jeśli wcześniej używałeś innego telefonu, usuń też jego hook Item('phone', ...) z ox_inventory/modules/items/client.lua.

ak47_inventory trzyma użycie przedmiotu we własnym wpisie każdego przedmiotu. Dodaj te:

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

Unikalne telefony (Config.Item.unique = true) zapisują numer telefonu w przedmiocie, więc przekazanie przedmiotu przekazuje telefon. Wymagają ox_inventory, qb-inventory, qs-inventory, core_inventory albo codem-inventory.