pxt-arcade 1.12.18 → 1.13.2

package/built/targetlight.json

@@ -508,11 +508,11 @@
         }
     ],
     "versions": {
-        "branch": "v1.12.18",
-        "tag": "v1.12.18",
-        "commits": "https://github.com/microsoft/pxt-arcade/commits/addd60bb6f35bfc5c1da4ee5f067da4d71f23e29",
-        "target": "1.12.18",
-        "pxt": "8.5.25"
+        "branch": "v1.13.2",
+        "tag": "v1.13.2",
+        "commits": "https://github.com/microsoft/pxt-arcade/commits/ea30c89ba2e2fce256192efb7837b9e605bcadc9",
+        "target": "1.13.2",
+        "pxt": "8.5.22"
     },
     "blocksprj": {
         "id": "blocksprj",

package/docs/beta-ref.json

@@ -1,3 +1,3 @@
 {
-    "appref": "v"
+    "appref": "v1.12"
 }

package/docs/hardware/kiosk.md

@@ -1,116 +1,83 @@
-# Kiosk
+# MakeCode Arcade Kiosk
 
-To allow users to showcase their games in a fun and unique way, the Kiosk is added to Makecode Arcade. The Kiosk is an interface where a list of games is displayed in a carousel, letting a user scroll through what's currently highlighted to play. Hopefully, this will excite users to want to upload their games.  
+The Kiosk mode in MakeCode Arcade is meant to be used in conjunction with a MakeCode Arcade machine, a [DIY MakeCode Arcade cabinet]( https://arcade.makecode.com/hardware/raspberry-pi/wooden-cabinet), or a simple computer screen with a game controller interface – i.e. [Shoe Box Controller](https://arcade.makecode.com/hardware/shoebox-controller).
 
-## Getting started 
+![Makecode Arcade consoles](/static/hardware/kiosk/makecode-arcade-machines.jpg)
 
-The default Kiosk contains an initial set some of our most popular games from Arcade. This page is located at https://arcade.makecode.com/kiosk.
+In Kiosk mode, MakeCode Arcade games are displayed in a carousel list. Games may be browsed and played using the joystick and buttons on an Arcade machine.
 
-![Starting screen](/static/hardware/kiosk/select-a-game.png)
+## Setting up the Kiosk
 
-## Clearing the Kiosk
-
-To have students start with an empty (clean) Kiosk, so that they won't be tempted to play random games, you can add the clean flag to the url:
-
-https://arcade.makecode.com/kiosk?clean=1
-
-If there are no games uploaded yet, your kiosk will look like the following:
-
-![No games uploaded yet](/static/hardware/kiosk/no-uploaded-games.png)
-
-If you have only uploaded one game, you will see three copies of that game. This gives the illusion that you can move to the next or previous game even though it's the same one.
-
-![Just one uploaded game](/static/hardware/kiosk/single-uploaded-game.png)
-
-When you upload more games, you will see them in the list as you scroll through.
+To use the MakeCode Arcade Kiosk mode in an Arcade machine or cabinet, you will need a monitor and a computer with internet access.
 
-![Multiple uploaded games](/static/hardware/kiosk/multiple-uploaded-games.png)
+If you are using a Windows computer for your Arcade machine, we recommend using [Windows Kiosk mode](https://learn.microsoft.com/en-us/deployedge/microsoft-edge-configure-kiosk-mode#configure-using-windows-settings) and select Microsoft Edge displayed full-screen with MakeCode Arcade Kiosk https://arcade.makecode.com/kiosk as the default URL, and in step 10 select Never. If you want to escape from the Windows Kiosk mode, press ctrl+alt+delete to switch or reboot user. Watch this [video](https://youtu.be/Z8alME1nRmQ) to see the process.
 
-## Locking the Kiosk
+## Operating the Kiosk
 
-If you are just looking to put games on display and not to edit the game list already in the kiosk, there is a **lock** flag that can be added to the url. This makes the **Add your game** button disappear. https://arcade.makecode.com/kiosk?lock=1 
+The default Kiosk mode, accessed at https://arcade.makecode.com/kiosk, contains a list of popular MakeCode Arcade single and multiplayer games including [Galga](https://arcade.makecode.com/_Y8VUmcHYsdsy), [Secure the River](https://arcade.makecode.com/32777-59846-95775-11055), [Tic Tac Two](https://arcade.makecode.com/13412-17300-80986-88577), [Pigeon: Deliverance](https://arcade.makecode.com/24832-19682-40817-54648) and more – see [GameList.json](https://github.com/microsoft/pxt-arcade/blob/master/kiosk/public/GameList.json) for the full list.
 
-![Locked kiosk](/static/hardware/kiosk/locked-state.png)
+To navigate the Kiosk interface, use the **Player 1** joystick and the **A** button:
 
-You can put your Kiosk in a locked and clean state by using both flags together like the this:
+* **Joystick**: left and right will allow you to move game selection through the carousel list
+* **Joystick**: up and down allows you to select the "Add your game" button, or scroll through the alphabet when setting High Score initials for a game
+* **Button A**: enter or select to play a game, click on buttons, or set a name initial in the High Score interface
+* **Menu button**: if your Arcade machine or controller includes a Menu button, this will take you back to the main Kiosk carousel menu screen
 
-https://arcade.makecode.com/kiosk?clean=1&lock=1
+If you have a keyboard connected to your Arcade machine, you can also use the directional arrow keys or WASD keys to simulate joystick movement, 
+the **Space bar** for the **A** button, and the **Escape** key (Esc) for the Menu button.
 
-The order of the flags does not matter.
+Each game in the Kiosk has an image or gif, a title, a description, and some have a list of high scores if scoring is enabled in the game.
 
-## Kiosk controls 
+![Share project button](/static/hardware/kiosk/hot-air-balloon.png)
 
-The Kiosk is added to improve the "console style" experience and the intention is that users will have a keyboard, connect their computer to a shoebox controller, or build themselves an arcade cabinet. You can do any of those projects with our help here: 
+## Customizing the Kiosk
 
-* [Making an arcade cabinet](https://arcade.makecode.com/hardware/raspberry-pi/wooden-cabinet)
-* [Making a shoe box controller](https://arcade.makecode.com/hardware/shoebox-controller)
+The MakeCode Arcade Kiosk mode supports fully customizing the game list. Any customizations you make will be stored in the local browser’s memory. This means that if you clear your browser history on the Arcade machine’s computer, your customizations will be lost. A best practice is to store a list of the share URL’s or game files for your Kiosk games in case they accidentally get deleted from the kiosk.
 
-There's a full list of do it yourself projects at:
+## Adding a game to the Kiosk
 
-* [Do it yourself hardware](diy-hardware)
+Open the [MakeCode Arcade]( https://arcade.makecode.com) game you would like to add to your Kiosk, and click the **Share** button.
 
-Because of this, the only way to interact with the kiosk is through keyboard controls. 
+![Share project button](/static/hardware/kiosk/share-button.png)
 
-![Keyboard controls](/static/hardware/kiosk/keyboard-controls.png)
+Give your game a title and select an image or gif of your game and click the **Share Project** button.
 
-Two additional keyboard controls are:
+![Share project dialog](/static/hardware/kiosk/share-project.png)
 
-* **Spacebar**: Select
-* **ESC**: Exit
+In the next window, click the **Share to Kiosk** button which will allow you to enter a code for your Kiosk.
 
-## Adding a game to the Kiosk 
+![Share project dialog with kiosk button](/static/hardware/kiosk/share-kiosk-button.png)
 
-Use the up arrow or trigger your joystick in the upwards direction to select the **Add your game** button.
+To obtain the code for your kiosk, on your Arcade machine’s computer, open [kiosk](https://arcade.makecode.com/kiosk) mode, then use the joystick to navigate to the **Add your game** button. Then press the **A** button to select.
 
-![Starting screen](/static/hardware/kiosk/select-a-game.png)
+![Select a game screen](/static/hardware/kiosk/select-a-game.png)
 
-Use the space bar or the a button to select the button. Then, scan the QR code on the Kiosk.
+In the "Add your Game" screen, you’ll see the 6-digit alphanumeric code of your kiosk.
 
-![Add your game screen](/static/hardware/kiosk/add-your-game.png)
+Type this code into the Share Project window of your game and click Submit.
 
-Get the share link or QR code of the game you created in MakeCode Arcade.
+![Share project dialog with kiosk code](/static/hardware/kiosk/share-kiosk-code.png)
 
-![Share project window](/static/hardware/kiosk/share-project.png)
+This will append your game to your Arcade machine’s kiosk game list.
 
-The steps to get your game's share link or QR code are outlined [below](#share-link-qr-code).
+Alternately, you can add a game to the kiosk through a shared game link. On the MakeCode Arcade machine, use your phone or other computer’s camera to scan the QR code in the Add your Game screen for your kiosk (or browse to http://arcade.makecode.com/kiosk#add-game:<KIOSK_ID> where the KIOSK ID is the 6-digit alphanumeric code of your kiosk) and enter in the **Share Link** for the game you would like to add to the kiosk.
 
-Use the following page to add your game.
+Please note that for security purposes, the Kiosk ID is only valid for 10 minutes, after which time you will need to generate a new Kiosk ID. There is no limit to how many games can be added to a kiosk.
 
-![Add the game to a kiosk](/static/hardware/kiosk/add-to-kiosk.png)
-
-If you submit/scan your game successfully, your game will be launched on the Kiosk. If you don't see your game, wait 5 seconds as the Kiosk might be polling for it. If you do not see your game in a couple of seconds, there might be something wrong. Check the logs on the page using the Developer Tools window.
-
-## Removing all user uploaded games from the Kiosk 
-
-At some point you may decide that you no longer want your games in the Kiosk anymore. If you want to get rid of all the user-uploaded games from Kiosk, follow these steps:
-
-1. Inspect the page by right clicking on the Kiosk's landing page and selecting 'Inspect'.
-This will bring up the Developer Tools window. 
-2. In the 'Application' tab, find the 'Storage' section.
-3. Expand 'Local Storage'.
-4. Click https://arcade.makecode.com to see all the items.
-5. Filter the items with the word 'user'.
-6. Click on the entry 'UserAddedGames'.
-7. Press backspace or delete on your keyboard.
-8. Close the Developer tools.
-9. Refresh the kiosk. You will now have the default kiosk.
-
-## Getting a game's share link or QR code #share-link-qr-code
-
-You can get a game's share link or QR code using these steps:
+## Clearing the Kiosk
 
-Click on the three connected dots in the upper right corner of the Arcade editor.
+Instead of starting with the default game list in the MakeCode Arcade Kiosk, you can open Kiosk mode with no games in the game list. Use the **"clean=1"** flag to do this:
 
-![Arcade editor menu bar](/static/hardware/kiosk/menu-bar.png)
+https://arcade.makecode.com/kiosk?clean=1
 
-Make sure to change your project title to something fun and update the project thumbnail if desired. Click 'Share Project'.
+![No games uploaded yet](/static/hardware/kiosk/no-uploaded-games.png)
 
-![Share project and name the project](/static/hardware/kiosk/shared-project-name.png)
+Note that if you have only uploaded one game to the kiosk, you will see three copies of that game. This behavior just allows the carousel interface to scroll to the left or right. Once you upload 3 or more different games, you should not see any duplicate games in the list.
 
-For the share link: Click 'Copy'. This will copy the game's share link to your clipboard.
+![Just one uploaded game](/static/hardware/kiosk/single-uploaded-game.png)
 
-![Shared project link](/static/hardware/kiosk/shared-project-link.png)
+## Locking the Kiosk
 
-To scan the QR Code, click on the QR code to enlarge it.
+Once you’ve set up your game list in the Kiosk, you have the option to lock the kiosk into a read-only mode – where no games can be added or deleted. This may be helpful if you have your MakeCode Arcade machine located in a public space and don’t want people to edit your game list. Use the **"lock=1"** flag to do this:
 
-![Enlarged QR code for scanning](/static/hardware/kiosk/qr-code-enlarged.png)
+https://arcade.makecode.com/kiosk?lock=1

package/docs/hero-banner.md

@@ -5,8 +5,15 @@ Here are some cool activities to get you started with your @boardname@!
 ## Intro Content
 
 ### ~ codecard
+* name: Start Skillmap
+* buttonLabel: Start Skillmap
+* description: New? Start here!
+* imageUrl: /static/hero-gallery/skillmap.png
+* url: https://aka.ms/ArcadeSkillmap
+* cardType: link
+---
 * name: Stand with Wakanda
-* buttonLabel: Make it now
+* buttonLabel: Make It Now
 * imageUrl: /static/hero-gallery/wakanda-banner.png
 * url: /tutorials/wakanda-forever
 * cardType: tutorial
@@ -17,13 +24,7 @@ Here are some cool activities to get you started with your @boardname@!
 * url: https://arcade.makecode.com/hour-of-code-2022
 * cardType: link
 ---
-* name: Holiday Bow Battle!
-* buttonLabel: Try Now
-* imageUrl: /static/hero-gallery/holiday.png
-* url: /tutorials/holiday
-* cardType: tutorial
----
-* name: How-to code a video game
+* name: How To Code a Video Game
 * imageUrl: /static/hero-gallery/how-to-code.png
 * youTubePlaylistId: PLMMBk9hE-SepfPK6z19t6aAfwbOQNY6K7
 ---

package/docs/index-ref.json

@@ -1,3 +1,3 @@
 {
-    "appref": "v1.11.37"
+    "appref": "v1.12.18"
 }

package/docs/multiplayer-games.md

@@ -10,6 +10,7 @@ Try these multiplayer games with your friends!
 * buttonLabel: Host Game
 * actionIcon: xicon multiplayer
 * imageUrl: /static/multiplayer/perfect-fit.png
+* largeImageUrl: /static/multiplayer/perfect-fit.gif
 * url: https://arcade.makecode.com/---multiplayer?host=_bz3CCuWFiepH
 * cardType: link
 * otherAction: https://arcade.makecode.com/_bz3CCuWFiepH, , sharedExample
@@ -19,6 +20,7 @@ Try these multiplayer games with your friends!
 * buttonLabel: Host Game
 * actionIcon: xicon multiplayer
 * imageUrl: /static/multiplayer/galga.png
+* largeImageUrl: /static/multiplayer/galga.gif
 * url: https://arcade.makecode.com/---multiplayer?host=_C71PmfFaYDm2
 * cardType: link
 * otherAction: https://arcade.makecode.com/_C71PmfFaYDm2, , sharedExample
@@ -28,6 +30,7 @@ Try these multiplayer games with your friends!
 * buttonLabel: Host Game
 * actionIcon: xicon multiplayer
 * imageUrl: /static/multiplayer/arrow-battle.gif
+* largeImageUrl: /static/multiplayer/arrow-battle-large.gif
 * url: https://arcade.makecode.com/---multiplayer?host=_dCP7f8c3q5PJ
 * cardType: link
 * otherAction: https://arcade.makecode.com/_dCP7f8c3q5PJ, , sharedExample
@@ -37,6 +40,7 @@ Try these multiplayer games with your friends!
 * buttonLabel: Host Game
 * actionIcon: xicon multiplayer
 * imageUrl: /static/multiplayer/tag.png
+* largeImageUrl: /static/multiplayer/tag.gif
 * url: https://arcade.makecode.com/---multiplayer?host=_cvxPm1WesYyi
 * cardType: link
 * otherAction: https://arcade.makecode.com/_cvxPm1WesYyi, , sharedExample
@@ -46,6 +50,7 @@ Try these multiplayer games with your friends!
 * buttonLabel: Host Game
 * actionIcon: xicon multiplayer
 * imageUrl: /static/multiplayer/horse-race.png
+* largeImageUrl: /static/multiplayer/horse-race.gif
 * url: https://arcade.makecode.com/---multiplayer?host=_1DogpPTpb8fK
 * cardType: link
 * otherAction: https://arcade.makecode.com/_1DogpPTpb8fK, , sharedExample
@@ -55,6 +60,7 @@ Try these multiplayer games with your friends!
 * buttonLabel: Host Game
 * actionIcon: xicon multiplayer
 * imageUrl: /static/multiplayer/painting.png
+* largeImageUrl: /static/multiplayer/painting.gif
 * url: https://arcade.makecode.com/---multiplayer?host=_FdYfDwixRTAw
 * cardType: link
 * otherAction: https://arcade.makecode.com/_FdYfDwixRTAw, , sharedExample

package/docs/projects.md

@@ -17,7 +17,8 @@
     {
         "name": "Multiplayer Games",
         "url": "/multiplayer-games",
-        "imageUrl": "/static/multiplayer/perfect-fit.png"
+        "imageUrl": "/static/multiplayer/perfect-fit.png",
+        "largeImageUrl": "/static/multiplayer/perfect-fit.gif"
     },
     {
         "name": "Live Coding",

package/docs/skillmap/balloon/balloon1.md

@@ -221,25 +221,12 @@ scene.setBackgroundColor(1)
 
 
 ```package
-pxt-sprite-scaling=github:microsoft/pxt-common-packages/libs/sprite-scaling
+sprite-scaling
 carnival=github:microsoft/arcade-carnival
-simple-blocks=github:microsoft/arcade-tutorial-extensions/simple-blocks
+simple-blocks=github:microsoft/arcade-tutorial-extensions/simple-blocks#v0.0.7
+balloon-images=github:kiki-lee/balloon-images#v0.0.1
 ```
 
-```customts
-namespace simplified{
-    /**
-    * just run the code
-    */
-    //% block="create player"
-    //% handlerStatement=1
-    export function wrap(handler: () => void) {
-        handler();
-    }
-}
-```
-
-
 
 ```assetjson
 {

package/docs/skillmap/balloon/balloon2.md

@@ -329,9 +329,10 @@ carnival.onGameOverExpanded(carnival.WinTypes.Multi)
 
 
 ```package
-pxt-sprite-scaling=github:microsoft/pxt-common-packages/libs/sprite-scaling
+sprite-scaling
 carnival=github:microsoft/arcade-carnival
-simple-blocks=github:microsoft/arcade-tutorial-extensions/simple-blocks
+simple-blocks=github:microsoft/arcade-tutorial-extensions/simple-blocks#v0.0.7
+balloon-images=github:kiki-lee/balloon-images#v0.0.1
 ```
 
 
@@ -346,19 +347,6 @@ scene.setBackgroundColor(1)
 
 ```
 
-```customts
-namespace simplified{
-    /**
-    * just run the code
-    */
-    //% block="create player"
-    //% handlerStatement=1
-    export function wrap(handler: () => void) {
-        handler();
-    }
-}
-```
-
 
 ```assetjson
 {

package/docs/skillmap/balloon/balloon3.md

@@ -301,11 +301,11 @@ myMouse.setImage(img`.`)
 
 ```
 
-
 ```package
-pxt-sprite-scaling=github:microsoft/pxt-common-packages/libs/sprite-scaling
+sprite-scaling
 carnival=github:microsoft/arcade-carnival
-simple-blocks=github:microsoft/arcade-tutorial-extensions/simple-blocks
+simple-blocks=github:microsoft/arcade-tutorial-extensions/simple-blocks#v0.0.7
+balloon-images=github:kiki-lee/balloon-images#v0.0.1
 ```
 
 
@@ -356,19 +356,6 @@ scaling.scaleByPixels_defl(myBalloon, 1, ScaleDirection.Uniformly, ScaleAnchor.B
 ```
 
 
-```customts
-namespace simplified{
-    /**
-    * just run the code
-    */
-    //% block="create player"
-    //% handlerStatement=1
-    export function wrap(handler: () => void) {
-        handler();
-    }
-}
-```
-
 
 ```assetjson
 {

package/docs/skillmap/balloon/balloon4.md

@@ -92,6 +92,7 @@ hint~
 
 
 #### ~ tutorialhint
+
 ```blocks
 let myMouse: Sprite = null
 let myBalloon: Sprite = null
@@ -207,6 +208,13 @@ Find a friend and have them press the (A) button or **space bar** while you pres
 
 
 
+```blockconfig.local
+let myMouse2: Sprite = null
+controller.player2.onButtonEvent(ControllerButton.A, ControllerButtonEvent.Released, function () {
+        myMouse2.setImage(img`.`)
+})
+```
+
 
 
 ## {9. Add a Label}
@@ -217,7 +225,7 @@ Find a friend and have them press the (A) button or **space bar** while you pres
 ```block
 carnival.addLabelTo("Burstin' Balloons", carnival.Areas.Mid)
 ```
-to **the end** of the ``||loops(noclick):on start||`` container to put a label on the booth so everyone knows the name of the game!
+to **the top** of the ``||loops(noclick):on start||`` container to put a label on the booth so everyone knows the name of the game!
 
 **Play your finished game a few times!  Who can get the best 2 out of 3?**
 
@@ -233,7 +241,13 @@ hint~
 
 
 
+
 ```blockconfig.local
+let myMouse2: Sprite = null
+controller.player2.onButtonEvent(ControllerButton.A, ControllerButtonEvent.Released, function () {
+        myMouse2.setImage(img`.`)
+})
+
 simplified.wrap(function () {
     let myBalloon3 = sprites.create(img`.`, SpriteKind.Player)
     myBalloon3.setPosition(110, 93)
@@ -314,15 +328,14 @@ controller.player2.onButtonEvent(ControllerButton.A, ControllerButtonEvent.Relea
     myMouse2.setImage(img`.`)
 })
 
-
-
 ```
 
 
 ```package
-pxt-sprite-scaling=github:microsoft/pxt-common-packages/libs/sprite-scaling
+sprite-scaling
 carnival=github:microsoft/arcade-carnival
-simple-blocks=github:microsoft/arcade-tutorial-extensions/simple-blocks
+simple-blocks=github:microsoft/arcade-tutorial-extensions/simple-blocks#v0.0.7
+balloon-images=github:kiki-lee/balloon-images#v0.0.1
 ```
 
 
@@ -355,18 +368,6 @@ myMouse.setPosition(80, 93)
 ```
 
 
-```customts
-namespace simplified{
-    /**
-    * just run the code
-    */
-    //% block="create player"
-    //% handlerStatement=1
-    export function wrap(handler: () => void) {
-        handler();
-    }
-}
-```