Mir 4 - Official Public Topaz Source

[](https://github.com/JevLOMCN/mir4/releases/latest) [](LICENSE)    

Topaz Mir 4 is an open-source implementation of the official Legend of Mir 4 server code that empowers community organizers, modders, and hobbyists to spin up their own private Mir 4 server in minutes. Built directly from the official sources for maximum compatibility, using MySQL for data storage and JSON files for server configuration, with simple setup scripts and detailed guides/wikis. Its friendly architecture lets you tweak rates, items, stats, and more, while an active LOMCN community provides a hub for sharing setups, reporting bugs, and collaborating on new features. No NFTs. No crypto. Just a clean, moddable Mir 4 experience built by and for the community. Dive in to explore, customize, and host your personalized Legend of Mir 4 experience today!

> [!IMPORTANT] > Server Source is NOT available at this time. Please stand by for us to Open Source it. > [!WARNING] > Anyone claiming to have the Mir 4 Source code is trying to scam you! [Never buy files](https://forum.ragezone.com/threads/stay-safe-list-of-known-mmorpg-scammers-and-fake-file-sellers.1233633/). --- ## 📦 Codebase Composition | Source | Lines of Code | Share | | :-------------------- | ------------: | ---------: | | **WEMADE (Original)** | **308,737** | **3.46%** | | **Topaz Project** | **8,926,627** | **96.54%** | > ### 📈 Project Evolution > > Although this project began with the leaked 2019 WEMADE server source, years of development have transformed it into a substantially new codebase. > > Today, **over 96% of the repository consists of new or heavily modified code** written by the Topaz team. This work includes: > > * 🏗️ Rebuilding missing server systems from scratch > * 🎮 Implementing game systems introduced between the **2021 global release** and the **2026 client** > * 🌐 Extensive networking and protocol updates > * 🖥️ Server architecture improvements and refactoring > * 🗄️ Database redesigns and optimization > * 🔒 Security enhancements and anti-exploit measures > * 🐞 Thousands of bug fixes, stability improvements, and performance optimizations > > Many core systems simply did not exist in the original leaked source and had to be recreated through reverse engineering, research, and implementation to achieve compatibility with the modern MIR4 client. > > The remaining **3.46%** represents original WEMADE source that remains largely unchanged. > > *Statistics exclude generated files, binaries, third-party libraries, metadata, and configuration files.* --- > **Fun fact:** The Topaz codebase is now approximately **29× larger** than the original WEMADE source it was built upon. --- ## 📂 Folder Structure - [**Tools**](/Tools) A collection of useful MIR4 tools, ranging from premade websites to client editors. - [**mir4-client-launcher**](/mir4-client-launcher) An optional client launcher, designed to look and feel like the official MIR4 launcher. - [**mir4-db-sps**](/mir4-db-sps) Complete MIR4 server database exports, including all schemas and stored procedures. - [**mir4-server-console**](/mir4-server-console) An optional server launcher with quick-edit tools for live tweaking. - [**mir4-server-jsons**](/mir4-server-jsons) Full set of MIR4 server JSON configuration files. ---

🔗 Quick Links

Everything you need to access, learn, and manage the project in one place. --- ### 🌐 Official Resources

🌐	Official Project Site
🌐	Test Website
📖	Server Wiki
📖	Server Database
	Mir4 Tools
	Discord
▶️	Server Setup Guide (YouTube)
📚	Server Setup Guide (Written)

### 💬 LOMCN Community

📚	Tutorials
📦	Releases
🐞	Bug Reports
💬	Help
🛠️	Updates

--- ## Dependencies | Component | Supported OS | Required Packages & Links | |------------------------|---------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Server (Windows)** | Windows 10+ Windows Server 2016+ | - [MySQL Community 8.0.42](https://dev.mysql.com/downloads/installer/) - [Couchbase Community 7.2](https://packages.couchbase.com/releases/7.2.0/couchbase-server-enterprise_7.2.0-windows_amd64.msi) - [Memurai](https://www.memurai.com/get-memurai) - [Windows Terminal](https://aka.ms/terminal) - [Microsoft Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170) | | **Server (Linux)** | Ubuntu 18.04+ / CentOS 7+ | - [MySQL Community 8.0.42](https://dev.mysql.com/downloads/installer/) - [Couchbase Community 7.2](https://docs.couchbase.com/server/current/install/install-linux.html) - [Memurai](https://www.memurai.com/get-memurai) | | **Client (Windows)** | Windows 8.1 / 10 / 11 | - [DirectX Runtime](https://www.microsoft.com/en-us/download/details.aspx?id=35) - [.NET Desktop Runtime](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-desktop-8.0.15-windows-x64-installer) | | **Optional** | — | - cPanel (Website) - [Unreal Engine 4.24.3](https://docs.unrealengine.com/4.24/en-US/) - [Plugins List](https://mirfiles.com/resources/mir2/users/Jev/Mir%204/MirMobile.upluginmanifest.txt) | --- ## Compatibility | Function | Windows | Linux | MacOS | Required | |--------------------|---------|-------|-------|----------------| | Servers | ✔️ | ➖ | ➖ | ✔️ | | Client | ✔️ | ➖ | ➖ | ✔️ | | Server Console | ✔️ | ✔️ | ✔️ | ❌ | | Client Launcher | ✔️ | ❌ | ❌ | ❌ | | Website | ✔️ | ✔️ | ✔️ | ❌ | **✔️** = Supported | **➖** = To be tested | **❌** = Not supported ---

👨‍💻 Development Team

Jev      Meacher      1PKRyan Wagner      BughyT      Chriz CodePwr ---

🤝 Contributors

Netskee 🎨 Graphic Design	Firev2 (AboveYou) 📦 Client & Server JSON Sourcing	Mental 🤝 Outsourcing, Sponsorship & Advertising
Gurgel 🎬 Art, Videos & Graphics	carolyangbb 🤖 GVAS Logic & Bot Research	Treffy 🛠️ Mir4Tools & Bot Collaboration
Sumiao 🖥️ Server Console Integration	S4oul 💻 C++ Development	cmb 💻 C++ Development
Hells 👥 Outsourcing Developers	manniL 📚 Operates Mir4.Wiki Documentation & Community Resources	Community Contributors ❤️ Everyone who has contributed

---

Other Projects

	Mir 1 • Project • Database Remake of ActozSoft's 1997 The Legend Of Mir 1
	Mir 2 • Project • Database • Map Editor Remake of ActozSoft / Wemade Entertainment's 1999 The Legend Of Mir 2