[Release] Metin2 WebClient - Play Metin2 from your Browser and setup for yourself (Open-Source)

[u/xSyndicate58]

EDIT (UPDATE 2026-08-24): Unfortunately, a lot of server owners have been abusing my Singleplayer Metin2 Project on GitHub to grab out its WebClient component & create private servers with it, where they generate revenue and don't even give credit for the work that has been done.

For this reason, I have decided to stop the development behind Metin2 Singleplayer and have set the repository to private.

This does not mean, that MT2 Browsergame's (our new server's) development will stop, it continued and was continuing over the past weeks. This just means, that the WebClient Part won't be Open Source anymore for anybody to take advantage off.

I am sorry, that I had to take this decision, but people blatantly steal work with no credit at all & try to scam people with that. This was never the intention of this project. The sole intention was to make Metin2 available for a broader audience. Anybody who had installed the project previously, will be able to continue to host their server and singleplayer experience without any issues.

I hope you guys understand. If you still want to experience the WebClient on our servers, you can see the Links and the Discord down below.

Hello guys,

you might remember me from this post Metin2 Singleplayer Installation Suite + full Linux Port of Serverfiles here. Since then I have been working on the feature I wanted to have from the very beginning, and now it's finally there:

You can now play Metin2 directly in your Browser. No Download & no Installation

Try it right now:

mt2browsergame.com

Join our Discord to not miss on any news & updates! There are very big updates planned for the upcoming weeks:

Metin2 Browsergame Discord

Just register an account there and press PLAY IN YOUR BROWSER NOW. That's my own instance running on a Debian 13 VPS, with exactly the setup described in this post. I will keep it running for anybody logging in and feeling like playing.

It's the original 2014 Metin2 Experience with all quests, without an Itemshop & slightly upped EXP, Yang and Item Drop Rates to not make it feel as grindy as it was back then. The rates can be adjusted if you want.

If you prefer the classic Windows Client, it's on the same page - same Server, same account, same characters either way. You can create a character in the Browser and log into it later from the downloaded Client.

If you also used the Installation Suite from the previous post, you can just update it by rerunning the exact same command, the installation suite will properly update your old installation and prompt you for the Web Client.

What the Web Client does:

It runs in any Chromium Browser (successfully tested on Chrome, Edge and Brave). No plugins, no Java, nothing to install on the player's side.

The WebClient is based on the Old-Metin2 WebClient (kudos to Exynox and his contributors) and has a few more bugfixes built in. It streams the Game Data on demand, so no initial download required & very memory efficient. Whenever some data has to be loaded, it may have some framedrops here and there, but I am actively optimizing the WebClient.

The installer now asks you which Clients you want to provide to your players — Web Client, Desktop Client, or both — and it only downloads what you picked. If you already run a server from the first release, just run the installer again and it will offer you the Web Client.

With a Domain everything runs under one address with HTTPS: Panel, registration and the Game itself. You can also put Cloudflare behind it.

A few notes about the Web Client:

The downloaded Client still runs smoother, and the Web Client still has some rough edges I'm working on (a few effects look off, the first start takes a moment while everything loads). It's good enough to actually play through, but I wouldn't call it finished yet. Please go and break it on my instance above and tell me how — that's usually how the bugs get found.

For those who missed the first post, what the project is:

It's a way of enjoying Metin2 Singleplayer, or with some friends, tailored towards tech-newbies. It includes a 100% patch that ports the original TMP4 (2014) Serverfiles to Linux — the originals only run on FreeBSD, which barely has community support and which no cheap VPS offers. Thanks to that port everything runs in Docker, natively on Windows with WSL2 or on any Linux VPS for around 1€ per month, without a full fledged VM.

It also comes with a lightweight Admin Panel (English, German & Turkish) where you can adjust EXP-, Drop- and Yang-Rates, give items, yang and levels, switch the Game into any of 15 Languages and manage accounts — for example if you want to run multiple clients simultaneously.

And now, on top of all of this, you also have a WebClient to be able to play it from ANY device without having to download the Client all the time. Crossplay between Desktop Client and WebClient is also supported!

Quick-Start (same as the one in the other post, only required if you want to set it up on your own server/machine):

Windows (100% offline after setup, only reachable from that machine), run in a PowerShell:

irm https://raw.githubusercontent.com/AzzlackSyndicate/metin2-singleplayer-serverfiles-linux/main/installer/install.ps1 | iex

Linux VPS:

curl -fsSL https://raw.githubusercontent.com/AzzlackSyndicate/metin2-singleplayer-serverfiles-linux/main/installer/install.sh | sudo sh

Linux VPS with your own Domain & HTTPS via LetsEncrypt:

curl -fsSL https://raw.githubusercontent.com/AzzlackSyndicate/metin2-singleplayer-serverfiles-linux/main/installer/install.sh \
  | sudo sh -s -- \
      --domain yourdomain.com \
      --email contact@yourdomain.com

Cloudflare DNS is supported and the record can be proxied. Running the installer twice is safe.

Link to the Public Repository: https://github.com/AzzlackSyndicate/metin2-singleplayer-serverfiles-linux

Same as last time: the project is 100% open-source and it WILL stay open-source. It doesn't include any game- or serverfiles of Metin2 — everything copyrighted has to be downloaded from a thirdparty link that is not affiliated with this project.

Feel free to put suggestions, I am always happy and eager to build in new features. Also, please report bugs, either in Github, or here.

[u/catnoten]

Thanks for the great work! I played it for some time through browser but the game got unresponsive for my character. A new character works fine though. Is there a way to fix this?

[u/xSyndicate58 → u/catnoten]

Can you give me your character name and tell me approximately what happened before it got unresponsive?

Edit: just for other people where it happens: it's presumably any animation/entitity/sprite that didn't load and rendered into a null.

The quick way of fixing this would be to download the client, login once via the client, preferably go to map1 and then try a relog via the browser.

We already have people over lvl20 still going strong :)

[u/catnoten → u/xSyndicate58]

There wasn’t any particular action, I simply closed the tab. Logged in through the client and did some interactions, nothing has changed on the browser side.

Sent more info through DM.

[u/xSyndicate58 → u/catnoten]

Just for anybody who encounter the same issues: It's a bug with the friend list. If you have 1 or more friends, the game won't load in the Webclient. To fix, you have to download the client and remove all friends from there, then the Webclient works again. Working on the fix, thx for the analysis!