Folia - wielowątkowy serwer Minecraft od PaperMC

Czym jest Folia

W zwykłym Paperze cały świat liczy jeden wątek główny. Nieważne, ile rdzeni ma procesor - gdy ten wątek nie wyrabia, spada TPS całego serwera. Folia działa inaczej: grupuje sąsiadujące, załadowane chunki w niezależne regiony. Każdy region ma własną pętlę ticków w normalnym tempie 20 TPS, a pętle wszystkich regionów wykonują się równolegle w puli wątków.

Głównego wątku po prostu nie ma - każdy region ma w praktyce własny. Gdy gracze rozchodzą się po mapie, Folia tworzy wiele rozproszonych regionów i przetwarza je jednocześnie, dzięki czemu serwer skaluje się z liczbą rdzeni. Dokładne zasady łączenia chunków w regiony opisuje dokumentacja PaperMC.

PaperMC rozwija Folię jako osobny projekt na licencji GPL-3.0. Według README projektu Folia nie zostanie włączona do Papera w dającej się przewidzieć przyszłości, więc to osobny silnik z własnymi wydaniami.

Wersje Folii w 2026

Folia dostaje nowe wersje później niż Paper. Paper 26.3 jest stabilny od 11 października 2026, a Folia przeszła na 26.3 dopiero 14 października. Tak wygląda lista wersji w API pobierania PaperMC:

W praktyce masz dziś wybór między alfą 26.3 a starszymi wersjami bez poprawek. Kanał alfa to wczesne buildy, więc zanim przeniesiesz na nie serwer z graczami, przetestuj je na kopii świata. Przy zmianie wersji obowiązują te same zasady co w Paperze: nowy układ folderów świata i brak możliwości powrotu do starszej wersji. Opisujemy je w poradniku aktualizacja serwera do 26.x.

Dla kogo jest Folia

PaperMC wskazuje dwa warunki. Pierwszy to typ serwera: najwięcej zyskują te, na których gracze naturalnie się rozchodzą, jak skyblock albo SMP. Drugi to liczba graczy - powinna być spora. Do tego sprzęt: najlepiej co najmniej 16 rdzeni procesora, i to fizycznych rdzeni, a nie wątków.

Gracze stojący blisko siebie trafiają do jednego regionu, a jeden region liczy jeden wątek. Serwer, na którym wszyscy siedzą na wspólnym spawnie albo jednej arenie, zyska więc mniej. Na małym serwerze dla znajomych korzyść z wielowątkowości będzie znikoma, a problemy z pluginami zostaną. Tam lepiej sprawdzi się zwykły Paper albo jeden z forków Papera, na przykład Purpur.

Sprzęt i konfiguracja wątków

Zacznij od pregenerowania świata, na przykład pluginem Chunky, który ma wersję dla Folii. Według PaperMC mocno zmniejsza to liczbę wątków potrzebnych do generowania chunków.

Potem rozdziel rdzenie. PaperMC podaje bardzo przybliżone wartości z testów przed premierą Folii, na serwerze z maksymalnie około 330 graczami:

• Netty IO (sieć) - około 4 wątki na 200-300 graczy.
• Wątki IO systemu chunków - około 3 na 200-300 graczy.
• Workery systemu chunków przy pregenerowanym świecie - około 2 na 200-300 graczy. Bez pregeneracji nie ma oszacowania: na serwerze testowym 16 wątków przy około 300 graczach wciąż nie wystarczało do szybkiego generowania.
• Garbage collector - wątki współbieżne GC ustawiasz flagą -XX:ConcGCThreads=n. Nie myl jej z -XX:ParallelGCThreads=n, bo te wątki działają tylko podczas pauzy GC i nie liczą się do puli.

Pozostałe rdzenie, tak żeby wszystkie przydzielone wątki nie przekroczyły 80% procesora, oddaj na wątki ticków regionów. Ustawiasz je w config/paper-global.yml, w sekcji threaded-regions, opcją threads. Zapas 20% zostaw dla wątków, które tworzą pluginy i sam serwer, a których nie da się skonfigurować.

threaded-regions:
  threads: 8

Domyślne threads: -1 oznacza automatyczny dobór. Z kodu źródłowego Folii 26.3 wynika, że jest on ostrożny: mniej więcej jedna ósma rdzeni zgłaszanych przez system, ale co najmniej jeden wątek. Na dużej maszynie ustaw więc wartość ręcznie. Wszystkie liczby powyżej to punkt wyjścia - dostrój je, obserwując faktyczne obciążenie wątków.

Pluginy i komendy na Folii

README Folii mówi wprost: oczekiwania co do zgodności pluginów ustaw na zero. Bez głównego wątku praktycznie każdy plugin wymaga jakichś zmian. Dlatego Folia ładuje tylko pluginy, których autor dopisał folia-supported: true w plugin.yml. Plugin bez tej linii nie wystartuje, nawet jeśli na Paperze działa bez zarzutu.

Regiony działają równolegle i nie współdzielą danych, a kod jednego regionu nie może sięgać do danych innego. Autor pluginu zamiast BukkitScheduler używa schedulerów Folii: RegionScheduler, AsyncScheduler, GlobalRegionScheduler i EntityScheduler (przez Entity#getScheduler). Zamiast Entity#teleport jest wyłącznie teleportAsync. Według README nie działa większość API portali i odradzania graczy, część API logowania, całe API tablicy wyników oraz ładowanie i wyładowywanie światów.

Popularne pluginy, które deklarują zgodność z Folią na Modrinth:

Stan na 20 października 2026. Deklaracja na Modrinth to informacja od autora, więc ostateczny test i tak robisz na własnym serwerze.

Folia wyłącza też część komend, m.in. /bossbar, /clone, /data, /datapack, /function, /item, /loot, /reload, /scoreboard, /spreadplayers, /team, /tick, /trigger i /save-all. Pełną listę znajdziesz w FAQ Folii. Jeśli twój serwer korzysta z tych komend, na przykład z tablicy wyników albo z /function, sprawdź to przed przejściem.

Canvas - fork Folii

Canvas (CraftCanvasMC) to fork Folii, który według autorów zawiera ponad 80 poprawek wielowątkowości regionów i dodatkowe optymalizacje. Domyślna konfiguracja stawia zgodność z vanilla na pierwszym miejscu, a wydajność na drugim. Autorzy planują przekazywać swoje poprawki do Folii.

Canvas trzyma patche Folii we własnym repozytorium i aktualizuje się bezpośrednio z Papera, więc może dostać nową wersję Minecrafta wcześniej niż Folia. Tak było z 26.3: pierwsze buildy alfa Canvasa pojawiły się na jego Jenkinsie 21 września 2026, bety na początku października, a od 11 października buildy 26.3 nie mają już dopisku Alpha ani Beta. Folia przeszła na 26.3 dopiero 14 października. Więcej o Canvasie i innych forkach przeczytasz w zestawieniu forków Papera.

Pobieranie i uruchomienie

Folię pobierzesz ze strony papermc.io/downloads/folia. Potrzebujesz Javy 25 - instalację opisujemy w poradniku Java do Minecrafta. Folię uruchamiasz tak samo jak Papera:

java -Xms8G -Xmx8G -jar folia-26.3-3.jar nogui

Ilość pamięci dobierz do swojego serwera. PaperMC podaje dla Folii ten sam zestaw zalecanych flag JVM z G1GC co dla Papera. Flagi Aikara i ustawienia G1GC omawiamy w poradniku o argumentach Javy. Gdy przejdziesz z Papera, sprawdź w konsoli, które pluginy nie wystartowały, i dopiero wtedy wpuść graczy.