Chcesz zacząć tworzyć własne modyfikacje i funkcje na swoim serwerze FiveM, ale nie wiesz, od czego zacząć? Tworzenie własnych skryptów w języku LUA to fundamentalna umiejętność każdego administratora i dewelopera. To pierwszy krok do pełnej personalizacji rozgrywki.
W tym poradniku przeprowadzimy Cię krok po kroku przez proces tworzenia prostego skryptu, który zarejestruje nową komendę na Twoim serwerze. Po ukończeniu tego przewodnika będziesz miał solidne podstawy do dalszej nauki i tworzenia bardziej zaawansowanych zasobów.
Wymagania Wstępne
- Dostęp do plików serwera FiveM (lokalnie lub przez FTP/SSH).
- Podstawowy serwer FiveM (może być czysta instalacja).
- Edytor kodu, np. Visual Studio Code, Notepad++ lub podobny.
- Podstawowa znajomość struktury plików serwera FiveM.
Przewodnik Krok po Kroku
- Utworzenie folderu zasobu: W głównym katalogu serwera przejdź do folderu
resources. Stwórz w nim nowy folder dla swojego skryptu. Nazwa powinna być unikalna i najlepiej ujęta w nawiasy kwadratowe, np.[moj-pierwszy-skrypt]. - Stworzenie pliku manifestu: Wewnątrz folderu
[moj-pierwszy-skrypt]utwórz plik o nazwiefxmanifest.lua. Ten plik informuje serwer, czym jest dany zasób i jakie pliki zawiera. - Stworzenie pliku skryptu: W tym samym folderze stwórz plik, w którym umieścisz swój kod. Ponieważ tworzymy komendę dla gracza, nazwijmy go
client.lua. Jeśli skrypt miałby działać po stronie serwera, nazwalibyśmy goserver.lua. - Edycja pliku manifestu: Otwórz
fxmanifest.luai wklej do niego podstawową konfigurację. Musisz zadeklarować wersję manifestu oraz wskazać, które pliki skryptów mają być ładowane. Zobacz przykładowy kod poniżej. - Pisanie kodu LUA: Otwórz plik
client.lua. Napiszemy w nim prostą funkcję, która rejestruje komendę/hello. Po wpisaniu jej na czacie, gracz zobaczy powitalną wiadomość. - Aktywacja zasobu w
server.cfg: Otwórz główny plik konfiguracyjny serwera, czyliserver.cfg. Na końcu pliku dodaj linię, która uruchomi Twój nowy zasób. Nazwa musi być identyczna z nazwą folderu, który stworzyłeś, np.ensure moj-pierwszy-skrypt. - Uruchomienie i testowanie: Zapisz wszystkie pliki. Uruchom ponownie serwer FiveM. Po wejściu na serwer, otwórz czat (klawisz T) i wpisz komendę
/hello. Jeśli wszystko poszło zgodnie z planem, na czacie powinna pojawić się wiadomość.
Przykładowy Kod / Konfiguracja
Poniżej znajdują się kompletne kody, które należy umieścić w odpowiednich plikach.
Plik: fxmanifest.lua
fx_version 'cerulean'
game 'gta5'
author 'Twoja Nazwa'
description 'Mój pierwszy skrypt LUA dla FiveM'
client_script 'client.lua'Ten kod definiuje podstawowe informacje o zasobie i informuje serwer, że plik client.lua powinien być uruchomiony po stronie klienta (gracza).
Plik: client.lua
RegisterCommand('hello', function(source, args, rawCommand)
TriggerEvent('chat:addMessage', {
color = {255, 0, 0},
multiline = true,
args = {'^1System', '^0Witaj na serwerze! To jest Twój pierwszy skrypt.'}
})
end, false)Ten fragment kodu LUA rejestruje nową komendę o nazwie hello. Kiedy gracz jej użyje, wywoływane jest zdarzenie chat:addMessage, które wyświetla sformatowaną wiadomość na czacie.
Plik: server.cfg (dodaj na końcu)
ensure moj-pierwszy-skryptTa linia gwarantuje, że Twój zasób zostanie załadowany i uruchomiony wraz ze startem serwera.
Podsumowanie
Gratulacje! Właśnie stworzyłeś i uruchomiłeś swój pierwszy, w pełni funkcjonalny skrypt LUA dla FiveM. Zrozumienie struktury zasobu, roli manifestu oraz sposobu rejestrowania komend to kluczowe fundamenty, na których możesz budować bardziej złożone systemy.
Teraz, gdy znasz już podstawy, zachęcamy do eksperymentowania. Spróbuj dodać kolejne komendy, zapoznaj się z dokumentacją FiveM (Natives) i odkrywaj możliwości, jakie dają zdarzenia (events) do komunikacji między skryptami. To początek Twojej przygody z tworzeniem unikalnych serwerów RP.
