Skip to content

Commit 8f8c00b

Browse files
committed
whitespace fix for pr
Not sure yet why but somehow there was a lot of whitespace added which made the pr much harder to read then intended
1 parent 82c1ed9 commit 8f8c00b

1 file changed

Lines changed: 22 additions & 22 deletions

File tree

resources/tutorials/02 Making your first game/tutorial.html

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ <h3>Requirements</h3>
1919
If you've gone through the Getting Started Guide you will have downloaded Phaser and got everything set-up and ready to code. Download the resources for this tutorial from here and unzip it into your web root.
2020

2121
Open the part1.html page in your editor of choice and let's have a closer look at the code. After a little boilerplate HTML that includes Phaser the code structure looks like this:
22-
22+
2323
<pre class="lang:js decode:true " >
2424
var game = new Phaser.Game(800, 600, Phaser.AUTO, '', { preload: preload, create: create, update: update });
2525

@@ -44,7 +44,7 @@ <h3>Load Assets</h3>
4444
Let's load the assets we need for our game. You do this by putting calls to game.load inside of a function called preload. Phaser will automatically look for this function when it starts and load anything defined within it.
4545

4646
Currently the preload function is empty. Change it to:
47-
47+
4848
<pre class="lang:js decode:true " >function preload() {
4949

5050
game.load.image('sky', 'assets/sky.png');
@@ -53,7 +53,7 @@ <h3>Load Assets</h3>
5353
game.load.spritesheet('dude', 'assets/dude.png', 32, 48);
5454

5555
}
56-
</pre>
56+
</pre>
5757

5858
This will load in 4 assets: 3 images and a sprite sheet. It may appear obvious to some of you, but I would like to point out the first parameter, also known as the asset key. This string is a link to the loaded asset and is what you'll use in your code when creating sprites. You're free to use any valid JavaScript string as the key.
5959

@@ -69,7 +69,7 @@ <h3>Create a Sprite</h3>
6969

7070
The order in which items are rendered in the display matches the order in which you create them. So if you wish to place a background behind the star sprite you would need to ensure that it was added as a sprite first, before the star.
7171

72-
<h3>World Building</h3>
72+
<h3>World Building</h3>
7373

7474
Under the hood game.add.sprite is creating a new <a href="http://docs.phaser.io/Phaser.Sprite.html">Phaser.Sprite</a> object and adding the sprite to the “game world”. This world is where all your objects live, it can be compared to the Stage in Actionscript3.
7575

@@ -78,7 +78,7 @@ <h3>World Building</h3>
7878
The world class can be accessed via game.world and comes with a lot of handy methods and properties to help you distribute your objects inside the world. It includes some simple properties like game.world.height, but also some more advanced ones that we will use in another tutorial.
7979

8080
For now let's build up the scene by adding a background and platforms. Here is the updated create function:
81-
81+
8282
<pre class="lang:js decode:true " >var platforms;
8383

8484
function create() {
@@ -112,17 +112,17 @@ <h3>World Building</h3>
112112
ledge = platforms.create(-150, 250, 'ground');
113113

114114
ledge.body.immovable = true;
115-
115+
116116
}
117-
</pre>
117+
</pre>
118118

119119
If you run this, which you'll find as part4.html in the tutorial zip file, you should see a much more game-like scene:
120120

121121
<img src="http://www.photonstorm.com/wp-content/uploads/2013/12/part4.png" alt="part4" width="800" height="600" class="alignnone size-full wp-image-13606" />
122122

123123
The first part is the same as the star sprite we had before, only instead we changed the key to 'sky' and it has displayed our sky background instead. This is an 800x600 PNG that fills the game screen.
124124

125-
<h3>Groups</h3>
125+
<h3>Groups</h3>
126126

127127
Groups are really powerful. As their name implies they allow you to group together similar objects and control them all as one single unit. You can also check for collision between Groups, and for this game we'll be using two different Groups, one of which is created in the code above for the platforms.
128128

@@ -135,7 +135,7 @@ <h3>Groups</h3>
135135
<h3>Ready Player One</h3>
136136

137137
Create a new local variable called 'player' and add the following code to the create function. You can see this in part5.html:
138-
138+
139139
<pre class="lang:js decode:true " > // The player and its settings
140140
player = game.add.sprite(32, game.world.height - 150, 'dude');
141141

@@ -150,7 +150,7 @@ <h3>Ready Player One</h3>
150150
// Our two animations, walking left and right.
151151
player.animations.add('left', [0, 1, 2, 3], 10, true);
152152
player.animations.add('right', [5, 6, 7, 8], 10, true);
153-
</pre>
153+
</pre>
154154

155155
This creates a new sprite called 'player', positioned at 32 pixels by 150 pixels from the bottom of the game. We're telling it to use the 'dude' asset previously loaded. If you glance back to the preload function you'll see that 'dude' was loaded as a sprite sheet, not an image. That is because it contains animation frames. This is what the full sprite sheet looks like:
156156

@@ -163,7 +163,7 @@ <h3>The Body and Velocity: A world of physics</h3>
163163
Phaser has support for a variety of different physics systems. It ships with Arcade Physics, Ninja Physics and P2.JS Full-Body Physics. For the sake of this tutorial we will be using the Arcade Physics system, which is simple and light-weight, perfect for mobile browsers. You'll notice in the code that we have to start the physics system running, and then for every sprite or Group that we wish to use physics on we enable them.
164164

165165
Once done the sprites gain a new body property, which is an instance of <a href="http://docs.phaser.io/Phaser.Physics.Arcade.Body.html">ArcadePhysics.Body</a>. This represents the sprite as a physical body in Phasers Arcade Physics engine. The body object has itself a lot of properties that we can play with. To simulate the effects of gravity on a sprite, it's as simple as writing this:
166-
166+
167167
<pre class="lang:js decode:true">player.body.gravity.y = 300;</pre>
168168

169169
This is an arbitrary value, but logically, the higher the value, the heavier your object feels and the quicker it falls. If you add this to your code or run part5.html you will see that the player falls down without stopping, completely ignoring the ground we created earlier:
@@ -179,7 +179,7 @@ <h3>The Body and Velocity: A world of physics</h3>
179179
game.physics.arcade.collide(player, platforms);
180180

181181
}
182-
</pre>
182+
</pre>
183183
We already told Phaser that our ground and ledges would be immovable. Had we not done that when the player collided with them it would stop for a moment and then everything would have collapsed. This is because unless told otherwise, the ground sprite is a moving physical object (also known as a dynamic body) and when the player hits it, the resulting force of the collision is applied to the ground, therefore, the two bodies exchange their velocities and ground starts falling as well.
184184

185185

@@ -190,11 +190,11 @@ <h3>The Body and Velocity: A world of physics</h3>
190190
<h3>Controlling the player with the keyboard</h3>
191191

192192
Colliding is all good and well, but we really need the player to move. You would probably think of heading to the documentation and searching about how to add an event listener, but that is not necessary here. Phaser has a built-in Keyboard manager and one of the benefits of using that is this handy little function:
193-
193+
194194
<pre class="lang:js decode:true " >cursors = game.input.keyboard.createCursorKeys();</pre>
195195

196196
This populates the cursors object with four properties: up, down, left, right, that are all instances of <a href="http://docs.phaser.io/Phaser.Key.html">Phaser.Key</a> objects. Then all we need to do is poll these in our update loop:
197-
197+
198198
<pre class="lang:js decode:true " > // Reset the players velocity (movement)
199199
player.body.velocity.x = 0;
200200

@@ -219,13 +219,13 @@ <h3>Controlling the player with the keyboard</h3>
219219

220220
player.frame = 4;
221221
}
222-
222+
223223
// Allow the player to jump if they are touching the ground.
224224
if (cursors.up.isDown &amp;&amp; player.body.touching.down)
225225
{
226226
player.body.velocity.y = -350;
227227
}
228-
</pre>
228+
</pre>
229229

230230
Although we've added a lot of code it should all be pretty readable. The first thing we do is reset the horizontal velocity on the sprite. Then we check to see if the left cursor key is held down. If it is we apply a negative horizontal velocity and start the 'left' running animation. If they are holding down 'right' instead we literally do the opposite. By clearing the velocity and setting it in this manner, every frame, it creates a 'stop-start' style of movement.
231231

@@ -240,7 +240,7 @@ <h3>Jump to it</h3>
240240
<h3>Starshine</h3>
241241

242242
It's time to give our little game a purpose. Let's drop a sprinkling of stars into the scene and allow the player to collect them. To achieve this we'll create a new Group called 'stars' and populate it. In our create function we add the following code (this can be seen in part8.html):
243-
243+
244244
<pre class="lang:js decode:true">
245245
// Finally some stars to collect
246246
stars = game.add.group();
@@ -260,7 +260,7 @@ <h3>Starshine</h3>
260260
// This just gives each star a slightly random bounce value
261261
star.body.bounce.y = 0.7 + Math.random() * 0.2;
262262
}
263-
</pre>
263+
</pre>
264264

265265
The process is similar to when we created the platforms Group. Using a JavaScript 'for' loop we tell it to create 12 stars in our game. They have an x coordinate of i * 70, which means they will be evenly spaced out in the scene 70 pixels apart. As with the player we give them a gravity value so they'll fall down, and a bounce value so they'll bounce a little when they hit the platforms. Bounce is a value between 0 (no bounce at all) and 1 (a full bounce). Ours will bounce somewhere between 0.7 and 0.9. If we were to run the code like this the stars would fall through the bottom of the game. To stop that we need to check for their collision against the platforms in our update loop:
266266

@@ -273,7 +273,7 @@ <h3>Starshine</h3>
273273
This tells Phaser to check for an overlap between the player and any star in the stars Group. If found then pass them to the 'collectStar' function:
274274

275275
<pre class="lang:js decode:true">function collectStar (player, star) {
276-
276+
277277
// Removes the star from the screen
278278
star.kill();
279279

@@ -298,7 +298,7 @@ <h3>Finishing touches</h3>
298298
16x16 is the coordinate to display the text at. 'Score: 0' is the default string to display and the object that follows contains a font size and fill colour. By not specifying which font we'll actually use the browser will default, so on Windows it will be Arial. Next we need to modify the collectStar function so that when the player picks-up a star their score increases and the text is updated to reflect this:
299299

300300
<pre class="lang:js decode:true">function collectStar (player, star) {
301-
301+
302302
// Removes the star from the screen
303303
star.kill();
304304

@@ -315,9 +315,9 @@ <h3>Finishing touches</h3>
315315

316316
<h2>Conclusion</h2>
317317

318-
You have now learnt how to create a sprite with physics properties, to control its motion and to make it interact with other objects in a small game world. There are lots more things you can do to enhance this, for example there is no sense of completion or jeopardy yet. Why not add some spikes you must avoid? You could create a new 'spikes' group and check for collision vs. the player, only instead of killing the spike sprite you kill the player instead. Or for a non-violent style game you could make it a speed-run and simply challenge them to collect the stars as quickly as possible. We've included a few
318+
You have now learnt how to create a sprite with physics properties, to control its motion and to make it interact with other objects in a small game world. There are lots more things you can do to enhance this, for example there is no sense of completion or jeopardy yet. Why not add some spikes you must avoid? You could create a new 'spikes' group and check for collision vs. the player, only instead of killing the spike sprite you kill the player instead. Or for a non-violent style game you could make it a speed-run and simply challenge them to collect the stars as quickly as possible. We've included a few
319319
extra graphics in the zip file to help inspire you.
320320

321321
With the help of what you have learnt in this tutorial and the <a href="http://examples.phaser.io">250+ examples</a> available to you, you should now have a solid foundation for a future project. But as always if you have questions, need advice or want to share what you've been working on then feel free to ask for help in the <a href="http://www.html5gamedevs.com/">Phaser forum</a>.
322-
322+
323323
More tutorials will follow, stay tuned :)

0 commit comments

Comments
 (0)