Lily/HackedBlocks: various tweaks (#969)

extensions/Lily/HackedBlocks.js

@@ -1,7 +1,8 @@
-// Name: Hacked Block Collection
+// Name: Hidden Block Collection
 // ID: lmsHackedBlocks
-// Description: Various modified vanilla blocks.
+// Description: Various "hacked blocks" that work in Scratch but are not visible in the palette.
 // By: LilyMakesThings <https://scratch.mit.edu/users/LilyMakesThings/>
+// By: pumpkinhasapatch
 
 (function (Scratch) {
   "use strict";
@@ -10,11 +11,13 @@
     getInfo() {
       return {
         id: "lmsHackedBlocks",
-        name: "Hacked Block Collection",
+        name: "Hidden Blocks",
+        docsURI: "https://en.scratch-wiki.info/wiki/Hidden_Blocks#Events",
         blocks: [
+          // Use the sensing_touchingobjectmenu instead of event_ to also list sprites, since the block supports it
           {
             blockType: Scratch.BlockType.XML,
-            xml: '<block type="event_whentouchingobject"><value name="TOUCHINGOBJECTMENU"><shadow type="event_touchingobjectmenu"/></value></block>',
+            xml: '<block type="event_whentouchingobject"><value name="TOUCHINGOBJECTMENU"><shadow type="sensing_touchingobjectmenu"/></value></block>',
           },
           "---",
           {
@@ -26,38 +29,34 @@
             xml: '<block id="while" type="control_while"/>',
           },
           "---",
+          // Counting blocks that function similarly to variables
           {
             blockType: Scratch.BlockType.XML,
-            xml: '<block type="sensing_keypressed"><value name="KEY_OPTION"><shadow type="text"><field name="TEXT">enter</field></shadow></value></block>',
-          },
-          {
-            blockType: Scratch.BlockType.XML,
-            xml: '<block type="sensing_touchingobject"><value name="TOUCHINGOBJECTMENU"><shadow type="text"><field name="TEXT">Stage</field></shadow></value></block>',
-          },
-          {
-            blockType: Scratch.BlockType.XML,
-            xml: '<block type="sensing_touchingcolor"><value name="COLOR"><shadow type="text"><field name="TEXT">#ffffff</field></shadow></value></block>',
+            xml: '<block type="control_get_counter"/>',
           },
           {
             blockType: Scratch.BlockType.XML,
-            xml: '<block type="sensing_coloristouchingcolor"><value name="COLOR"><shadow type="text"><field name="TEXT">#ffffff</field></shadow></value><value name="COLOR2"><shadow type="text"><field name="TEXT">#ffffff</field></shadow></value></block>',
+            xml: '<block type="control_incr_counter"/>',
           },
           {
             blockType: Scratch.BlockType.XML,
-            xml: '<block type="operator_join"><value name="STRING1"><shadow type="colour_picker"/></value><value name="STRING2"><shadow type="text"><field name="TEXT"></field></shadow></value></block>',
+            xml: '<block type="control_clear_counter"/>',
           },
           "---",
           {
             blockType: Scratch.BlockType.XML,
-            xml: '<block type="control_get_counter"/>',
+            xml: '<block type="operator_round"><value name="NUM"><shadow type="note"><field name="NOTE">60</field></shadow></value></block>',
           },
+          "---",
           {
             blockType: Scratch.BlockType.XML,
-            xml: '<block type="control_incr_counter"/>',
+            xml: '<block type="operator_join"><value name="STRING1"><shadow type="colour_picker"/></value><value name="STRING2"><shadow type="text"><field name="TEXT"></field></shadow></value></block>',
           },
+          // Dot matrix input from the micro:bit extension
+          // Returns a 5x5 binary grid of pixels depending on what was drawn. White pixels are 1 and green pixels are 0
           {
             blockType: Scratch.BlockType.XML,
-            xml: '<block type="control_clear_counter"/>',
+            xml: '<block type="operator_join"><value name="STRING1"><shadow type="matrix"><field name="MATRIX">1111110101001000010001110</field></shadow></value><value name="STRING2"><shadow type="text"><field name="TEXT"></field></shadow></value></block>',
           },
         ],
       };