Plik server.cfg to serce każdego serwera FiveM. To w nim definiujesz nazwę serwera, maksymalną liczbę graczy, wczytywane zasoby i kluczowe ustawienia wpływające na wydajność i bezpieczeństwo. Prawidłowa edycja tego pliku jest absolutnie fundamentalną umiejętnością dla każdego administratora.
W tym poradniku przeprowadzimy Cię przez najważniejsze komendy i pokażemy, jak skonfigurować plik server.cfg, aby Twój serwer działał stabilnie, wydajnie i zgodnie z Twoimi oczekiwaniami. Po lekturze będziesz w stanie samodzielnie zarządzać podstawową konfiguracją swojego projektu RP.
Wymagania Wstępne
- Pełen dostęp do plików serwera (poprzez FTP, panel hostingowy lub bezpośrednio na maszynie VPS/dedykowanej).
- Edytor kodu, który wspiera składnię i kodowanie UTF-8 (np. Visual Studio Code, Notepad++, Sublime Text). Unikaj systemowego Notatnika Windows.
- Podstawowa wiedza na temat struktury plików serwera FiveM.
Przewodnik Krok po Kroku
- Krok 1: Zlokalizuj plik server.cfg
Plik konfiguracyjny
server.cfgznajduje się w głównym katalogu Twojego serwera FiveM. Jest to ten sam folder, w którym znajduje się plik uruchomieniowy serwera (np.run.cmdlubrun.sh). - Krok 2: Utwórz kopię zapasową i otwórz plik
Zanim dokonasz jakichkolwiek zmian, zawsze twórz kopię zapasową pliku
server.cfg. Skopiuj go i zmień nazwę kopii na przykład naserver.cfg.bak. Następnie otwórz oryginalny plik w wybranym edytorze kodu. - Krok 3: Zrozumienie podstawowej składni
Składnia w pliku
.cfgjest prosta. Każda linia to zazwyczaj jedna komenda lub komentarz. Komentarze, czyli linie ignorowane przez serwer, zaczynają się od znaku#. Komendy mają formatnazwa_komendy "wartość"lubnazwa_komendy wartość. - Krok 4: Edycja najważniejszych komend
Poniżej znajduje się lista kluczowych komend, które powinieneś znać i skonfigurować.
Podstawowa Konfiguracja Serwera
sv_hostname "Nazwa Twojego Serwera | Zbrojownia FiveM"– Ustawia nazwę serwera widoczną na liście serwerów.sv_maxclients 64– Definiuje maksymalną liczbę slotów (graczy) na serwerze. Wartość zależy od Twojej licencji FiveM Patreon.sets locale "pl-PL"– Ustawia język i region serwera, co może być istotne dla niektórych zasobów.
Zarządzanie Zasobami (Skryptami)
ensure [nazwa_folderu_skryptu]– Uruchamia zasób i dba o to, by był on zawsze włączony. Jest to zalecana metoda dla kluczowych skryptów, takich jak framework (ESX, QBCore), system postaci czy anitcheat.start [nazwa_folderu_skryptu]– Uruchamia zasób jednorazowo. Można go później zatrzymać w trakcie działania serwera. Używane dla map, pojazdów czy skryptów, które nie są krytyczne.
Klucze i Licencje
sv_licenseKey "TWOJ_KLUCZ_LICENCYJNY_FIVEM"– Klucz licencyjny z Twojego konta na FiveM Keymaster. Jest absolutnie wymagany do uruchomienia serwera.steam_webApiKey "TWOJ_KLUCZ_STEAM_API"– Klucz API od Steam, wymagany do poprawnego działania uwierzytelniania graczy. Możesz go wygenerować na stronie Steam.
Tagi i Opis Serwera
sets sv_projectDesc "Szczegółowy opis Twojego serwera, widoczny dla graczy. Opisz tutaj klimat, zasady i unikalne cechy."– Ustawia opis serwera.sets tags "roleplay, rp, polska, custom, policja, ems"– Tagi oddzielone przecinkami, które pomagają graczom znaleźć Twój serwer na liście.
- Krok 5: Zapisz zmiany i zrestartuj serwer
Po wprowadzeniu wszystkich zmian, zapisz plik
server.cfg. Upewnij się, że kodowanie pliku to UTF-8. Następnie zrestartuj serwer FiveM, aby nowe ustawienia zostały wczytane. Sprawdź konsolę serwera w poszukiwaniu ewentualnych błędów.
Przykładowy Kod / Konfiguracja
Poniżej znajdziesz przykładową, dobrze skomentowaną konfigurację pliku server.cfg, która może posłużyć jako solidna baza dla Twojego serwera.
# =================================================================
# PLIK KONFIGURACYJNY SERWERA - ZBROJOWNIA FIVEM
# =================================================================
# --- Podstawowe Ustawienia ---
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_maxclients 48
sv_hostname "[PL] Zbrojownia RP | Nowy Projekt | Zapraszamy!"
sets sv_projectDesc "Witaj na serwerze Zbrojownia RP! Oferujemy unikalne skrypty i rozbudowaną ekonomię. Dołącz do naszej społeczności."
# --- Klucze API ---
# Pamiętaj, aby nigdy nie udostępniać tych kluczy publicznie!
sv_licenseKey "tutaj_wklej_swoj_klucz_z_keymaster"
steam_webApiKey "tutaj_wklej_swoj_klucz_steam_api"
# --- Tagi i Język ---
sets tags "roleplay, rp, polska, pl, custom, esx, policja, lspd, ems"
sets locale "pl-PL"
# --- Uruchamianie Zasobów (Framework i Podstawowe Systemy) ---
# Używaj 'ensure' dla zasobów, które muszą działać cały czas.
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
# Przykład dla frameworka ESX
ensure mysql-async
ensure essentialmode
ensure esplugin_mysql
ensure es_extended
# --- Uruchamianie Zasobów Dodatkowych (Skrypty, Mapy, Pojazdy) ---
# Używaj 'start' dla zasobów, którymi chcesz zarządzać w konsoli.
start jakis_skrypt_na_prace
start jakas_mapa_yMAP
start jakis_pojazd
# --- Ustawienia Zaawansowane ---
sv_endpointprivacy true
sv_scriptHookAllowed false # Zawsze ustawiaj na false na serwerach publicznych!
Podsumowanie
Gratulacje! Opanowałeś właśnie podstawy konfiguracji pliku server.cfg. Pamiętaj, że jest to plik, do którego będziesz wracać wielokrotnie podczas rozwijania swojego serwera. Każdy nowy skrypt, który dodajesz, musi zostać w nim zadeklarowany.
Zachęcamy do eksperymentowania z różnymi komendami (zawsze z kopią zapasową!), aby lepiej zrozumieć ich działanie. Następnym krokiem może być zgłębienie systemu uprawnień (ACE Permissions) oraz zaawansowanych zmiennych (Convars), które również definiuje się w tym pliku.
