Moonlight is the source-code of a Maplestory GMS v214 private server, including an authentication hook and launcher.
This is, of course, based upon Swordie's v214 source, so credits go to their phenomenal development team.
Check us out on Discord and consider starring the repository if you liked it!
I do not guarantee that this will make any substantial progress. Use at your own peril.
- Environment Variables
- Source Code Rundown
- Installation
- Requirements
- v214 Client Files
- Server WZ Files
- Start The Server < 8000 /ul>
- Contributing
- Privacy Policy
- License
Some aspects of the code-base relies on a filled out .env file.
Be sure to look at the .env.local file for what a valid example looks like.
You can find the source code for the server in the server directory.
The applicable
datandwzfiles are not included.
You can find the source code for the server auth hook in the auth_hook directory.
You can find the source code and applicable README for the custom launcher in the launcher directory.
The server and its database are hosted in Docker containers, so you will need Docker installed on your machine.
For Windows users, do be sure to pick up Docker Desktop and not just the Docker daemon.
We highly recommend getting all of GMS v214 through Steam via the use of Depot Downloader.
- Open the Steam console
- Run
download_depot 216150 216151 976750626611673486 - Wait until the download has finished
If this method does not work for you due to being outside of North America, there should be publicly available Mega.nz download links out there.
Due to the immense file size of dumped WZ files, we do not include them in this repository.
These files are required though, and you should dump them yourself.
- Download the latest release of HaRepacker Resurrected
- Using the v214 client files you dumped earlier, open HaRepacker and load all of the client's WZ files
- Using HaRepacker, dump all of the WZ files by clicking on Tools -> Export File(s) To -> Private Server XML
- Wait until the dump has finished and move the dumped WZ files to Server/wz
Once all previous steps have been completed, you may run the server by typing ./start.sh in your terminal while in this directory.
The first time you start the server, you may have to wait for several minutes as the Docker images and volumes are set-up, as well as for when the server generates all necessary DAT file data.
See our Contributing standards for information on contributing to development.
In Moonlight, information is kept between you and our server and all sensitive information is encrypted.
For more information, see our Privacy Policy.
This project is licensed under GNU GPL 3.
For more information about the license, check out the LICENSE.