Przedmiot składa się z listy funkcji, uruchamianych od góry do dołu w momencie użycia go przez gracza, oraz zestawu ograniczeń sprawdzanych przed wykonaniem którejkolwiek z nich.
- Gracz używa przedmiotu w swoim ekwipunku.
- Po stronie serwera sprawdzane są ograniczenia: cooldown, wymagany przedmiot oraz praca. Jeśli którekolwiek nie zostanie spełnione, gracz otrzymuje powiadomienie z powodem i nic więcej się nie dzieje.
- Wykonywane są funkcje serwerowe (Bundle).
- Wykonywane są funkcje klienckie w kolejności, w jakiej zostały ułożone. Każda z nich może mieć ustawione opóźnienie (delay) w milisekundach, odczekiwane przed jej startem — w ten sposób budujesz sekwencje: najpierw animacja, po 3 sekundach powiadomienie, a potem prop.
- Jeśli włączona jest opcja Remove on Use, z ekwipunku pobierana jest określona liczba sztuk przedmiotu.
Funkcje rozciągnięte w czasie — animacje, scenariusze, style chodzenia, zmieniona prędkość, supermoce, przyczepione propy — mogą zostać w każdej chwili przerwane przez gracza klawiszem anulowania (domyślnie X).
| Funkcja | Co robi |
|---|
| Animation | Odtwarza animację ze słownika. Loop działa aż do anulowania; w przeciwnym razie powtarza się przez określony czas. Movable pozwala chodzić (animuje tylko górną część ciała); static animuje całe ciało. Nie działa w pojeździe |
| Scenario | Uruchamia scenariusz GTA w miejscu na określony czas |
| Walking Style | Zmienia styl chodzenia gracza na określony czas (15 sekund, jeśli pole pozostanie puste) |
| Speed | Przyspiesza (lub spowalnia) ruch gracza o podany mnożnik, na określony czas lub do momentu anulowania |
| Superpower | Jedna z mocy: Teleport (do znacznika na mapie), Invisibility, Invincibility, Superjump lub Stamina (nieskończony sprint) — każda z własnym czasem trwania |
| Clothes | Zakłada elementy ubioru oraz propy, konfigurowane osobno dla męskiego i żeńskiego modelu freemode, wraz z pasującą animacją zakładania z pliku data/clothing.lua |
| Funkcja | Co robi |
|---|
| Attach Prop | Przyczepia obiekt do kości gracza w pozycji ustawionej w edytorze na żywo. Widzą go wszyscy w pobliżu. Loop utrzymuje go do anulowania; w przeciwnym razie znika po upływie czasu. Nie działa w pojeździe |
| Placeable Prop | Gracz stawia obiekt w świecie gry: podgląd podąża za wzrokiem, kółko myszy go obraca, ↑ / ↓ podnoszą i obniżają, E stawia, a X anuluje. Postawiony obiekt można z powrotem podnieść — zobacz poniżej |
| Particles | Efekt cząsteczkowy na graczu z wybranego pakietu i nazwy efektu, o podanej skali i czasie trwania |
| Visual Effect | Pełnoekranowy efekt wizualny na określony czas |
| Sound | Dźwięk GTA z podanej nazwy i zestawu dźwięków, o określonej głośności |
| Funkcja | Co robi |
|---|
| Health/Armor | Dodaje zdrowie i pancerz (maksymalnie do pełnej wartości) |
| Food/Thirst | Dodaje głód i pragnienie przez esx_status na ESX lub eventy consumables na QBCore |
| Stress | Dodaje stres lub go obniża (gdy wpiszesz wartość ujemną) |
| Funkcja | Co robi |
|---|
| Notification | Wyświetla powiadomienie przez Twój framework z wybranym typem (domyślnie sukces) |
| Progress Bar | Pasek postępu z etykietą na określony czas: wbudowany lub z ox_lib, zależnie od Config.ProgressBar |
| Webhook | Wysyła wpis na webhook Discorda: Twoją wiadomość, identyfikatory gracza oraz opcjonalnie zrzut ekranu (wymaga screenshot-basic). Akceptowane są wyłącznie adresy URL webhooków Discorda |
| Funkcja | Co robi |
|---|
| Command | Wykonuje komendę jako gracz. Ukośnik / na początku jest opcjonalny |
| Trigger | Wywołuje event klienta, event serwera lub export zapisany jako resourceName:exportName. Każdy z nich otrzymuje w argumencie nazwę przedmiotu |
| Car | Spawnuje model pojazdu w miejscu, w którym stoi gracz (zwrócony w tym samym kierunku) i opcjonalnie sadza gracza na fotelu kierowcy |
| Bundle | Daje graczowi kilka przedmiotów jednocześnie — np. sześciopak piwa lub apteczkę. Działa po stronie serwera. Połącz z Remove on Use, aby zużyć samo opakowanie; pakiet nigdy nie daje przedmiotu, do którego należy |
Gdy gracz postawi Placeable Prop, obiekt pojawia się u wszystkich graczy. Gracz, który go postawił, może go z powrotem podnieść — za pomocą tekstu 3D i klawisza E lub przez ox_target / qb-target, jeśli tak ustawiono w Config.Interaction. Podniesienie obiektu zwraca dokładnie tyle sztuk przedmiotu, ile zabrała opcja Remove on Use, dzięki czemu postawiony pachołek wraca z powrotem do kieszeni.
Znajdziesz je po otwarciu ustawień (settings) danego przedmiotu. Każde ograniczenie ma własny przełącznik.
| Ograniczenie | Co robi |
|---|
| Cooldown | Czas, jaki gracz musi odczekać pomiędzy kolejnymi użyciami tego przedmiotu, podawany w milisekundach (60000 to jedna minuta). Zapamiętywany do restartu serwera |
| Job Restriction | Przedmiotu mogą użyć wyłącznie gracze posiadający jedną z wymienionych prac na określonym minimalnym stopniu (lub wyższym) |
| Required Item | Gracz musi mieć przy sobie określoną liczbę sztuk innego przedmiotu — np. zapalniczkę, aby zapalić papierosa |
| Remove on Use | Liczba sztuk przedmiotu zabierana z ekwipunku przy każdym użyciu |
| Always Attached Prop | Dopóki przedmiot znajduje się w ekwipunku, skonfigurowany w nim Attach Prop pozostaje na postaci gracza i znika po utracie ostatniej sztuki. Ten prop widzi wyłącznie gracz, który go nosi |
- Save zapisuje przedmiot w tabeli
mic_itemcreator i sprawia, że staje się on natychmiast używalny dla wszystkich.
- Z poziomu menu możesz nadać (give) sobie przedmiot (po jednej sztuce), aby go przetestować.
- Delete usuwa konfigurację: od tego momentu użycie przedmiotu nic nie robi. Framework pamięta rejestrację używalnego przedmiotu do następnego restartu, co jest całkowicie nieszkodliwe.
