Introduction

This is a Star Wars Galaxies server emulator, targeted at the Combat Upgrade (CU) era of the game.

Vision

• Providing an experience that's reasonably close to the original, out of the box
• Easily expandable with new functionality
• Good amount of configuration options for in-game features
• Efficient use of system resources and solid performance

Setting up a development environment

Ready to help bring back an awesome MMORPG with your programming skills?

Java Development Kit

In order to compile the source code, you need a JDK installation on your machine. The JAVA_HOME environment variable should point to the directory of the JDK! It should be version 18 as minimum. You can see your installed Java version by running java -version.

Submodules

The project uses submodules. Get them by running: git submodule update --init

MongoDB

A MongoDB instance can be bootstrapped by running docker-compose up -d.

This will run and initialize a MongoDB instance with a default game server user.

• Username: user
• Password: pass

This will also run a web UI, which can be accessed in the browser at: http://localhost:8081

You can stop both with: docker-compose down.

Running Holocore

Compile and run Holocores main code using Gradle: ./gradlew runDevelopment

Running automated tests

Compile and run Holocores automated tests using Gradle: ./gradlew test --info

Running your own server

If you're interested in running your own server, you should use the provided Docker image.