pxt-arcade 1.7.3 → 1.7.4

package/docs/skillmap/story/story1.md

@@ -156,7 +156,7 @@ forever(function () {
 ```
 
 
-## Intro @showdialog
+## {Intro @showdialog}
 
 Are you ready to make greeting cards for your friends and family?
 
@@ -166,7 +166,7 @@ Follow these quick steps and you'll have one in no time!
 
 
 
-## Step 2
+## {Step 2}
 
 **🎨 This card centers around an artistic background 🎨**
 
@@ -313,7 +313,7 @@ scene.setBackgroundImage(img`
 
 
 
-## Step 3
+## {Step 3}
 
 **💛 Let's add a heartfelt greeting 💛**
 
@@ -451,7 +451,7 @@ scene.setBackgroundImage(img`
 
 
 
-## Step 4
+## {Step 4}
 
 **🎉 Time for a celebration 🎉**
 
@@ -590,7 +590,7 @@ effects.confetti.startScreenEffect()
 ```
 
 
-## Step 5
+## {Step 5}
 
 **🎵 Let's add a personal note 🎵 **
 
@@ -738,7 +738,7 @@ music.playMelody("G B A G C5 B A B ", 120)
 
 
 
-## Congrats @showdialog
+## {Congrats @showdialog}
 
 **🥳 That's it! 🥳**
 
@@ -747,7 +747,7 @@ You now have a basic greeting card!
 **Take a look at the game screen to see how it turned out!**
 
 
-## Finish
+## {Finish}
 
 **Congratulations, you've finished your greeting card! **
 

package/docs/skillmap/story/story2.md

@@ -289,13 +289,13 @@ forever(function () {
 ```
 
 
-## Introduction @showdialog
+## {Introduction @showdialog}
 
 You've created a greeting, now let's send it over the top!
 
 ![Send our love](/static/skillmap/story/story-activity-2.gif "Why do tropical fish like saltwater?" )
 
-## Step 2
+## {Step 2}
 
 The code for a simple greeting card is already in the workspace.
 **⭐ Build a new card by editing the images ⭐**
@@ -444,7 +444,7 @@ music.playMelody("G B A G C5 B A B", 120)
 ![The background gallery](/static/skillmap/story/story-bg-select.gif "Toggle between editor and gallery" )
 
 
-## Step 3
+## {Step 3}
 
 **🎹 Cue the music 🎹**
 
@@ -593,7 +593,7 @@ music.playMelody("G B A G C5 B A B ", 120)
 
 
 
-## Step 4
+## {Step 4}
 
 You can make your card even more special by adding some text that
 cycles through when the **Ⓐ** button is pressed.
@@ -617,7 +617,7 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 
 ```
 
-## Step 5
+## {Step 5}
 
 👀 Now take a look at your card on the game screen 👀
 
@@ -625,7 +625,7 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 
 
 
-## Step 6
+## {Step 6}
 
 **💚 What a nice surprise 💚 **
 Add a second message below the first to really show you care.
@@ -649,7 +649,7 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 ```
 
 
-## Step 7
+## {Step 7}
 
 **🎨 Make it POP 🎨**
 Customize the dialog to bring it all together.
@@ -708,14 +708,14 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 ```
 
 
-## Step 8
+## {Step 8}
 
 😍 Take a look at your card on the game screen 😍
 
 **Press the Ⓐ button to cycle through your messages.**
 
 
-## Step 9
+## {Step 9}
 
 **🎀 The final touch 🎀**
 Change the color of your text so it works with your new background.
@@ -775,7 +775,7 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 ```
 
 
-## Congrats @showdialog
+## {Congrats @showdialog}
 
 🥳 That's it! 🥳
 
@@ -784,7 +784,7 @@ to see how it works!**
 
 
 
-## Finale
+## {Finale}
 
 **🎊 Congrats 🎊**
 

package/docs/skillmap/story/story3.md

@@ -198,7 +198,7 @@ forever(function () {
 
 ```
 
-## Introduction @showdialog
+## {Introduction @showdialog}
 
 Everyone loves a good joke.
 Let's build one we can share with friends.
@@ -209,7 +209,7 @@ add style.
 
 ![Here's the story](/static/skillmap/story/saltwater.gif "Why do tropical fish like saltwater?" )
 
-## Step 2
+## {Step 2}
 
 To prepare for the next steps,
 [__*click here to choose a joke from our list*__](#doc:/skillmap/story/joke-examples "Find a good two line joke here."),
@@ -222,7 +222,7 @@ A: Because pepper makes them sneeze!
 ```
 
 
-## Step 3
+## {Step 3}
 
 
 Do you have a joke?
@@ -367,7 +367,7 @@ dddddddddd444ddddd3ddddddddddddd4ddddddddddddddddddddddddddddddddddddddddddddddd
 
 
 
-## Step 4
+## {Step 4}
 
 **✨ Great ✨**
 
@@ -513,7 +513,7 @@ let mySprite = sprites.create(assets.image`myImage1`, SpriteKind.Player)
 
 ```
 
-## Step 5
+## {Step 5}
 
 One benefit of having text controlled by a button is that
 the reader gets to choose the timing of the joke.
@@ -533,7 +533,7 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 })
 ```
 
-## Step 5
+## {Step 5}
 
 No matter how you split your joke, you're likely to get the biggest laugh if
 your punchline is presented separately at the end.
@@ -546,7 +546,7 @@ the last line, and it's the part that makes people laugh.
 ► Break the rest of the joke up into small sentences. How many long text boxes will you need?
 
 
-## Step 6
+## {Step 6}
 
 ► Right-click and duplicate the ``||game: show long text [" "] [bottom]||`` block as many times as you need to fit your entire joke.
 
@@ -563,7 +563,7 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 
 
 
-## Step 7
+## {Step 7}
 
 **Take a minute to look at your joke on the game screen!**
 
@@ -582,7 +582,7 @@ Does the text flow better somewhere else?
     game.showLongText("...you shouldn't try skydiving!", DialogLayout.Right)
 ```
 
-## Step 8
+## {Step 8}
 
 **👏 Now take a bow 👏**
 
@@ -604,7 +604,7 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 })
 ```
 
-## Finale
+## {Finale}
 
 **🤣 Congrats 🤣**
 

package/docs/skillmap/story/story4.md

@@ -490,7 +490,7 @@ controller.right.onEvent(ControllerButtonEvent.Pressed, function () {
 
 ```
 
-## Introduction @showdialog
+## {Introduction @showdialog}
 
 Short stories are fun to read and fun to write!
 
@@ -500,7 +500,7 @@ share anywhere we like.
 ![Here's the story](/static/skillmap/story/story-activity-4.gif "How mystical!" )
 
 
-## Step 2
+## {Step 2}
 
 The base code for a two-line story is already in the workspace.
 Let's build on it to create a new short story worth sharing.
@@ -516,7 +516,7 @@ Example 3: An alien in the grocery store
 ```
 
 
-## Step 3
+## {Step 3}
 
 **Now add your setting and main character to the story.**
 
@@ -781,7 +781,7 @@ mySprite = sprites.create(img`
 ```
 
 
-## Step 4
+## {Step 4}
 
 **📚 Explain your set-up 📚**
 
@@ -836,7 +836,7 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 ```
 
 
-## Step 5
+## {Step 5}
 
 **🎭 Create some drama 🎭**
 
@@ -889,7 +889,7 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 
 
 
-## Step 6
+## {Step 6}
 
 **📕 Show the story 📕**
 
@@ -963,7 +963,7 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 
 ```
 
-## Step 7
+## {Step 7}
 
 **😲 The reaction 😲**
 
@@ -1036,7 +1036,7 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 ```
 
 
-## Step 8
+## {Step 8}
 
 **🌳 Change of scene 🌳**
 
@@ -1263,7 +1263,7 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 })
 ```
 
-## Step 9
+## {Step 9}
 
 **🎬 The conclusion 🎬**
 
@@ -1758,7 +1758,7 @@ controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
 
 ```
 
-## finish
+## {finish}
 
 **And that's it!**
 

package/docs/skillmap/zoo/zoo1.md

@@ -11,19 +11,21 @@ No worries,
 we'll show you the zookeeper ropes. First things first,
 click that green **OK** button to see the **Keeper's Hut**.
 
-## Step 1
 
-**🏠 Home sweet home 🏠**.
+## 2. Make a Sprite
+
+**🏠 Home sweet home 🏠**   
 Let's get you set up in your new place!
 
 ---
 
-▶ From the ``||sprites:Sprites||`` category, drag the ``||variables:set [mySprite] to sprite [ ] of kind [Player]||``
+- :paper plane:  From the ``||sprites:Sprites||`` category, drag the  
+``||variables:set [mySprite] to sprite [ ] of kind [Player]||``   
 block into the ``||loops:on start||`` container.
 
-▶ Click the grey box to open the **image editor** and draw yourself in your best zookeeper outfit!
+- :paint brush:  Click the grey box to open the **image editor** and draw yourself in your best zookeeper outfit!
 
-▶ Click **> Next** when you're ready to see the next step.
+- :mouse pointer:  Click **Next** when you're ready to see the next step.
 
 ```blocks
 let mySprite = sprites.create(img`
@@ -46,21 +48,19 @@ let mySprite = sprites.create(img`
     `, SpriteKind.Player)
 ```
 
-## Step 2
+## 3. Move Around
 
-**🕰 Time to get moving 🕰**
+**🕰 Time to get move 🕰**  
 
 ---
 
-▶ From the ``||controller:Controller||`` category, drag
-``||controller:move [mySprite] with buttons ⊕||``
+- :game:  From the ``||controller:Controller||`` category, drag  
+``||controller:move [mySprite] with buttons ⊕||``  
 into the bottom of the ``||loops:on start||`` container.
 
 ---
 
 This will allow you to move your sprite around the screen.
-Try it on the game screen using the arrow keys on your keyboard
-or by clicking the joystick.
 
 
 ```blocks
@@ -86,14 +86,27 @@ let mySprite = sprites.create(img`
 controller.moveSprite(mySprite)
 ```
 
-## Step 3
+## 4. 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 around the game screen!  Your zookeeper will move with the joypad or the arrow keys on your keyboard.
 
-**👀 Take a look around the room 👀**
+
+
+## 5. Look About
+
+**Take a look around the room**  
+👀 
 
 ---
 
-▶ From the ``||scene:Scene||`` category, drag ``||scene:camera follow sprite [mySprite]||`` into the bottom
-of the ``||loops:on start||`` container and use the arrow keys to
+- :tree:  From the ``||scene:Scene||`` category, drag  
+``||scene:camera follow sprite [mySprite]||``  
+into the bottom of the ``||loops:on start||`` container and use the arrow keys to
 check out the hut!
 
 ```blocks
@@ -120,10 +133,12 @@ controller.moveSprite(mySprite)
 scene.cameraFollowSprite(mySprite)
 ```
 
-## Step 4
+## Finale
 
 **🐯 Fantastic! 🐯**
 
+---
+
 You're all ready for your first task.
 
 Click on the **Done** button to head out to the **Zoo**!

package/docs/skillmap/zoo/zoo2.md

@@ -1,23 +1,26 @@
 # First Exhibit: By Land
 
 
-## Step 1
+## 1. Make an Animal
 
-**Your very first exhibit! Exciting, huh?**
+**Your very first exhibit!**  
+Exciting, huh?
 
 Hm... it does look a little empty.  
 Well, what's your favorite animal? Let's invite them over!
 
 ---
 
-▶ From the ``||sprites:Sprites||`` category, drag ``||variables:set [mySprite] to sprite [ ] of kind [Player]||`` 
+- :paper plane:  From the ``||sprites:Sprites||`` category, drag  
+``||variables:set [mySprite] to sprite [ ] of kind [Player]||``   
 into ``||loops:on start||``. 
 
-▶ Click the grey box in the new block and draw your animal using the **image editor**!
+- :paint brush:  Click the grey box in the new block and draw your animal using the **image editor**!
 
-▶ Click **> Next** when you're ready for the next step.
+- :mouse pointer:  Click **> Next** when you're ready for the next step.
 
 ```blocks
+//@highlight
 let mySprite = sprites.create(img`
     . . . . . . 5 5 5 . . . . . . . 
     . . . . 5 5 5 5 5 5 5 . . . . . 
@@ -38,19 +41,20 @@ let mySprite = sprites.create(img`
     `, SpriteKind.Player)
 ```
 
-## Step 2 
-
-**🦓  Take your animal for a walk! 🐆**
+## 2. Move Around 
 
+**Take your animal for a walk!**
+🐆 🦓
 ---
 
-▶From ``||sprites:Sprites||``, grab
-``||sprites:set [mySprite] velocity to vx [50] vy [50]||`` 
-and drag it into the **end** of the ``||loops:on start||`` container. Your animal friend
-should start moving! 
+- :paper plane: From ``||sprites:Sprites||``, grab  
+``||sprites:set [mySprite] velocity to vx [50] vy [50]||``  
+and drag it into the **end** of the ``||loops:on start||`` container. 
 
-▶ Try changing the numbers next to **vx** and **vy**
-and watch the game screen to see what happens.
+Your animal friend should start moving! 
+
+- :mouse pointer:  Try changing the numbers next to **vx** and **vy**
+and watch the game screen to see what happens!
 
 ```blocks
 let mySprite = sprites.create(img`
@@ -75,22 +79,22 @@ let mySprite = sprites.create(img`
 mySprite.setVelocity(50, 50)
 ```
 
-## Step 3
+## 3. Random Mosey
 
 The same old path gets boring after a while.  
 **Let's add some randomness!**
 
 ---
 
-▶ Go to the ``||math:Math||`` category and grab two 
-``||math:pick random [0] to [10]||`` value blocks. 
-Use them to replace the numbers next to the **vx** and **vy**. 
+- :calculator:  Go to the ``||math:Math||`` category and grab two   
+``||math:pick random [0] to [10]||``   
+value blocks. 
 
-▶ Change the numbers inside the **random** blocks to see different kinds of 
-movement each time you reload!
+- :mouse pointer:  Use the two **random** value blocks to replace the numbers next to the **vx** and **vy**. 
 
----
-**Hint:** Don't forget to try negative numbers!
+- :mouse pointer:  Change the numbers inside the **random** blocks to see different kinds of movement each time you reload!
+
+_💡 Don't forget to try negative numbers!_
 
 
 ```blocks
@@ -116,18 +120,18 @@ let mySprite = sprites.create(img`
 mySprite.setVelocity(randint(-50, 50), randint(-50, 50))
 ```
 
-## Step 4 
+## 4. Bounce 
 
-**When the animal hits the edge of the enclosure they stop moving!**
+**When the animal hits the edge of the enclosure it stops moving!**
 
 Let's fix that. 
 
 ---
 
-▶ Open the ``||sprites:Sprites||`` category, then grab ``||sprites:set [mySprite] bounce on wall <ON>||`` 
+- :paper plane:  Open the ``||sprites:Sprites||`` category, then grab  
+``||sprites:set [mySprite] bounce on wall <ON>||``  
 to snap in at the **end** of the program.
 
----
 
 Now your animal can explore the entire exhibit!
 
@@ -156,7 +160,18 @@ mySprite.setVelocity(randint(-50, 50), randint(-50, 50))
 mySprite.setBounceOnWall(true)
 ```
 
-## Step 5 @showdialog
+## 5. 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!")
+
+---
+
+Watch your animal move around!
+
+
+
+## 6. Something's Happening @showdialog
 
 ![A clipboard with a checklist. One item is checked off](/static/skillmap/zoo/zoo-clipboard.png)
 
@@ -165,7 +180,7 @@ mySprite.setBounceOnWall(true)
 The other kids at the zoo are going to 
 love it...WHOA! What's that sound?
 
-## Step 6 @showdialog
+## 7. WooWoo @showdialog
 
 ![A rotating red siren](/static/skillmap/zoo/siren.gif)
 
@@ -174,10 +189,10 @@ love it...WHOA! What's that sound?
 What's going on? Hold on, we're getting a report from the penguin department — the
 penguins did *what*? 
 
-## Step 7
+## Finale
 **🚨 OH NO🚨**
 
-You better get over there!
+You better click **Done** and get over there!