No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
Metro is a 2D Gaming framework built around gosu (game development library). Metro makes it easy to create games by enforcing common conceptual structures and conventions.


~> 2.11
~> 1.0.1


~> 0.7
~> 0.6.1
~> 0.6.0
~> 0.4
~> 0.16.0
~> 0.1.2
 Project Readme

Metro Image

Metro is a framework built around gosu (the 2D game development library in Ruby). The goal of Metro is to enforce common conceptual structures and conventions making it easier to quickly generate a game.

Code Climate

Build Status

Dependency Status

Why Use Metro?

You want to develop games in Ruby.

Why not just use Gosu?

Gosu does a lot of great work bringing OpenGL to Ruby. However, when you finish the initial tutorial you are left with a brittle game that is very resistant to changes or new features.

  • Metro provides the concept of a Scene which is the first abstraction you would likely build after completing the tutorial.

Developing your game in individual scenes will make it easier to logically layout your game.

  • Sane management of images, animations, fonts, songs, and samples through model properties.

Having to load and cache fonts and images in every one of your models is tedious. It is also is wasteful as several of the same fonts are being used all over the place.

Metro makes it simple to move an actor from one position to another position. So simple movements, fades, color changes, and really any property change over time is defined very simply.

Delete those huge if ... elsif ... else input checking structures for keyboard, gamepad, and mouse button presses (down,up, and held). Metro makes it easy to define them and an attach a course of action to take when the event happens.

Why not use Chingu or Gamebox?

Both Gamebox and Chingu are more mature libraries with a larger set of features. I encourage you to check out those libraries.

Metro's primary goal is to be a framework of features that make game development joyful.

  • Active Reloading while building your scenes.

Adjustments to your game code while working on a scene will automatically reload your game code. The template game sets up a shortcut key (Ctrl+R) that allows you to explicitly reload the game and the current scene.

  • Scene Edit Support

Scenes can enter an edit mode which allows you to re-position actors within the scene. The changes can then be saved back to the view. This allows you to fine tune the layout of those scene elements, making it easier to get things pixel perfect.

Metro's secondary goal is to make it easier for individuals familiar with Rails get into game development. That is the reason for some of the design choices, the opinionated structure, and generators that come with Metro.

Why you shouldn't use Metro?

Metro has some the following limitations:

  • Limited to the gems defined within Metro

At this point in time you are not able to define and package additional dependencies with your game. This means if you are using a gem that is not already defined by Metro you will run into trouble when running it on alternate systems. This will likely be addressed in the future when more demand arises.

  • Difficult Deployment

For individuals to play your game, they will also have to install Metro. However, work is being made to bring some simple packaging to Metro games to make them stand-along executables.


$ gem install metro


Running a Game

By default metro will look for a file named 'metro' within the current working directory if no gamefilename has been provided.


Please take a look at the example game project that is being built alongside of 'metro'. It currently showcases all the current features available to the game.

$ git clone git://
$ cd starry-knight
$ metro

Creating a Game

Metro contains content generators to assist you.

Creating a Game can be done with a single command.

$ metro new GAMENAME

This should generate for you a starting game with a branding scene, title scene and first game scene. The game allows the player to start the game.


Metro Documentation

The Metro wiki contains lots of documentation: