pxt-common-packages 9.4.1 → 9.4.5

package/libs/game/docs/reference/sprites/sprite/ax.md

@@ -36,13 +36,15 @@ mySprite.ax = 0
 
 * **value**: the new horizontal acceleration for the sprite in pixels per second, per second.
 
-## Sprite acceleration
+## Sprite horizontal acceleration
 
-Acceleration of a sprite makes it speed up or slow down. The value for acceleration determines how quickly the speed  of the sprite will change. A positive value makes the sprite speed up as it moves. A negative value causes the sprite to slow down while it moves.
+The value for acceleration determines how quickly the speed of the sprite will change. Acceleration of a sprite makes it speed up in a direction toward the right or left. A positive value causes the sprite's speed in the `right` direction to increase. A negative value causes the sprite's speed in the `left` direction to increase.
+
+Acceleration can be used as an opposing force too. If a sprite is travelling toward the right at a certain speed and a negative horizontal acceleration is applied, the sprite will keep moving to the right but it will slow down. When the sprite's speed reaches `0`, the sprite will begin to move to the left.
 
 ### ~ hint
 
-**How speed changes**
+#### How speed changes
 
 Speed, or velocity, is how much distance an object moves during some period of time. Distance in your game is measured in pixels so the speed of a sprite is in _pixels per second_. Speed is changed by _accelerating_ an object. In your game, a sprite is accelerated by some amount of change in speed per second. So, acceleration is measured in _pixels per second per second_.
 
@@ -131,6 +133,35 @@ game.onUpdateInterval(1000, function () {
 })
 ```
 
+### Opposite force #ex3
+
+Make a sprite move from the left side of the screen to the right side. Apply acceleration in the opposite direction to slow the sprite down and send back to the left.
+
+```blocks
+let mySprite = sprites.create(img`
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . 5 5 5 5 5 5 . . . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . . . 5 5 5 5 5 5 . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    `, SpriteKind.Player)
+mySprite.setStayInScreen(true)
+mySprite.left = 0
+mySprite.vx = 100
+mySprite.ax = -35
+```
+
 ## See also #seealso
 
 [ay](/reference/sprites/sprite/ay),

package/libs/game/docs/reference/sprites/sprite/ay.md

@@ -36,13 +36,16 @@ mySprite.ay = 0
 
 * **value**: the new vertical acceleration for the sprite in pixels per second, per second.
 
-## Sprite acceleration
+## Sprite vertical acceleration
+
+The value for acceleration determines how quickly the speed of the sprite will change. Acceleration of a sprite makes it speed up in a direction toward the bottom or top. A positive value causes the sprite's speed in the `bottom` direction to increase. A negative value causes the sprite's speed in the `top` direction to increase.
+
+Acceleration can be used as an opposing force too. If a sprite is travelling toward the bottom at a certain speed and a negative vertical acceleration is applied, the sprite will keep moving to the bottom but it will slow down. When the sprite's speed reaches `0`, the sprite will begin to move to the top.
 
-Acceleration of a sprite makes it speed up or slow down. The value for acceleration determines how quickly the speed  of the sprite will change. A positive value makes the sprite speed up as it moves. A negative value causes the sprite to slow down while it moves.
 
 ### ~ hint
 
-**How speed changes**
+#### How speed changes
 
 Speed, or velocity, is how much distance an object moves during some period of time. Distance in your game is measured in pixels so the speed of a sprite is in _pixels per second_. Speed is changed by _accelerating_ an object. In your game, a sprite is accelerated by some amount of change in speed per second. So, acceleration is measured in _pixels per second per second_.
 
@@ -129,6 +132,34 @@ game.onUpdateInterval(1000, function () {
     interval += 1
 })
 ```
+### Opposite force #ex3
+
+Make a sprite move from the top of the screen to the bottom. Apply acceleration in the opposite direction to slow the sprite down and send back to the top.
+
+```blocks
+let mySprite = sprites.create(img`
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . 5 5 5 5 5 5 . . . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . . . 5 5 5 5 5 5 . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    `, SpriteKind.Player)
+mySprite.setStayInScreen(true)
+mySprite.top = 0
+mySprite.vy = 80
+mySprite.ay = -35
+```
 
 ## See also #seealso
 

package/libs/game/docs/reference/sprites/sprite/fx.md

@@ -0,0 +1,123 @@
+# fy (property)
+
+Get or set the friction opposing a sprite's motion in the vertical direction.
+
+## Get
+
+Get the vertical friction on the sprite.
+
+```block
+let mySprite: Sprite = null
+
+let horzAccel = mySprite.fy
+```
+
+```typescript-ignorelet
+horzAccel = mySprite.fy
+```
+
+### Returns
+
+* a [number](/types/number) that is the current vertical friction of the sprite.
+
+## Set
+
+Set the vertical friction for the sprite.
+
+```block
+let mySprite: Sprite = null
+
+mySprite.fy = 0
+```
+
+```typescript-ignore
+mySprite.fy = 0
+```
+
+### Parameter
+
+* **value**: the new vertical friction opposing the sprite's motion in pixels per second, per second.
+
+## Sprite vertical friction
+
+Friction is an opposing force against the motion of a sprite. If a sprite has a vertical velocity (`vy`), it's friction will slow the sprite down until it's vertical velocity becomes `0`. This is similar to setting an opposite vertical acceleration but the opposite acceleration goes away once the sprite stops.
+
+## Examples #example
+
+### Measure stopping time #ex1
+
+Move the sprite from top to bottom across the screen. Use the correct amount of friction (`fy`) to make the sprite stop at `3` seconds.
+
+```blocks
+let stopTime = 0
+let counting = true
+let mySprite = sprites.create(img`
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . 5 5 5 5 5 5 . . . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . . . 5 5 5 5 5 5 . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    `, SpriteKind.Player)
+mySprite.setStayInScreen(true)
+mySprite.top = 0
+mySprite.fy = 20
+mySprite.vy = 60
+game.onUpdateInterval(100, function () {
+    if (counting) {
+        stopTime += 0.1
+        if (mySprite.vy == 0) {
+            counting = false
+            mySprite.sayText("" + stopTime + "sec", 5000, false)
+        }
+    }
+})
+```
+
+### Skipppng sprite #ex2
+
+Make a sprite move from the top to the bottom. Make it skip to the right once every second.
+
+```blocks
+let mySprite = sprites.create(img`
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . 5 5 5 5 5 5 . . . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . . . 5 5 5 5 5 5 . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    `, SpriteKind.Player)
+mySprite.setStayInScreen(true)
+mySprite.top = 0
+mySprite.fy = 60
+mySprite.vy = 60
+for (let index = 0; index < 3; index++) {
+    mySprite.vy = 60
+    pause(1000)
+}
+```
+
+## See also #seealso
+
+[fx](/reference/sprites/sprite/fx),
+[ay](/reference/sprites/sprite/ay)

package/libs/game/docs/reference/sprites/sprite/fy.md

@@ -0,0 +1,123 @@
+# fy (property)
+
+Get or set the friction opposing a sprite's motion in the horizontal direction.
+
+## Get
+
+Get the horizontal friction on the sprite.
+
+```block
+let mySprite: Sprite = null
+
+let horzAccel = mySprite.fx
+```
+
+```typescript-ignorelet
+horzAccel = mySprite.fx
+```
+
+### Returns
+
+* a [number](/types/number) that is the current horizontal friction of the sprite.
+
+## Set
+
+Set the horizontal friction for the sprite.
+
+```block
+let mySprite: Sprite = null
+
+mySprite.fx = 0
+```
+
+```typescript-ignore
+mySprite.fx = 0
+```
+
+### Parameter
+
+* **value**: the new horizontal friction opposing the sprite's motion in pixels per second, per second.
+
+## Sprite horizontal friction
+
+Friction is an opposing force against the motion of a sprite. If a sprite has a horizontal velocity (`vx`), it's friction will slow the sprite down until it's horizontal velocity becomes `0`. This is similar to setting an opposite horizontal acceleration but the opposite acceleration goes away once the sprite stops.
+
+## Examples #example
+
+### Measure stopping time #ex1
+
+Move the sprite from left to right across the screen. Use the correct amount of friction (`fx`) to make the sprite stop at `3` seconds.
+
+```blocks
+let stopTime = 0
+let counting = true
+let mySprite = sprites.create(img`
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . 5 5 5 5 5 5 . . . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . . . 5 5 5 5 5 5 . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    `, SpriteKind.Player)
+mySprite.setStayInScreen(true)
+mySprite.left = 0
+mySprite.fx = 30
+mySprite.vx = 90
+game.onUpdateInterval(100, function () {
+    if (counting) {
+        stopTime += 0.1
+        if (mySprite.vx == 0) {
+            counting = false
+            mySprite.sayText("" + stopTime + "sec", 5000, false)
+        }
+    }
+})
+```
+
+### Skipppng sprite #ex2
+
+Make a sprite move from the left to the right. Make it skip to the right once every second.
+
+```blocks
+let mySprite = sprites.create(img`
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . 5 5 5 5 5 5 . . . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . . . 5 5 5 5 5 5 . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    `, SpriteKind.Player)
+mySprite.setStayInScreen(true)
+mySprite.left = 0
+mySprite.fx = 80
+mySprite.vx = 80
+for (let index = 0; index < 3; index++) {
+    mySprite.vx = 80
+    pause(1000)
+}
+```
+
+## See also #seealso
+
+[fy](/reference/sprites/sprite/fy),
+[ax](/reference/sprites/sprite/ax)

package/libs/game/docs/reference/sprites.md

@@ -58,6 +58,8 @@ sprites.onOverlap(0, 0, function (sprite, otherSprite) {})
 * [**vy- velocity y**](/reference/sprites/sprite/vy)
 * [**ax - acceleration x**](/reference/sprites/sprite/ax)
 * [**ay - acceleration y**](/reference/sprites/sprite/ay)
+* [**fx - friction x**](/reference/sprites/sprite/fx)
+* [**fy - friction y**](/reference/sprites/sprite/fy)
 
 ### Image and Attributes
 

package/libs/game/physics.ts

@@ -597,7 +597,7 @@ class ArcadePhysicsEngine extends PhysicsEngine {
         const alreadyHandled: tiles.Location[] = [];
 
         for (const tile of overlappedTiles) {
-            if (alreadyHandled.some(l => l.col === tile.col && l.row === tile.row)) {
+            if (alreadyHandled.some(l => l.column === tile.column && l.row === tile.row)) {
                 continue;
             }
             alreadyHandled.push(tile);

package/libs/game/renderText.ts

@@ -61,6 +61,8 @@ namespace sprites {
         }
 
         calculatePartialHeight(startLine: number, lengthToDraw: number) {
+            if (this.linebreaks.length === 0) return this.font.charHeight;
+
             let current = 0;
 
             for (let i = startLine; i < this.linebreaks.length + 1; i++) {
@@ -93,9 +95,9 @@ namespace sprites {
             return total;
         }
 
-        protected lineEnd(index: number) {
-            const prevEnd = index > 0 ? this.linebreaks[index - 1] : 0;
-            let end = index < this.linebreaks.length ? this.linebreaks[index] : this.text.length;
+        lineEnd(lineIndex: number) {
+            const prevEnd = lineIndex > 0 ? this.linebreaks[lineIndex - 1] : 0;
+            let end = lineIndex < this.linebreaks.length ? this.linebreaks[lineIndex] : this.text.length;
             let didMove = false;
 
             // Trim trailing whitespace
@@ -115,8 +117,8 @@ namespace sprites {
             return didMove ? end + 1 : end;
         }
 
-        protected lineStart(index: number) {
-            let start = index > 0 ? this.linebreaks[index - 1] : 0;
+        lineStart(lineIndex: number) {
+            let start = lineIndex > 0 ? this.linebreaks[lineIndex - 1] : 0;
 
             // Trim leading whitespace
             while (start < this.text.length) {
@@ -133,6 +135,29 @@ namespace sprites {
 
             return start;
         }
+
+        widthOfLine(lineIndex: number, fullTextOffset?: number) {
+            if (fullTextOffset != undefined) {
+                return (Math.min(this.lineEnd(lineIndex), fullTextOffset + 1) - this.lineStart(lineIndex)) * this.font.charWidth;
+            }
+            return (this.lineEnd(lineIndex) - this.lineStart(lineIndex)) * this.font.charWidth;
+        }
+
+        widthOfLines(lineStartIndex: number, lineEndIndex: number, offset?: number) {
+            if (this.linebreaks.length === 0) return this.widthOfLine(0, offset);
+
+            let width = 0;
+            let fullTextOffset: number;
+            for (let i = lineStartIndex; i < Math.min(lineEndIndex, this.linebreaks.length + 1); i++) {
+                if (offset != undefined) {
+                    fullTextOffset = this.lineStart(i) + offset;
+                    offset -= this.lineEnd(i) - this.lineStart(i);
+                }
+                if (fullTextOffset !== undefined && this.lineStart(i) > fullTextOffset) break;
+                width = Math.max(width, this.widthOfLine(i, fullTextOffset));
+            }
+            return width;
+        }
     }
 
 
@@ -203,6 +228,9 @@ namespace sprites {
         protected pageLine: number;
         protected timer: number;
         protected pauseMillis: number;
+        protected onTickCB: () => void;
+        protected onEndCB: () => void;
+        protected prevOffset: number;
 
         constructor(public text: RenderText, public height: number) {
             this.state = RenderTextAnimationState.Idle;
@@ -232,17 +260,21 @@ namespace sprites {
         }
 
         currentHeight() {
-            const maxHeight = Math.min(
-                Math.idiv(this.height, this.text.lineHeight()) + 1,
-                this.text.linebreaks.length + 1 - this.pageLine
-            ) * this.text.lineHeight();
+            const minHeight = this.text.lineHeight();
+            const maxHeight = Math.max(
+                Math.min(
+                    Math.idiv(this.height, this.text.lineHeight()) + 1,
+                    this.text.linebreaks.length + 1 - this.pageLine
+                ) * this.text.lineHeight(),
+                minHeight
+            );
 
 
             if (this.state === RenderTextAnimationState.Printing) {
-                return Math.min(
+                return Math.max(Math.min(
                     this.text.calculatePartialHeight(this.pageLine, this.currentOffset()),
                     maxHeight
-                );
+                ), minHeight)
             }
             else if (this.state === RenderTextAnimationState.Pausing) {
                 return maxHeight
@@ -252,10 +284,34 @@ namespace sprites {
             }
         }
 
+        currentWidth() {
+            return this.text.widthOfLines(
+                this.pageLine,
+                this.pageLine + Math.idiv(this.currentHeight(), this.text.lineHeight()) + 1,
+                this.state === RenderTextAnimationState.Printing ? this.currentOffset() : undefined
+            );
+        }
+
         currentOffset() {
             return Math.idiv(control.millis() - this.timer, this.tickPeriod)
         }
 
+        isDone() {
+            return this.state === RenderTextAnimationState.Idle;
+        }
+
+        cancel() {
+            this.state = RenderTextAnimationState.Idle;
+        }
+
+        onCharacterPrinted(cb: () => void) {
+            this.onTickCB = cb;
+        }
+
+        onAnimationEnd(cb: () => void) {
+            this.onEndCB = cb;
+        }
+
         draw(canvas: Image, left: number, top: number, color: number) {
             if (this.state === RenderTextAnimationState.Idle) return;
             else if (this.state === RenderTextAnimationState.Printing) {
@@ -269,6 +325,10 @@ namespace sprites {
                     this.pageLine + Math.idiv(this.height, this.text.lineHeight()) + 1
                 );
 
+                if (this.onTickCB && this.prevOffset !== this.currentOffset()) {
+                    this.onTickCB();
+                }
+
                 if (pageFinished) {
                     this.state = RenderTextAnimationState.Pausing;
                     this.timer = this.pauseMillis
@@ -290,6 +350,7 @@ namespace sprites {
                     this.pageLine += Math.idiv(this.height, this.text.lineHeight()) + 1;
                     if (this.pageLine > this.text.linebreaks.length) {
                         this.state = RenderTextAnimationState.Idle;
+                        if (this.onEndCB) this.onEndCB();
                     }
                     else {
                         this.state = RenderTextAnimationState.Printing;
@@ -297,6 +358,8 @@ namespace sprites {
                     }
                 }
             }
+
+            this.prevOffset = this.currentOffset();
         }
     }
 }

package/libs/game/scenes.ts

@@ -18,7 +18,7 @@ enum CameraProperty {
 }
 
 //% weight=88 color="#4b6584" icon="\uf1bb"
-//% groups='["Screen", "Effects", "Tiles", "Collisions", "Camera"]'
+//% groups='["Screen", "Camera", "Effects", "Tilemaps", "Tilemap Operations", "Locations"]'
 //% blockGap=8
 namespace scene {
     /**
@@ -128,6 +128,7 @@ namespace scene {
     //% duration.shadow=timePicker duration.defl=500
     //% group="Camera"
     //% help=scene/camera-shake
+    //% weight=90
     export function cameraShake(amplitude: number = 4, duration: number = 500) {
         const scene = game.currentScene();
         scene.camera.shake(amplitude, duration);
@@ -140,6 +141,7 @@ namespace scene {
     //% blockId=camerafollow block="camera follow sprite %sprite=variables_get(mySprite)"
     //% group="Camera"
     //% help=scene/camera-follow-sprite
+    //% weight=100
     export function cameraFollowSprite(sprite: Sprite) {
         const scene = game.currentScene();
         scene.camera.sprite = sprite;
@@ -152,6 +154,7 @@ namespace scene {
     //% blockId=camerapos block="center camera at x %x y %y"
     //% group="Camera"
     //% help=scene/center-camera-at
+    //% weight=80
     export function centerCameraAt(x: number, y: number) {
         const scene = game.currentScene();
         scene.camera.sprite = undefined;
@@ -190,6 +193,7 @@ namespace scene {
     //% blockId=cameraproperty block="camera $property"
     //% group="Camera"
     //% help=scene/camera-property
+    //% weight=70
     export function cameraProperty(property: CameraProperty): number {
         const scene = game.currentScene();
         switch (property) {

package/libs/game/sprite.ts

@@ -705,8 +705,9 @@ class Sprite extends sprites.BaseSprite {
      * @param direction
      */
     //% blockId=spritehasobstacle block="is %sprite(mySprite) hitting wall %direction"
-    //% blockNamespace="scene" group="Collisions" blockGap=8
-    //% help=sprites/sprite/is-hitting-tile
+    //% blockNamespace="scene" group="Locations" blockGap=24
+    //% help=scene/is-hitting-tile
+    //% weight=15
     isHittingTile(direction: CollisionDirection): boolean {
         return this._obstacles && !!this._obstacles[direction];
     }
@@ -717,8 +718,9 @@ class Sprite extends sprites.BaseSprite {
      */
     //% blockId=spritetileat block="tile to $direction of $this(mySprite) is $tile"
     //% tile.shadow=tileset_tile_picker
-    //% blockNamespace="scene" group="Collisions" blockGap=8
-    //% help=sprites/sprite/tile-kind-at
+    //% blockNamespace="scene" group="Locations" blockGap=8
+    //% help=scene/tile-kind-at
+    //% weight=20
     tileKindAt(direction: TileDirection, tile: Image): boolean {
         const tilemap = game.currentScene().tileMap;
         let x = this.x >> tilemap.scale;
@@ -748,13 +750,28 @@ class Sprite extends sprites.BaseSprite {
      * @param direction
      */
     //% blockId=spriteobstacle block="%sprite(mySprite) wall hit on %direction"
-    //% blockNamespace="scene" group="Collisions"
+    //% blockNamespace="scene" group="Locations"
+    //% direction.shadow=tiles_collision_direction_editor
     //% help=sprites/sprite/tile-hit-from
     //% deprecated=1
-    tileHitFrom(direction: CollisionDirection): number {
+    tileHitFrom(direction: number): number {
         return (this._obstacles && this._obstacles[direction]) ? this._obstacles[direction].tileIndex : -1;
     }
 
+    /**
+     * Gets the tilemap location at the center of a sprite
+     */
+    //% block="tilemap location of $this"
+    //% blockId=tiles_location_of_sprite
+    //% this.shadow=variables_get
+    //% this.defl=mySprite
+    //% blockNamespace="scene" group="Locations" weight=90
+    tilemapLocation(): tiles.Location {
+        const scene = game.currentScene();
+        if (!scene.tileMap) return undefined;
+        return tiles.getTileLocation(this.x >> scene.tileMap.scale, this.y >> scene.tileMap.scale);
+    }
+
     clearObstacles() {
         this._obstacles = [];
     }

package/libs/game/spriteevents.ts

@@ -46,7 +46,7 @@ namespace sprites {
     //% group="Overlaps"
     //% weight=100 draggableParameters="reporter"
     //% blockId=spritesoverlap block="on $sprite of kind $kind=spritekind overlaps $otherSprite of kind $otherKind=spritekind"
-    //% help=sprites/on-overlap
+    //% help=scene/on-overlap
     //% blockGap=8
     export function onOverlap(kind: number, otherKind: number, handler: (sprite: Sprite, otherSprite: Sprite) => void) {
         if (kind == undefined || otherKind == undefined || !handler) return;
@@ -82,11 +82,11 @@ namespace scene {
      * @param tile
      * @param handler
      */
-    //% group="Tiles"
-    //% weight=100 draggableParameters="reporter" blockGap=8
+    //% group="Tilemaps"
+    //% weight=120 draggableParameters="reporter" blockGap=8
     //% blockId=spriteshittile block="on $sprite of kind $kind=spritekind overlaps $tile at $location"
     //% tile.shadow=tileset_tile_picker
-    //% help=tiles/on-overlap-tile
+    //% help=scene/on-overlap-tile
     export function onOverlapTile(kind: number, tile: Image, handler: (sprite: Sprite, location: tiles.Location) => void) {
         if (kind == undefined || !tile || !handler) return;
 
@@ -105,10 +105,10 @@ namespace scene {
      * @param kind
      * @param handler
      */
-    //% group="Tiles"
-    //% weight=120 draggableParameters="reporter" blockGap=8
+    //% group="Tilemaps"
+    //% weight=100 draggableParameters="reporter" blockGap=8
     //% blockId=spriteshitwall block="on $sprite of kind $kind=spritekind hits wall at $location"
-    //% help=tiles/on-hit-wall
+    //% help=scene/on-hit-wall
     export function onHitWall(kind: number, handler: (sprite: Sprite, location: tiles.Location) => void) {
         if (kind == undefined || !handler) return;