back to all blogsSee all blog posts

Liberty Bikes: a microservices-based game built on Open Liberty

image of author
Liam Westby on Sep 24, 2021
Post available in languages:
Liberty Bikes

A while ago, the Open Liberty team was looking for some cool and interesting demos to show off some of the new features in Open Liberty, including MicroProfile. These demos would illustrate key concepts provided by this great technology and could be used as tutorials to show developers how to do cool things in their own code. That sounded like a fun project! A team of us (Olen Cook, Ryan Esch, Andy Guibert, and I, with art by Sarah Ishida) got together to come up with a submission. 

But what to create? It should be more complex and sophisticated than Hello World, as well as being polished and interesting enough to draw people in who might be passing by a conference booth. Something that keeps bringing people back, not just to have a look at the code, but to keep using it again and again. 

Something like…​ a game! We call it Liberty Bikes, and you can play it right here: Liberty Bikes. It’s all open source, so you can see how it works here: Liberty Bikes on GitHub

What is Liberty Bikes?

screen capture of the Liberty Bikes game board

Liberty Bikes is a multiplayer game for up to four players, either on four separate computers or with four mobile device controllers and one hosting computer. To play, you pilot a bike that leaves a trail as it moves around the arena. Your objective is to be the last player standing by avoiding other players' trails, the walls, and the obstacles scattered throughout the arena. You can steer your bike left or right, but you can’t slow down or stop. 

The game can be played in two ways:

  • on a desktop or laptop, you can see the game board and steer using the arrow keys.

  • on a mobile device, you’ll get a touch-based gamepad, but you’ll need to use a computer hosting the game as a spectator in order to see the board. 

screen capture of the Liberty Bikes mobile game pad

Some player statistics are stored for each players, such as wins and rounds played. As you play, you can see how you’re doing and who among you is the best at staying in the game. You can play either as a guest or by signing in through one of several OAuth providers.

How it works

block diagram of Liberty Bikes

Liberty Bikes is implemented as three backend microservices that power the game itself and the player management and leaderboard features, as well as authenticating users. Each of these services is a MicroProfile and Java-based application running on Open Liberty. The game’s user interface is an Angular-based front end application.

Data flow among the services is best described by walking through what happens when you access the game.

screen capture of the Liberty Bikes login page

First, when you load the game, the front end user interface makes a REST API call to the Authentication microservice to find out which OAuth authentication providers have been configured. All REST APIs in Liberty Bikes are implemented with JAX-RS and MicroProfile OpenAPI. If you choose to log in with an available provider, the UI makes more REST calls to the Authentication service to set up the flow. 

Once you are authenticated, the UI then makes a REST call to the Player microservice to add you to the Players database. Now you’re logged in.

screen capture of a player logged in to Liberty Bikes ready to start a game

Suppose you click Play Now to quickly get into a game. The UI makes a REST call to the Game microservice to create a new game room, and then sets up the game board by opening a websocket between your browser and the Game service. This connection sends your control inputs to the Game service so it knows which direction to move you in the next frame. It also allows quick communication of the location of players and obstacles in every frame. Since we want to update the board every 50 milliseconds, speed is essential.

screen capture of the Liberty Bikes game board

When the round completes, the Game service sends the UI the information to join a new round. Behind the scenes, the Game service also makes a REST call (using MicroProfile REST Client) to update the player statistics for everyone in the round.

Liberty Bikes and MicroProfile

Apart from using JAX-RS, MicroProfile OpenAPI, and MicroProfile REST Client to provide and consume the REST APIs that communicate between services, several other MicroProfile features provide useful capabilities:

Give it a try!

So that’s Liberty Bikes! Give it a try and have a look at the source code. Everything you need to build and run it is in the readme file at the root of the repository. We hope you have as much fun playing and exploring Liberty Bikes as we did building it!