Skip to content

This Chrome extension allows users to send custom WebSocket packets to modify Scratch cloud variables.

Notifications You must be signed in to change notification settings

AceCoderClaws/Scratch-Cloud-Manager

Repository files navigation

Scratch Cloud Manager

This Chrome extension allows users to send custom WebSocket packets to modify Scratch cloud variables.

How to Install

  1. Download the .zip file from the repository.
  2. Open chrome://extensions/ in your browser.
  3. Enable developer mode by toggling the switch in the top-right corner.
    Developer Mode Switch
  4. Drag the .zip file onto the page or click "Load unpacked" and select the .zip file.
    Load unpacked, Pack extension, Update

How to Use

Warning

Use this extension only on Scratch projects you own or have permission to modify. Unauthorized use can violate Scratch's terms of service and result in penalties. Learn more here.

Step 1: Sign Into Scratch
Ensure you are signed into a Scratch account with the Scratcher role to use cloud variables.

Step 2: Preparing Your Project
Go to the project you want to use (Example) and click the green flag to start it.
Green flag, Red stop sign, Fullscreen

Step 3: The Handshake

  1. Click the extension icon and open the "Handshake" tab.
  2. Under "Packet Name:", enter "handshake".
  3. Enter your account's username under "Username:" (it must match your actual account name).
  4. Enter the project's ID under "Project ID:".
  5. Click "Submit".

You'll see something like "Sent Handshake: {"name":"handshake","user":"YourUsername","project_id":"1067597166"} under "Response Packets"."
Packet Type (handshake), Username, Project ID

Step 4: Sending Set Requests

  1. Go to the "Send Action" tab.
  2. Enter "set" under "Packet Method".
  3. Enter your username under "Username:" (it must match your actual account name).
  4. Enter the project's ID under "Project ID:".
  5. Type the variable name under "Variable Name:" (do not include the ☁ symbol, the code handles that).
  6. Enter the value (numbers only) under "Value:".
  7. Click "Submit".

You'll see something like "Sent Cloud Update: {"method":"set","user":"YourUsername","project_id":"1067597166","name":"☁ Cloud","value":"123456789"}" under "Response Packets".
Packet Method (set), Username, Project ID, Variable Name, Value

What's Planned

I'm planning on continuing to improve the Chrome extension. Here's what's coming in future updates:

  • Better UI: A cleaner, more user-friendly design for easier navigation.
  • Username & Project ID Autofill: Automatically fill in your account's username and the current project's ID to save time.
  • Easy Save-and-Load: Quickly save and load frequently used packet configurations.
  • Dark Mode: A sleek dark theme for improved visibility in low-light environments.
  • Basic Encryption: An easy way to encode text-based messages as numbers so projects can receive them.