The ShuffleScript Editor

Every action you take on the Main screen is quietly written down as ShuffleScript — a plain, step-by-step recipe. The Editor lets you inspect and modify that recipe directly without typing raw code.

1. What the Editor Is

Open the Editor via 📜 ShuffleScript on the Main screen. The Editor directly modifies your live build's script. Unlike Playback mode (which previews external models without touching your workspace), any changes made here directly update your active 3D model.

Use the Editor to fix mistakes made earlier in your workflow — such as adjusting a hole's diameter three steps back — without needing to undo and rebuild everything manually.

2. Screen Layout

The Editor panel docks to the right side of the screen while keeping the 3D workspace visible on the left. You can still orbit and zoom the 3D view (right-click and drag, or scroll), but selecting or dragging 3D objects directly is disabled while the Editor is open. All edits are made through the step list.

3. Working with the Step List

The main view is a field-editable list with one row per build step. Each row includes:

• Line Number: Click a line number to jump the 3D preview directly to that point in the build process.
• Validity Mark: Indicates step execution status:
  • ✓ — Step executed successfully.
  • ✗ — Step failed (hover over the mark to view the error message).
  • · — Pending step (an earlier line contains an error that must be fixed first).
• Command Word: Click the command name (or empty space on the row) to edit the line as raw text.
• Argument Fields: Editable fields labelled in plain language (e.g., Width, Depth, Height) rather than raw positional syntax. Dropdowns are provided for shapes and axes. Modifying a field instantly updates the 3D preview.

Adding Steps: Hover between any two rows and click the + button to insert a new step. Select a command from the picker to insert a pre-configured step with standard default values, which you can then customize in the list.

Looking for full command syntax? See the ShuffleScript Language Guide.

4. Raw Text Mode & Shortcuts

Click ✎ Raw text in the toolbar to switch from the list view to a plain text editor where you can hand-type or paste full scripts. Click 📋 Show list at any time to return to the interactive list view and re-validate your code.

Undo & Redo: Pressing Ctrl+Z or Ctrl+Y inside the Editor undoes or redoes changes made to the script text, keeping your Editor edits separate from the main workspace history.

5. Toolbar Reference

• ✎ Raw text / 📋 Show list: Toggles between the field-editable list and the plain text editor.
• Load new .shuf: Opens a .shuf script directly into the Editor. Note: This replaces your current script and rebuilds your active 3D workspace to match the newly loaded file.
• Simplify: Cleans up redundant consecutive operations (such as multiple moves along the same axis) into a single step before saving.
• ⬆ Upgrade this script: Appears when loading a script created in an older version of ShapeShuffle, updating its syntax automatically.
• Save .shuf: Downloads your current script as a .shuf text file.
• 🔗 Copy link: Generates a shareable URL that opens this build directly into Playback mode for others to view.
• ? Commands: Toggles a quick command syntax cheatsheet.

6. Leaving the Editor

Click ← Back to main view at the top-left to exit. If you made any edits, your live 3D build updates to match your changes. If you only previewed steps without editing, your workspace remains unchanged.