pxt-arcade 1.7.3 → 1.7.4

package/docs/skillmap/interface/activity1.md

@@ -36,7 +36,7 @@ game.splash("These blocks are in your workspace!")
 
 ### @explicitHints true
 
-## Introduction @unplugged
+## {Introduction @unplugged}
 
 ![Psyched Monkey](/static/skillmap/interface/monkey.png "Psyched Monkey is Ready!" )
 
@@ -50,7 +50,7 @@ Complete this tutorial to learn how to:
 
 Before you know it, you'll have an arcade game of your very own!
 
-## step 1
+## {step 1}
 
 **⭐Welcome⭐**
 
@@ -69,7 +69,7 @@ When you're ready to move to the next step, click **[ >  Next]** to continue.
 ---
 
 
-## step 2
+## {step 2}
 
 This box is where you'll find information for each step.
 
@@ -83,7 +83,7 @@ click the lightbulb to the right for an extra hint.
 ```
 
 
-## Using the workspace
+## {Using the workspace}
 
 Your [__*workspace*__](#workIt "The area where you build code") is the area
 below the instructions where you'll connect blocks to build your program.
@@ -104,7 +104,7 @@ game.splash("I like bananas!")
 ```
 
 
-## Meet the Blocks  @unplugged
+## {Meet the Blocks  @unplugged}
 
 Blocks can be dragged out from the  [__*toolbox*__](#tools "The strip to the left of your workspace that lists block categories."),
 
@@ -116,7 +116,7 @@ Keep going to learn more about blocks.
 
 
 
-## Your Toolbox
+## {Your Toolbox}
 
 **Blocks you need won't always be in the workspace to start.**
 
@@ -134,7 +134,7 @@ game.splash(" ")
 This block adds a [__*splash screen*__](#splasht "A full-screen message that shows while a program or level is loading") to your project.
 
 
-## Your Toolbox 2
+## {Your Toolbox 2}
 
 **Let's see how this works**
 
@@ -152,7 +152,7 @@ game.splash("My monkey is better than yours")
 
 
 
-## The Exception
+## {The Exception}
 
 Every rule has an exception, so let's look at a block
 that doesn't match its category.
@@ -206,7 +206,7 @@ let mySprite = sprites.create(img`
 ```
 
 
-## Container Blocks
+## {Container Blocks}
 
 **Now let's look at different types of blocks and how to use them.**
 
@@ -233,7 +233,7 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 })
 ```
 
-## Standard Blocks
+## {Standard Blocks}
 
 Next, there are [__*standard blocks*__](#sBlockIt "Single line blocks that make up the majority of most programs").
 Standard blocks are single-line blocks with notches at the top and bottom that
@@ -267,7 +267,7 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 
 
 
-## Value Blocks
+## {Value Blocks}
 
 Finally, we have [__*value blocks*__](#aBlockIt "special pieces that provide values for other blocks").
 Value blocks are special pieces that add information to other
@@ -300,7 +300,7 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 
 
 
-## Play Time
+## {Play Time}
 
 **🕹️ Time to play 🕹️**
 
@@ -313,7 +313,7 @@ Click it again to launch your effects!
 
 
 
-## Putting it Together
+## {Putting it Together}
 
 **🎨 Now get creative 🎨**
 
@@ -329,7 +329,7 @@ it's behaving the way you want it to!
 
 
 
-## Conclusion
+## {Conclusion}
 
 **🎈 Congratulations 🎈**
 

package/docs/skillmap/jungle/jungle1.md

@@ -1,4 +1,4 @@
-# Simple Platformer
+# Moving Monkey
 
 
 ## Welcome @showdialog
@@ -15,19 +15,19 @@ This kind of game peeks in on the action from the side, and relies on a [__*tile
 
 
 
-## Step 2
+## 2. See the Scene
 
 **Your scene has already been set!**
 
 ---
 
-► Look at your workspace to see that the **background image** and **tilemap** have already been set for the scene in this activity.
+- :binoculars: Look at your workspace to see that the **background image** and **tilemap** have already been set for the scene in this activity.
 
-💡 Both blocks have been added to the ``||loops: on start||`` container so they load as soon as the game starts.
+_💡 Both blocks have been added to the ``||loops: on start||`` container so they load as soon as the game starts.)_
 
 
 
-## Step 3 - We need a HERO
+## 3. We need a HERO
 
 **🐒 We need a hero 🐒**
 
@@ -35,9 +35,13 @@ Our moving characters are called [__*sprites*__](#sprote "2-D images that move o
 
 ---
 
-► From the ``||sprites:Sprites||`` category, drag ``||variables:set [mySprite] to sprite [ ] of kind [Player]||`` to **the end** of the ``||loops:on start||`` container.
+- :paper plane: From the ``||sprites:Sprites||`` category, drag ``||variables:set [mySprite] to sprite [ ] of kind [Player]||`` to **the end** of the ``||loops:on start||`` container.
 
-► To choose a standing monkey, click the empty grey box, then toggle to **My Assets** and click the monkey named **stand**.
+_💡  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: To choose a standing monkey, click the empty grey box, then toggle to **My Assets** and click the monkey named **stand**.
+
+![Toggle to My Assets](/static/skillmap/assets/my-assets-three.png "toggle to the My Assets Window")
 
 
 ```blocks
@@ -48,16 +52,18 @@ let mySprite = sprites.create(assets.image`stand`, SpriteKind.Player)
 ```
 
 
-## Step 4 - Control the Player
+## 4. Control the Player
 
 **↔️ Time to get the player moving ↔️**
 
 ---
 
-► From ``||controller:Controller||``, drag ``||controller:move [mySprite] with buttons ⊕||``
+- :game: Drag ``||controller:move [mySprite] with buttons ➕||``
 to **the end** of the ``||loops:on start||`` container.
 
-► Press the ⊕ button to the right of the block and change the [__*vy*__](#whatVY "vertical velocity") (up/down speed)
+_💡  Remember, the icon to the left of the instructions shows the same icon as the toolbox category for the block you need._
+
+- :mouse pointer: Press the ➕  button to the right of the block and change the [__*vy*__](#whatVY "vertical velocity") (up/down speed)
 argument to **0** so that the player won't hover up or down when you use the joypad.
 
 
@@ -70,16 +76,18 @@ controller.moveSprite(mySprite, 100, 0)
 ```
 
 
-## Step 5 - Try It
+## 5. Try It
 
-**🕹️ Be sure to give your game a try on the game screen 🕹️ **
+**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!")
 
 ---
 
 How do you like it?  Feel like making a few more changes?
 
 
-## Step 6 - Add gravity
+## 6. Add gravity
 
 **To make the game feel more realistic, it needs gravity.**
 
@@ -88,11 +96,14 @@ to "pull down" on the sprite.
 
 ---
 
-►  From ``||sprites:Sprites||``, drag ``||sprites:set [mySprite] [x] to [0]||`` to **the end** of the ``||loops:on start||`` container.
+- :paper plane:  Drag  
+``||sprites:set [mySprite] [x] to [0]||``  
+to **the end** of the  
+``||loops:on start||`` container.
 
-► Click the dropdown to change **x** to **ay (acceleration y)**.
+- :mouse pointer: Click the dropdown to change **x** to **ay (acceleration y)**.
 
-► To pull the sprite toward the ground, replace **0** with **500**.
+- :mouse pointer: To pull the sprite toward the ground, replace **0** with **500**.
 
 ```blocks
 scene.setBackgroundImage(assets.image`background`)
@@ -103,14 +114,16 @@ controller.moveSprite(mySprite, 100, 0)
 mySprite.ay = 500
 ```
 
-## Step 7 - Follow with Camera
+## 7. Follow with Camera
 
 **Oops!  The monkey falls off-screen!**
 
 ---
 
-►  To keep the monkey in sight, open ``||scene:Scene||`` and drag
-``||scene:camera follow sprite [mySprite]||`` to **the end** of the ``||loops:on start||`` container.
+- :tree:  To keep the monkey in sight, drag  
+``||scene:camera follow sprite [mySprite]||``  
+to **the end** of the  
+``||loops:on start||`` container.
 
 ```blocks
 scene.setBackgroundImage(assets.image`background`)
@@ -124,23 +137,28 @@ scene.cameraFollowSprite(mySprite)
 ```
 
 
-## Step 8 - Look Again
+## 8. Look Again
 
-**🕹️ Look at the game window to make sure you can see the monkey land on a platform. 🕹️ **
+**🕹️ Look at the game window to make sure you can see the monkey land on a platform.**
 
 
 
-## Step 9 - Jump
+## 9. Jump
 
 Now that the monkey has landed safely, we can make it jump using the **up** arrow!
 
 ---
 
-► From ``||controller:Controller||``, drag the ``||controller:on [A] button [pressed]||`` container into an empty area of the workspace.
+- :game: Drag the  
+``||controller:on [A] button [pressed]||``  
+container into an empty area of the workspace.
 
-► Click the **A** option and change it to **up**.
+- :mouse pointer: Click the **A** option and change it to **up**.
 
-► Inside of the ``||controller:on [up] button [pressed]||`` container, add ``||sprites:make [mySprite] gravity jump||``.
+- :paper plane: Inside of the  
+``||controller:on [up] button [pressed]||``  
+container, add  
+``||sprites:make [mySprite] gravity jump||``.
 
 ```blocks
 controller.up.onEvent(ControllerButtonEvent.Pressed, function () {
@@ -152,12 +170,14 @@ controller.up.onEvent(ControllerButtonEvent.Pressed, function () {
 
 
 
-## Done
+## Finale
 
-🔥 **That's it! Now give your game a try!** 🔥
+🔥 **That's it! Now give your game a try!** 🔥  
 Can you jump around between platforms?
 
-Take a spin through the level, then click **Done** to return to the main skillmap and go on to the next activity!
+---
+
+Take a spin through the level, then click **Done** to return to the main skillmap and go on to the next activity where we'll show you how to add **good** and **bad** tiles!
 
 
 ```package

package/docs/skillmap/jungle/jungle2.md

@@ -9,9 +9,9 @@
 
 
 
-## Step 2 -Try It!
+## 2. Try It!
 
-**🕹️ First, move your sprite around in the game window 🕹️**
+**🕹️ First, move your sprite around in the game window.**
 
 ---
 
@@ -19,19 +19,24 @@ Keep in mind which piece of code controls each action!
 
 
 
-## Step 3 - Game Over Pt. 1
+## 3. Game Over
 
-**💀 Time for danger 💀 **
+**Time for danger**  
+💀💀💀
 
-When the player overlaps the _poison pit_ tile, let's trigger a "GAME OVER" message.
+When the player overlaps a _poison pit_ tile, let's trigger a "GAME OVER" message.
 
 ---
 
-► From ``||scene:Scene||``, drag the ``||scene:on [sprite] of kind [Player] overlaps [ ] at [location]||`` container into an empty area of the workspace.
+- :tree: Drag the  
+``||scene:on [sprite] of kind [Player] overlaps [ ] at [location]||``  
+container into an empty area of the workspace.
 
-► Click the checkerboard image and change it to the **poison pit** tile.
+- :paint brush: Click the checkerboard image and change it to the **poison pit** tile.
 
-► From ``||game:Game||``, snap a ``||game:game over <LOSE>||`` block into the new container.
+- :circle: Snap a  
+``||game:game over <LOSE>||``  
+block into the new container.
 
 
 ```blocks
@@ -40,9 +45,9 @@ scene.onOverlapTile(SpriteKind.Player, assets.tile`poison pit`, function (sprite
 })
 ```
 
-## Try It!
+## 4. Try It Again!
 
-**🕹️ Give it a try in the game window 🕹️**
+**Give it a try in the game window**
 
 ---
 
@@ -50,19 +55,22 @@ When your monkey lands on the poison pit, it should end the game as a loss.
 
 
 
-## You Win Pt. 1
+## 5. You Win
 
-**🎈 We have a way to lose, let's add a way to win 🎈**
+**We have a way to lose, let's add a way to win!**
 
 ---
 
 
-► Drag another ``||scene:on [sprite] of kind [Player] overlaps [ ] at [location]||``
+- :tree: Drag another  
+``||scene:on [sprite] of kind [Player] overlaps [ ] at [location]||``  
 container into the workspace.
 
-► This time, change the checkerboard to the **chest1** tile.
+- :paint brush: This time, change the checkerboard to the **chest1** tile.
 
-► Snap a ``||game:game over <LOSE>||`` block into the new container and toggle
+- :circle: Snap a  
+``||game:game over <LOSE>||``  
+block into the new container and toggle
 the **`<LOSE>`** switch to **`<WIN>`**!
 
 
@@ -73,20 +81,30 @@ scene.onOverlapTile(SpriteKind.Player, assets.tile`chest1`, function (sprite, lo
 })
 ```
 
+## 6. Try It Again, Again!
 
-## You Earned Points pt. 1
+**Give it a try in the game window**
 
-**💯 Award points when the player collects an orange bauble 💯**
+---
+
+It's easy to lose...but impossible to win!  How do you get over the pits?
+
+
+
+## 7. Add Points 1
+
+**💯 Award points when the player collects an orange bauble.**
 
 ---
 
 
-► Drag another ``||scene:on [sprite] of kind [Player] overlaps [ ] at [location]||``
+- :tree: Drag another  
+``||scene:on [sprite] of kind [Player] overlaps [ ] at [location]||``  
 container into the workspace.
 
-► Change the checkerboard to the orange sphere tile called **orange bauble**.
+- :paint brush: Change the checkerboard to the orange sphere tile called **orange bauble**.
 
-► From ``||info:Info||``, snap a ``||info:change score by [1]||`` block into the new container.
+- :id card: Snap a ``||info:change score by [1]||`` block into the new container.
 
 
 ```blocks
@@ -95,7 +113,7 @@ scene.onOverlapTile(SpriteKind.Player, assets.tile`orange bauble`, function (spr
 })
 ```
 
-## Try It Too!
+## 8. Play!
 
 **🕹️ Play your game and collect an orange bauble 🕹️**
 
@@ -104,15 +122,21 @@ scene.onOverlapTile(SpriteKind.Player, assets.tile`orange bauble`, function (spr
 Uh oh!  You get WAY too many points when you touch an orange bauble. We can fix that in the next step.
 
 
-## You Earned Points pt. 2
+## 9. Add Points 2
 
 **Replace the baubles you collect with an empty tile.**
 
 ---
 
-► From ``||scene:Scene||``, drag ``||scene:set [ ] at tilemap col [0] row [0]||`` into **the top** of the ``||scene:on [sprite] of kind [Player] overlaps [orange bauble] at [location]||`` container.
+- :tree: Drag  
+``||scene:set [ ] at tilemap col [0] row [0]||``  
+into **the top** of the  
+``||scene:on [sprite] of kind [Player] overlaps [orange bauble] at [location]||``   container.
 
-► Replace ``||scene:tilemap col [0] row [0]||`` with the ``||variables:location||`` value from the top of the **Player overlaps orange bauble** container.
+- :mouse pointer: Replace  
+``||scene:tilemap col [0] row [0]||``  
+with the ``||variables:location||``  
+value from the top of the **Player overlaps orange bauble** container.
 
 ![Share your location](/static/skillmap/jungle/jungle-location.gif "Grab the variable from the overlap container")
 
@@ -126,13 +150,13 @@ scene.onOverlapTile(SpriteKind.Player, assets.tile`orange bauble`, function (spr
 
 
 
-## Finished
+## Finale
 
 **Now we have a simple platformer that has a way to win, a way to lose, and a way to collect points.**
 
 ---
 
-When you're done playing with your game, click **Done** to return to the main page to learn how to make it even more exciting.
+When you're done playing with your game, click **Done** to return to the main skillmap and keep going so we can show you how to win the game!
 
 
 

package/docs/skillmap/jungle/jungle3.md

@@ -10,9 +10,9 @@ We need a way to pass the poison pits!
 
 
 
-## Step 2 - Try It!
+## 2. Try It!
 
-**🕹️ First, play the game in the game window 🕹️**
+**🕹️ First, play the game in the game window.**
 
 ---
 
@@ -20,18 +20,24 @@ Can you remember which piece of code controls each action?
 
 
 
-## Step 3 - Adding Block Walls
+## 3. Adding Block Walls
 
-**You know what would help us get over those pits?**
-We need some well-placed platforms! Let's add a crate beneath the player when the A button is pressed.
+**You know what would help us get over those pits?**  
+We need some well-placed platforms! Let's add a crate beneath the player when the (A) button is pressed.
 
 ---
 
-► From ``||controller:Controller||``, drag the ``||controller:on [A] button [pressed]||`` container into an empty area of the workspace.
+- :game: Drag the  
+``||controller:on [A] button [pressed]||``  
+container into an empty area of the workspace.
 
-► Set a wall by going to the ``||scene:Scene||`` category and dragging ``||scene:set wall <OFF> at tilemap col [0] row [0]||`` into the empty ``||controller:on [A] button [pressed]||`` container.
+- :tree: Set a wall by dragging  
+``||scene:set wall <OFF> at tilemap col [0] row [0]||``  
+into the empty  
+``||controller:on [A] button [pressed]||``  
+container.
 
-► Toggle `<OFF>` to `<ON>`.
+- :mouse pointer: Toggle `<OFF>` to `<ON>`.
 
 
 ```blocks
@@ -40,14 +46,20 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 })
 ```
 
-## Step 4 - Adding Block Walls, Cont.
+## 4. Block Walls, Cont.
 
 
-► Make sure the new wall ends up in the right place by opening ``||tiles:Tilemaps||`` and dragging ``||tiles:location [left] of [location]||`` in to replace  ``||scene:tilemap col [0] row [0]||``.
+- :map: Make sure the new wall ends up in the right place by dragging  
+``||tiles:location [left] of [location]||``  
+in to replace   
+``||scene:tilemap col [0] row [0]||``.
 
-► Click the word **left** to open the dropdown menu, and change the direction to **bottom**.
+- :mouse pointer: Click the word **left** to open the dropdown menu, and change the direction to **bottom**.
 
-► Create the wall **under** your sprite by opening ``||tiles:Tilemaps||`` and dragging ``||tiles:location of [mySprite]||`` in to replace  ``||variables:location||``.
+- :map: Create the wall **under** your sprite by dragging  
+``||tiles:location of [mySprite]||``  
+in to replace   
+``||variables:location||``.
 
 
 ```blocks
@@ -59,9 +71,9 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 
 
 
-## Try It!
+## 5. Try It!
 
-**🕹️ Give it a try in the game window 🕹️**
+**🕹️ Give it a try in the game window.**
 
 ---
 
@@ -69,16 +81,20 @@ Try jumping while you press the (A) button. Your monkey should continue to hover
 
 
 
-## Step 5 - Adding Block Tiles
+## 6. Adding Block Tiles
 
-**Where did my brick go??**
+**Where did my brick go??**  
 The walls are great, but it's hard to remember where they are. Let's add special tiles over them so we can find them again later.
 
 ---
 
-► Set a tile by going to the ``||scene:Scene||`` category and dragging ``||scene:set [ ] at tilemap col [0] row [0]||`` into **the bottom** of the ``||controller:on [A] button [pressed]||`` container.
+- :tree: Set a tile by dragging  
+``||scene:set [ ] at tilemap col [0] row [0]||``  
+into **the bottom** of the  
+``||controller:on [A] button [pressed]||``  
+container.
 
-► Click the empty square and choose the crate called **bounce**.
+- :paint brush: Click the empty square and choose the crate called **bounce**.
 
 
 ```blocks
@@ -91,14 +107,19 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 })
 ```
 
-## Step 6 - Adding Block Tiles, Cont.
+## 7. Adding Block Tiles, Cont.
 
 
-► Make sure the new tile ends up in the right place by opening ``||tiles:Tilemaps||`` and dragging ``||tiles:location [left] of [location]||`` in to replace  ``||scene:tilemap col [0] row [0]||``.
+- :map: Make sure the new tile ends up in the right place by dragging  
+``||tiles:location [left] of [location]||``  
+in to replace   
+``||scene:tilemap col [0] row [0]||``.
 
-► Click the word **left** to open the dropdown menu, and change the direction to **bottom**.
+- :mouse pointer: Click the word **left** to open the dropdown menu, and change the direction to **bottom**.
 
-► As before, create the tile **under** your sprite by opening ``||tiles:Tilemaps||`` and dragging ``||tiles:location of [mySprite]||`` in to replace  ``||variables:location||``.
+- :map: As before, create the tile **under** your sprite by dragging  
+``||tiles:location of [mySprite]||``  
+in to replace  ``||variables:location||``.
 
 
 ```blocks
@@ -111,9 +132,9 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 ```
 
 
-## Try It!
+## 8. Try It!
 
-**🕹️ Now try it in the game window 🕹️**
+**🕹️ Now try it in the game window.**
 
 ---
 
@@ -122,13 +143,13 @@ Now you can set your own blocks in-mid air to help you over the poison pit!
 
 
 
-## Finished
+## Finale
 
-**Play your game and see how many points you can get.**
+**Play your game and see how many points you can get!**
 
 ---
 
-When you're done playing, click **Done** to return to the main page to learn how to **break** tiles.
+When you're done playing, click **Done** to return to the main skillmap and continue to the next level where we will show you how to **break** tiles.