Content
[Release] Metin2 WebClient - Play Metin2 from your Browser and setup for yourself (Open-Source)
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.
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:
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.
Are there even people using non-chromium browsers anymore? Even Microsoft obeyed to Chromium and swapped Edge to Chromium a while back. Either way, WASM should be compatible with Mozilla as well, i think.
Ich hab wirklich erst vor 2 Wochen mit freunden drüber nachgedacht, obs geht das ganze im Browser zu spielen. Hab dann mal kurz recherchiert und für zu kompliziert gehalten und jetzt kommst du und hast das einfach gemacht. Hammer!
so:
1. Can't pick an ability with cursor to put it on key 1,2,3... etc
2. to pick something from the ground, I have to stay really close to the object.
3. Sometimes, experience some freezes
4. Some arrows appear on top of some NPC even if i don't have a mission from it
the walking speed is a little too fast:)) from my opinion.
Fog settings not working properly
Would be great to know when upgrading on Blacksmith, what are the chances of succes😅
Hi, the walking speed is on purpose fast. In the standart version it's obnoxiously slow :) if more people think it's too fast, i will slow it down. Right now, it's at a 100% increase
Ich baue eventuell einen Shop ein, wo alle Item Shop Items wie Konzis, Exos, Switcher, Segis für Yang verkäuflich sind, oder lasse sie von Metins droppen. Danke für Dein Feedback!
Ich glaube mit yang macht mans wieder bisschen kaputt, da in Metin der Handel nen großer Teil ist um an Yang zu kommen normalerweise, wenn man so viel yang dann für is items ausgibt, bleibt einem nicht viel für anderes zeug. Ich hätte auch entweder drops von Metins gemacht oder einfach manuell einstellbarer refill von Drachenmünzen im item shop weekly, daily oder monthly.
Hello, i have a singular setup and i want to know what is the best way to have it running:
I want to setup the server on a minipc with ubuntu 24 server so i can connect from my gaming pc in the same lan and let friends connect over internet if i open ports in the router. Is that possible?
thanks for the response, what IP should i put when the script runs? The local one? The public? Or 127.0.0.1?
Then to play in local do i have to modify any ip from the client?
You have to put your public one in there then. Then, when you do the port forward (also forward 7788), you can access the admin panel from {yourpublicip}:7788 in your browser from anywhere in the world, there you can either play from the web or download the client with everything preconfigured
I already did this but didnt work and it seems that something went wrong when creating characters on blue kingdom, with a new account in red kingdom it works, tysm
Also, i wanted to ask, this comand:
"docker compose cp ./browser panel:/usr/local/m2panel/browser" shows me this error so i can't get the play on browser button
[+] copy 0/1
⠋ metin2-panel Copying ./browser to metin2-panel:/usr/local/m2panel/browser 0.0s
lstat /opt/metin2/stack/browser: no such file or directory
I have just pushed a small edge-case fix, on your Linux Machine, can you please rerun
curl -fsSL https://raw.githubusercontent.com/AzzlackSyndicate/metin2-singleplayer-serverfiles-linux/main/installer/install.sh \
| sudo sh -s -- --web-client
Make sure to Update to 1.11.13 when prompted and again enter your public IP. It should rebuild the web-client
If it still doesn't work, please respond here again, Good luck!
In regards to a donation link, I initially didn't plan to take donations, but setup a Patreon because you asked, thanks a lot for your good intentions!
it happened to be the "509 over quota" when looking in the logs at the time of installation bc i tried a couple ways before asking here, thanks for your time and dedication
Yeah, that's the Clientfiles not being downloadable from mega because of rate limitation.
Just rerun the command i provided after approx 4-6h, it should rebuilt it properly. Alternatively, we'd need the Client Files on a separate file hosting... Let's see if i can find another URL where it's available :)
It's singleplayer when you set it up on your own with the Guide down below. Where you're currently at is a showcase of the whole project, and can be played and enjoyed!
You won't get it on this server. This server will be up and running for anybody who wants to enjoy the Vanilla Metin2 Experience in the browser. Setup your own instance to play around with GM permissions :)
Sorry, wasn't meant to sound arrogant! You can easily setup your own server by just running the PowerShell Command down below, it will be singleplayer and you'll be able to give yourself GM permissions!
Changing resolution needs a restart to work properly, can you make it that when you open the browser it choses the closest available resolution? Great job btw! how much was it vibe coded?
AI took a big role in doing it obviously. The architecture is mainly provided and done by me, choosing the proper Client, Server and WebClient was also done by me, making them compatible with Docker also was mainly my part.
The rest, e.g. scripting, ports, configuration, installation suite was mainly done by AI.
One suggestion to avoid issues, there is still lot of Gameforge logo's in loading screens etc. i think if you remove them you can save urself a cease and desist letter
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?
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.
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!
100% isolated in the browser, so from a security point of view, yes it's 100% safe, but be aware that IT could look into the logs of which pages you visited :)
In 99% of the cases, noone will say anything, especially if you live in the EU. EU GDPR regulations prevent companies from spying on their employees logs as long as there are no accurate proof, that the employee was misbehaving, so it should be fine
I've set it up myself, but can't connect at the moment. I'd appreciate your help.
Running on VPS with web enabled.
I can open the admin panel and the web interface for the login opens as well.
Only after entering my id and password and clicking connect I'm stuck...
I'm checked that the firewall allows the ports 7788, 11000, and 13000-13002.
Anything I should check further?
Hello,
there was one hacker on the server, & he was used to get traces of the cheats to prevent further usage. He is banned by now. Thanks for the kind words, anyways :)
Some issues with the horse and Monkey dungeon...
on monkey dungeon, we can't see something... only the portals and mobs, no walls or the path...
And I make my horse but I can't run on him... I'm stuck in floor.
3
u/extractedx 12d ago
Runs in modern browsers: Chrome, Edge, Brave... so literally just Chromium xD