Skip to main content

Validation

The web editor and the upload flow both perform comprehensive validation of your project for story integrity, syntax errors, and semantic errors.

In the Web Editor​

Click the Check button in the editor toolbar to validate your script without saving. Errors are displayed in the panel below the editor and are mapped to the specific chapter and line where they occur.

Click on any error to navigate directly to the problematic line.

Syntax Errors​

If the parser detects a syntax error in your script, it will point out the line and column where the error occurred.

Common syntax errors:

  • Missing --- or === separators
  • Unclosed <<if>> blocks (missing <<endif>>)
  • Invalid variable names
  • Malformed tags (e.g., missing [/b] closing tag)

Semantic Errors​

Semantic errors are logical issues in your story flow. You will see all identified errors with a description of the issue and the location. Since your story can branch, an error might occur on one path but not on another β€” the validator will show the path from the start node to the problematic section.

Common semantic errors:

  • <<jump>> to a non-existent node
  • Using a variable before declaring it
  • Dead-end nodes (no <<jump>> and no options)
Tip

Errors may affect one another, so it is recommended to fix them in order. If the error is typical for your project, resolve it in all occurrences while following the order in which they were found.

Errors in Other Chapters​

When working in the web editor, if errors are found in chapters other than the one you're currently editing, they are displayed in a separate panel at the bottom. Click on any error to switch to the corresponding chapter and line.