Fast-paced space shooter game.
Java Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Exp3D
Exp3DDesktop
Exp3DGWT
media
LICENSE.md
README.md

README.md

Exp3D

banner

WebGL Live Demo         Google Play         Website

This is the source code of the game Exp3D, a space shooter I released on Android in 2013.
It started out as an Android-only game I began writing from scratch back in 2011, in my free time. During the development, desktop support (Windows/Linux/Mac) was added, followed by a WebGL port by transcompiling to pure Javascript.

Here is the complete source code of the game, including the assets (with the exception of some music due to licensing issues and some in-app purchase/analytics code left out).

License

All the program source code is released under GPL.

But the game assets (sprites, images, sound effects...) remain proprietary, they are included here as a courtesy, for educational purposes only.
Note that due to restrictive licensing issues, I cannot myself redistribute the original BGM songs so they are replaced with placeholder files.
In short: you are free to study and play with the source code but you are not allowed to redistribute a recompiled version of Exp3D.

Details

All the code of Exp3D was written from scratch. The game runs on top of a minimalistic multiplatform framework I wrote. The source is entirely in Java, there is no "native" code included. The main loop doesn't perform any dynamic allocation to maintain a constant 60FPS with 0 GC pauses, this was achieved by relying heavily on object pooling.
95% of the code is written on top of this framework and thus is shared between the different platforms.

The rendering engine can run on either a fixed-pipeline (OpenGL ES 1.1) or a programmable-pipeline (OpenGL ES 2.0, WebGL).

architecture

Compiling

There are 3 Eclipse projects in the repository:

  • Exp3D for Android
  • Exp3DDesktop for the desktop (Windows/Linux/Mac)
  • Exp3DGWT for the Javascript + WebGL version

Android

The project Exp3D is self-contained and doesn't require any external code or library.
If you have the Android SDK installed with Eclipse, simply open the project in Eclipse and do Run As Android Application.

Note: you need an Android SDK with API level 17 (Android 4.2) or newer to compile the game.
The APK generated is still compatible down to Android 2.2 thanks to version check at runtime. (The game could actually run on an old Android 1.6 with a bit of tuning.)

Desktop

First you need to make Eclipse aware of the JOGL library, it is the only external library required to make Exp3D run.
Download the JOGL version corresponding to your OS and add it to Eclipse as a user library under the name jogl. (more details here)

The Exp3D Android project is referenced by the desktop project so make sure you imported it in Eclipse first.

Then import the Exp3DDesktop project in Eclipse and simply run the class com.breakingbyte.wrap.DesktopApplication to start the game.

Web

The Java code is actually transcompiled to Javascript using GWT.

First install the GWT plugin for Eclipse (it now appears to be contained into the Google Plugin).
The version supported by the current code is GWT 2.6.0.

Make sure the the Exp3DDesktop project is open in Eclipse, even if not all of its dependencies are installed.
Run once the class com.breakingbyte.wrap.SynchronizeGWT, this copies and pre-processes some assets to optimize them for the web.

Import the Exp3DGWT project into Eclipse and do Google → GWT Compile. You can now open the web page war/Exp3DGWT.html and the game will start.