normal-ext.js

class ExampleExtension {
  getInfo() {
    return {
      // Required: the machine-readable name of this extension.
      // Will be used as the extension's namespace. Must not contain a '.' character.
      id: 'someBlocks',

      // Optional: the human-readable name of this extension as string.
      // This and any other string to be displayed in the Scratch UI may either be
      // a string or a call to `intlDefineMessage`; a plain string will not be
      // translated whereas a call to `intlDefineMessage` will connect the string
      // to the translation map (see below). The `intlDefineMessage` call is
      // similar to `defineMessages` from `react-intl` in form, but will actually
      // call some extension support code to do its magic. For example, we will
      // internally namespace the messages such that two extensions could have
      // messages with the same ID without colliding.
      // See also: https://github.com/yahoo/react-intl/wiki/API#definemessages
      name: 'someBlocks.name',
      // block color
      color1: '#4D7EB4',
      // Optional: URI for an icon for this extension. Data URI OK.
      menuIconURI:
        'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAkAAAAFCAAAAACyOJm3AAAAFklEQVQYV2P4DwMMEMgAI/+DE' +
        'UIMBgAEWB7i7uidhAAAAABJRU5ErkJggg==',
      
      blockIconURI: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADIAAAAyCAYAAAAeP4ixAAAABmJLR0QA/wD/AP+gvaeTAAAEtklEQVRoge2ZW4hWVRTHf984Kk1jlj2kI2H2UIwRacVot7EiSLtQBFlPRWUvSQTdsJCCyogy6CWSiMoeqrGioKDJLmpWYxcjxyZSJ4hRuznihZnQRj09rP/unO+b852z9/edT3qYPxz2OXuv9V9rX87Za68DYxhDQ1AqmO9sYAEwDzgDaAMmq20/8BuwDegBuoEfC7Y/CuOAl4HdwAfAyRmy44E7gF4gCrw2A7eLoxpagC758jZwXEhHbqww+FIVuYuBvoTcHuBN4DagA5ghR1p036G2Lsk6vT7goio2llf4cndIR96X0tPAQeCIOpfE/cCI5AaAxUBzgI1m4E7pRuK6t0LmioT9JyT3TYANfpHS6SKPgMPAc8DMBGkErAAmhpBXYCLwbILvcezdekydiICngON1P0TAuz0opTY9P0g8+u76B5uForBYnBE2AxFwFFsVJWACNphHyX6nyrBJRFcm6s4BPiLuyJL6fR+FJQn+dcCFibY5qt8RQuiWzocV9d2qf71WTz3wRhXbq1T/YgjZNOy7HwGPqO4SPR8ATqrH0xxMkY1INgHuwpbUIeDMUMKbpRwBn2BT7b5kjcYK2foUeJcClvMiYG+CaASbrUZjOvZiO7vD2Ke6LpxCvG6/rpcsAN/K5jvAqXnCTR6EfwK/6n5t7X4FY53KrXh8qXw6AvbpBfgipe1qYKeMLfTk89HbUGG7EGzDpnl2StsO4rU8EMCZp3eu2rb6kPnOiAvF93jKF4FBlScWSepinpaUtoXY6A5gZxFf5Om1yObBIE9z4JbAsYa3XZ+ldVp9vhSCun3oAP7ARuXLAL2vdCXPJ83A56oP4YmA34HzA/TK0IntqBEWJrQG6G6R3irsKDAdeE11vQE8rcQhyhDVT5FVMYP4TLKS8CTFfOJBSF7DxIGgL5qwiDcC/sJjl3coYUFiBKzBEhG1YA7wHjYgg9jIpu1DPhiX8OljPAf2Bins5dgEiL5oA/Zhvl3vo7BZwvc10Kla8QDm2/d5gudJcB922P+/oZV4VsqWaeU+cq3K1diL6TAN+A74rEEOpmEtFsonl/cQ8Jbur8tSXoP1NpnDmgn0E395phblaQamJuz1U74hLlJ9dxaBi3Lb9TwZ+JnyT+hlhbqcjssrbP5EHLi2kxIVVy6tKSpd5PkMdtjvA15V3axCXU7HWSpfke124lzBbpVZ+ej/ZuQmLDo9gmUuZgG3qu35Ql1OxwuydYtsH5IvC+Rb7jnlYUbvxg+pbTbhMVet6JEtdzpcmuLX0iyCJmAZ1tte4B7iXXQCNjLDhCWrQzEe+Fu2XGq0JF965dsy/A+FqfiB8pFqBFxqdFOIUmivHPkFgXohmKcyd/dOIrQj7v24NENmPbAdeBSYC5yga67qthOnetIwX2XIuSUYLv+7K0PG97dbNeyiPO9bONqId/j1GXLO0ZXYAeuAri2qy+uIyzH3E/+fKQwlLM6KgI3ApAzZPEfz2ifJhkueF4prRLyf/Fir3o4gG+63xlWePnphtUiXe8gW0RGAJyXX5SHrjZ0i7fSQLaojnQSkYX2TCiOE7+bVuEMTfYfx+Pnpu49sDDS+IaMtLaOfhZ5A+TGMoUj8CyaTiB/WbnspAAAAAElFTkSuQmCC',

      // Optional: Link to documentation content for this extension.
      // If not present, offer no link.
      docsURI: 'https://ccw.site',

      // Required: the list of blocks implemented by this extension,
      // in the order intended for display.
      // Scratch object is pera
      blocks: [
        {
          opcode: 'example-noop',
          blockType: Scratch.BlockType.COMMAND,
          blockAllThreads: false,
          text: 'do nothing',
          func: 'noop',
        },
        {
          opcode: 'example-conditional',
          blockType: Scratch.BlockType.CONDITIONAL,
          branchCount: 4,
          isTerminal: true,
          blockAllThreads: false,
          text: 'choose [BRANCH]',
          arguments: {
            BRANCH: {
              type: Scratch.ArgumentType.NUMBER,
              defaultValue: 1,
            },
          },
          func: 'noop',
        },
        {
          // Required: the machine-readable name of this operation.
          // This will appear in project JSON. Must not contain a '.' character.
          opcode: 'myReporter', // becomes 'someBlocks.myReporter'

          // Required: the kind of block we're defining, from a predefined list:
          // 'command' - a normal command block, like "move {} steps"
          // 'reporter' - returns a value, like "direction"
          // 'Boolean' - same as 'reporter' but returns a Boolean value
          // 'hat' - starts a stack if its value is truthy
          // 'conditional' - control flow, like "if {}" or "repeat {}"
          // A 'conditional' block may return the one-based index of a branch
          // to run, or it may return zero/falsy to run no branch. Each time a
          // child branch finishes, the block is called again. This is only a
          // slight change to the current model for control flow blocks, and is
          // also compatible with returning true/false for an "if" or "repeat"
          // block.
          // TODO: Consider Blockly-like nextStatement, previousStatement, and
          // output attributes as an alternative. Those are more flexible, but
          // allow bad combinations.
          blockType: Scratch.BlockType.REPORTER,

          // Required for conditional blocks, ignored for others: the number of
          // child branches this block controls. An "if" or "repeat" block would
          // specify a branch count of 1; an "if-else" block would specify a
          // branch count of 2.
          // TODO: should we support dynamic branch count for "switch"-likes?
          branchCount: 0,

          // Optional, default false: whether or not this block ends a stack.
          // The "forever" and "stop all" blocks would specify true here.
          isTerminal: true,

          // Optional, default false: whether or not to block all threads while
          // this block is busy. This is for things like the "touching color"
          // block in compatibility mode, and is only needed if the VM runs in a
          // worker. We might even consider omitting it from extension docs...
          blockAllThreads: false,

          // Required: the human-readable text on this block, including argument
          // placeholders. Argument placeholders should be in [MACRO_CASE] and
          // must be [ENCLOSED_WITHIN_SQUARE_BRACKETS].
          text: 'letter [LETTER_NUM] of [TEXT]',

          // Required: describe each argument.
          // Note that this is an array: the order of arguments will be used
          arguments: {
            // Required: the ID of the argument, which will be the name in the
            // args object passed to the implementation function.
            LETTER_NUM: {
              // Required: type of the argument / shape of the block input
              type: Scratch.ArgumentType.NUMBER,

              // Optional: the default value of the argument
              defaultValue: 1,
            },

            // Required: the ID of the argument, which will be the name in the
            // args object passed to the implementation function.
            TEXT: {
              // Required: type of the argument / shape of the block input
              type: Scratch.ArgumentType.STRING,

              // Optional: the default value of the argument
              defaultValue: 'text',
            },
          },

          // Optional: a string naming the function implementing this block.
          // If this is omitted, use the opcode string.
          func: 'myReporter',

          // Optional: list of target types for which this block should appear.
          // If absent, assume it applies to all builtin targets -- that is:
          // ['sprite', 'stage']
          filter: ['someBlocks.wedo2', 'sprite', 'stage'],
        },
        {
          opcode: 'example-Boolean',
          blockType: Scratch.BlockType.BOOLEAN,
          text: 'return true',
          func: 'returnTrue',
        },
        {
          opcode: 'example-hat',
          blockType: Scratch.BlockType.HAT,
          text: 'after forever',
          func: 'returnFalse',
        },
        {
          // Another block...
        },
      ],

      // Optional: define extension-specific menus here.
      menus: {
        // Required: an identifier for this menu, unique within this extension.
        menuA: [
          // Static menu: list items which should appear in the menu.
          {
            // Required: the value of the menu item when it is chosen.
            value: 'itemId1',

            // Optional: the human-readable label for this item.
            // Use `value` as the text if this is absent.
            text: 'Item One',
          },

          // The simplest form of a list item is a string which will be used as
          // both value and text.
          'itemId2',
        ],

        // Dynamic menu: a string naming a function which returns an array as above.
        // Called each time the menu is opened.
        menuB: 'getItemsForMenuB',
      },

      // Optional: translations
      translation_map: {
        'zh-cn': {
          'someBlocks.name': 'CCW Lab',
          'someBlocks.setValue': '设置[KEY]=[VALUE]',
          'someBlocks.getValue': '获取[KEY]的值',
        },
        en: {
          'someBlocks.name': 'CCW Lab',
          'someBlocks.setValue': 'set[KEY]=[VALUE]',
          'someBlocks.getValue': 'get[KEY]',
        },
      },

      // Optional: list new target type(s) provided by this extension.
      targetTypes: [
        'wedo2', // automatically transformed to 'someBlocks.wedo2'
        'speech', // automatically transformed to 'someBlocks.speech'
      ],
    }
  }
  noop () {}
  returnTrue () {
    return true
  }
  returnFalse  () {
    return false
  }
}

/** dont forget register your extension to Scratch */
Scratch.extensions.register(new ExampleExtension())