Instalacja

Pięć minut. Żadnego pliku SQL, żadnego ręcznego ustawiania frameworka — tylko jedno uprawnienie i restart.

Zanim zaczniesz

Wymagane	Dlaczego
ESX, QBCore lub QBox	Używalne przedmioty, prace, powiadomienia i statusy pochodzą z frameworka
oxmysql	Konfiguracje przedmiotów są zapisywane w tabeli o nazwie `mic_itemcreator`
Ekwipunek obsługujący używalne przedmioty frameworka	Dzięki temu użycie przedmiotu w ekwipunku trafia do tego zasobu
ox_lib, ox_target / qb-target, screenshot-basic	Opcjonalne; zobacz Personalizacja

1. Umieść folder w zasobach

Pobierz mic_itemcreator ze swoich przyznanych zasobów Cfx.re (Granted Assets) i wrzuć folder do zasobów serwera, na przykład resources/[mic]/mic_itemcreator.

2. Uruchom go po zasobach, od których zależy

W pliku server.cfg linijka ensure mic_itemcreator musi znaleźć się poniżej oxmysql, Twojego frameworka (es_extended, qb-core lub qbx_core) oraz ekwipunku.

Framework jest wykrywany poprzez sprawdzenie, czy es_extended lub qb-core jest już uruchomiony, dlatego kolejność ma znaczenie: jeśli uruchomisz skrypt zbyt wcześnie, nie znajdzie żadnego z nich. QBox jest wykrywany dzięki kompatybilności z QBCore — qbx_core zapewnia qb-core — więc nie trzeba niczego dodatkowo ustawiać.

3. Baza danych — nic do roboty

Przy pierwszym uruchomieniu zasób sam tworzy tabelę mic_itemcreator (jeden wiersz na każdy skonfigurowany przedmiot) i dopisuje ewentualne kolumny, których brakowało w starszych wersjach. Nie ma żadnego pliku SQL do zaimportowania.

Działa poprawnie, gdy po pierwszym uruchomieniu w bazie danych znajduje się tabela mic_itemcreator.

4. Przedmioty

Item Creator nie dodaje nowych przedmiotów do Twojego ekwipunku — nadaje działanie przedmiotom, które już posiadasz. Każdy konfigurowany przedmiot musi najpierw istnieć w Twoim ekwipunku.

Do skryptu nie są dołączone żadne definicje przedmiotów ani obrazki. Dla nowych przedmiotów wbudowane w menu narzędzie Registry Tool wygeneruje odpowiedni wpis: wybierz OX, QBCORE lub ESX SQL, wypełnij pola i skopiuj wynik do ox_inventory/data/items.lua, qb-core/shared/items.lua lub tabeli items w bazie ESX. Ikony umieść w folderze z obrazkami swojego ekwipunku, nazywając je tak samo jak przedmioty.

Menu jest zabezpieczone uprawnieniem ACE mic_itemcreator.open. Nadaj je w server.cfg za pomocą linijki add_ace — pojedynczej osobie, na przykład add_ace identifier.discord:YOUR_DISCORD_ID mic_itemcreator.open allow, lub całej grupie, na przykład add_ace group.admin mic_itemcreator.open allow.

Uprawnienie jest sprawdzane w momencie wchodzenia na serwer. Nadałeś je, będąc już w grze? Połącz się ponownie (reconnect).

Działa poprawnie, gdy komenda /itemcreator otwiera menu na ekranie głównym. Bez uprawnienia otrzymasz powiadomienie o braku dostępu.

6. Pierwszy test

Wpisz /itemcreator → Usable Items i wybierz przedmiot istniejący w Twoim ekwipunku, na przykład water.
Dodaj funkcję Notification z dowolną wiadomością oraz funkcję Food/Thirst uzupełniającą trochę pragnienia.
Otwórz ustawienia przedmiotu, włącz Remove on Use z wartością 1 i zapisz.
Nadaj sobie ten przedmiot (w menu znajduje się do tego przycisk, dodający po jednej sztuce) i użyj go z ekwipunku.

Działa poprawnie, gdy pojawia się powiadomienie, poziom pragnienia rośnie, a z ekwipunku znika jedna sztuka przedmiotu.

Zanim otworzysz serwer dla graczy

Tylko zaufane osoby mają uprawnienie mic_itemcreator.open. Pozwala ono przypisać dowolnemu przedmiotowi dowolne działanie, w tym spawnowanie aut, wykonywanie komend i nadawanie supermocy.
Każdy skonfigurowany przedmiot istnieje w Twoim ekwipunku pod dokładnie taką samą nazwą.
Sprawdź, czy Config.ImageInventoryPath wskazuje na folder z obrazkami Twojego ekwipunku — w przeciwnym razie w menu nie będą wyświetlać się ikony.
Poinformuj graczy o klawiszu anulowania — domyślnie X — który zatrzymuje animacje, scenariusze, style chodzenia, zmienioną prędkość, supermoce oraz propy uruchomione przez przedmiot.