A communication middleware for (mobile) games based on RabbitMQ
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
doc
game
src
test
.gitignore
LICENSE
README
README.md

README.md

ZebroGaMQ: Communication Middleware for Mobile Gaming

ZebroGaMQ provides an easy and reliable way to publish and consume messages in the context of mobile multiplayer games. A prototypical game involves:

  • A Python server
  • Android applications
  • JavaScript applications
  • Java J2SE applications
  • C++ applications
  • iOS applications

Here are the most powerful features of the middleware:

  • Clients of ZebroGaMQ don’t have to handle the low-level details of reception of messages, they just need to define a behaviour on the consumption of these messages.
  • Disconnection management of Android devices: you just have to focus on publishing your messages, the middleware handles for you the loss of network connection inherent to mobile networks.
  • Game instances management: you can create several instances of your game, and let players use those instances in parallel.

ZebroGaMQ is presented with a demonstrator game called aMazing, a geolocalized multiplayer game for Android devices.

Installation and tests

For the server side (mandatory)

  • Erlang ≥ R13B03,
  • RabbitMQ Server ≥ 3.1.3,
  • Python ≥ 2.6,
  • Pika version ≥ 0.9.5

For Java applications

  • Java ≥ 1.5,
  • Maven ≥ 2.2.1
To run the tests on Unix/Mac:
cd test
./java-integration-test.sh
To run the tests on Windows:
cd test
java-integration-test.bat

For Android applications

  • ADT plugin for Eclipse ≥ 12.0.0,
  • Android SDK API level ≥ 7
To run the tests on Unix/Mac:
cd test
./android-integration-test.sh
To run the tests on Windows:
cd test
android-integration-test.bat

For iOS applications

  • XCode ≥ 5.0.2,
  • iOS SDK API level ≥ 7
To run the tests on Unix/Mac:
cd test
./ios-integration-test.sh

For JavaScript applications

  • Node.js ≥ 0.4.10,
  • NPM ≥ 1.0.106,
  • AMQP library (to install with NPM) = 0.1.0,
  • XMLRPC library (to install with NPM) ≥ 0.8.1
To run the tests on Unix/Mac:
cd test
./javascript-integration-test.sh
To run the tests on Windows:
cd test
javascript-integration-test.bat

Resources for Newcomers