ab8d8e5f34
When execute calls itself to step into the next stack level, pass RECURSIVE to the recursiveCall level. This argument provides opportunity to recursed calls in execute to reduce the time needed for some checks. - Reduce time for checking around setting thread.requestScriptGlowInFrame - Call thread.pushReportedValue at end of execute when in a recursive call A boolean check is faster than a type lookup, command blocks will only be executed in non-recursive calls. This saves a minor amount of time for any result reporting blocks like blocks that get variables or add two inputs together. If the block is not returning a promise and execute is a recursed call, that implies that the block is neither a hat or that the thread is not at the top. That reduces handleReport to pushReportedValue. Using the recursiveCall argument the final block calling handleReport can shortcut the extra work in handleReport and reduce it to immediately calling pushReportedValue. |
||
|---|---|---|
| .github | ||
| .tx | ||
| src | ||
| test | ||
| .editorconfig | ||
| .eslintignore | ||
| .eslintrc.js | ||
| .gitattributes | ||
| .gitignore | ||
| .npmignore | ||
| .travis.yml | ||
| LICENSE | ||
| package.json | ||
| README.md | ||
| TRADEMARK | ||
| webpack.config.js | ||
scratch-vm
Scratch VM is a library for representing, running, and maintaining the state of computer programs written using Scratch Blocks.
Installation
This requires you to have Git and Node.js installed.
To install as a dependency for your own application:
npm install scratch-vm
To set up a development environment to edit scratch-vm yourself:
git clone https://github.com/LLK/scratch-vm.git
cd scratch-vm
npm install
Development Server
This requires Node.js to be installed.
For convenience, we've included a development server with the VM. This is sometimes useful when running in an environment that's loading remote resources (e.g., SVGs from the Scratch server). If you would like to use your modified VM with the full Scratch 3.0 GUI, follow the instructions to link the VM to the GUI.
Running the Development Server
Open a Command Prompt or Terminal in the repository and run:
npm start
Playground
To view the Playground, make sure the dev server's running and go to http://localhost:8073/playground/ - you will be directed to the playground, which demonstrates various tools and internal state.
Standalone Build
npm run build
<script src="/path/to/dist/web/scratch-vm.js"></script>
<script>
var vm = new window.VirtualMachine();
// do things
</script>
How to include in a Node.js App
For an extended setup example, check out the /src/playground directory, which includes a fully running VM instance.
var VirtualMachine = require('scratch-vm');
var vm = new VirtualMachine();
// Block events
Scratch.workspace.addChangeListener(vm.blockListener);
// Run threads
vm.start();
Abstract Syntax Tree
Overview
The Virtual Machine constructs and maintains the state of an Abstract Syntax Tree (AST) by listening to events emitted by the scratch-blocks workspace via the blockListener. Each target (code-running object, for example, a sprite) keeps an AST for its blocks. At any time, the current state of an AST can be viewed by inspecting the vm.runtime.targets[...].blocks object.
Anatomy of a Block
The VM's block representation contains all the important information for execution and storage. Here's an example representing the "when key pressed" script on a workspace:
{
"_blocks": {
"Q]PK~yJ@BTV8Y~FfISeo": {
"id": "Q]PK~yJ@BTV8Y~FfISeo",
"opcode": "event_whenkeypressed",
"inputs": {
},
"fields": {
"KEY_OPTION": {
"name": "KEY_OPTION",
"value": "space"
}
},
"next": null,
"topLevel": true,
"parent": null,
"shadow": false,
"x": -69.333333333333,
"y": 174
}
},
"_scripts": [
"Q]PK~yJ@BTV8Y~FfISeo"
]
}
Testing
npm test
npm run coverage
Publishing to GitHub Pages
npm run deploy
This will push the currently built playground to the gh-pages branch of the currently tracked remote. If you would like to change where to push to, add a repo url argument:
npm run deploy -- -r <your repo url>
Donate
We provide Scratch free of charge, and want to keep it that way! Please consider making a donation to support our continued engineering, design, community, and resource development efforts. Donations of any size are appreciated. Thank you!