Jak wgrać mapę na serwer Garry’s Mod i ustawić mapę startową?

Mapę na serwer Garry’s Mod dodasz przez Steam Workshop albo przesyłając plik .bsp do katalogu garrysmod/maps. Następnie możesz uruchomić ją komendą changelevel nazwa_mapy. Jeśli ma pojawiać się po każdym starcie procesu, potrzebujesz również właściwej konfiguracji mapy startowej.

W Vorlantix skorzystasz z menedżera plików, SFTP i konsoli serwera. Przy nowej instalacji mapę startową wybierzesz w formularzu. Poniżej pokazujemy obie metody dostarczenia mapy, jej test oraz sprawdzenie, czy znajomi mogą dołączyć bez brakujących plików.

Plik mapy, nazwa i Workshop ID — czym się różnią?

Nazwa widoczna na stronie dodatku nie zawsze odpowiada nazwie pliku. Do polecenia zmiany mapy potrzebujesz nazwy pliku bez rozszerzenia .bsp. Jeżeli autor udostępnia kilka wariantów, sprawdź, który przeznaczony jest do waszego trybu gry.

gm_moja_mapa jest tu nazwą przykładową. Zastąp ją rzeczywistą nazwą swojej mapy. Samo wpisanie tytułu dodatku albo jego ID w polu mapy nie pobierze brakującej zawartości.

Krok 1. Przygotuj pliki i kopię serwera

Przed zmianą zanotuj obecną mapę i tryb gry. W panelu Vorlantix wykonaj kopię zapasową, szczególnie jeśli zamierzasz zastępować istniejące pliki. Uzgodnij termin z ekipą: zmiana poziomu przenosi wszystkich na inną mapę i może usunąć niezapisane konstrukcje zależnie od używanego trybu.

Sprawdź opis autora, wymagane gry i paczki zawartości. Mapa przygotowana dla określonego trybu może wymagać jego mechanik lub konfiguracji. Nie zmieniaj jednocześnie mapy, trybu i kilkunastu dodatków — pojedynczy test łatwiej ocenić.

Krok 2A. Wgraj mapę przez pliki lub SFTP

1. Pobierz paczkę mapy z zaufanego źródła i rozpakuj ją na komputerze.
2. Odnajdź właściwy plik .bsp oraz dołączone przez autora zasoby.
3. W panelu Vorlantix zatrzymaj serwer przed podmianą plików.
4. Otwórz menedżer plików albo połącz się przez SFTP danymi swojej usługi.
5. Prześlij mapę do garrysmod/maps i zaczekaj na zakończenie transferu.
6. Sprawdź nazwę, rozszerzenie i rozmiar przesłanego pliku, a następnie uruchom usługę.

garrysmod/
    maps/
        gm_moja_mapa.bsp

Jeśli menedżer otwiera już katalog zawartości gry, wybierz samo maps. Nie twórz przypadkowo struktury garrysmod/garrysmod/maps. Archiwum ZIP umieszczone w katalogu map nie zastępuje wypakowanego pliku.

Dodatkowe foldery, takie jak materials, models i sound, zachowaj zgodnie ze strukturą paczki. Jeżeli mapa jest kompletnym dodatkiem, może mieć własny katalog w garrysmod/addons, zawierający między innymi maps. Zasady tej struktury opisuje dokumentacja dodatków Facepunch. Nie wrzucaj wszystkich plików do jednego folderu.

Krok 2B. Dodaj mapę ze Steam Workshop

Jeśli mapa jest dostępna w Workshop, możesz dodać ją do kolekcji używanej przez serwer. Przy instalacji Garry’s Mod w Vorlantix podaj ID tej kolekcji w polu „ID kolekcji Steam Workshop (opcjonalne)”. Kolekcja musi być publiczna albo dostępna przez link, aby serwer mógł ją odczytać.

Na istniejącej usłudze z podłączoną kolekcją dopisz mapę do tej samej listy i wykonaj kontrolowany restart. Poczekaj na pobranie oraz zamontowanie dodatku. Jeżeli kolekcji wcześniej nie ustawiono, ustal z obsługą zmianę konfiguracji startowej bez reinstalowania wartościowej zawartości.

Mapy Workshop nie muszą pojawiać się jako luźny plik w głównym katalogu maps. Mogą być zamontowane z dodatku. Nazwę potrzebną do uruchomienia sprawdź w opisie autora. Mechanizm instalowania kolekcji i udostępniania aktywnej mapy klientom wyjaśnia poradnik Workshop dla serwerów.

Krok 3. Uruchom mapę komendą changelevel

Po potwierdzeniu instalacji otwórz konsolę serwera w panelu Vorlantix i wpisz:

changelevel gm_moja_mapa

Użyj prawdziwej nazwy bez .bsp, bez ścieżki katalogu i bez znaku +. To polecenie konsoli serwera, nie wiadomość na czacie. Obserwuj log ładowania i poczekaj, aż uczestnicy połączą się z nową mapą.

changelevel zmienia bieżący poziom, ale nie ustawia trwale mapy startowej. Po restarcie procesu serwer może wrócić do poprzedniej konfiguracji. Przed ustawieniem nowej mapy na stałe sprawdź punkty odradzania, działanie trybu i brak krytycznych błędów.

Krok 4. Ustaw mapę startową

Nowy serwer w Vorlantix

W formularzu instalacji znajdziesz pole „Mapa startowa”, domyślnie gm_construct. Wpisz właściwą nazwę bez rozszerzenia. Jeśli używasz Workshop, podaj też kolekcję zawierającą mapę. Pliki muszą być dostępne podczas uruchamiania.

Już działający serwer

Mapa startowa jest określana parametrem procesu, na przykład:

+map gm_moja_mapa

To składnia uruchomieniowa opisana w dokumentacji serwera GMod. Nie wklejaj jej do zwykłej konsoli jako zamiennika changelevel. Bieżący formularz ustawień Vorlantix nie udostępnia zmiany tego parametru. Po przetestowaniu mapy zgłoś obsłudze identyfikator usługi, nazwę mapy i prośbę o ustawienie jej przy starcie.

Nie dopisuj changelevel do server.cfg, żeby wymusić mapę po restarcie. Ten plik jest konfiguracją wykonywaną przy ładowaniu map i nie zastępuje poprawnego parametru startowego. Nie reinstaluj serwera wyłącznie w celu zmiany mapy. Po zmianie konfiguracji wykonaj restart i potwierdź, co faktycznie się załadowało.

Krok 5. Sprawdź pobieranie mapy przez graczy

Mapa działająca na serwerze musi być również dostępna dla klientów. Poproś o test osobę, która wcześniej jej nie instalowała. Administrator z lokalną kopią może wejść poprawnie mimo brakującej konfiguracji pobierania.

Przy aktywnej mapie pochodzącej z kolekcji serwera GMod potrafi automatycznie wskazać jej dodatek do pobrania. Przy ręcznym pliku trzeba zapewnić uczestnikom zgodną kopię albo skonfigurować dostarczanie plików, na przykład FastDL. Samo ustawienie sv_downloadurl wymaga działającego źródła HTTP i odpowiednich plików. Nie wpisuj tam adresu strony Workshop. Metody opisuje dokumentacja udostępniania zawartości.

Dla prywatnej ekipy prostym testem jest dostarczenie wszystkim identycznej paczki przed połączeniem. Przy późniejszej aktualizacji zadbaj o zgodność wersji; ręczna kopia i wersja z Workshop o tej samej nazwie mogą utrudnić rozpoznanie, który plik jest używany.

Najczęstsze problemy

Serwer nie znajduje mapy

Sprawdź nazwę pliku, katalog, ukończenie transferu i montowanie Workshop. Na serwerze Linux zachowaj dokładną wielkość liter. Upewnij się, że wpisujesz nazwę mapy, a nie tytuł dodatku lub ID kolekcji.

Po restarcie wraca gm_construct

Porównaj konfigurację startową z wcześniej wykonaną komendą. Zmiana bieżącego poziomu nie zmienia parametru uruchomienia. Sprawdź też, czy dodatek zarządzający rotacją map nie przełącza poziomu po starcie.

Klient zgłasza inną wersję mapy

Porównaj źródło i wersję pliku po obu stronach. Zabezpiecz lokalną kopię przed zastąpieniem, a następnie pobierz właściwą mapę. Nie kasuj całego katalogu map jako pierwszego rozwiązania.

Widać brakujące tekstury albo ERROR

Sprawdź zależności autora, dodatkowe materiały oraz zasoby innych gier. Sama obecność .bsp nie potwierdza kompletności paczki. Ustal, czy problem występuje u wszystkich, czy tylko na jednym komputerze.

Podsumowanie

Najpierw dostarcz mapę przez pliki lub Workshop, potem przetestuj ją poleceniem changelevel. Mapę startową wybierz podczas instalacji, a dla działającej usługi uzgodnij zmianę parametru +map z obsługą Vorlantix. Na koniec sprawdź restart i wejście gracza bez wcześniejszej kopii mapy. Dzięki temu potwierdzisz zarówno konfigurację serwera, jak i dostępność zawartości dla ekipy.