Aktualizacja serwera do Minecraft 26.x - Java 25, nowe foldery świata, pluginy

Wersje 26.x i wsparcie silników

Mojang zmienił numerację: wersja zaczyna się od roku, potem jest numer dropu w danym roku i ewentualnie numer poprawki. Po 1.21.11 przyszły więc 26.1 (24 marca 2026), 26.1.1 (1 kwietnia), 26.1.2 (9 kwietnia), 26.2 (16 czerwca) i 26.3 (15 września 2026). Kolejna, 26.4, jest na razie w snapshotach.

Silniki serwerowe dogoniły wydania Mojanga w różnym tempie. Tak wygląda sytuacja na dzień aktualizacji tego artykułu:

Paper 1.21.11 od 15 czerwca 2026 nie dostaje poprawek, a PaperMC nie przenosi łatek exploitów do starszych wersji, gdy nowsza jest już stabilna. Publiczny serwer, który zostaje na 1.21.11, zostaje też bez nowych poprawek bezpieczeństwa.

Java 25 na serwerze

Minecraft 26.1 jako pierwsza wersja wymaga Javy 25 i ta zasada obowiązuje w całej linii 26.x. Paper, Purpur i Fabric na Javie 21 nie wystartują, a BuildTools Spigota dla 26.x przyjmuje Javę 25 lub 26. Wersje od 1.20.5 do 1.21.11 działały na Javie 21, więc na wielu maszynach nowa Java musi stanąć obok starej.

Na własnym serwerze zainstaluj JDK 25, na przykład Eclipse Temurin z adoptium.net, i sprawdź wynik poleceniem java -version. Jeśli w systemie masz kilka wersji Javy, w skrypcie startowym wpisz pełną ścieżkę do nowej. Na hostingu wersję Javy zmieniasz zwykle w panelu, w ustawieniach startu serwera. Szczegóły instalacji znajdziesz w poradniku Java do Minecrafta.

java -version
java -Xms4G -Xmx4G -jar paper-26.3-207.jar nogui

Gdy uruchomisz serwer 26.x starszą Javą, start kończy się błędem UnsupportedClassVersionError z informacją o class file version 69.0 - to numer odpowiadający Javie 25.

Ta sama zmiana dotyczy proxy. Velocity od wersji 4.0.0, wydanej 14 lipca 2026, wymaga Javy 25. Velocity 3.5.1, najnowsze wydanie linii 3.x działające na Javie 21, ma w PaperMC status wycofanego, a jako koniec wsparcia podano 30 września 2026. Jeśli proxy i serwery gry działają na jednej maszynie, zaktualizuj Javę dla wszystkich naraz.

Nowy układ folderów świata

W 26.1 Mojang przebudował zapis świata: wszystkie domyślne wymiary trafiły do podfolderu dimensions, a postępy, dane i statystyki graczy do folderu players. Paper przez lata trzymał się układu odziedziczonego po Bukkicie, w którym Nether i End leżały w osobnych folderach w katalogu głównym serwera. Od Papera 26.1 układ jest bliższy vanilla:

world/
  data/minecraft/
  datapacks/
  dimensions/minecraft/
    overworld/
      data/minecraft/
      data/paper/
      entities/
      poi/
      region/
      paper-world.yml
    the_nether/
    the_end/
  players/
    advancements/
    data/
    stats/
  level.dat

Foldery the_nether i the_end mają tę samą strukturę co overworld. Dane Papera (level_overrides.dat, metadata.dat, persistent_data_container.dat) leżą w data/paper/ danego wymiaru, a plik paper-world.yml z ustawieniami pojedynczego świata przeniesiono do folderu wymiaru. Ustawienia domyślne dla wszystkich światów dalej trzymasz w config/paper-world-defaults.yml. Paper zachował przy tym własne funkcje, takie jak osobne reguły gry i punkty odrodzenia dla każdego świata.

Co z tego wynika w praktyce:

• Kopie zapasowe i mapy - skrypty backupu, synchronizacji i narzędzia map, które wskazują na stare foldery Netheru i Endu w katalogu głównym, przestaw na nowe ścieżki.
• Czas w światach - Paper domyślnie prowadzi osobny zegar dla każdego świata, żeby dynamicznie tworzone światy miały własny czas jak wcześniej. Jeśli wolisz zachowanie vanilla ze wspólnym czasem dla całego serwera, ustaw time.affects-all-worlds: true w config/paper-global.yml. Wtedy światy tego samego typu wymiaru dzielą zegar, a komenda /time działa na wszystkie światy, a nie tylko na ten, w którym jesteś.
• Kompresja regionów - dawne unsupported-settings.compression-format zastąpiła opcja region-file-compression w server.properties, która przyjmuje teraz także gzip.

Po przejściu na 26.2 możesz zobaczyć w logach komunikat Missing file: /data/minecraft/game_rules.dat. PaperMC pisze, że jest spodziewany i można go bezpiecznie zignorować, bo pochodzi z logiki trybu jednoosobowego.

Pluginy, mody i serwer bez obfuskacji

Od 26.1 Mojang wydaje serwer bez obfuskacji, czyli z prawdziwymi nazwami klas, metod i pól. PaperMC całkowicie usunął w związku z tym wewnętrzny remapper. Według PaperMC zmiana dotyczy pluginów, które sięgają do wnętrza serwera (NMS) bezpośrednio lub przez refleksję - takie pluginy potrzebują nowych wydań. Plugin korzystający tylko z API tego nie odczuje.

Na Fabricu zmiana jest dużo bardziej odczuwalna. Zespół Fabric pisze wprost, że żaden mod z 1.21.11 lub starszej wersji nie zadziała na 26.1 bez co najmniej ponownej kompilacji. Przy 26.3 Fabric API usunęło też kilka rejestrów, m.in. FuelRegistry i CompostingChanceRegistry, więc każdy mod musi mieć wydanie na konkretną wersję 26.x. Lithium, C2ME, FerriteCore, Krypton i Carpet takie wydania już mają.

Paper 26.2 przyniósł też Adventure 5, które usuwa wcześniej oznaczone jako przestarzałe API. Najważniejsze zmiany dotyczą BookMeta, które nie rozszerza już interfejsu Book, oraz przestarzałych zastosowań ClickEvent i HoverEvent. Do tego łóżka przestały być blokami-encjami i tracą PersistentDataContainer. Plugin napisany pod stare API może przez to przestać działać albo zgubić dane zapisane w łóżkach.

Przykładowe deklaracje zgodności na Modrinth:

Deklaracja wersji to informacja od autora, a nie gwarancja. Brak 26.3 na liście, jak przy EssentialsX, nie przesądza, że plugin nie ruszy, ale to sygnał, żeby sprawdzić go najpierw na serwerze testowym.

Lista kontrolna aktualizacji

1. Kopia zapasowa. Zatrzymaj serwer i skopiuj cały folder: świat, pluginy, konfigurację. Po pierwszym starcie na 26.x świata nie cofniesz, więc kopia to jedyna droga powrotu. Automatyzację opisujemy w poradniku kopie zapasowe serwera.
2. Java 25. Zainstaluj ją i podmień ścieżkę w skrypcie startowym albo ustawienie w panelu hostingu.
3. Spis pluginów i modów. Zapisz wersje i dla każdego sprawdź wydanie na docelową wersję 26.x na Modrinth, Hangar lub SpigotMC.
4. Serwer testowy. Uruchom kopię z nowym plikiem JAR i zaktualizowanymi pluginami. Przejrzyj logs/latest.log pod kątem błędów ERROR i ostrzeżeń o pluginach.
5. Test funkcji. Sprawdź logowanie, uprawnienia, ekonomię, ochronę terenu i przejścia przez portale do Netheru i Endu.
6. Ścieżki. Przestaw skrypty backupu i narzędzia map na world/dimensions/minecraft/.
7. Proxy. Zaktualizuj Velocity do 4.x i pluginy proxy, na przykład ViaVersion.
8. Produkcja. Dopiero teraz zaktualizuj właściwy serwer i obserwuj pierwszy start w konsoli. Jeśli przy okazji zmieniasz hosting, skorzystaj z poradnika migracja serwera.

Co dalej: 26.4

Kolejna wersja, 26.4, jest w fazie snapshotów - piąty snapshot wyszedł 20 października 2026. Funkcje ze snapshotów mogą się jeszcze zmienić przed premierą.

PaperMC zapowiada na 26.4 połączenie konfiguracji: prawie wszystkie opcje rozrzucone dziś po plikach Bukkit, Spigot i Paper mają trafić w jedno miejsce. To plan, a nie gotowa zmiana - postęp prac śledzisz w zgłoszeniu #14304 na GitHubie PaperMC. Zespół planuje też zabezpieczyć pliki JAR przed podmianą, na przykład przez podpisywanie.