Slimefun: kompletny przewodnik po pluginie dla serwera Minecraft 2026

Slimefun4 zamienia zwykły serwer Paper w mini-modpack typu sandbox bez żadnej modyfikacji po stronie klienta. Gracz wchodzi standardowym launcherem Mojanga i dostaje crafty w stylu GregTech, magiczne ołtarze, sieci cargo i dziesiątki maszyn. Poniżej praktyczna ścieżka 2026: instalacja Slimefun4 na Paper 1.21, przeżycie systemu badań i cargo, oraz uniknięcie spadku TPS do 8 w drugim tygodniu sezonu.

Czym jest Slimefun4 i po co go brać

Slimefun4 to utrzymywany fork pierwotnego Slimefun, prowadzony przez TheBusyBiscuit i społeczność od 2019 roku. W 2026 aktywna jest linia RC-38, buildy znajdziecie na Hangar (hangar.papermc.io) i w repo Slimefun/Slimefun4 na GitHubie. Plugin jest w 100% serwerowy, klient niczego dodatkowego nie potrzebuje. Całe UI to vanilla itemy i menu inwentarzowe.

Dlaczego Slimefun ma sens na survivalu albo semi-vanilli:

• Długa progresja. Drzewo badań spokojnie wystarcza na kilkaset godzin, od ulepszonego kilofa do kwantowego teleportera.
• Tech i magia w jednym pluginie. Ołtarze z runami stoją obok elektrycznych pieców i auto crafterów.
• Realne ekosystem dodatków. ExoticGarden daje farming, InfinityExpansion endgame, Soul Jars łapie moby do słoików.
• Brak modów po stronie klienta. Bez Forge, bez Fabrica, bez resource packa wymaganego do podstaw.

Minusy od razu, żeby było uczciwie: Slimefun jest ciężki dla CPU i I/O przez BlockStorage, nie lubi olbrzymich sieci cargo, a folder z danymi rośnie szybko. Sekcja o wydajności poniżej to najważniejsza część artykułu, nie pomijajcie jej.

Instalacja Slimefun4 na Paper 1.21

Baza na 2026: Paper 1.21.x na Java 21 LTS. Stare 1.20 i 1.19 są wciąż formalnie wspierane, ale nowe dodatki i optymalizacje testuje się najpierw na 1.21.

Minimalny stack:

1. Paper 1.21.4 albo nowszy.
2. Java 21 (Temurin, Zulu, Liberica, co woli wasz hosting).
3. Slimefun4 RC-38 albo nowszy z Hangar.
4. Bez CS-CoreLib. Ta zależność została wycięta lata temu. Jeśli jakiś poradnik każe ją instalować, poradnik jest z 2018.

Na typowym Linux dedyku albo VPS u OVH lub na panelu mc.pl:

cd ~/server
wget -O server.jar https://api.papermc.io/v2/projects/paper/versions/1.21.4/builds/latest/downloads/paper-1.21.4-latest.jar
mkdir -p plugins
cd plugins
# Pobierzcie najnowszy Slimefun4 jar z Hangar
# https://hangar.papermc.io/Slimefun/Slimefun4
ls -la Slimefun-*.jar

Start:

java -Xms6G -Xmx6G \
  -XX:+UseG1GC -XX:+ParallelRefProcEnabled \
  -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions \
  -XX:+DisableExplicitGC -XX:+AlwaysPreTouch \
  -jar server.jar nogui

Pierwszy start tworzy plugins/Slimefun/. Zatrzymujemy serwer, zaglądamy do configów, dopiero potem wpuszczamy graczy.

Konfiguracja bazowa: co ruszyć od razu

Główny plik: plugins/Slimefun/config.yml. Klucze, które ustawiam pierwszego dnia:

options:
  auto-update: false
  chat-prefix: "&aSlimefun &7> "
  enable-armor-effects: true
  backwards-compatibility: false
  talismans-actionbar: true

researches:
  enable-researching: true
  free-creative-research: true
  guide-give-on-first-join: true
  use-levels: true

guide:
  default-view-book: false
  show-vanilla-recipes: true

Dlaczego akurat te:

• free-creative-research: true oszczędza adminowi XP, kiedy testuje balans w kreatywie.
• guide-give-on-first-join: true ścina liczbę pytań na czacie. Nowy gracz dostaje guide book w slocie 9 automatycznie.
• use-levels: true zachowuje sens ekonomii badań. Po ustawieniu na false cała progresja się rozjeżdża.
• default-view-book: false przełącza guide w tryb inwentarza. Klikanie jest szybsze niż przewracanie stron.
• auto-update: false na produkcji jest obowiązkowe. Update najpierw na testbox.

Drugi plik wart uwagi: plugins/Slimefun/Researches.yml. Tam nadpisujecie koszt każdego pojedynczego badania. Przydatne, jeśli przy resecie sezonu chcecie podnieść cenę endgame itemów.

Guide book i kategorie itemów

Slimefun Guide to centralne UI plugina. Gracz otwiera księgę i widzi kategorie: Tools, Weapons, Armor, Food, Magical Items, Cargo Management, Electricity i sporo więcej. Każdy item ma wymagany level i koszt w XP.

Komendy admina, których używam codziennie:

/sf guide                       # nowy guide do inwentarza
/sf research <player> all       # odblokuj wszystko (test balansu)
/sf research <player> reset     # wyczyść postęp, sprzątanie po cheaterach
/sf give <player> <item> <n>    # daj dowolny Slimefun item
/sf timings                     # profiler plugina
/sf debug                       # tryb debug do raportowania bugów

ID itemów są w UPPER_SNAKE_CASE: ELECTRIC_SMELTERY, CARGO_NODE_INPUT, ENERGY_REGULATOR. Pełna lista w wiki repo na GitHubie albo przez tryb cheat w configu.

Sieć cargo i energia: jak to działa

Te dwa systemy są najcięższe w pluginie, więc trzeba je rozumieć przed otwarciem serwera dla graczy.

Sieć energii. Trzy role:

1. Generatory: Coal Generator, Solar Generator, Bio Reactor, Nuclear Reactor.
2. Regulator: Energy Regulator. Jeden na sieć, fizycznie połączony z generatorami i odbiornikami przez Energy Connector.
3. Odbiorniki: Electric Furnace, Grind Stone, Auto Crafter i tak dalej.

Energia nie buforuje się w przewodach. Regulator zbiera per tick to, co generatory wyprodukowały, i rozdziela odbiornikom w tym samym ticku. Jeśli chcecie bufor, dorzućcie Capacitor. Skala od Small do Carbonado, miliony J pojemności.

Sieć cargo. Automatyczny przepływ itemów między maszynami Slimefuna i vanilla skrzyniami. Klocki:

• Cargo Manager: mózg, jeden na sieć.
• Cargo Node (Input): pobiera ze skrzyni.
• Cargo Node (Output): wkłada do skrzyni.
• Cargo Connector Node: czyste łącze tranzytowe.
• Advanced Cargo Output Node: filtry po NBT i Slimefun ID.

Każda noda ma numer kanału ustawiony w GUI. Najczęstszy błąd nowicjusza: dwie nody Input na tej samej skrzyni z różnymi kanałami i potem zdziwienie, czemu nic nie płynie.

Typowa mała fabryka: farma drzew sypie do skrzyni, Input node na kanale 1 wciąga dębowe kłody do Electric Smeltery, kanał 2 dowozi węgiel z osobnej skrzyni, Output node na kanale 3 wyciąga gotowy charcoal do skrzyni magazynowej. Kanały rozrysowane na kartce przed budową oszczędzają godziny debugowania.

Rada, która naprawdę oszczędza godziny dłubania: rozrysujcie kanały na kartce albo w Excalidraw, zanim postawicie pierwszą nodę. Sieć 30 węzłów da się utrzymać w głowie, sieć 200 już nie. Gracze, którzy ten krok pomijają, zwykle pod koniec sezonu przychodzą z prośbą o wyzerowanie ich fabryki, bo sami się w niej pogubili.

Jeszcze jeden szczegół: Cargo Manager działa tylko w załadowanych chunkach. Jeśli wasza autofabryka wisi poza zasięgiem per-chunk loadingu, po prostu stoi. Rozwiązanie albo chunk loader z dodatku typu ChrislieChunkLoader, albo umieszczenie fabryk blisko spawnu w chunkach przyklejonych komendą /forceload add.

Popularne dodatki w 2026

Na Hangar i Modrinth jest kilkadziesiąt dodatków o różnej jakości. Lista, którą bym faktycznie zainstalował na świeżym survival serwerze dziś:

Dodatek	Co dodaje	Stabilność 1.21	Kiedy ma sens
ExoticGarden	Owoce, jagody, gotowanie, wino	dobra	Każdy survival z farmingiem
InfinityExpansion	Maszyny i materiały endgame	dobra	Długi sezon, late-game
Soul Jars	Łapanie mobów i crafty spawnerów	średnia	Jeśli vanilla spawnery są nudne
Networks	Bezprzewodowe cargo	dobra	Gdy normalne cargo lagi
FoxyMachines	Dodatkowa automatyzacja	dobra	Szersze mid-game crafty
HotBricks	Bloki dekoracyjne	stabilna	Buildery i kreatyw
RykenSlimefunCustomizer	Custom itemy i przepisy	średnia	Własne mechaniki
GalactiFun	Kosmos i planety	beta	Serwery tematyczne

Każdy dodatek to jar w plugins/. Slimefun podchwytuje je przy starcie automatycznie. Przed każdym minor bumpem Papera sprawdźcie, czy dodatek ma już build pod docelową wersję, inaczej dostaniecie NoSuchMethodError przy bocie.

Wydajność: BlockStorage i AsyncBlockTicker

Najbrzydsza część. Slimefun trzyma własne dane per-block przez BlockStorage. Każdy Slimefun block na mapie to wiersz w pliku YAML pod plugins/Slimefun/data-storage/Slimefun/stored-blocks/. Przy 200k Cargo Connector node w czterech światach macie 200k wierszy w wielu plikach o łącznej wadze setek megabajtów.

Pokrętła, które naprawdę pomagają:

# config.yml
worlds:
  enable-async-block-storage: true

performance:
  type: balanced  # low | balanced | high
  show-hidden-blocks-in-inventory: false
  show-vanilla-recipes-in-guide: false
  show-stats-on-startup: false

performance.type to preset dla AsyncBlockTicker. Slimefun decyduje per tick, ile bloków przerobić, i adaptuje się do bieżącego TPS. Gdy TPS spada poniżej 18, preset low ściąga ticki maszyn zamiast zamrażać cały plugin. Adaptacyjne dławienie wygrywa z twardym freezem zawsze.

Narzędzie drugie: /sf timings. Pokazuje najwolniejsze bloki i dodatki. Jeśli Energy Regulator siedzi na 80% budżetu, macie jedną gigantyczną sieć energetyczną, którą trzeba pociąć na kilka niezależnych.

Narzędzie trzecie: limity rozmiaru sieci cargo w Slimefun.yml. Domyślnie Cargo Manager obchodzi do 5000 nód, co przy dużych fabrykach jest brutalne dla CPU.

# Slimefun.yml
networks:
  cargo:
    max-nodes: 256
  energy:
    max-nodes: 1024

I przypomnienie sprzętowe: Slimefun pisze YAML, a YAML to dyskowe I/O. Na zwykłym HDD poczujecie save lag co kilka minut. NVMe albo przynajmniej porządne SSD jest niepodlegające dyskusji.

Strona pamięciowa. Na dużych światach z ponad 50k Slimefun bloków BlockStorage trzyma cały indeks w RAM. Na sezonie z InfinityExpansion i ExoticGarden plugin sam zjadł 2.4 GB heapa, więc moje 6 GB -Xmx było już naciągane. Planujcie minimum 8 GB i obserwujcie /sf debug pod kątem powolnych wycieków.

Przydatna komenda diagnostyczna: /sf timings paste. Wrzuca raport timings na pastebin Slimefuna i podaje link. Po nim deweloperzy plugina i społeczność realnie potrafią pomóc znaleźć wąskie gardło. Tylko nie udostępniajcie tych linków publicznie bez redakcji, raport często zawiera nazwę serwera i dane IP z plugin sąsiadujących.

Typowe błędy admina

Kolekcja grabi. Każdy raz na nie nadepnął.

• Brak osobnego backupu plugins/Slimefun/data-storage/. Gdy plik stored-blocks się popsuje, wszystkie Slimefun bloki na mapie stają się duchami. Folder backupować osobno od świata, na osobnym cronie.
• Stary Slimefun na nowym Paperze. RC-37 i starsze nie startują na Paper 1.21 przez zmiany w API. Jeśli plugin nie ładuje się, najpierw sprawdźcie świeży build na Hangar.
• Usuwanie Slimefun bloków przez WorldEdit. Region czyści się fizycznie, ale BlockStorage trzyma wpisy. Powstają niewidzialne maszyny-duchy. Używajcie /sf clear albo dodatku Slimefun-WorldEdit-Support.
• Brak ochrony regionów. Cargo Manager na nieobjętej działce to cel. Jeden cios kilofem od griefera kasuje całą fabrykę. WorldGuard albo GriefPrevention obowiązkowe.
• Ignorowanie /sf timings po pierwszym miesiącu. Serwer narasta maszynami wykładniczo. Czytajcie timings co tydzień, szczególnie po instalacji InfinityExpansion.
• Auto-update na produkcji. Świeże RC czasem regresują. auto-update: false i ręczny update po teście.
• Wspólne XP z innym pluginem leveli. Przy CombatLevels, MyXp i podobnych koszty badań zjadają tę samą pulę. Rozwiązanie: use-levels: false albo waluta z dodatku.

FAQ

Czy Slimefun4 wymaga CS-CoreLib?

Nie. CS-CoreLib było zależnością Slimefun 3, wycięte wiele wydań temu. Jeśli jakiś poradnik z 2026 każe go instalować, poradnik jest przestarzały. Slimefun4 RC-38 to pojedynczy jar.

Czy Slimefun pójdzie na Spigocie zamiast Paper?

Technicznie tak, w praktyce nikt tego nie robi. Paper daje async chunk loading i sporo optymalizacji, na których Slimefun pod obciążeniem polega. Każdy nowoczesny tutorial i sami opiekunowie Slimefuna celują w Paper, z osobnym forkiem pod Folię, którego status śledzicie w issue trackerze repo.

Slimefun zżera 100% CPU. Co teraz?

Najpierw /sf timings i /timings paste z Papera. Znajdźcie top pięć kosztownych bloków. Najczęściej to spuchnięte sieci cargo albo Nuclear Reactor bez właściwego coolanta. Zmniejszcie max-nodes, przełączcie performance.type na low, sprzątnijcie bazy długo nieaktywnych graczy.

Czy Slimefun konfliktuje z ItemsAdder albo Oraxen?

Slimefun żyje obok ItemsAddera i Oraxen bez kolizji ID itemów, bo Slimefun trzyma tożsamość przez PersistentDataContainer, nie przez CustomModelData. Tarcia pojawiają się tylko, gdy oba pluginy chcą obsłużyć ten sam event kliknięcia w blok. Regulujcie priorytety eventów albo rozdzielajcie zawartość na osobne światy.

Jak wyczyścić postęp graczy na nowy sezon?

/sf research <player> reset

Masowo: po backupie usuńcie YAML w plugins/Slimefun/data-storage/Slimefun/Players/: find . -name '*.yml' -delete. Gracze zachowają inwentarze, stracą postęp badań.

Czy Slimefun chroni przed atakami DDoS?

Oczywiście nie, to plugin gameplayowy. Ochrona sieci dzieje się na perimetrze. Serwery z dużą Slimefun bazą rosną szybko i przyciągają uwagę, też tę niepożądaną. Filtr taki jak MineGuard siedzi przed serwerem właśnie dlatego. Slimefun nie zastępuje DDoS protection, on zwiększa potrzebę jego posiadania.

Gdzie szukać dokumentacji i ID itemów?

GitHub Slimefun/Slimefun4, zakładka Wiki. Itemy, maszyny i API dla dodatków są tam udokumentowane. Modrinth i Hangar dają tylko jar i krótki opis. Pełna referencja jest w wiki.

Czy mogę uruchomić Slimefun na BungeeCord lub Velocity?

Slimefun żyje na pojedynczych instancjach Papera. Pod Bungee albo Velocity jako proxy nie wkładacie tam plugina, on siedzi na każdym backend serwerze osobno. To ważne, bo postępy badań i bloki są lokalne dla danej instancji. Jeśli macie sieć z lobby plus survival plus creative, Slimefun stawiacie tylko na survivalu, a synchronizację XP graczy ogarniacie przez plugin typu MysqlPlayerDataBridge.

To jest fundament. Slimefun4 startuje w pół godziny, ale strojenie pod żywą bazę graczy zjada tydzień eksperymentów. Dwie zasady, do których wracam: backup data-storage osobno od świata, czytanie /sf timings co tydzień. Trzymając się obu, plugin wytrzyma sezon, dwa, dziesięć.