pxt-arcade 1.7.3 → 1.7.7

package/docs/skillmap/space/space1.md

@@ -9,15 +9,22 @@ In this tutorial, you'll prepare your ship for a journey into space!
 
 ![Flying through space](/static/skillmap/space/spacet1.gif "Blasting through space")
 
-## Set the scene
-**Time to give 'em a view** 🔭
+## 2. Set the scene
+**🔭 Time to give 'em a view** 
 
 ---
 
-► From the  ``||scene:Scene||`` category, drag ``||scene:set background image to [ ]||`` into the ``||loops:on start||`` container already in the workspace.
+- :tree: From the  ``||scene:Scene||`` category, drag  
+``||scene:set background image to [ ]||``  
+into the  
+``||loops:on start||``  
+container already in the workspace. 
 
-► Next, click the grey box and toggle to **My Assets** to choose the **Galaxy** background, then click **Done**.
+_💡  Having trouble finding the block you need? Look to the left of the instructions for the icon of the toolbox category where your block lives!_
 
+- :paint brush: Next, click the grey box and toggle to **My Assets** to choose the **Galaxy** background, then click **Done**.
+
+![Toggle to My Assets](/static/skillmap/assets/my-assets-three.png "toggle to the My Assets Window")
 
 ```blocks
 // @highlight
@@ -31,16 +38,21 @@ scene.setBackgroundImage(assets.image`Galaxy`)
 
 
 
-## Make it fly
+## 3. Make it fly
 **🚀 Make it fly 🚀**
 
 ---
 
-► From  ``||scroller:Scroller||``, grab ``||scroller:scroll background with vx [-50] vy [-50]||`` and drop it in to **the end** of the ``||loops:on start||`` container.
+- :arrows alternate:  Grab  
+``||scroller:scroll background with vx [-50] vy [-50]||``  
+and drop it in to **the end** of the  
+``||loops:on start||`` container.
+
+_💡  Remember, the icon to the left of the instructions shows the same icon as the toolbox category for the block you need._
 
-► To keep the background from scrolling sideways, change **vx** to **0**.
+- :mouse pointer: To keep the background from scrolling sideways, change **vx** to **0**.
 
-► To set a nice, slow vertical pace, change **vy** to **10**.
+- :mouse pointer: To set a nice, slow vertical pace, change **vy** to **10**.
 
 ```blocks
 scene.setBackgroundImage(assets.image`Galaxy`)
@@ -49,15 +61,19 @@ scroller.scrollBackgroundWithSpeed(0, 10)
 ```
 
 
-## Draw your ship
-**🧑🏿‍🚀 Time to choose our ship! 👩🏾‍🚀**
+## 4. Choose your ship
+**Time to pick your ship!**
 
 ---
 
-► From ``||sprites:Sprites||``, drag  ``||variables:set [mySprite] to sprite [ ] of kind [Player]||``  to **the end** of the ``||loops:on start||`` container.
+- :paper plane: Drag  
+``||variables:set [mySprite] to sprite [ ] of kind [Player]||``   
+to **the end** of the  
+``||loops:on start||`` container.
 
-► Click on the grey box in the middle of
- ``||variables:set [mySprite] to sprite [ ] of kind [Player]||``, then toggle to **My Assets** and choose the **Rocket**.
+- :paint brush: Click on the grey box in the middle of  
+ ``||variables:set [mySprite] to sprite [ ] of kind [Player]||``,   
+ then toggle to **My Assets** and choose the **Rocket**.
 
 
 ```blocks
@@ -69,17 +85,17 @@ let mySprite = sprites.create(assets.image`Rocket`, SpriteKind.Player)
 
 
 
-## Control your ship
+## 5. Control your ship
 
-🌟 Let's get your ship moving 🌟
+🌟 **Let's get your ship moving**
 
 ---
 
-► Find the ``||controller:move [mySprite] with buttons ⊕||`` block
-and drag it into the bottom of the ``||loops:on start||`` container.
+- :game: Find the  
+``||controller:move [mySprite] with buttons ⊕||``  
+block and drag it into the bottom of the  
+``||loops:on start||`` container.
 
-** Now try moving your ship around the game screen! **
-Your ship will move with the joystick, arrow keys, or **W A S D** keys.
 
 
 
@@ -91,15 +107,30 @@ mySprite = sprites.create(assets.image`Rocket`, SpriteKind.Player)
 controller.moveSprite(mySprite)
 ```
 
-## Stay in screen
+
+## 6. Try It
+
+**Click the Game Window Tab (Above)**  
+![Click the Game Window tab to see your scene. ](/static/skillmap/assets/game-win-tab.png "Don't forget to look at your game!")
+
+---
+
+Try moving your ship around the game screen!  Your ship will move with the joypad, arrow keys, or **W A S D** keys.
+
+What happens when you hold one arrow down for a long time?
+
+
+
+## 7. Stay on Screen
 
 **Uh-oh, if you move off screen, your ship disappears!**
 
 ---
 
-► To keep your ship from exploring beyond the edges, find
- the ``||sprites:set [mySprite] stay in screen <on>||`` block and
-snap it in at the end of the program.
+- :paper plane: To keep your ship from exploring beyond the edges, find
+ the  
+ ``||sprites:set [mySprite] stay in screen <on>||``  
+ block and snap it in at the end of the program.
 
 
 
@@ -115,29 +146,31 @@ mySprite.setStayInScreen(true)
 ```
 
 
-## Finale @showdialog
+## 8. Test It
 
 **Great Job!**
 
+---
 
-Now try your project on the game screen!
+Now test your project on the game screen!
 
 Is everything how you want it? You can always go back and edit steps if you discover you'd like them to work differently.
 
 
 
-## Byeeee
+## 9. Finale
 
 ** 🚀 That's it! 🚀**
 
 You're all set to travel the universe!
 
-Click **Done** to return to the main page where you can share your game
-with family and friends!
+---
+
+Click **Done** to return to the main skillmap where you can move on to discover how to launch projectiles!
 
 
 ```package
-arcade-background-scroll=github:microsoft/arcade-background-scroll/
+arcade-background-scroll=github:microsoft/arcade-background-scroll#926e12eefffd09d453c7cde73f8d6ebd0e666d9d/
 ```
 
 
@@ -158,6 +191,7 @@ mySprite.y = 100
 
 ```
 
+
 ```assetjson
 {
   "README.md": " ",

package/docs/skillmap/space/space2.md

@@ -9,17 +9,17 @@ In this tutorial, you'll equip your ship with [__*projectiles*__](#projected "a
 ![Releasing projectiles](/static/skillmap/space/spacet2.gif "Here, enemy ship. Would you like to borrow a blaster?")
 
 
-## Customize sprites
+## 2. Customize Sprites
 
-**🚀 The workspace already has the code for a flying ship 🚀**
+**🚀 The workspace already has the code for a flying ship**
 
 ---
 
-►  Play with your project in the game screen to make sure it works the way you expect.
+Play with your project in the game screen to make sure it works the way you expect.
 
 
 
-## Add a button event
+## 3. Add a Button Event
 
 **Time for action!**
 
@@ -27,18 +27,22 @@ Let's launch projectiles when the **Ⓐ** button is pressed!
 
 ---
 
-► From ``||controller:Controller||``, drag an ``||controller:on [A] button pressed ||`` container into the workspace.
+- :game: Drag an  
+``||controller:on [A] button pressed ||``  
+container into the workspace.
 
-► From ``||sprites:Sprites||``, snap
-``||variables:set [projectile] to projectile [ ] from [mySprite] with vx [50] vy [50]||``
-inside the new ``||controller:on [A] button pressed ||`` container.
+- :paper plane: Snap  
+``||variables:set [projectile] to projectile [ ] from [mySprite] with vx [50] vy [50]||``   
+inside the new  
+``||controller:on [A] button pressed ||``  
+container.
 
-► Click the grey box inside of the new projectile block and toggle to **My Assets** to choose one of the **Dart** sprites.
+- :paint brush: Click the grey box inside of the new projectile block and toggle to **My Assets** to choose one of the **Dart** sprites.
 
 ---
 
-**Tip:** Run your code on the game screen and launch a few projectiles
-by pressing the **Ⓐ** button.  What happens?
+_💡 Run your code on the game screen and launch a few projectiles
+by pressing the **Ⓐ** button.  What happens?_
 
 
 ```blocks
@@ -72,9 +76,9 @@ In MakeCode Arcade, we call this [__*velocity*__](#veloc "speed in a given direc
 ![Directional Projectiles](/static/skillmap/space/vxvy.gif "Round and Round")
 
 
-## Create a projectile
+## 6. Create a Projectile
 
-Play with the __vx__ and __vy__ values of the projectile until they're flying straight up at a decent speed.
+Play with the __vx__ and __vy__ values of the projectile until the lasers are flying straight up at a decent speed.
 
 ```blocks
 controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
@@ -82,24 +86,26 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 })
 ```
 
-## Custom effects
+## 7. Custom Effects
 
-💥 Now for some special effects 💥
+**Now for some special effects**  
+💥 💥 💥 
 
 ---
 
-► Find
-``||sprites:[mySprite] start [spray] effect ⊕||`` and snap it in at
-the bottom of the ``||controller:on [A] button pressed ||`` container.
+- :paper plane: Find  
+``||sprites:[mySprite] start [spray] effect ➕||``   
+and snap it in at **the end** of the  
+``||controller:on [A] button pressed ||``  
+container.
 
-► Change ``||variables:mySprite||`` to ``||variables:projectile||`` if you
-want the effects on your projectiles instead of on your ship.
+- :mouse pointer: Change ``||variables:mySprite||`` to ``||variables:projectile||`` if you want the effects on your projectiles instead of on your ship.
 
-► Try different options from the ``||sprites:[spray]||`` dropdown menu and choose the one you like best!
+- :mouse pointer: Try different options from the ``||sprites:[spray]||`` dropdown menu and choose the one you like best!
 
 ---
 
-**Tip:** Click the __⊕__ button on the ``||sprites:[mySprite] start [spray] effect ⊕||`` block to change the time on the effect from 500 ms to **100** ms for a smoother experience.
+_💡 Click the➕ button on the ``||sprites:[mySprite] start [spray] effect ➕||`` block to change the time on the effect from 500 ms to **100** ms for a smoother experience._
 
 
 
@@ -111,20 +117,22 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 ```
 
 
-## Complete
+## Finale
 
 🎆 **Congratulations** 🎆
 
+---
+
 You can now use the direction buttons to move your space plane and
 press **Ⓐ** to lauch projectiles!
 
-Play your game on the game screen, then click **Done** to return to the main page where you can share with family and friends!
+Play your game on the game screen, then click **Done** to return to the main skillmap where you can carry on to find out how to add enemies to your project!
 
 
 
 
 ```package
-arcade-background-scroll=github:microsoft/arcade-background-scroll/
+arcade-background-scroll=github:microsoft/arcade-background-scroll#926e12eefffd09d453c7cde73f8d6ebd0e666d9d/
 ```
 
 ```ghost
@@ -161,6 +169,7 @@ mySprite.setStayInScreen(true)
 
 ```
 
+
 ```assetjson
 {
   "README.md": " ",

package/docs/skillmap/space/space3.md

@@ -9,17 +9,20 @@ Let's add some enemies for your ship to avoid.
 ![Fighting enemies](/static/skillmap/space/spacet3.gif "Here, enemy ship. Have one of mine.")
 
 
-## Step 2
+## 2. Enemy Rain
 
-**👾 Feel like making enemies rain from the sky? 👾**
+**Feel like making enemies rain from the sky?**  
+👾👾👾  
 
 Let's add some code that will drop an enemy toward the ship every couple of seconds.
 
 ---
 
-► Add an ``||game:on game update every [500] ms||`` container to the workspace.
+- :circle: Add an  
+``||game:on game update every [500] ms||``  
+container to the workspace.
 
-► Change the number value to **2000** [__*ms*__](#millis "milliseconds...aka 1/1000 of a second")
+- :mouse pointer: Change the number value to **2000** [__*ms*__](#millis "milliseconds...aka 1/1000 of a second")
 (or pick **2 second** from the dropdown)
 
 
@@ -29,16 +32,15 @@ game.onUpdateInterval(2000, function () {
 })
 ```
 
-## Step 3
+## 3. Rename the Variable
 
-► In the ``||sprites:Sprites||`` category, find the
-``||variables:set [projectile2] to projectile [ ] from side with vx [50] vy [50]||`` block
-and drag it into the new **on game update** container.
+- :paper plane: Find the  
+``||variables:set [projectile2] to projectile [ ] from side with vx [50] vy [50]||``   
+block and drag it into the new **on game update** container.
 
-► Click on the ``||variables:[projectile2]||`` value inside the new block and
-select "Rename variable..."
+- :mouse pointer: Click on the ``||variables:[projectile2]||`` value inside the new block and select "Rename variable..." .
 
-► Change the variable name to ``||variables:myEnemy||`` so we know these are the baddies.
+- :mouse pointer: Change the variable name to ``||variables:myEnemy||`` so we know these are the baddies.
 
 
 
@@ -54,14 +56,15 @@ game.onUpdateInterval(2000, function () {
 })
 ```
 
-## Step 4
-**🎆 Let's get the enemies moving in the right direction 🎆**
+## 4. Straight Down
+
+**Let's get the enemies moving in the right direction**
 
 ---
 
-► Click the grey square in the new block and toggle to **My Assets** to grab **Spider**.
+- :paint brush: Click the grey square in the new block and toggle to **My Assets** to grab **Spider**.
 
-► Play with the **vx** and **vy** values of **myEnemy** until
+- :mouse pointer: Play with the **vx** and **vy** values of **myEnemy** until
 your new sprites are falling straight down the side of the screen.
 
 💡 Are the enemies all falling down to the left of the screen? Don't worry, we'll handle that in the next step!
@@ -76,17 +79,19 @@ game.onUpdateInterval(2000, function () {
 
 ```
 
-## Step 5
+## 5. So Random
 
 Enemies aren't likely to hit the ship if they're off to the side. Let's add an element of surprise using [__*random numbers*__](#randos "numbers appearing seemingly without a predictable pattern") .
 
 ---
 
-► Snap a ``||sprites:set [mySprite] [x] to [0]||`` block into the
-end of the ``||game:on game update every [2000] ms||`` container.
+- :paper plane: Snap a  
+``||sprites:set [mySprite] [x] to [0]||``  
+block into the end of the  
+``||game:on game update every [2000] ms||``  
+container.
 
-► To make sure we're acting on the right sprites, use the dropdown in the
-new block to change ``||variables:mySprite||`` to ``||variables:myEnemy||``.
+- :mouse pointer: To make sure we're acting on the right sprites, use the dropdown in the new block to change ``||variables:mySprite||`` to ``||variables:myEnemy||``.
 
 ```blocks
 game.onUpdateInterval(2000, function () {
@@ -95,21 +100,24 @@ game.onUpdateInterval(2000, function () {
 })
 ```
 
-## Step 6
+## 6. Horizontal
 
-► Set a random [__*x*__](#setX "horizontal location")
-for the enemies using a
-``||Math:pick random [0] to [10]||`` block from the ``||Math:Math||`` category.
-Connect it to replace the **0** in the ``||sprites:set [myEnemy] [x] to [0]||`` block.
+- :calculator: Set a random [__*x*__](#setX "horizontal location")
+for the enemies using a  
+``||Math:pick random [0] to [10]||`` block.  
+Connect it to replace the **0** in the  
+``||sprites:set [myEnemy] [x] to [0]||``  
+block.
 
-► Finally, update the minimum argument of the ``||Math:pick random [0] to [10]||`` block to **5** and the
-maximum argument to **155**.
+- :mouse pointer: Finally, update the minimum argument of the  
+``||Math:pick random [0] to [10]||``  
+block to **5** and the maximum argument to **155**.
 
 ---
 
-**Tip:** The Arcade screen is 160px wide,
+_💡 The Arcade screen is 160px wide,
 so you could make your enemies fall anywhere between 0 and 160
-and still be able to see a piece of them.
+and still be able to see a piece of them._
 
 ```blocks
 game.onUpdateInterval(2000, function () {
@@ -119,18 +127,18 @@ game.onUpdateInterval(2000, function () {
 ```
 
 
-## Step 7
+## 7. Enemy Kind
 
 We now have two different kinds of projectiles. Let's make sure the computer knows they're different by setting this one to an
 "**Enemy**" [__*kind*__](#withClass "a label you give a particular group so you can refer to it later").
 
 ---
 
-► Snap a ``||sprites:set [mySprite] kind to [Player]||`` block into the bottom of the
-**on game update** container.
+- :paper plane: Snap a  
+``||sprites:set [mySprite] kind to [Player]||``  
+block into the bottom of the **on game update** container.
 
-► Change ``||variables:mySprite||`` to ``||variables:myEnemy||``, then choose
- ``||sprites:Enemy||`` as the kind.
+- :mouse pointer: Change ``||variables:mySprite||`` to ``||variables:myEnemy||``, then choose ``||sprites:Enemy||`` as the kind.
 
 
 
@@ -143,25 +151,25 @@ game.onUpdateInterval(2000, function () {
 ```
 
 
-## Step 8
+## 8. Collision
 
-**💥 Time to create some enemy behavior 💥**
+**Time to create some enemy behavior**
 
 To add excitement to the game, let's make something happen when an enemy
 collides with our ship.
 
 ---
 
-► Drag an ``||sprites:on [sprite] of kind [Player] overlaps [othersprite] of kind [Player]||``
+- :paper plane: Drag an  
+``||sprites:on [sprite] of kind [Player] overlaps [othersprite] of kind [Player]||``  
 container into the workspace.
 
-► Change the last value from ``||sprites:Player||`` to ``||sprites:Enemy||``.
+- :mouse pointer: Change the last value from ``||sprites:Player||`` to ``||sprites:Enemy||``.
 
 ---
 
-**Tip:** Don't try to change "sprite" → "mySprite" or "otherSprite" → "myEnemy".
-The variable "sprite" refers to the **Player** sprite (our Rocket) and the "otherSprite"
-variable is the specific **Enemy** sprite that our **Player** overlapped with.
+_💡 Don't try to change "sprite" → "mySprite" or "otherSprite" → "myEnemy".
+The variable "sprite" is the **Player** sprite (our Rocket) and the "otherSprite" variable is the specific **Enemy** sprite that our **Player** overlapped with._
 
 ```blocks
 sprites.onOverlap(SpriteKind.Player, SpriteKind.Enemy, function (sprite, otherSprite) {
@@ -169,17 +177,20 @@ sprites.onOverlap(SpriteKind.Player, SpriteKind.Enemy, function (sprite, otherSp
 })
 ```
 
-## Step 9
+## 9. Fewer Lives
 
 When the enemy collides with the ship,
 we want it to subtract a life...then disappear.
 
 ---
 
-► From the ``||info:Info||`` category, grab the ``||info:change life by [-1]||`` block and snap it into the
-**on player overlaps enemy** container. That removes a life from the player every time it's hit by an enemy!
+- :id card: Grab the  
+``||info:change life by [-1]||``  
+block and snap it into the **on player overlaps enemy** container. That removes a life from the player every time it's hit by an enemy!
 
-► Find the ``||sprites:destroy [mySprite] ⊕||`` block and snap it below the previous block.
+- :paper plane: Find the  
+``||sprites:destroy [mySprite] ⊕||``  
+block and snap it below the previous block.
 
 ```blocks
 let mySprite: Sprite = null
@@ -189,19 +200,19 @@ sprites.onOverlap(SpriteKind.Player, SpriteKind.Enemy, function (sprite, otherSp
 })
 ```
 
-## Step 10
+## 10. Destroy
 
-► To tell the **destroy** block that you want it to affect the overlapping enemy,
-click on the ``||variables:otherSprite||`` variable from the top of the
-**overlaps** container and drag it down to replace the
-``||variables:mySprite||`` argument in ``||sprites:destroy [mySprite] ⊕||``.
+- :mouse pointer: To tell the **destroy** block that you want it to affect the overlapping enemy, click on the ``||variables:otherSprite||`` value from the top of the **overlaps** container and drag it down to replace the
+``||variables:mySprite||`` value inside  
+``||sprites:destroy [mySprite] ➕||``.
 
 ![Grabbing variable from block](/static/skillmap/space/give-var.gif "So that's how you do that!")
 
 ---
 
-**Tip:** Click the __⊕__ on the ``||sprites:destroy [otherSprite] ⊕||`` block to get
-a menu of effects to display upon your enemy's demise!
+_💡 Click the __➕__ on the  
+``||sprites:destroy [otherSprite] ➕||``  
+block to get a menu of effects to display upon your enemy's demise!_
 
 ```blocks
 sprites.onOverlap(SpriteKind.Player, SpriteKind.Enemy, function (sprite, otherSprite) {
@@ -210,30 +221,34 @@ sprites.onOverlap(SpriteKind.Player, SpriteKind.Enemy, function (sprite, otherSp
 })
 ```
 
-## Step 11
+## 11. Fire!
 
-**🌍 Time to save the world 🌏**
+**Time to save the world**
+🌍 🌍 🌍 
 
-Another **overlap** container will help our projectiles
+Another **overlap** container will help the projectiles
 destroy our enemies on impact.
 
 ---
 
 
-► Drag another ``||sprites:on [sprite] of kind [Player] overlaps [othersprite] of kind [Player]||``
+- :paper plane: Drag another  
+``||sprites:on [sprite] of kind [Player] overlaps [othersprite] of kind [Player]||``  
 container into the workspace.
 
-► Change the first kind to ``||sprites:Enemy||`` and the second kind to
+- :mouse pointer: Change the first kind to ``||sprites:Enemy||`` and the second kind to
 ``||sprites:Projectile||``.
 
-► Inside, add two ``||sprites:destroy [mySprite] ⊕||`` blocks, then change the arguments
+- :paper plane: Inside, add two  
+``||sprites:destroy [mySprite] ⊕||``   
+blocks, then change the arguments
 so that one destroys the enemy (``||variables:sprite||``) and the other
 destroys your projectile (``||variables:otherSprite||``).
 
 ---
 
-**Tip:** Don't forget to hit that __⊕__ button on the **destroy** block to get
-some spectacular effects when your projectile makes contact!
+_💡 Don't forget to hit that __➕__ button on the **destroy** block to get
+some spectacular effects when your projectile makes contact!_
 
 ```blocks
 sprites.onOverlap(SpriteKind.Enemy, SpriteKind.Projectile, function (sprite, otherSprite) {
@@ -242,13 +257,15 @@ sprites.onOverlap(SpriteKind.Enemy, SpriteKind.Projectile, function (sprite, oth
 })
 ```
 
-## Step 12
+## 12. Add Points
 
-**🌍 Finally, let's add a point for each enemy destroyed 🌏**
+**Finally, let's add a point for each enemy destroyed**
 
 ---
 
-► Drag ``||info:change score by [1]||`` into **the end** of the **on enemy overlaps projectile** container.
+- :id card: Drag  
+``||info:change score by [1]||``  
+into **the end** of the **on enemy overlaps projectile** container.
 
 ```blocks
 sprites.onOverlap(SpriteKind.Enemy, SpriteKind.Projectile, function (sprite, otherSprite) {
@@ -258,26 +275,26 @@ sprites.onOverlap(SpriteKind.Enemy, SpriteKind.Projectile, function (sprite, oth
 })
 ```
 
-## Complete
+## 13. Finale
 
 **Congratulations**
 
-Now you have a barrage of enemies to combat!
+---
+
+Now you have a bunch of enemies to combat.  
 Don't forget to play with your project in the game screen before you go.
 
-Once you're happy, click **Done** to return to the main page where you can share your game
-with family and friends!
+Once you're happy, click **Done** to return to the main skillmap where you can carry on to add some drama with an animated ship!
 
 
 
 
 
 ```package
-arcade-background-scroll=github:microsoft/arcade-background-scroll/
+arcade-background-scroll=github:microsoft/arcade-background-scroll#926e12eefffd09d453c7cde73f8d6ebd0e666d9d/
 pxt-status-bar=github:jwunderl/pxt-status-bar
 ```
 
-
 ```template
 
 controller.A.onEvent(ControllerButtonEvent.Pressed, function () {