Sandwalkers for Mac: In-Depth Analysis and User Guide

Source: 爱上MAC  |  Software download link: Sandwalkers for Mac

Sandwalkers is a professional-grade nonlinear narrative and interactive storytelling creation tool designed specifically for macOS. It allows creators to build complex story branches, character interactions, and dynamic variable systems through a node-based interface, making it widely applicable to game narrative design, interactive fiction writing, and immersive experience prototyping. This article will provide an in-depth breakdown of its core interface, complete workflow, and efficient operation techniques.

I. Detailed Explanation of the Core Interface and Workspace

The main interface of Sandwalkers adopts a clear, functionally partitioned design, primarily divided into the following five core areas:

• Navigation Panel (Left Side): Displays all scenes, characters, variables, and resource files of the project in a tree structure. You can quickly jump to the corresponding item by clicking on it.
• Node Graph Workspace (Center): This is the core creation area. Each story node (such as dialogue, choices, and conditional checks) is presented as a draggable block, with connecting lines representing the narrative flow. It supports unlimited canvas zooming and panning.
• Property Inspector (Right Side): When any node in the workspace or item in the navigation panel is selected, this area displays and allows editing of its detailed properties, such as text content, associated variables, and transition conditions.
• Preview and Testing Toolbar (Top): Contains main function buttons such as Run Project, Test from a Specific Node, and Export. Real-time preview requires no compilation.
• Resource Library and Snippet Library (Bottom Panel): Stores reusable node templates, preset conditional logic code blocks, and imported media assets (images, audio).

II. Complete Workflow: From Creation to Export

1. Project Creation and Initial Setup

Step 1: Launch the software, then click “New Project” on the welcome screen, or use the shortcut Command + N.

Step 2: In the dialog box that appears, enter the project name, choose a save path, and select a starting point from the template library (e.g., “Branching Dialogue Template,” “Visual Novel Template”).

Step 3: After entering the main interface, it is recommended to first configure global story variables and metadata (e.g., author, version) in “Project Settings” in the Navigation Panel.

2. Building the Narrative Node Graph

Step 1: Add nodes. Right-click on an empty area in the Node Graph Workspace and select “Add Node,” or use the shortcut Command + Shift + A. Common node types include:

• Dialogue Node: Contains character avatar, name, and text content.
• Choice Node: Provides players with multiple options, each of which can connect to a different subsequent node.
• Condition Node: Determines the branch direction based on story variables (e.g., “Character Affinity > 5”).
• Variable Operation Node: Performs operations such as setting, incrementing, or decrementing variables.

Step 2: Connect nodes. Hover the mouse over a node’s output port (usually located at the bottom or right side of the node), and drag the connecting line that appears to the target node’s input port (usually located at the top or left side).

Step 3: Edit node content. Click to select any node and edit its specific content in the Inspector on the right. For dialogue nodes, you can type directly into the text box, and below it you can associate an audio file or trigger effect with the current dialogue.

3. Defining and Using Variables

Variables are the key to driving interactive narratives.

Step 1: Create a variable. In the Navigation Panel, right-click the “Variables” folder and select “New.” Define the variable name (e.g., `player_choice`), type (boolean, integer, string), and initial value.

Step 2: Reference variables in condition nodes. Select a condition node and enter an expression such as player_choice == "Help" in the “Condition Expression” field of the Inspector.

Step 3: Modify variable values. Drag in a “Variable Operation” node, set its operation to “Set” or “Add,” and select the target variable and value.

4. Real-Time Testing and Debugging

Click the “Run” button in the top toolbar (or press Command + R), and the story will start running from the starting node. The pop-up preview window will simulate the final experience.

Tip: To test a specific branch, right-click any node in the workspace and select “Test from This Node.” During debugging, you can open the “Debug Panel” (Command + Shift + D) to monitor changes in all variable values in real time.

5. Export the Final Project

Step 1: Click the menu bar “File” -> “Export Project”.

Step 2: In the export dialog, select the target format. Sandwalkers supports multiple formats:

• Standalone Executable: For distributing desktop story experiences.
• Web Format (HTML5): Can be embedded directly into web pages.
• Script File: Export as JSON data readable by other game engines (such as Unity).

Step 3: Configure export options such as window size and whether to compress assets, then click “Export” and choose a save location.

III. Advanced Tips for Common Features

• Quickly copy node structures: After selecting a node, press Command + C to copy, then press Command + Shift + V to perform a “copy with connections,” automatically preserving its original input/output connection logic.
• Canvas navigation efficiency: Hold the Spacebar and drag the mouse to pan the canvas; use Command + mouse scroll wheel to quickly zoom in and out.
• Node alignment and distribution: After selecting multiple nodes, right-click and choose the “Align” tool to quickly achieve left alignment, horizontal center distribution, and more, making your node graph neater.
• Speed up creation with the snippet library: Save commonly used complex logic (such as the “affinity check and feedback” combination) to the snippet library in the bottom panel, so you can drag and reuse them directly later.
• Global search and replace: Use Command + Shift + F to open global search, which lets you find not only text but also all nodes that reference a specific variable.

IV. Common Problems and Solutions

• Problem 1: Connection error or unable to connect
  • Cause: Port type mismatch (for example, connecting an output to another output).
  • Solution: Make sure the connection is dragged from the node’s output port (small triangle) to another node’s input port (small square). Hovering will show a highlighted prompt.
• Issue 2: The story does not branch as expected during preview
  • Cause: Incorrect conditional expression logic or variable values not updated at the expected time.
  • Solution: Open the debug panel (Command + Shift + D), run tests, observe the variable change paths, and troubleshoot condition nodes step by step.
• Issue 3: The software runs slowly and the node graph responds sluggishly
  • Cause: Too many nodes in a single canvas (more than 500).
  • Solution: Use the “Scenes” feature in the navigation panel to split a large story into multiple scenes (sub-graphs). Connect them via “Scene Jump” nodes to improve performance and manageability.
• Issue 4: The exported web version displays abnormally in the browser
  • Cause: Possibly using media formats not supported by the browser, or paths containing special characters such as Chinese.
  • Solution: Ensure all audio is in MP3 format and images are JPG/PNG. Use English and numbers for project file paths and asset names whenever possible.

V. Sandwalkers for Mac Shortcuts Overview

By mastering the core interface, workflow, tips, and shortcuts above, you will be able to fully leverage the powerful features of Sandwalkers for Mac and efficiently build clear, richly interactive nonlinear narrative works. Be sure to make good use of the real-time testing feature during the creation process to ensure the smoothness and accuracy of your story logic.

“`