Przedmioty

Trzy rodzaje przedmiotów, z których tylko pierwszy jest wymagany: telefon, opcjonalnie ładowarka oraz opcjonalnie czternaście etui.

Nazwy należą do Ciebie — każda z nich to pojedyncza linijka w konfiguracji — ale poniższe wartości są domyślne i dokładnie tak samo nazwano ikony dostarczane wraz z zasobem.

---

Telefon

-- shared/config.lua
Config.Open = {
    RequireItem = true,      -- false lets anybody open it: fine while you are trying it out
    Item        = 'phone',
    UseItem     = true,      -- using it from the inventory opens the phone
}

Większość konfiguracji ESX oraz QB posiada już przedmiot phone. Jeśli Twoja go nie ma:

ox_inventory

-- ox_inventory/data/items.lua
['phone'] = {
    label = 'Phone',
    weight = 190,
    stack = false,
    close = true,
    description = 'A phone that folds.',
},

qb-core

-- qb-core/shared/items.lua
phone = { name = 'phone', label = 'Phone', weight = 190, type = 'item', image = 'phone.png',
          unique = true, useable = true, shouldClose = true, description = 'A phone that folds.' },

Notatka

Gdy opcja Config.Device jest włączona, telefon jest przedmiotem: nowy egzemplarz to nowy telefon z nowym numerem, a urządzenie przekazywane z rąk do rąk zabiera ze sobą całą zawartość. Wymaga to ustawienia stack = false / unique = true, dlatego oba powyższe bloki kodu je zawierają.

---

Ładowarka

Wymagana tylko wtedy, gdy bateria jest włączona (shared/config/battery.lua, domyślnie wyłączona).

Charger = { Item = 'phone_charger', Minutes = 25, Consume = false },

ox_inventory

['phone_charger'] = { label = 'Phone Charger', weight = 120, stack = true, close = false },

qb-core

phone_charger = { name = 'phone_charger', label = 'Phone Charger', weight = 120, type = 'item',
                  image = 'phone_charger.png', unique = false, useable = true, shouldClose = false },

Consume = false oznacza, że jest to ładowarka wielokrotnego użytku, a nie jednorazowy powerbank: działa dalej po naładowaniu.

---

Czternaście etui

Tylko jeśli Config.Prop.Fold.Cases.Enabled jest ustawione na true. Gdy opcja jest wyłączona, kolory są darmowym ustawieniem w menu Ustawienia i nic z poniższych rzeczy nie jest potrzebne — zobacz 📦 Etui i kolory.

Items = {
    black    = 'phone_case_black',    natural = 'phone_case_natural',
    white    = 'phone_case_white',    blue    = 'phone_case_blue',
    gold     = 'phone_case_gold',     green   = 'phone_case_green',
    graphite = 'phone_case_graphite', silver  = 'phone_case_silver',
    rose     = 'phone_case_rose',     purple  = 'phone_case_purple',
    red      = 'phone_case_red',      sierra  = 'phone_case_sierra',
    mint     = 'phone_case_mint',     orange  = 'phone_case_orange',
},

ox_inventory

-- fourteen of these, one per colour
['phone_case_blue'] = { label = 'Blue Case', weight = 20, stack = false, close = true },

qb-core

phone_case_blue = { name = 'phone_case_blue', label = 'Blue Case', weight = 20, type = 'item',
                    image = 'phone_case_blue.png', unique = true, useable = true, shouldClose = true },

Ikony są już narysowane. Czternaście plików PNG o wymiarach 100×100, po jednym na każdy kolor, nazwanych phone_case_<colour>.png. Skopiuj je do folderu z obrazkami swojego ekwipunku — w przypadku ox będzie to ox_inventory/web/images/.

Usuń linijkę z tabeli Items, a dany kolor przestanie istnieć: nie zostanie ukryty, po prostu zniknie. Miejsce sprzedaży etui zależy wyłącznie od Twojego miasta; sam zasób telefonu nie stawia nigdzie żadnego sklepu.

---

Po dodaniu przedmiotów

Twój skrypt ekwipunku musi zostać zrestartowany, aby zobaczyć nowe przedmioty.

Uwaga

Restartowanie ox_inventory, gdy gracze są połączeni z serwerem, blokuje ich klienta. Flaga invBusy pozostaje ustawiona na true, a każde wyszukiwanie zawiesza się w nieskończoność, przez co telefon się nie otworzy.

Zrestartuj go drugi raz. Pierwszy restart psuje połączonego klienta, a drugi przywraca go do życia. Nikt nie musi łączyć się ponownie, a ręczne wyczyszczenie state baga nie wystarczy.