To help you get started Grid Framework comes with several examples showing you how to implement from scratch features commonly found in games, such as moving along a grid, using the grid for game logic like in a puzzle game, assembling a level or even extending Grid Framework with your own methods without touching the source code of Grid Framework itself.

The source code has comments explaining the idea behind almost every line of code. I also have tutorial videos where I build those examples from scratch and explain the idea behind the code, for those of you who prefer learning by doing rather than having the source code served to them in one go.

Click a title to get to a playable build, or watch a video of me coding the example live. These videos were recorded at different points in Grid Frameworks development and the interface and usability may appear more crude than it currently is. If the example doesn't load right away please be patient.

Moving along a grid

One of the most common uses for grids is movement. Maybe you have a tactical game, or a board game or you just want the old-school feel of tile based games. In this example we convert the hero's world coordinates to grid coordinates and then move it in grid space before converting the result back to world space. As an extra touch we can limit the hero to only stay within the bounds of the grid size. We need this because grids are infinitely large, so the sphere could wander off into infinity.

Lights-out puzzle game

Here we learn how write a simple puzzle game where the goal is to turn all the lights off and every time you click a light that light and the four adjacent ones flip their state. No light knows anything about its surrounding lights, making this game very flexible, you can have all sorts of crazy shapes and holes in it.

Assembling a level from data

In this example we create a bubble puzzle field from an array by placing objects on the grid according to the position inside the array. This approach has several advantages; most obviously it is faster and easier to design levels in data than in an editor, you can add new levels very easily, parse them from files, add a level editor, or allow players to add their own levels. Instead of having a separate scene for each level we only need one scene, we can build new levels without having to worry about carrying the background or music from scene to scene, allowing for seamless transition.

Runtime snapping

If you want to allow the user to place object only on the grid, then this example is for you. Snapping is a two-step process: first we move the object to where the cursor is pointing, then we correct the position.

transform.position = cursorWorldPoint;

Seemingly endless grid

Grids are infinity large when it come to calculations, but rendering an infinite amount of lines is impossible. We will use a trick instead where we dynamically adjust the rendering range of the grid according to the camera. The result is a seamless illusion that only renders the bare minimum and only updates when it has to.

for (int i = 0; i < 3; i++) {
    rangeShift[i] += transform.position[i] - lastPosition[i];

renderer.From += rangeShift;
renderer.To   += rangeShift;

Terrain mesh generation

We generate a mesh as a SimCity-like terrain from data. Clicking a vertex raises or lowers it. Everything is accomplished be converting from grid coordinates to world coordinates.

Rotary dial

A rotary dial as it would have been found on older phones. When the player clicks a sector of this polar grid the grid coordinates are used to determine which number was selected and use it to control the animation and print that number on the console.

Sliding puzzle

Sometimes Unit's physics engine is too good for its own good and we need something simpler instead. In a sliding puzzle it is common for blocks to be touching each other with no space between, yet the player will expect there to be no friction. In this example we use Grid Framework to construct a matrix of cells and track for each cell whether it's free or occupied. Then we restrict movement of the blocks based on that information.

Snake game

Another example of tile-base movement. The snake is made of several segments, linked together using a list. Only the head moves, the other segments follow their parent.

Vectrosity support

Having some fun with Vectrosity and laser lines. The grids can move around or even change their properties at runtime.