pxt-microbit 6.1.2 → 6.1.4

package/docs/projects/heads-guess.md

@@ -1,11 +1,11 @@
 # Heads Guess!
 
-## Introduction @unplugged
+## {Introduction @unplugged}
 
 This is a simple remake of the famous **Heads Up!** game. The player holds the @boardname@ on the forehead and has 30 seconds to guess words displayed on the screen.
 If the guess is correct, the player tilts the @boardname@ forward; to pass, the player tilts it backwards.
 
-## Step 1
+## {Step 1}
 
 Put in code to ``||game:start a countdown||`` of 30 seconds.
 
@@ -13,7 +13,7 @@ Put in code to ``||game:start a countdown||`` of 30 seconds.
 game.startCountdown(30000)
 ```
 
-## Step 2
+## {Step 2}
 
 Create a ``||arrays:text list||`` of words to guess. You will find **Arrays** under **Advanced**.
 
@@ -23,7 +23,7 @@ text_list = ["PUPPY", "CLOCK", "NIGHT"]
 game.startCountdown(30000)
 ```
 
-## Step 3
+## {Step 3}
 
 Add an event to run code when the @boardname@ ``||input:logo||`` is pointing ``||input:up||``.
 This is the gesture to get a new word.
@@ -33,7 +33,7 @@ input.onGesture(Gesture.LogoUp, function () {
 })
 ```
 
-## Step 4
+## {Step 4}
 
 The items in ``||arrays:text list||`` are numbered ``0`` to ``length - 1``.
 Add code to pick a ``||math:random||`` ``||variables:index||``.
@@ -47,7 +47,7 @@ input.onGesture(Gesture.LogoUp, function () {
 })
 ```
 
-## Step 5
+## {Step 5}
 
 Add code to ``||basic:show||`` the value of the item stored at ``||variables:index||`` in  ``||arrays:text list||``.
 
@@ -61,7 +61,7 @@ input.onGesture(Gesture.LogoUp, function () {
 })
 ```
 
-## Step 6
+## {Step 6}
 
 Use an event to run code when the @boardname@ ``||input:screen||`` is pointing ``||input:down||``.
 This is the gesture for a correct guess.
@@ -71,7 +71,7 @@ input.onGesture(Gesture.ScreenDown, function () {
 })
 ```
 
-## Step 7
+## {Step 7}
 
 Put in code to add points to the ``||game:score||``.
 
@@ -82,7 +82,7 @@ input.onGesture(Gesture.ScreenDown, function () {
 })
 ```
 
-## Step 8
+## {Step 8}
 
 Add anonther event to run code when the @boardname@ ``||input:screen||`` is pointing ``||input:up||``.
 This is the gesture for a pass.
@@ -92,7 +92,7 @@ input.onGesture(Gesture.ScreenUp, function () {
 })
 ```
 
-## Step 9
+## {Step 9}
 
 For the pass gesture, add code to remove a ``||game:life||`` from the player.
 

package/docs/projects/hot-potato.md

@@ -1,11 +1,11 @@
 # Hot Potato
 
-## Introduction @unplugged
+## {Introduction @unplugged}
 
 In this game, you will start a timer with a random countdown of a number of seconds. When the timer is off, the game is over and whoever is holding the potato has lost!
 Watch the tutorial on the [MakeCode YouTube channel](https://youtu.be/xLEy1B_gWKY).
 
-## Step 1
+## {Step 1}
 
 Add an event to run code when ``||input:button A is pressed||``.
 
@@ -14,7 +14,7 @@ input.onButtonPressed(Button.A, function () {
 })
 ```
 
-## Step 2
+## {Step 2}
 
 Make a ``||variables:timer||`` variable and ``||variables:set||`` it to
 a ``||math:random value||`` between ``5`` and ``15``.
@@ -29,7 +29,7 @@ input.onButtonPressed(Button.A, function () {
 })
 ```
 
-## Step 3
+## {Step 3}
 
 Add code to ``||basic:show||`` that the game started.
 
@@ -42,7 +42,7 @@ input.onButtonPressed(Button.A, function () {
 })
 ```
 
-## Step 4
+## {Step 4}
 
 Put in a loop to repeat code ``||loops:while||``  ``||variables:timer||`` ``||logic:is positive||``. When `timer` is negative, the game is over.
 
@@ -58,7 +58,7 @@ input.onButtonPressed(Button.A, function () {
 })
 ```
 
-## Step 5
+## {Step 5}
 
 Inside the ``||loops:while||`` loop, add code to ``||variables:decrease||`` the timer ``||loops:every second||``.
 
@@ -76,7 +76,7 @@ input.onButtonPressed(Button.A, function () {
 })
 ```
 
-## Step 6
+## {Step 6}
 
 **After** the ``||loops:while||`` loop is done, add code to ``||basic:show||`` that the game is over.
 
@@ -94,7 +94,7 @@ input.onButtonPressed(Button.A, function () {
 })
 ```
 
-## Step 7
+## {Step 7}
 
 `|Download|` your code to your @boardname@, tape it to a potato and play the game with your friends!
 

package/docs/projects/love-meter.md

@@ -1,12 +1,12 @@
 # Love Meter
 
-## Introduction @unplugged
+## {Introduction @unplugged}
 
 Make a love meter, how sweet! The @boardname@ is feeling the love, then sometimes not so much!
 
 ![Love meter banner message](/static/mb/projects/love-meter/love-meter.gif)
 
-## Step 1
+## {Step 1}
 
 Let's build a **LOVE METER** machine. We'll use an ``||input:on pin pressed||`` block to run code when pin **0** is pressed. Use ``P0`` from the list of pin inputs.
 
@@ -15,34 +15,40 @@ input.onPinPressed(TouchPin.P0, function() {
 })
 ```
 
-## Step 2
+## {Step 2}
 
 Using ``||basic:show number||`` and ``||Math:pick random||`` blocks, show a random number from `0` to `100` when pin **0** is pressed.
 
 ```blocks
 input.onPinPressed(TouchPin.P0, function() {
+    //@highlight
     basic.showNumber(randint(0, 100))
 })
 ```
-## Step 3
+## {Step 3}
 
 Click on pin **0** in the simulator and see which number is chosen.
 
-## Step 4
+## {Step 4}
 
 Show ``"LOVE METER"`` on the screen when the @boardname@ starts.
 
 ```blocks
+//@highlight
 basic.showString("LOVE METER")
 input.onPinPressed(TouchPin.P0, function() {
     basic.showNumber(randint(0, 100))
 });
 ```
 
-## Step 5
+## {Step 5}
 
 Click ``|Download|`` to transfer your code in your @boardname@. Hold the **GND** pin with one hand and press pin **0** with the other hand to trigger this code.
 
+```validation.global
+# BlocksExistValidator
+```
+
 ```template
 input.onPinPressed(TouchPin.P0, function() {})
 ```

package/docs/projects/magic-button-trick.md

@@ -2,7 +2,7 @@
 
 ## ~avatar avatar
 
-Build a magic trick that uses the @boardname@'s compass to detect a nearby magnet!
+Build a magic trick that uses the @boardname@'s magnetometer to detect a nearby magnet!
 
 ## ~
 
@@ -33,7 +33,7 @@ input.onButtonPressed(Button.B, () => {
 
 ## Step 2: Measuring magnetic force
 
-We will use the @boardname@'s compass to detect the magnet. A compass tells us which direction we are pointing to by detecting the Earth's magnetic field, but it can also detect any other magnet nearby. We will use that to check if our magnet is next to the @boardname@ by using the ``||input:magnetic force||`` block found in the **Input** menu's **... More** section. Since we only want to measure the strength we change the drop down to select `strength`:
+We will use the @boardname@'s magnetometer to detect the magnet. We will use it to check if our magnet is next to the @boardname@ by using the ``||input:magnetic force||`` block found in the **Input** menu's **... More** section. Since we only want to measure the strength we change the drop down to select `strength`:
 
 ```block
 let force = input.magneticForce(Dimension.Strength)
@@ -96,8 +96,6 @@ input.onButtonPressed(Button.B, () => {
 
 Now you just need to program your own @boardname@ and practice the trick a few times before performing for your friends. Try asking your friends to click the buttons after you have switched the labels and the trick won't work for them because they don't have a hidden magnet in their hand!
 
-Remember, that as we are using @boardname@'s compass, it will need to be [calibrated](https://support.microbit.org/support/solutions/articles/19000008874-calibrating-the-micro-bit-compass-what-does-it-mean-when-the-micro-bit-says-draw-a-circle-or-tilt) each time we flash the program or run it for the first time.
-
 ## About the authors
 
 This project was contributed by Brian and Jasmine Norman, aka [@MicroMonstersUK](https://twitter.com/MicroMonstersUK). You can checkout their [MicroMonsters](https://www.youtube.com/channel/UCK2DviDexh_Er2QYZerZyZQ) tutorials channel on YouTube for more projects.

package/docs/projects/multi-dice.md

@@ -1,6 +1,6 @@
 # Multi Dice
 
-## Introduction @unplugged
+## {Introduction @unplugged}
 
 ![Multiple @boardname@ throwing a dice](/static/mb/projects/multi-dice.png)
 
@@ -8,7 +8,7 @@ Build a multi-player dice game using the **radio**. The **radio** blocks let you
 
 In this game, you shake to "throw the dice" and send the result to the other @boardname@. If you receive a result of a dice throw equal or greater than yours, you lose.
 
-## Dice game
+## {Dice game}
 
 Let's start by rebuilding the **dice** game. If you are unsure about the details, try the **dice** tutorial again.
 
@@ -18,7 +18,7 @@ input.onGesture(Gesture.Shake, function () {
 })
 ```
 
-## Dice variable
+## {Dice variable}
 
 We need to store the result of the dice cast in a variable. A **variable** is like a place in the memory of the @boardname@ where you save information, like numbers.
 
@@ -34,7 +34,7 @@ input.onGesture(Gesture.Shake, function () {
 })
 ```
 
-## Send the dice
+## {Send the dice}
 
 Put in a ``||radio:send number||`` and a ``||variables:dice||`` to send the value stored in the ``||variables:dice||`` variable via radio. Make sure to add a ``||radio:set group||`` to ``||basic:on start||`` with the group number set to the group you want to use.
 
@@ -48,7 +48,7 @@ input.onGesture(Gesture.Shake, function () {
 })
 ```
 
-## Receive the dice
+## {Receive the dice}
 
 Go get an ``||radio:on received number||`` event block. This event runs when a radio message from another @boardname@ arrives. The ``||variables:receivedNumber||`` value is the value of the dice in this game.
 
@@ -57,7 +57,7 @@ radio.onReceivedNumber(function (receivedNumber) {
 })
 ```
 
-## Check your cast
+## {Check your cast}
 
 Add a ``||logic:if||`` block to test if ``||variables:receivedNumber||`` is greater or equal to ``||variables:dice||``.
 If is, you lost so display a sad face on the screen.
@@ -71,7 +71,7 @@ radio.onReceivedNumber(function (receivedNumber) {
 })
 ```
 
-## Test it!
+## {Test it!}
 
 Try pressing **SHAKE** in the simulator and see that a second @boardname@ appears. You can play the game on both virtual boards.
 

package/docs/projects/name-tag.md

@@ -1,12 +1,12 @@
 # Name Tag
 
-## Introduction @unplugged
+## {Introduction @unplugged}
 
 Tell everyone who you are. Show you name on the LEDs.
 
 ![Name scrolling on the LEDs](/static/mb/projects/name-tag/name-tag.gif)
 
-## Step 1
+## {Step 1}
 
 Place the ``||basic:show string||`` block in the ``||basic:forever||`` block to repeat it. Change the text to your name.
 
@@ -16,11 +16,11 @@ basic.forever(function() {
 })
 ```
 
-## Step 2
+## {Step 2}
 
 Look at the simulator and make sure it shows your name on the screen.
 
-## Step 3
+## {Step 3}
 
 Place more ``||basic:show string||`` blocks to create your own story.
 
@@ -31,7 +31,7 @@ basic.forever(function() {
 })
 ```
 
-## Step 4
+## {Step 4}
 
 If you have a @boardname@ connected, click ``|Download|`` to transfer your code and watch your name scroll!
 

package/docs/projects/rock-paper-scissors-v2.md

@@ -1,12 +1,12 @@
 # Rock Paper Scissors V2
 
-## Introduction @unplugged
+## {Introduction @unplugged}
 
 ![Cartoon of the Rock Paper Scissors game](/static/mb/projects/a4-motion-v2.png)
 
 Build a "Rock Paper Scissors" game with ADDED BONUS SOUNDS using the **micro:bit V2** buzzer!
 
-## Step 1 @fullscreen
+## {Step 1 @fullscreen}
 
 Use the ``||input:on shake||`` block in the Workspace to run code when you shake the @boardname@.
 
@@ -16,13 +16,13 @@ input.onGesture(Gesture.Shake, function () {
 })
 ```
 
-## Step 2 @fullscreen
+## {Step 2 @fullscreen}
 
 Make a new variable called ``hand`` and place the ``||variables:set hand to||`` block in the shake event.
 
 ![A animation that shows how to create a variable](/static/mb/projects/rock-paper-scissors/newvar.gif)
 
-## Step 3 @fullscreen
+## {Step 3 @fullscreen}
 
 Add a ``||math:pick random||`` block to pick a random number from `1` to `3` and store it in the variable named ``hand``.
 
@@ -35,7 +35,7 @@ input.onGesture(Gesture.Shake, function () {
 
 In a later step, each of the possible numbers (`1`, `2`, or `3`) is matched to its own picture. The picture is shown on the LEDs when its matching number is picked.
 
-## Step 4 @fullscreen
+## {Step 4 @fullscreen}
 
 Place an ``||logic:if||`` block under the ``||math:pick random||`` and check whether ``hand`` is equal to ``1``. Add a ``||basic:show leds||`` block that shows a picture of a piece of paper. The number `1` is the value for paper.
 
@@ -57,7 +57,7 @@ input.onGesture(Gesture.Shake, function () {
 })
 ```
 
-## Step 5 @fullscreen
+## {Step 5 @fullscreen}
 
 Place a ``||music:play sound||`` block under ``||basic:show leds||`` and edit it to make it sound like paper.
 
@@ -78,14 +78,14 @@ input.onGesture(Gesture.Shake, function () {
 })
 ```
 
-## Step 6 @fullscreen
+## {Step 6 @fullscreen}
 
 Click on the **SHAKE** button in the simulator. If you try enough times, you should see a picture of paper on the screen.
 
 ![Shaking a @boardname@ simulator](/static/mb/projects/rock-paper-scissors/rpsshake.gif)
 
 
-## Step 7 @fullscreen
+## {Step 7 @fullscreen}
 
 Click the **(+)** button to add an ``||logic:else||`` section.
 
@@ -110,7 +110,7 @@ input.onGesture(Gesture.Shake, function () {
 })
 ```
 
-## Step 8 @fullscreen
+## {Step 8 @fullscreen}
 
 Add both a ``||basic:show leds||`` block and a ``||music:play sound||`` block inside the ``||logic:else||``. Make a picture for **scissors** using LEDs and create a scissors sound.
 
@@ -140,13 +140,13 @@ input.onGesture(Gesture.Shake, function () {
 })
 ```
 
-## Step 9 @fullscreen
+## {Step 9 @fullscreen}
 
 Click the **(+)** button again to add an ``||logic:else if||`` section. Now, add a conditional block for ``||logic:hand = 2||`` to the empty slot in the ``||logic:else if||``. Since ``hand`` can only be `1`, `2`, or `3`, your code is now covering all possible cases!
 
 ![Adding an else if clause](/static/mb/projects/rock-paper-scissors/ifelseif.gif)
 
-## Step 10 @fullscreen
+## {Step 10 @fullscreen}
 
 Get one more ``||basic:show leds||`` block and ``||music:play sound||`` block and put them inside the ``||logic:else if||``. Make a picture of a rock in the LEDs and create a rock-like sound.
 
@@ -185,13 +185,13 @@ input.onGesture(Gesture.Shake, function () {
 })
 ```
 
-## Step 11 @fullscreen
+## {Step 11 @fullscreen}
 
 Click on the **SHAKE** button in the simulator and check to see that each image is showing up.
 
 ![Shaking a @boardname@ simulator](/static/mb/projects/rock-paper-scissors/rpssim3.gif)
 
-## Step 12 @fullscreen
+## {Step 12 @fullscreen}
 
 If you have a @boardname@ V2, click on ``|Download|`` and follow the instructions to get the code
 onto your @boardname@. 

package/docs/projects/rock-paper-scissors.md

@@ -1,12 +1,12 @@
 # Rock Paper Scissors
 
-## Introduction @unplugged
+## {Introduction @unplugged}
 
 ![Cartoon of the Rock Paper Scissors game](/static/mb/projects/a4-motion.png)
 
 Use the accelerometer and the screen to build a **Rock Paper Scissors** game that you can play with your friends!
 
-## Step 1 @fullscreen
+## {Step 1 @fullscreen}
 
 Let's use a ``||input:on shake||`` block to run code when you shake the @boardname@.
 
@@ -16,13 +16,13 @@ input.onGesture(Gesture.Shake, function() {
 })
 ```
 
-## Step 2 @fullscreen
+## {Step 2 @fullscreen}
 
 Add a ``hand`` variable and place the ``||variables:set hand to||`` block in the shake event.
 
 ![A animation that shows how to create a variable](/static/mb/projects/rock-paper-scissors/newvar.gif)
 
-## Step 3 @fullscreen
+## {Step 3 @fullscreen}
 
 Add a ``||math:pick random||`` block to pick a random number from `1` to `3` and store it in the variable named ``hand``.
 
@@ -35,7 +35,7 @@ input.onGesture(Gesture.Shake, function() {
 
 In a later step, each of the possible numbers (`1`, `2`, or `3`) is matched to its own picture. The picture is shown on the LEDs when its matching number is picked.
 
-## Step 4 @fullscreen
+## {Step 4 @fullscreen}
 
 Place an ``||logic:if||`` block under the ``||math:pick random||`` and check whether ``hand`` is equal to ``1``. Add a ``||basic:show leds||`` block that shows a picture of a piece of paper. The number `1` will mean paper.
 
@@ -57,13 +57,13 @@ input.onGesture(Gesture.Shake, function() {
 })
 ```
 
-## Step 5 @fullscreen
+## {Step 5 @fullscreen}
 
 Click on the **SHAKE** button in the simulator. If you try enough times, you should see a picture of paper on the screen.
 
 ![Shaking a @boardname@ simulator](/static/mb/projects/rock-paper-scissors/rpsshake.gif)
 
-## Step 6 @fullscreen
+## {Step 6 @fullscreen}
 
 Click the **(+)** button to add an ``||logic:else||`` section.
 
@@ -87,7 +87,7 @@ input.onGesture(Gesture.Shake, function() {
 })
 ```
 
-## Step 7 @fullscreen
+## {Step 7 @fullscreen}
 
 Add a ``||basic:show leds||`` block inside the ``||logic:else||``. Make a picture of a scissors in the LEDs.
 
@@ -115,13 +115,13 @@ input.onGesture(Gesture.Shake, function() {
 })
 ```
 
-## Step 8 @fullscreen
+## {Step 8 @fullscreen}
 
 Click the ``+`` button again to add an ``||logic:else if||`` section. Now, add a conditional block for ``||logic:hand = 2||`` to the condition in ``||logic:else if||``. Since ``hand`` can only be `1`, `2`, or `3`, your code is covering all possible cases!
 
 ![Adding an else if clause](/static/mb/projects/rock-paper-scissors/ifelseif.gif)
 
-## Step 9 @fullscreen
+## {Step 9 @fullscreen}
 
 Get one more ``||basic:show leds||`` block and put it in the ``||logic:else if||``. Make a picture of a rock in the LEDs.
 
@@ -157,13 +157,13 @@ input.onGesture(Gesture.Shake, function() {
 })
 ```
 
-## Step 10 @fullscreen
+## {Step 10 @fullscreen}
 
 Click on the **SHAKE** button in the simulator and check to see that each image is showing up.
 
 ![Shaking a @boardname@ simulator](/static/mb/projects/rock-paper-scissors/rpssim3.gif)
 
-## Step 11 @fullscreen
+## {Step 11 @fullscreen}
 
 If you have a @boardname@, click on ``|Download|`` and follow the instructions to get the code
 onto your @boardname@. Your game is ready! Gather your friends and play Rock Paper Scissors!

package/docs/projects/smiley-buttons.md

@@ -1,13 +1,13 @@
 # Smiley Buttons
 
-## Introduction @unplugged
+## {Introduction @unplugged}
 
 Code the buttons on the @boardname@ to show that it's happy or sad.
 (Want to learn how the buttons works? [Watch this video](https://youtu.be/t_Qujjd_38o)).
 
 ![Pressing the A and B buttons](/static/mb/projects/smiley-buttons/sim.gif)
 
-## Step 1
+## {Step 1}
 
 Use the ``||input:on button pressed||`` block to run code when button **A** is pressed.
 
@@ -16,7 +16,7 @@ input.onButtonPressed(Button.A, function() {
 })
 ```
 
-## Step 2
+## {Step 2}
 
 Place a ``||basic:show leds||`` block inside ``||input:on button pressed||`` to display a smiley on the screen. Press the **A** button in the simulator to see the smiley.
 
@@ -32,7 +32,7 @@ input.onButtonPressed(Button.A, function() {
 })
 ```
 
-## Step 3
+## {Step 3}
 
 Add ``||input:on button pressed||`` and ``||basic:show leds||`` blocks to display a frowny when button **B** is pressed.
 
@@ -48,7 +48,7 @@ input.onButtonPressed(Button.B, function() {
 });
 ```
 
-## Step 4
+## {Step 4}
 
 Add a secret mode that happens when **A** and **B** are pressed together. For this case, add multiple ``||basic:show leds||`` blocks to create an animation.
 
@@ -71,11 +71,11 @@ input.onButtonPressed(Button.AB, function() {
 })
 ```
 
-## Step 5
+## {Step 5}
 
 If you have a @boardname@, connect it to USB and click ``|Download|`` to transfer your code. Press button **A** on your @boardname@. Try button **B** and then **A** and **B** together.
 
-## Step 6
+## {Step 6}
 
 Nice! Now go and show it off to your friends!