Magic World

Magic World is a small Action RPG that I am currently developing.

This is my first ever Java program. I decided not to use a game engine and instead make my own (I regret this decision).

At the moment, the game has neither a story nor any interesting gameplay.

Building

I am developing this game as a hobby. The latest commit might not always work. I will try to mark working commits as stable, but there ist no warranty. Currently the game is in pre alpha. These are only snapshots.

Requirements

You must have at least Java 23 installed. Additionally you need Maven.

You can use Git to download the files, but it is not required.

1. Download the project

Open a terminal and run:

git clone https://github.com/athalion/Magic-World.git

(You need to have Git installed for this to work.)

Alternatively, you can click the Code button at the top and choose Download ZIP or use your IDE of choice to clone the repository.

2. Dependencies

The program uses Maven, so you do not have to worry about most dependencies. However, since TinySound is not available on Maven Central, you will need to install it manually.

You can get the latest release here. Then unzip the folder and open a terminal in it.

On Windows, go to the address bar which displays the current location (e.g., C:\Download\) and type cmd, then press Enter.
If you use Linux, you probably already have at least one terminal open :))

Install TinySound in your local Maven repository by running:

mvn install:install-file -Dfile=tinysound-1.1.1.jar -DgroupId=kuusisto -DartifactId=tinysound -Dversion=1.1.1 -Dpackaging=jar

3. Building

Simply run

mvn clean package

to build the project. You can find the JAR file in the target directory.

Create a new folder (e.g., on your Desktop) and put the JAR file inside. Run the game using

java -jar Magic-World-<version>.jar

(Replace <version> with the actual file name.)

Known Issues

Linux

In some cases audio is output on the wrong device or with wrong volume.

GNOME

Fullscreen and the screen selector might not work corectly on Linux systems with the GNOME desktop environment.

Credits

The basis of this game was created with the help of a tutorial by RyiSnow. (Go and check out his channel)

At the moment, the game uses some assets by RyiSnow. I will replace those soon.

The game uses the following libraries:

• Jamepad by Will Hartman for easy controller support.
• sdl2gdx by Richard Smith (required by Jamepad).
• GSON by Google as an easy-to-use JSON library.
• TinySound by Finn Kuusisto for playing audio.