Instalacja

Piętnaście minut. Dwa foldery, kilka ustawień i przedmioty. Nic nie jest zapisywane w bazie danych, więc sam zasób nie wymaga importowania żadnych tabel.

Zanim zaczniesz

Wymagane	Dlaczego
ESX, QBCore lub QBox, uruchomiony	Przedmioty, właściciele i prace działają przez framework
ox_target lub qb-target, uruchomiony	Odpowiada za każdą interakcję z postawioną sziszą lub krzesłem
Oba foldery z zakupu: `mic_hookah` oraz `mic_hookah_prop`	Skrypt oraz modele fajek wodnych
Dostęp do listy przedmiotów i folderu z obrazkami Twojego ekwipunku	Szisze, meble, zapasy i smaki są przedmiotami

1. Umieść oba foldery na miejscu

Wrzuć mic_hookah oraz mic_hookah_prop do folderu z zasobami serwera, na przykład do resources/[mic]/.

mic_hookah_prop zawiera dziesięć modeli sziszy (mic_hookah_black … mic_hookah_yellow) oraz plik mic_hookah.ytyp. Nie zawiera żadnego kodu — służy wyłącznie do streamowania modeli. Stoły i krzesła korzystają z modeli z podstawowej wersji gry i nie wymagają dodatkowych plików.

2. Kolejność uruchamiania

W pliku server.cfg, poniżej swojego frameworka, ekwipunku i zasobu targetu, dodaj ensure mic_hookah_prop, a następnie ensure mic_hookah.

Działa poprawnie, gdy oba zasoby uruchamiają się bez czerwonych komunikatów o błędach.

3. Framework i target

Otwórz config.lua:

Opcja	Ustaw na	Domyślnie
`Config.Framework`	`esx`, `qbcore` lub `qbox`	`esx`
`Config.Target`	`ox_target` lub `qb-target`	`ox_target`
`Config.ESXResourceName`	Nazwa folderu ESX, jeśli została zmieniona	`es_extended`
`Config.QBResourceName`	Nazwa folderu QBCore, jeśli została zmieniona	`qb-core`
`Config.QBoxResourceName`	Nazwa folderu QBox, jeśli została zmieniona	`qbx_core`
`Config.QBTargetResourceName`	Nazwa folderu qb-target, jeśli została zmieniona	`qb-target`

Skrypt niczego tu nie wykrywa automatycznie: te wartości decydują o tym, który framework i który target są używane.

4. Baza danych

Sam zasób jej nie używa: postawione szisze i meble istnieją w pamięci serwera, a nie w tabeli. Na ESX z domyślnym ekwipunkiem przedmioty trafiają do tabeli items — opisano to w kolejnym kroku.

5. Dodaj przedmioty

Pełna lista znajduje się na stronie 🎒 Przedmioty. W skrócie:

Przedmiot	Co robi
`hookah_black`, `hookah_blue`, `hookah_green`, `hookah_grey`, `hookah_orange`, `hookah_pink`, `hookah_purple`, `hookah_red`, `hookah_skyblue`, `hookah_yellow`	Użyj, aby nieść i postawić daną sziszę
`hookah_table` … `hookah_table5`	Użyj, aby postawić stół
`hookah_chair` … `hookah_chair6`	Użyj, aby postawić krzesło, na którym można usiąść
`hookah_coal`	Uzupełnia węgiel z poziomu menu konfiguracji
`hookah_water`	Uzupełnia wodę z poziomu menu konfiguracji
`hookah_<flavour>_flavor`	Sześćdziesiąt smaków wybieranych w menu konfiguracji

Gdzie znajdują się gotowe definicje — w folderze inventory_items/ wewnątrz mic_hookah:

Plik	Dla	Co należy zrobić
`esx_items.sql`	ESX z domyślnym ekwipunkiem	Zaimportuj jednorazowo do swojej bazy danych
`ox_items.md`	ox_inventory	Wklej zawartość do pliku `ox_inventory/data/items.lua`
`qb_items.md`	QBCore / QBox z qb-inventory	Wklej zawartość do pliku `qb-core/shared/items.lua`

Obrazki: ikony znajdują się w folderze inventory_images/, po jednym pliku PNG nazwanym tak samo jak przedmiot. Skopiuj je do folderu z obrazkami swojego ekwipunku — ox_inventory/web/images/ lub qb-inventory/html/images/.

Następnie skieruj Config.InventoryImagePath na ten sam folder, aby ikony smaków wyświetlały się w menu konfiguracji. Domyślnie jest to nui://ox_inventory/web/images/; dla qb-inventory użyj nui://qb-inventory/html/images/.

Działa poprawnie, gdy możesz nadać sobie przedmiot hookah_red i pojawia się on w ekwipunku razem z ikoną.

6. Pierwszy test

Nadaj sobie przedmioty hookah_red, hookah_coal, hookah_water oraz hookah_mint_flavor.

Użyj hookah_red. Twoja postać będzie trzymać sziszę na tacy. Naciśnij E.
Podgląd podąża za Twoim celownikiem. Obróć go kółkiem myszy, podnieś lub obniż strzałkami i naciśnij E, aby postawić.
Namierz sziszę targetem i wybierz Open Setup Menu. Dodaj węgiel, dodaj wodę, wybierz smak Mint, a następnie kliknij Light Hookah.
Zamknij menu, ponownie namierz sziszę targetem i wybierz Grab Hose. Naciśnij E.

Działa poprawnie, gdy od sziszy do Twojej postaci biegnie wąż, a po naciśnięciu E zaciągasz się i wypuszczasz jasnozielony dym. Poziom węgla i wody w menu spada odrobinę przy każdym zaciągnięciu.

Zanim otworzysz serwer dla graczy

Zdecyduj, kto może zarządzać sziszami. Config.AdminGroups jest domyślnie ustawione na false, co pozwala każdemu graczowi otworzyć menu i podnieść dowolną sziszę lub mebel. Wpisz tam swoje grupy administracyjne, aby ograniczyć te uprawnienia tylko do właściciela i administracji. Zobacz Personalizacja.
Config.InventoryImagePath wskazuje na folder z obrazkami, którego faktycznie używasz.
Stres: Config.Stress jest włączone, ale funkcja ReduceStress w server_functions.lua jest pusta, dopóki nie wpiszesz tam wywołania ze swojego skryptu.
Poinformuj graczy, że postawione szisze i meble nie są zapisywane w bazie: znikają po restarcie zasobu lub serwera.