Installation (Windows)

Prefer step-by-step instructions? Open the interactive guide to installation, updates and settings. You choose a computer or a VPS and get instructions for your own installation.

Where to download the game

Full packages are available for download on Discord: metin2sp.pl/discord. There are two versions:

  • MT2009 PLUS Yohara (3.x) – the main version; all new content goes only to it. A separate server package and game client; new versions arrive automatically from the supporters’ hub (the supporter code in the launcher) or as patches.
  • MT2009 PLUS 2.x – now receives bug fixes only. One full package (the Serwer folder and the Klient folder); the launcher downloads updates from GitHub by itself. A 2.43 server can move to Yohara with the UPGRADE TO YOHARA button („AKTUALIZUJ DO YOHARY”).

Don’t want to set up your own server? The YOHARA community server is open to everyone: sv.metin2sp.pl.

Both versions need a full package for the first installation. You cannot install the game from scratch using update files:

  • in 2.x – from the *-update-*.zip files on the Releases tab on GitHub (the launcher downloads them by itself; if you unpack such a file as a new server, the launcher will tell you it is an update, not an installation),
  • in Yohara – from the patches (…-latka-…zip), which only update an existing server or client (Updates).

What you need

  • Windows 10 or 11 (64-bit) with virtualisation enabled (in the BIOS/UEFI: Intel VT-x or AMD SVM).
  • Docker Desktop.
  • Free space on the system drive – Docker keeps its images on drive C:, even when the server is in another folder (Hardware requirements).
  • The full package of your chosen version (server and game client).

Docker won’t start and complains about virtualisation? See Problems and FAQ – it has a script that fixes this.

Step by step

  1. Install and run Docker Desktop. Wait until a green Engine running appears at the bottom left.
  2. Unpack the package into a new, empty folder, preferably with no Polish characters or spaces in the path, e.g. C:\Metin2Mod\ (2.x) or C:\MT2009-Yohara\ (Yohara).
  3. Run Metin2-Launcher-GUI.bat from the server folder (in the 2.x package: from the Serwer folder).
  4. Click 1. INSTALL / PREPARE, then 2. PLAY. If the launcher cannot find the client by itself, point it to the client folder with the CHOOSE CLIENT button. Before the first start, the Yohara launcher also asks for the server’s default language. The first run takes from a dozen to several dozen minutes – Docker builds the server and creates the database with bots. Do not close the launcher meanwhile.
  5. Log in to the game with the account admin / password admin (four GM characters) or create your own account (FAQ).

After startup, the following work in your browser:

Address What it is
http://127.0.0.1:7788 classic panel and the bots map (/map)
http://127.0.0.1:7790 advanced panel (Seban Panel): players, DC, rankings, economy, Database Editor
http://127.0.0.1:7791 ItemShop

Windows blocks the game’s exe file? See Problems and FAQ.

Yohara: a separate installation and a separate world

  • The Yohara server has its own Docker images – they cannot be confused with the images of another server version or be replaced by them.
  • Every unpacked server folder is a separate world with its own database – the launcher gives it its own name in Docker. A new installation in a new folder starts with an empty world.
  • Do not unpack the package into the folder of another server. If another server is running on your computer, stop it first (STOP AND SAVE or stop.bat) – both use the same ports.

Updates

  • MT2009 PLUS 2.x: the launcher checks for updates by itself at startup (or CHECK FOR UPDATES), and the client is updated by MT2009-Patcher (UPDATE CLIENT).
  • Yohara: automatic updates are switched off in the package – new versions arrive as server and client patches. Do not run MT2009-Patcher there.

More: Updates.

Change history

Yohara releases that changed what this article describes:

All news

See also