Jak stworzyć własny shell do FiveM
Własne wnętrza to jedna z funkcji, o które gracze na serwerach roleplay FiveM proszą najczęściej. Chcą mieszkań, kryjówek gangów, komisariatów i lokali firm, które wyglądają wyjątkowo. Tradycyjnie oznacza to szukanie paczek MLO, użeranie się z pobieraniem i nadzieję, że będą pasować do używanego skryptu na housing. Shelle to prostsza alternatywa, a dzięki Shell Creator zbudować je może każdy admin serwera.
Czym jest shell w FiveM?
Shell to gotowa konstrukcja wnętrza, która istnieje poza normalnym światem gry. Umieszcza się ją w pustej przestrzeni, zwykle wysoko nad mapą, gdzie niczemu nie przeszkadza. Gracze są do niej teleportowani, gdy wchodzą do nieruchomości lub lokacji.
Shelle różnią się od MLO. MLO (Map Level Object) to własne wnętrze 3D wbudowane bezpośrednio w świat gry, w stałym miejscu na mapie. Shelle są bardziej elastyczne, bo można ich używać wielokrotnie. Kilka nieruchomości może korzystać z tego samego układu shella, a same shelle są spawnowane i despawnowane dynamicznie, zamiast być na stałe wczytane do świata.
Większość skryptów na housing obsługuje shelle, a wiele z nich używa ich jako domyślnego typu wnętrza dla mieszkań i nieruchomości.
Tradycyjny sposób na shelle
Zanim pojawiły się narzędzia takie jak Shell Creator, admini serwerów mieli dwie opcje.
Pierwsza to pobieranie gotowych paczek shelli od społeczności. Mają stałe układy bez możliwości modyfikacji. Co pobierzesz, to masz.
Druga to zapłacenie mapperowi za zbudowanie własnego shella w narzędziach takich jak Blender z wtyczką Sollumz. Dostajesz wtedy dokładnie to, czego potrzebujesz, ale to zajmuje czas, kosztuje i wymaga mappera, który rozumie pipeline streamingu w FiveM.
Żadna z tych opcji nie jest szczególnie szybka i żadna nie pozwala adminom samodzielnie poprawiać ani zmieniać układu.
Co robi Shell Creator
Edytor Shell Creator działa w grze i pozwala adminom budować własne wnętrza bezpośrednio na serwerze, bez żadnych zewnętrznych narzędzi. Cały proces budowania odbywa się w FiveM, w interfejsie edytora.
Skrypt ma bibliotekę propów do budowania:
- Szeroki wybór tekstur podłóg i ścian, z możliwością dodania własnych
- Schody, okna i drzwi
- Oświetlenie i elementy sufitu
- Własne meble
Wszystkie propy ważą łącznie poniżej 12mb, więc gracze nie muszą pobierać dużych plików, żeby poprawnie widzieć wnętrze.
Shelle zapisują się w bazie danych w skompresowanym formacie i spawnują się dynamicznie, gdy gracz wchodzi do nieruchomości. Gdy w środku nikogo nie ma, shell jest despawnowany. Skrypt działa na 0.00 do 0.01ms idle, więc nie ma realnego wpływu na wydajność serwera.
Co możesz w nim zbudować
Shell Creator nie ogranicza się do housingu. Każdy skrypt, który korzysta z shelli lub IPL-i, może używać shella zbudowanego w tym edytorze. Typowe zastosowania:
- Mieszkania i housing: kompatybilne z każdym skryptem na housing, który obsługuje shelle lub IPL-e
- Kryjówki gangów i bazy organizacji: stały shell przypisany do lokacji, a nie do nieruchomości gracza
- Lokacje do jobów: warsztaty mechaników, szatnie policji, laboratoria narkotykowe, magazyny
- Przestrzenie publiczne: bary, kluby, sklepy, domy kultury
- Integracje ze skryptami: Grow Ops w skrypcie Weed Production od KuzQuality korzystają z Shell Creator przy podziemnych wnętrzach laboratoriów
W przypadku skryptów na housing Shell Creator sam generuje kod konfiguracji. Wybierz system housingu z listy, skopiuj wynik i wklej go do configu. Obsługiwane systemy znajdziesz w dokumentacji na docs.kuzquality.com.
Jeśli twojego systemu housingu nie ma na liście, wygenerowany format nadal możesz dostosować ręcznie.
Niektóre systemy housingu idą o krok dalej. Na przykład nolag_properties korzysta bezpośrednio z eksportu Shell Creator, żeby automatycznie pobrać listę shelli. Nie trzeba niczego kopiować ani wklejać do configu. Integracja działa w pełni bezproblemowo od razu po instalacji.
Wbudowany system teleportów
Shell Creator ma system teleportów na sytuacje, gdy shell nie jest powiązany ze skryptem na housing. Admini mogą ustawić punkty wejścia i wyjścia bezpośrednio w edytorze, dzięki czemu gracze dostają się do wnętrza bez dodatkowego skryptowania. Teleportowanie pojazdów jest opcjonalne i też konfigurowalne.
Timecycle i klimat
Do każdego shella możesz przypisać timecycle. Timecycle odpowiada za oświetlenie, color grading i ogólny klimat wnętrza. Czyste mieszkanie może wyglądać jasno i nowocześnie. Kryjówka gangu może być ciemna i surowa. Wnętrze klubu nocnego może mieć zupełnie inny charakter niż komisariat, nawet jeśli sama konstrukcja shella jest podobna.
Jak stworzyć shell
Po zainstalowaniu skryptu cały proces jest prosty:
- Otwórz edytor Shell Creator w grze skonfigurowaną komendą lub z menu
- Postaw podłogę, ściany i sufit za pomocą selektora propów
- Dodaj meble, oświetlenie, schody i inne elementy
- Przypisz timecycle, żeby ustawić klimat
- Zapisz shell w bazie danych
- Jeśli używasz skryptu na housing, skopiuj wygenerowany config, a przy dostępie standalone ustaw teleport
Pełny poradnik wideo znajdziesz tutaj: Jak stworzyć shell do FiveM za pomocą KQ Shell Creator
Kompatybilność z frameworkami
Shell Creator działa na każdym frameworku: ESX, QBCore, QBox, vRP, TMC, a także na w pełni customowych serwerach. Do łączenia z frameworkiem i zależnościami używa kq_link.
