This project uses a strict, 3-branch architecture to separate the raw backend source from our custom game fixes and the modern deployment environment.
| Branch | Version / Build | Description |
|---|---|---|
main |
v2.0.0-docker |
(Default) The production-ready version. It wraps the classic branch into a modern Docker form suitable for easy, scalable deployment in 2026. |
classic |
v1.1.0-classic |
The re-edited and fixed version of the base emulator. This branch introduces crucial game fixes and fully working Party Quests (PQs). |
OdinMS |
v1.0.0-base |
The raw, unedited base source we downloaded. It contains the original Java source code, scripts, and configurations. |
- Fully Working Party Quests (PQs): Heavily edited and fixed to ensure flawless PQ progression.
- Core Game Fixes: Resolved bugs, exploits, and stability issues present in the base
OdinMSversion. - 2026 Modernization (
mainbranch): Fully containerized environment using Docker and Docker Compose for instant, isolated deployment without local environment clutter.
- Backend: Java (J2SE)
- Database: MySQL / MariaDB
- Containerization: Docker & Docker Compose (
mainbranch only) - Scripting: JavaScript (for NPC/Portal/Quest logic) & Bash/Shell (launch scripts)
To comply with licensing and distribution rules, this repository only contains the backend emulator logic. You must provide the following files yourself to run the server:
- WZ Data Files: The XML/WZ data extracted from the MapleStory client is missing. You must place a valid
wz/folder in your root directory containing strings, items, maps, and mob data for the server to boot. - Compiled Binaries: We do not distribute compiled
.jarfiles. You must compile the Java source code to generate the server executables. - Game Client: The actual client executable (
localhost.exeorMapleStory.exe) is not provided.
Maintained by the BiosSystem team.