Serwer RAGE:MP - konfiguracja conf.json i pakiety

RAGE Multiplayer to alternatywa dla FiveM do grania w GTA V w trybie wieloosobowym. Serwery piszą gamemody w JavaScript (Node.js) albo C#. Jest mniej popularny niż FiveM, ale ceniony za wydajność i prostą budowę. Gotowy serwer RAGE:MP postawisz u nas w kilka minut, a ten poradnik pokaże, jak go skonfigurować.

Plik conf.json

Główna konfiguracja leży w pliku conf.json w głównym folderze serwera (zakładka Files):

{
  "maxplayers": 50,
  "name": "Mój serwer RAGE:MP",
  "gamemode": "freeroam",
  "stream-distance": 500.0,
  "announce": true,
  "port": 22005,
  "csharp": "disabled"
}

• name - nazwa na liście serwerów (do 64 znaków). Ustawisz ją też w zakładce Startup.
• gamemode - nazwa trybu widoczna na liście.
• stream-distance - z jakiej odległości gracze widzą innych graczy i pojazdy. Mniejsza wartość to mniejsze obciążenie.
• announce - czy serwer ma być widoczny na publicznej liście.
• csharp - enabled, jeśli gamemode jest napisany w C#.

Opcje port i bind ustawia panel na podstawie przydzielonego adresu - nie zmieniaj ich ręcznie. Limit graczy wynika z pakietu.

Po zmianie zrestartuj serwer.

Struktura folderów

• packages/ - kod serwera (JavaScript). Każdy podfolder to osobny pakiet z plikiem index.js.
• client_packages/ - kod wysyłany do graczy: interfejs, skrypty klienta. Główny plik to client_packages/index.js.
• dotnet/ - zasoby C# (gdy csharp jest włączone).
• maps/ - mapy w formacie JSON.

Pierwszy skrypt

Przykładowy pakiet serwera packages/powitanie/index.js:

mp.events.add("playerJoin", (player) => {
  player.outputChatBox(`Witaj na serwerze, ${player.name}!`);
});

mp.events.addCommand("heal", (player) => {
  player.health = 100;
});

Po restarcie serwera każdy gracz dostanie powitanie, a komenda /heal uleczy postać. Pełna dokumentacja API: wiki.rage.mp.

Połączenie z serwerem

Gracz potrzebuje GTA V i klienta RAGE Multiplayer z rage.mp. W kliencie wybierz Direct connect i wpisz adres oraz port z zakładki Network w panelu gier.

Serwer pobiera do graczy zawartość client_packages przy każdym wejściu (z pamięcią podręczną). Duże pliki interfejsu wydłużą pierwsze wejście.

Gotowe gamemody

Na forum RAGE:MP i GitHubie znajdziesz gotowe gamemody RP i freeroam. Przed wgraniem sprawdź, czy są aktualne dla bieżącej wersji serwera - RAGE:MP zmienia API między dużymi wersjami. Gamemody RP zwykle potrzebują bazy MySQL: utworzysz ją w zakładce Databases.

Najczęstsze problemy

• Serwer nie jest widoczny na liście - sprawdź "announce": true i czy nazwa nie przekracza 64 znaków.
• Gracze się łączą, ale nic się nie dzieje - brak pliku index.js w pakiecie albo błąd w kodzie. Błędy JavaScript widać w konsoli panelu.

Aktualizacja: 2026-10-11