MuOnline Server on JavaScript

This project aims to create a full javascript based MuOnline server that can be used across all OS (Windows, Linux, Mac)

An alternative open-source project using TypeScript is currently in development by ycr4zy. Repo link: https://github.com/ycr4zy/emulator-ts

How to use

This guide describes two ways of starting the server. Use Docker, if you just want to play around. If you want to develop or debug the server, choose the manual way.

Using Docker

Install docker from https://docs.docker.com/engine/install/
Execute docker-compose up -d in the root directory of the repo

This will spin-up three docker containers - MySQL, ConnectServer and JoinServer. MySQL will automatically create the database MuOnline and will create the required tables with sample data. All that is defined in .docker-files/mysql/init.sql.

You can access the database from your local machine as usual. The only thing that you need to know is that the MySQL port is forwarded to 3307.

Example command to connect to the MySQL server inside the container:

mysql -uroot -proot -h127.0.0.1 -P3307 muonline

Manually

Install Node.js >= v14 from here: https://nodejs.org/en/download
Install yarn following the guide here: https://classic.yarnpkg.com/en/docs/install
Install MySQL following the guide here: https://dev.mysql.com/doc/mysql-installation-excerpt/8.0/en/
Navigate to ConnectServer directory using your terminal and execute yarn install
Then execute yarn start
Repeat steps 4 & 5 for the JoinServer as well
Navigate to libs/mu-db and execute the following commands:

yarn install
yarn install-db
yarn install-dummy-data

If you want to start the servers in debug mode, use yarn debug instead

Licensing

This project is released under the MIT license (see LICENSE file).

How to contribute code

If you want to contribute code, please do the following steps: