Skip to content

JevLOMCN/mir4

Repository files navigation

Mir 4 - Official Public Topaz Source

Latest Release License: GPL v2 Build MySQL C++ Discord

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.


📦 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
    A collection of useful MIR4 tools, ranging from premade websites to client editors.
  • mir4-client-launcher
    An optional client launcher, designed to look and feel like the official MIR4 launcher.
  • mir4-db-sps
    Complete MIR4 server database exports, including all schemas and stored procedures.
  • mir4-server-console
    An optional server launcher with quick-edit tools for live tweaking.
  • 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
- Couchbase Community 7.2
- Memurai
- Windows Terminal
- Microsoft Visual C++ Redistributable
Server (Linux) Ubuntu 18.04+ / CentOS 7+ - MySQL Community 8.0.42
- Couchbase Community 7.2
- Memurai
Client (Windows) Windows 8.1 / 10 / 11 - DirectX Runtime
- .NET Desktop Runtime
Optional - cPanel (Website)
- Unreal Engine 4.24.3
- Plugins List

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 1ProjectDatabase
Remake of ActozSoft's 1997 The Legend Of Mir 1
Mir 2ProjectDatabaseMap Editor
Remake of ActozSoft / Wemade Entertainment's 1999 The Legend Of Mir 2
Mir 3ProjectDatabaseMap Editor
Remake of Wemade Entertainment's 2003 The Legend Of Mir 3
WoOOLProjectMap Editor
Remake of Shanda Games' (Shengqu Games) 2003 The World Of Legend
Mir 3DMoon SpiritHoly Cow
Remake of Shanda Games' 2016 Legend Eternal
Mir 4Project
Remake of Wemade Entertainment's 2021 Mir 4
Mir 5Leaked FilesGameplay Video (24m)
A massive 2TB development leak from the currently unreleased Mir 5. Includes server/client builds, internal documentation, and a 24-minute video showing Jev connecting a leaked client to Wemade's official development server—since removed from YouTube with two copyright strikes. Preserved for historical and research purposes.

💖 Sponsored By



RageZone

Leading MMORPG development community featuring reverse engineering, open-source projects, tutorials, server resources, and an active community of developers.



LOMCN

The largest English-speaking Legend of Mir community, providing forums, open-source projects, technical resources, and years of support for the Mir development scene.



PTS Games

A long-running gaming community founded in 2011. PTS Games generously sponsors the project by hosting our European game server free of charge, helping keep MIR4 Online accessible to players across Europe.


❤️ We Support Stop Killing Games

Stop Killing Games

The Topaz team proudly supports the Stop Killing Games initiative.

Stop Killing Games is a consumer movement campaigning against the practice of publishers permanently disabling games after they have been sold. The campaign advocates for consumer rights, game preservation, and ensuring that legally purchased games remain playable even after official support ends.

As a community-driven preservation project, we share these values and believe that online games deserve a future beyond their commercial lifespan.

🌐 Learn More About Stop Killing Games


Star History

Star History Chart

📄 Disclaimer

Please read our Disclaimer before using this project.

About

Mir 4 - Official Public Topaz Source

Topics

Resources

License

Stars

Watchers

Forks

Contributors