PL/Server Manual

Pierwsze kroki

Uruchomienie swojego własnego serwera MTA:SA jest o wiele łatwiejsze niż mogłoby się wydawać. Jeżeli chciałbyś postawić serwer by pograć ze znajomymi lub po prostu z ludźmi z sieci - zachęcam do lektury.

Instalacja serwera

Poniżej opisane są sposoby instalacji serwera w zależności od posiadanego systemu operacyjnego.

Linux

Serwer pod Linuksem można zainstalować na kilka sposobów:

• Instalując i uruchamiając MTA na systemie linux
• Uruchamiając gotowe binarki (wcześniej skompilowane pliki)
• Kompilując własny kod źródłowy serwera

Dodatkowe informacje możemy znaleźć tutaj

Możesz doświadczyć różnych błędów i częstych problemów. Jeśli tak się dzieje to sprawdź

• Building MTASA Server on GNU Linux#Troubleshooting

FreeBSD

Możesz uruchomić MTA:SA na FreeBSD za pomocą emulatora Linuxa.

• Włącz Kompatybilność plików binarnych linuxa
• Zainstaluj lub skompiluj następująće pakiet: hs-terminfo, linux_base-f10, linux-f10-sqlite3
• Zaintaluj Skompilowane binarki dla linuxa

Windows

Instalacja serwera na Windowsie jest prosta "jak budowa cepa".

• Najpierw pobieramy instalator ze strony głównej
• Po ściągnięciu uruchamiamy ów instalator
• Wybieramy folder gdzie chcemy zainstalować MTA (serwer jest w jednej paczce z klientem)
• Klikamy na zainstaluj...
• ...i gotowe!

Aby dowiedzieć się czym jest lista kontroli dostępu w pliku acl.ml, sprawdź ACL

Konfiguracja serwera

Serwer Multi Theft Auto jest wstępnie konfigurowany z okna konsoli, z poziomu gry i z przeglądarki internetowej.

Ogólna konfiguracja

Podstawowa konfiguracja serwera znajduje się w pliku "mods/deathmatch/mtaserver.conf". Plik ten można edytować za pomocą dowolnego edytora tekstu (jeśli nie mamy zainstalowanego żadnego "specjalistycznego" edytora - na Windowsie można użyć windowsowego notatnik-a, zaś na Linuksie nano lub vi).

Przekierowanie portów

W pliku mtaserver.conf znajdują się takie dwie linijki:

<serverport>22003</serverport> 
<httpport>22005</httpport>

Porty są potrzebne do prawidłowej konfiguracji serwera. Wyjaśnimy później, jak je ustawić, ale najpierw, jeśli chcesz, aby Twój serwer pojawiał się w przeglądarce serwerów, potrzebujemy innego portu, a jest to port ASE.

(krótki przykład włączania i wyłączania ASE):

<ase>1</ase> <!-- 0 = wyłączony, 1 = włączony -->

Teraz przekierujemy porty w Twoim routerze, co nie jest potrzebne, jeśli masz już otwarte wszystkie porty lub jeśli nie masz routera z zaporą sieciową. Jeśli tak, pomiń tę część.

Jeśli nie wiesz, jak działa przekierowanie portów w Twoim routerze, wejdź na stronę Port Forward, znajdź tam model swojego routera i postępuj zgodnie z zawartymi tam instrukcjami.

Prawie w każdym routerze można ustawić typ portu: UDP lub TCP. Poniższa lista wyjaśni, jaki typ portu jest potrzebny do czego:

Główny port serwera: UDP Port HTTP: TCP Port ASE: UDP (jest to potrzebne, jeśli chcesz, aby Twój serwer pojawił się na liście serwerów)

Port ASE jest również łatwy do uzyskania - Port ASE = port głównego serwera + 123 Jeśli więc masz port głównego serwera ustawiony na 22003, port ASE będzie miał numer 22126.

Jeśli masz jakieś problemy (i przeszukałeś podaną wcześniej stronę portforward.com to zapoznaj się z tym wątkiem
Przekierowanie portów dla serwerów MTA

W najnowszej wersji serwera możesz sprawdzić status portu za pomocą komendy serwera openports.

Kontrola klienta

Serwer MTA można skonfigurować na kilka sposobów. Możemy na przykład wyłączyć jakieś komponenty systemu AntyCheat, lub zezwolić na zmodyfikowane pliki gry. Wszystkie te ustawienia znajdują się w pliku mods/deathmatch/mtaserver.conf. Możesz także zapoznać się z konfiguracją antycheat.

Jeżeli chcesz ustawić minimalną wersje klienta, wyszukaj taką linijkę:

<minclientversion></minclientversion>

Przykładowa wersja wygląda tak: 1.1.1-9.02320

Konta administratorskie

Zaleca się, aby serwer posiadał przynajmniej jedno konto administratora - tak, aby właściciel serwera miał w każdej chwili możliwość włączenia/wyłączenia serwera (lub danej jego części poprzez panel-www, konsole, grę).

Aby dodać konto administratora, postępuj według tych kroków:

1. Uruchom serwer i dodaj nowe konto za pomocą addaccount login haslo w konsoli serwera, o tak:

   addaccount SEBA18293 12344321
   

   Uwaga: Jeżeli nie masz konsoli serwera, i zasób 'admin' nie jest uruchomiony, to możesz użyć komendy register, której użyjesz tak:\ /register SEBA18293 12344321

2. Serwer wyświetli wiadomość, że konto zostało zarejestrowane
3. Następnie wyłącz serwer za pomocą shutdown w konsoli serwera.
4. Serwer zostanie zatrzymany.
5. Otwórz plik 'mods/deathmatch/acl.xml' za pomocą edytora tekstu.
6. Dodaj konto do grupy Admin

   <acl>
     ...
     <group name="Admin">
       <acl name="Admin"/>
       ...
       <object name="user.SEBA18293" />
     </group>
     ...
   </acl>
   

   Gratulacje, dodałeś konto administratora. W ten sposób możesz dodać dowolną liczbę administratorów lub użytkowników. Przyjrzyj się na przykład niektórym innym grupom i listom ACL. Dostęp do listy ACL można także uzyskać poprzez odpowiednie funkcje, sprawdź ACL.

   Zaleca się zajrzeć do interfejsu internetowego, poniżej wyjaśnimy, jak to zrobić.

   Uwaga: Istnieją również sposoby dodawania kont i edytowania uprawnień serwera podczas jego działania. "addaccount <login> <haslo>" to wewnętrzne polecenie służące do dodawania kont, ale w celu dodania tych kont do określonych grup/list ACL konieczne będzie użycie interfejsu internetowego!

   Można także zmodyfikować plik acl.xml podczas działania serwera i użyć komendy "reloadacl"

Korzystanie z interfejsu WWW (panelu www)

Interfejs WWW daje nam możliwość zdalnego zarządzania serwerem. Możemy za jego pomocą dodawać użytkowników, zarządzać grupami ACL oraz zasobami na serwerze. Cały interfejs jest dostarczany wraz z serwerem przy pomocy kilku zasobów.

Zasoby odpowiedzialne za interfejs www są uruchamiane wraz z serwerem w domyślnej konfiguracji. Panel WWW jest dostępny na wbudowanym serwerze HTTP, domyślnie na porcie 22005. Aby sprawdzić czy serwer ten jest aktywny należy wykonać poniższe kroki:

1. Zatrzymaj serwer
2. Otwórz plik mtaserver.conf znajdujący się mods/deathmatch
3. Upewnij się czy serwer HTTP jest włączony:

   <httpserver>1</httpserver>
   

4. Ustaw port HTTP według własnych potrzeb (domyślnie 22005):

   <httpport>22005</httpport>
   

5. Zapisz zmiany i zamknij plik
6. Uruchom serwer
7. Do poprawnego działania interfejsu WWW muszą być uruchomione następujące zasoby:
   1. resourcebrowser
   2. resourcemanager
   3. webadmin
   4. webmap
   Dlatego jeśli dokonałeś jakichkolwiek zmian w autostarcie zasobów, upewnij się, że powyższe są uruchomione. Jeśli nic nie ruszałeś to domyślnie są uruchomione wraz ze startem serwera.
8. Otwórz przeglądarkę internetową (Internet Explorer 6 oraz 7 nie jest wspierany) i przejdź do serwera HTTP wprowadzając adres URL http://ip_serwera:port/.
9. Po przejściu serwer poprosi o zalogowanie się - Logujemy się tam danymi administratora konta ACL, które opisaliśmy w poprzedniej sekcji wyżej.

Od tej pory mamy dostęp do zarządzania serwerem przez interfejs WWW.

Konfiguracja zewnętrznego serwera WWW (np. do serwowania plików statycznych tj. obrazki, modele itd.)

Wbudowany serwer HTTP jest także używany do pobierania plików uruchomionych zasobów na serwerze do każdego gracza z osobna. Przykładowo jeśli masz na serwerze jakiś zasób, który zawiera graficzny interfejs lub jakieś modele do podmiany to pliki takie jak obrazki, modele, kolizje, tekstury itd muszą zostać przesłane z serwera do każdego gracza na serwerze. To zadanie właśnie wykonuje domyślnie wbudowany serwer HTTP lub ustalony przez nas serwer zewnętrzny (zazwyczaj jest szybszy), z tym, że taki zewnętrzny serwer musimy skonfigurować zupełnie osobno.

Mając na uwadze wydajność i spójność serwera możesz skonfigurować zewnętrzny serwer HTTP do pobierania plików na serwerze przez graczy. Zewnętrzny serwer WWW musi być publicznie dostępny, tak aby każdy gracz na serwerze (klient) mógł się połączyć z tym serwerem w celu pobrania potrzebnych plików klienta. Taki zabieg może przyśpieszyć proces pobierania oraz odciążyć serwer.

Aby umożliwić pobieranie plików z zewnętrznego serwera WWW należy skonfigurować pole httpdownloadurl:

<httpdownloadurl>http://www.mojserwer.pl/skad/chce/sciagac/pliki</httpdownloadurl>

Po uruchomieniu serwera MTA w katalogu mods/deathmatch/resource-cache/http-client-files będą znajdować się pliki klienta gotowe do wrzucenia na zewnętrzny serwer WWW. Jeśli serwer WWW znajduje się na tej samej maszynie co serwera MTA to wystarczy połączyć odpowiedni katalog serwera WWW z katalogiem http-client-files. Jeśli natomiast serwer WWW i serwer MTA znajdują się na różnych maszynach to należy zapewnić dostęp serwerowi WWW do katalogu http-client-files za pomocą ścieżki sieciowej lub utworzyć zdalną kopię przy pomocy oprogramowania do synchronizacji.

Uwagi

• Należy unikać znaków specjalnych (np. ~,!) w adresie URL zewnętrznego serwera
• Nie należy stawiać ukośnika (/) na końcu adresu URL, czyli zamiast http://www.mojserwer.pl/katalog/ podajemy http://www.mojserwer.pl/katalog bez tego ukośnika na końcu.
• Serwer WWW musi używać formatu danych "ContentType: application/octet-stream" dla plików Lua. Większość serwerów ma to już domyślnie ustawione, ale w razie potrzeby można to zrobić ręcznie dodając do pliku .htaccess taką linijkę:

AddType application/octet-stream .lua

Instrukcja jak zainstalować i skonfigurować Nginx jako zewnętrzny serwer WWW dla MTA znajduje się tutaj: Instalcaja i konfiguracja Nginx jako zewnętrzny serwer WWW

Uruchamianie serwera

Aby uruchomić serwer kliknij dwukrotnie na plik MTA-Server.exe. Na Linuksie uruchom komende ./mta-server.

Pamiętaj, aby zapewnić dostęp w zaporze sieciowej i przekierować porty, jeśli jest to potrzebne.

Instalacja/Aktualizacja zasobów na serwerze

Zasoby serwera mogą być wgrane na dwa sposoby:

• Archiwum ZIP (zawierające pliki zasobu)
• Katalog zawierający pliki zasobu

Aby wgrać nowy zasób należy:

1. Przenieść lub skopiować go do mods/deathmatch/resources/.
2. W oknie konsoli serwera wpisać komendę refresh.

Usuwanie zasobów

Usuwanie zasobów jest bardzo proste. Sprowadza się do:

1. Usunięcia archiwum ZIP danego zasobu, lub jego katalogu.
2. Wpisania w oknie konsoli komendy refresh.

Administrowanie serwerem

Aby uruchomić dany zasób wystarczy użyć polecenia (oczywiście bez nawiasu):

start [nazwa zasobu]

Następnie gdybyśmy chcieli go zatrzymać:

stop [nazwa zasobu]

Jeśli zrestartować:

restart [nazwa zasobu]

Polecenia te (oraz inne) są dostępne z poziomu konsoli serwera oraz konsoli w grze pod klawiszem ~ lub F8. Jeśli używamy konsoli w grze to, aby móc używać tych komend musimy mieć do tego uprawnienia i musimy być zalogowani na konto ACL.

Ponadto także możemy skorzystać z panelu administratora w graficznej formie, który jest dostępny domyślnie pod klawiszem P. Pozwala on na karanie graczy, zarządzanie zasobami, serwerem i wiele więcej.

Zarządzanie serwerem jest także możliwe przez panel WWW opisany w sekcjach wyżej.

Uruchamianie map / Tryb gry

Więcej informacji znajdziesz tutaj.

Utrzymywanie serwera

Aby zapewnić stabilność działania serwera nie należy pozostawiać go bez opieki po uruchomieniu. Oto kilka wskazówek na temat prowadzenia i utrzymywania serwera:

• Warto co jakiś czas monitorować zużycie pamięci przez proces poprzez menadżer zadań lub performancebrowser / ipb. Jeśli serwer MTA zużywa powyżej 1,2 GB to w każdej chwili może wystąpić błąd Out of memory (OOM), który mówi o braku pamięci. W takim przypadku powinieneś:
  • Zrestartować serwer
  • Rozpocząć poszukiwania nieoptymalnych skryptów. Przeczytasz niżej jak można je znaleźć.
• Dbaj, aby zużycie procesora przez serwer nie osiągało wysokich wartości, ponieważ zazwyczaj powoduje to lagi lub nawet awarię serwera.
• Używaj setElementData i getElementData z rozsądkiem. Są to funkcje, które w przypadku synchronizacji wykonują ją ciągle. Gdy to możliwe ogranicz ilość synchronizowanych danych i używaj addElementDataSubscriber. Możesz także rozważyć stworzenie własnego systemu wymiany i przechowywania danych, który zastąpi ten wbudowany.
• Jak w każdej grze tutaj także znajdują się cheaterzy (choć jest ich mniej dzięki silnemu systemowi antycheat), którzy tylko szukają możliwości aby uprzykrzyć Ci życie i zaszkodzić. Jeśli więc wprowadzasz jakieś nowe, niestandardowe zasoby na serwer to zapoznaj się z bezpieczeństwem skryptów.
• Zaleca się co jakiś czas restartowanie serwera - Jak w przypadku procesów i aplikacji nie wszystkie wywołania mogą zostać "uwolnione". Przykładowo po uruchomienia serwera zużycie pamięci jest na poziomie około 50 mb. Jeśli w międzyczasie wejdą jacyś gracze, a po czasie wyjdą z serwera to zużycie pamięci wzrośnie, nawet jeśli na serwerze będzie 0 graczy. Jest to znane jako ["starzenie" się oprogramowania]. Jest to wynik ciągłego działania serwera i pewnych działań w kodzie - Serwer, który nie jest ponownie uruchomiony będzie zużywał coraz więcej pamięci, aż dojdzie do wspomnianego wyżej braku pamięci lub innej awarii. Oczywiście taki proces "degradacji" serwera trwa bardzo długi okres czasu i zależy od liczby graczy, obciążenia i wielu innych czynników. Jeśli tworzysz duży serwer, dla setek graczy to dobrą praktyką jest restartowanie go np. raz w tygodniu w godzinach nocnych.

Optymalizacja serwera

Jeśli masz zasoby, które działają w sposób nie optymalny to w bardzo łatwy sposób może to doprowadzić do lagów, przeciążenia, braku pamięci i awarii serwera. Aby zapobiegać takim sytuacjom należy monitorować co jakiś czas zużycie zasobów serwera przez konkretne skrypty i procesy.

Do takiego monitorowania przeznaczone są zasoby performancebrowser oraz ipb.

• Performancebrowser umożliwia monitorowanie stabilności serwera za pomocą interfejsu WWW w przeglądarce. W pasek adresu w przeglądarce wprowadzamy adres URL: ip_serwera:port/performancebrowser/, port który podajemy to port HTTP. Domyślnie jest to po prostu port serwera + 1. Gdy wszystko się uda zostaniemy poproszeni o zalogowanie się do konta ACL z uprawnieniami.
• IPB jest dokładnie tym samym, tyle tylko, że jest to interfejs graficzny w grze. Aby go używać musimy posiadać uprawnienia ACL.

W zakładce Lua memory możemy zobaczyć zużycie pamięci serwera przez poszczególne zasoby. Natomiast w zakładce Lua timing możemy zobaczyć zużycie procesora przez poszczególne zasoby.

Możemy także sprawdzić zużycie pamięci i procesora po stronie klienta i u konkretnych graczy. W tym celu zaznaczamy pole Incl. clients i wybieramy kogoś z listy Target.

Im niższe zużycie pamięci i procesora przez zasób tym lepiej. Jeśli zasób zużywa przykładowo 300% procesora klienta to taki gracz z pewnością doświadczy utrudnień w postaci lagów, zacinania się gry a nawet awarii. Dlatego należy zawsze pilnować i optymalizować lub eliminować takie zasoby, które zużywają duże ilości zasobów serwera.

Przydatne informacje

1. Zasoby można odświeżać również w grze za pomocą komendy refresh na czacie lub w konsoli F8. Używanie tej komendy wymaga odpowiednich uprawnień ACL. Komenda może wywołać chwilowy lag, jeśli jest wiele zasobów na serwerze
2. W instrukcji zostały podane względne ścieżki (tzn. np. /deathmatch/resources odnosi się do katalogu w katalogu serwera). Dla serwera lokalnego domyślnie jest to C:\Program Files\MTA San Andreas\server
3. Można wybrać inny plik konfiguracyjny z którego będzie korzystać MTA, podając parametr --config [nazwa pliku konfiguracyjnego] np. mtaserver.exe --config nowyplik.cfg
4. Nie należy martwić się błędami i ostrzeżeniami dotyczącymi pliku settings.xml. Jest to normalne przy świeżym i czystym serwerze

Potrzebujesz pomocy?

Potrzebujesz pomocy? Napisz na forum lub napisz na Discord. Skorzystaj z odpowiedniego kanału pomocy #help-support dla serwera lub któryś ze #scripting-helo dla pomocy w skryptach/zasobach.