1. Code
  2. Games

Improve Your Memory With an Away3D Game

Read Time:8 minsLanguages:

In this tutorial we'll build a 3D memory game. Along the way we'll look at adding variables and mouseEvents to Away3D objects. Let's get started..

Step 1: ActionScript File

Create a new ActionScript 3.0 file.

away3d flash gameaway3d flash gameaway3d flash game

Step 2: Edit Profile

In the Properties panel press the Edit button.

away3d flash gameaway3d flash gameaway3d flash game

Step 3: Choose Flash Player Version

Choose the Flash Player 9 profile and click OK.

away3d flash gameaway3d flash gameaway3d flash game

Step 4: Get the Away3D Engine!

Save your file as "Memory Game.fla" in the Memory Game Tutorial folder. Now download the Away3D engine from Away3D Downloads. We'll use version 2.3.3 for Flash Player 9. Unpack the archive and copy all folders into the Memory Game Tutorial folder.

Step 5: Get the Tweener!

Download Tweener from here. Unpack the class files to your Memory Game Tutorial folder so it all looks like this:

away3d flash gameaway3d flash gameaway3d flash game

Step 6: Import Textures

We'll use 5 different cards for this game (you can find them in the source files). Import them into Flash by going File > Import > Import to Library.

away3d flash gameaway3d flash gameaway3d flash game

Step 7: Export Textures for ActionScript

To use these textures in runtime we need to attach a Class name to them. Select the images one by one and go Right-Click > Properties > Export for ActionScript. Just remove the ".png" parts of their names.

away3d flash gameaway3d flash gameaway3d flash game

Step 8: Start Coding

After all that we're ready to start coding. Let's fill our first lines by importing the classes:

Step 9: Setup Variables

After importing our classes we should define our variables to use in the following steps.

The textures array holds our texture images. To attach images to our stage from the library we use this method:
var imageData:BitmapData = LibraryLinkageName(0,0). We use the same approach for our table and back face of the cards. xoffset and yoffset define the distance between cards.

Step 10: Setup Away3D

First of all we need to build Away3D.

the first line in our function creates the 3D scene. We'll add 3D objects into it. After that we create the camera. We'll move it backward and upward a bit. By doing this, we'll able to see cards better when we're playing the game. Then we'll center it. Finally we create the View and set it in the middle of the scene.

Step 11: Creating the Table

In this step we'll create the table:

To make it look more realistic we're using a Cube instead of a Plane. The most important point here is to use pushback properties in Cube to make it visible under the cards. The material we use for Cube is BitmapMaterial. This is the best way to use bitmaps as textures.

Step 12: Creating One Card

First we'll create a holder. There'll be two planes in this holder. One of these planes is the front face of the cards and the other one is the back. We'll use the holder to rotate or move the cards.

away3d flash gameaway3d flash gameaway3d flash game

In this function we are recreating what the diagram illustrates. We should use rotation to place the cards face down. We aren't adding an event to the holder, because we only click the back face of the card. For this reason we add a mouseDown event to the back Plane only.

Every 3D object in Away3D can have extra variables and every color in our game has a unique id. We'll add this id variable to the "extra" propertie of back Plane. We'll use ids to check if the selected two cards are the same color or not.

Step 13: Creating All Cards

After the card creating function, we're ready to create all of them.

We'll push all our cards to a cards array. There'll be two cards of each color (two blue, two red and two green). Because of this we create two cards with the same color then push them to the array.

Step 14: Randomize Cards

Next step is to randomize the cards array.

It's all so simple. First we are creating a new array. Then we are picking a random item from the cards array, pushing it to the new array and removing it from cards array. After the while loop has completed we equalize the cards array to our new array. Now we have a randomized array.

Step 15: Adding Cards to the Scene

Now, we've randomized our cards, so we can add them to the scene. We'll use a grid system for their positions

The first "for" loop is for the x axis and the second one is for the y axis. We're adding cards to a new main holder, so when we want to rotate or move the cards we can only use the main holder. Then we set the cards by using the grid system. For that we are using cardwidth, cardheight, xoffset and yoffset variables. The cards need to be in the middle of table. To do this we need to get width and height values of the main cards holder. This diagram shows the way we are getting them.

away3d flash gameaway3d flash gameaway3d flash game

After we get them we move the main holder into the middle of the table.

Step 16: Mouse Down Event

We've added cards to scene. Our next step will be creating the mouseDown event function.

First we check disableMouseEvents. That means if we have permission to click cards we continue but if we don't nothing happens. If the first card isn't selected, clicked card is our first card. If first card isn't null then this clicked card is our second card.

Our game must make a desicion after we select the two cards as to whether they're same or not. For this reason our "waitForDecision" function is running and we set disableMouseEvents to true. So while the game is waiting for a decision, nothing will happen if we click a card.

The rotationZ property of our clicked card will be 180 degree with Tweener, so we can see the color of the card.

Step 17: Wait for a Decision

When the two cards are selected, the game waits a little (this is just for fun).

As you can see, this is a simple Timer usege. It waits 1000 miliseconds (1 second). After that, TimerEvent triggers the makeDecision function to run.

Step 18: Make a Decision

We waited 1 second so now it's time to make a decision. If the id values of the cards are the same they will disappear, if not they will turn face down again

We are doing exactly that in this function. We are checking the id values of two selected cards. If they are same, the alpha values of them will change 0 with Tweener (we make them disappear). When this tween is finished , the removeCard function is called. The parameter of the removeCard function is the cards themselves. We do this to the two cards at the same time. If they are not the same, we send them to their old positions and make them face down. Whatever the desicion is, selectedCard1 and selectedCard2 will be set to null.

Step 19: Removing Cards

We need to remove the two cards from our main cards holder when they disappear, because we don't need them anymore.

After they are kicked out of the scene, the value of totalchildren decreases one by one. When it reaches 0 this means you've won the game!

Step 20: Rendering

The final step is to write a loop function to render Away3D in runtime.

Step 21: Call All Functions

We're ready to call all the functions we've written.

Now test it and play your game :)


In this lesson we learned how to add variables and mouseEvents to Away3D objects. With these skills we made a game and as you can see it wasn't so hard :)

I hope you liked this tutorial, thanks for reading!

Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.