Instalacja serwera Minecraft na Debianie lub Ubuntu (Paper)

Chcesz uruchomić własny serwer Minecraft na swoim serwerze root z Linuksem pod Debianem albo Ubuntu? Ten poradnik jest właśnie dla ciebie. Krok po kroku instalujemy w nim serwer Paper (zgodny z pluginami Spigot i Bukkit) przez konsolę SSH.

Wszystkie polecenia są przygotowane pod Debiana 13, Debiana 12 i Ubuntu 24.04 LTS. Starsze systemy, takie jak Debian 10 czy Ubuntu 20.04, mają koniec wsparcia już za sobą i nie dostają poprawek bezpieczeństwa. Na serwerze osiągalnym z internetu lepiej ich już nie używać.

Wymagania do uruchomienia własnego serwera Minecraft

• Serwer root lub VPS z Debianem 13, Debianem 12 albo Ubuntu 24.04 LTS
• Dostęp root przez SSH
• Co najmniej 2 GB pamięci RAM na sam serwer Minecraft, a przy pluginach lub większej liczbie graczy odpowiednio więcej
• Otwarty port TCP 25565, czyli domyślny port Minecraft Java Edition

Zaktualizuj listę pakietów i wgraj aktualizacje

Zanim zaczniemy, zaktualizuj listę pakietów swojego systemu operacyjnego i zainstaluj wszystkie dostępne aktualizacje. Załatwia to jedno polecenie:

apt update && apt upgrade -y

Jakiej wersji Javy potrzebuje twój serwer Minecraft?

Minecraft wymaga innego wydania Javy zależnie od wersji serwera. Jeśli serwer wystartuje na zbyt starej Javie, przerwie pracę od razu z komunikatem o błędzie, najczęściej ze wskazaniem na nieobsługiwaną wersję pliku klasy. Dla Java Edition obowiązuje takie przyporządkowanie:

• Minecraft 1.20.5 i nowszy: Java 21
• Minecraft 1.18 do 1.20.4: Java 17
• Minecraft 1.17: Java 16
• Minecraft 1.16.5 i starszy: Java 8

Aktualne wersje serwera wymagają więc Javy 21. W razie wątpliwości zainstaluj Javę 21, bo nowsza wersja Javy z reguły uruchomi także starsze buildy Minecrafta.

Instalacja Javy 21 na Debianie 13 i Ubuntu 24.04 LTS

Oba systemy dostarczają Javę 21 bezpośrednio we własnych źródłach pakietów:

apt install openjdk-21-jre-headless -y

W Debianie 12 standardowe źródło pakietów zawiera tylko Javę 17. Jak mimo to zdobyć tam Javę 21, pokazuje nasz osobny poradnik Instalacja Javy 21 na Debianie.

Java 17 dla starszych wersji Minecrafta

Jeśli świadomie prowadzisz starszą wersję serwera z przedziału od 1.18 do 1.20.4, zainstaluj zamiast tego Javę 17:

apt install openjdk-17-jre-headless -y

Kolejne sposoby instalacji opisuje nasz poradnik Instalacja Javy 17 na Debianie.

Sprawdź instalację Javy

Następnie sprawdź, która wersja Javy jest faktycznie aktywna:

java -version

W wyniku musi pojawić się oczekiwana wersja główna, czyli na przykład „openjdk version 21”. Jeśli widzisz inną wersję, jako domyślna ustawiona jest jeszcze druga instalacja Javy.

Zainstaluj screen, żeby serwer działał bez przerwy

Bez dodatkowego narzędzia serwer Minecraft zostałby zakończony, gdy tylko zamkniesz sesję SSH. Pakiet „screen” utrzymuje proces przy życiu we własnej sesji:

apt install screen -y

Załóż osobnego użytkownika dla serwera Minecraft

Nigdy nie uruchamiaj serwera jako root. Załóż zamiast tego osobnego użytkownika. Jest to ważne zwłaszcza wtedy, gdy na tym samym serwerze działają jeszcze inne aplikacje, bo przejęty plugin nie dobierze się wtedy do całego systemu.

adduser --disabled-login spigot

Dodatek --disabled-login wyłącza dla tego użytkownika bezpośrednie logowanie przez SSH. Pytania o imię, adres czy numer telefonu możesz pominąć klawiszem Enter.

Teraz przejdź na nowego użytkownika i do jego katalogu domowego:

su spigot && cd

Tam załóż katalog dla serwera (w przykładzie „server”) i wejdź do niego:

mkdir server && cd server/

Wybierz i pobierz wersję Paper

Wybraną wersję Paper znajdziesz na oficjalnej stronie pobierania: https://papermc.io/downloads. Przez wybór wersji dotrzesz tam także do starszych buildów.

Skopiuj link do pobrania (kliknij przycisk builda prawym przyciskiem myszy, potem „Kopiuj adres linku”), wróć do konsoli SSH i pobierz plik poleceniem wget. Wygląda to mniej więcej tak:

#TO TYLKO PRZYKŁADOWY LINK, UŻYJ AKTUALNEGO LINKU Z PAPERMC.IO!

wget https://api.papermc.io/v2/projects/paper/versions/1.20.1/builds/45/downloads/paper-1.20.1-45.jar

Następnie zmień nazwę pobranego pliku na „spigot.jar”, żeby skrypt startowy zawsze mógł używać tej samej nazwy pliku. Przy późniejszej zmianie wersji podmieniasz wtedy wyłącznie plik:

mv paper*.jar spigot.jar

Utwórz skrypt startowy i zaakceptuj EULA

Utwórz plik „start.sh”:

nano start.sh

Wpisz następującą zawartość. W przykładzie serwer dostaje 4 GB pamięci RAM, a tę wartość dopasujesz do swojego serwera przez -Xmx:

screen -AmdS spigot java -Xmx4G -jar spigot.jar

Plik zapiszesz kombinacją „CTRL + X”, potem „Y” i „Enter”.

Na koniec nadaj skryptowi prawo wykonywania i zaakceptuj licencję użytkownika końcowego Minecrafta. Bez zaakceptowanej EULA żaden serwer Minecraft nie wystartuje:

chmod +x start.sh && echo "eula = true" > eula.txt

Uruchom serwer Minecraft i obsłuż konsolę

Teraz uruchom serwer:

./start.sh

Pierwsze uruchomienie trwa nieco dłużej, bo generowany jest świat i tworzone są pliki konfiguracyjne.

Kombinacją „CTRL + A + D” opuścisz konsolę serwera, nie kończąc jego pracy. Do konsoli wrócisz w każdej chwili poleceniem:

screen -r spigot

Ważne: sesja screen należy do użytkownika „spigot”. Zaloguj się więc najpierw poleceniem su spigot, zanim wywołasz screen -r.

Kolejne kroki po instalacji

Serwer działa, czyli podstawowa instalacja jest zakończona. Dwie rzeczy warto zrobić od razu potem:

• Automatyczny start: Żeby serwer sam wstawał po restarcie systemu operacyjnego, skonfiguruj jednostkę usługi systemd. Cały przebieg opisuje nasz poradnik Automatyczne uruchamianie serwera Minecraft.
• Konfiguracja: W pliku „server.properties” ustawiasz między innymi tryb gry, poziom trudności, maksymalną liczbę graczy i port. Po każdej zmianie potrzebny jest restart serwera.