Problemy i FAQ – najczęstsze błędy i rozwiązania

Problemy, z którymi gracze najczęściej przychodzą na Discorda – z gotowymi rozwiązaniami. Gdy rozwiązanie zależy od wersji, opis jest osobno dla MT2009 PLUS 2.x i dla Yohary (3.x). Jeśli twojego problemu tu nie ma, przejdź do sekcji Zgłoś problem.

Nigdy nie używaj docker compose down -v. Opcja -v usuwa wolumeny, czyli całą bazę: konta, postacie i boty. Do zatrzymania serwera wystarczy przycisk w launcherze albo docker compose down bez -v.

Docker: „Virtualization support not detected”

Komunikat „Docker Desktop failed to start because virtualisation support wasn't detected” pojawia się, gdy wirtualizacja jest wyłączona w BIOS-ie albo gdy w Windows nie są włączone i zaktualizowane Platforma maszyny wirtualnej i WSL 2 – to częste nawet przy włączonym BIOS-ie.

Szybko: skrypt Docker_WSL2_SMART

Pobierz Docker_WSL2_SMART.zip

Skrypt sprawdza wirtualizację i start hypervisora, włącza potrzebne składniki Windows, instaluje albo aktualizuje WSL do wersji 2 i mówi, co zrobić dalej. Niczego nie kasuje, nie restartuje komputera sam i nie zmienia BIOS-u.

  1. Rozpakuj zip i uruchom Docker_WSL2_SMART.bat. Zgódź się na uprawnienia administratora.
  2. Skrypt sprawdzi i skonfiguruje system. Jeśli instalator WSL o coś zapyta, odpowiedz w tym samym oknie.
  3. Gdy zobaczysz [RESTART] – zapisz pracę, uruchom Windows ponownie i odpal ten sam plik jeszcze raz.
  4. Po [OK] uruchom Docker Desktop.

Wymaga Windows 10/11 build 19041 lub nowszego. Log przebiegu: %LOCALAPPDATA%\DockerWSL2Setup\Logs – dołącz go przy zgłoszeniu problemu.

Ręcznie

  1. W BIOS/UEFI włącz Intel Virtualization Technology (Intel) albo SVM Mode (AMD).
  2. W Windows wyszukaj „Włącz lub wyłącz funkcje systemu Windows” i zaznacz Platforma maszyny wirtualnej oraz Podsystem Windows dla systemu Linux. Uruchom ponownie.
  3. W PowerShell jako administrator: wsl --update i wsl --set-default-version 2.

Dokładniej, krok po kroku: FAQ – Docker i wirtualizacja albo interaktywny poradnik (zadanie „Docker i wirtualizacja”).

Instalacja na Windows

Windows blokuje plik exe gry (Metin2Distribute.exe)

Komunikat SmartScreen / Inteligentnej kontroli aplikacji to fałszywy alarm Windows 11 dla plików bez firmowego certyfikatu.

  1. Prawy przycisk na pliku exe gry (np. Metin2Distribute.exe) → Właściwości → na dole zaznacz Odblokuj → OK.
  2. Zabezpieczenia Windows → Ochrona przed wirusami i zagrożeniami → Zarządzaj ustawieniami → Wykluczenia → Dodaj wykluczenie → Folder → wybierz folder klienta.

Jeśli antywirus usunął plik przy rozpakowywaniu, dodaj wykluczenie i rozpakuj paczkę jeszcze raz.

„To paczka aktualizacji, a nie instalacja”

Rozpakowałeś plik aktualizacji jako nowy serwer – w 2.x plik *-update-*.zip z zakładki Releases na GitHubie, w Yoharze łatkę (…-latka-…zip). Z nich nie zainstalujesz gry od zera. Pobierz pełną paczkę z Discorda i zainstaluj ją: Instalacja (Windows). Aktualizacje 2.x launcher pobiera potem sam, a łatki Yohary wgrywa się na działający już folder serwera (Aktualizacje).

Pierwsze uruchomienie trwa bardzo długo

To normalne: Docker buduje serwer i tworzy bazę z botami, co trwa od kilkunastu do kilkudziesięciu minut. Nie zamykaj launchera. Na VPS pierwsza budowa trwa 15–40 minut. Dłużej trwa też pierwszy start po większej aktualizacji 2.x i po wgraniu łatki Yohary – serwer przebudowuje się sam.

Budowanie serwera (Docker)

„failed to compute cache key” albo „snapshot … does not exist”

Uszkodzona pamięć podręczna budowania Dockera. Wyczyść ją i zbuduj serwer ponownie:

docker builder prune -af

Na Windows potem uruchom ponownie Docker Desktop, na Linuksie systemctl restart docker. Baza danych zostaje.

„no space left on device”

Skończyło się miejsce na dysku. Usuń stare warstwy budowania i nieużywane obrazy:

docker builder prune -af
docker image prune -af

Nie usuwaj wolumenów (docker volume prune, down -v) — tam jest baza. Na VPS sprawdź miejsce poleceniem df -h.

Baza danych „unhealthy” albo „nie mogę połączyć się z bazą”

W launcherze kliknij NAPRAW DOSTĘP DO BAZY. Jeśli to nie pomoże, użyj DIAGNOSTYKA i wyślij logi (niżej). Więcej: Baza danych i pliki serwera.

Aktualizacje

Jak zaktualizować serwer?

  • MT2009 PLUS 2.x: SPRAWDŹ AKTUALIZACJE w launcherze (launcher sprawdza je też sam przy starcie); na Linuksie sudo sh linux-port/tools/update.sh run albo sudo sh linux-port/tools/vps-install.sh update.
  • Yohara: łatką serwera – zatrzymaj serwer, skopiuj zawartość łatki do folderu serwera i kliknij GRAJ (na Linuksie sudo sh linux-port/tools/vps-install.sh install).

Postacie i baza zostają. Pierwszy start po aktualizacji buduje serwer na nowo, co może potrwać kilkanaście minut – nie zamykaj okna. Więcej: Aktualizacje.

Nie widać nazw przedmiotów albo nowe przedmioty nie mają ikon

Klient jest starszy niż serwer albo ma stare dane przedmiotów.

  • 2.x: zaktualizuj klienta – AKTUALIZUJ KLIENTA w launcherze albo MT2009-Patcher, który pobiera też dane przedmiotów twojego serwera.
  • Yohara: wgraj brakujące łatki klienta. Nie uruchamiaj MT2009-Patchera.

Gdy to nie pomoże, w panelu pobierz pliki klienta z Edytora bazy danych i rozpakuj je do folderu gry (Aktualizacje).

Yohara: „Wymagana aktualizacja klienta gry przez Patcher.”

Serwer Yohary odrzuca zbyt stary klient. Wgraj na klienta wszystkie łatki klienta po kolei — nie uruchamiaj MT2009-Patchera, bo nadpisałby pliki klienta Yohary. Zobacz Aktualizacje.

2.x: wierzchowiec pisze „już jesteś na koniu” albo pet się nie przywołuje

Zaktualizuj serwer do 2.9.0 lub nowszego – naprawia to na serwerach zainstalowanych ze starszej paczki (Wierzchowce).

Gra i połączenie

Klient wisi na „łączenie z serwerem” (VPS)

Serwer nie zna swojego publicznego adresu albo klient wskazuje zły adres. W ustawieniach serwera wpisz publiczny adres IP albo domenę VPS (M2_PUBLIC_ADDRESS; adres sprawdzisz poleceniem curl -4 ifconfig.me) i uruchom serwer ponownie. Klient musi łączyć się z tym samym adresem. Opis: Instalacja na Linuksie / VPS.

Na nowej instalacji kanał CH1 jest OFF

Zatrzymaj serwer (ZATRZYMAJ I ZAPISZ) i kliknij GRAJ jeszcze raz. W 2.x na instalacji ze starszej paczki najpierw zaktualizuj serwer. Jeśli to nie pomoże, wyślij logi (niżej).

Czarny ekran i powrót do logowania przy wejściu na mapę

Gra laguje na VPS

Sprawdź obciążenie poleceniem top. Wysoka wartość st (steal) oznacza, że dostawca VPS daje mniej procesora, niż obiecuje — pomoże zmiana planu albo dostawcy. Możesz też zmniejszyć liczbę botów albo przenieść ich część na drugi kanał: Metin2 boty AI, wymagania sprzętowe.

Panel WWW nie otwiera się na VPS

Panele działają tylko lokalnie na serwerze (127.0.0.1), żeby nikt obcy się do nich nie dostał. Połącz się przez tunel SSH, np. ssh -L 7790:127.0.0.1:7790 root@ADRES_VPS, i otwórz http://127.0.0.1:7790 u siebie. Opis paneli: Panele WWW.

Częste pytania

Gdzie założyć postać, żeby grać z botami? W dowolnym królestwie – boty grają w Shinsoo, Chunjo i Jinno.

Jakie jest konto testowe? Login admin, hasło admin – cztery postacie GM. Jeśli hostujesz COOP, launcher zmieni to hasło (Zabezpiecz konta).

Jak zobaczyć boty na mapie w przeglądarce? OTWÓRZ PANEL WWW w launcherze albo http://localhost:7788/map.

Więcej pytań o grę: FAQ – najczęstsze pytania.

Zgłoś problem

Serwer albo gra nie startuje:

  1. W launcherze kliknij DIAGNOSTYKA.
  2. Kliknij ZBIERZ / WYŚLIJ LOGI – powstanie zip z logami, hasła są w nim zamazane.
  3. Wyślij go na Discordzie w kanale błędy i bugi z opisem: co robiłeś, co się stało, wersja serwera (plik VERSION; 2.x czy Yohara).

Błąd w grze: zgłoś go na Discordzie w kanale błędy i bugi: co robiłeś, na jakiej mapie, nazwa przedmiotu albo potwora, najlepiej ze zrzutem ekranu.

Zobacz też: FAQ · Aktualizacje · Kopia świata.