PlottiPlotti Docs
Script Factory

Node Types

Learn about the functions and usage of various nodes in the script editor

Plotti provides six node types, each with specific functions.

Node Types Overview

NodeMain Function
Start NodeScript entry point
Story NodeDisplay text and images
Choice NodeProvide multiple options
Condition NodeSingle condition check
Conditional Branch NodeMulti-condition logic
Interaction NodeCharacter dialogue

Start Node

Where you set up the cover and opening image.


Story Node

Basic Information

  • Function: Display text content and images for narrating story plot
  • Trigger: Player clicks continue after reading, automatically enters next node

Editing Story Node

Click the node to open the editor:

Content Block Types

TypeDescription
Text BlockStory text content
Image BlockScene image or character art

Adding Content Blocks

  1. Click the "Add Content" button
  2. Select "Text" or "Image"
  3. Enter text or upload image

Usage Tips

  • Split long text into multiple content blocks for better reading experience
  • Use images appropriately to enhance immersion
  • Each node focuses on one scene or plot point

Choice Node

Basic Information

  • Function: Provide multiple options for players to actively choose story direction
  • Trigger: Player clicks an option to jump to corresponding node

Editing Choice Node

Click the node to open the editor:

Configuration

FieldDescription
Prompt TextDescription text above options (optional)
Option ListMultiple choices

Option Configuration

Each option contains:

FieldDescription
Option ContentText displayed to player
Next NodeTarget node after selection
State UpdateState changes triggered (optional)

Connection Method

  1. Connect nodes first: Drag connections from choice node to multiple target nodes
  2. Then configure options: Assign target nodes for each option in the editor

State Updates

Each option can trigger state changes:

TypeDescriptionExample
Affection ChangeModify character affectionSakura affection +10
Item ChangeAdd or remove itemsObtain "Mysterious Key"
Player StatusModify player attributesUpdate player name

Condition Node

Basic Information

  • Function: Automatically select subsequent path based on current game state
  • Trigger: System auto-judges, no player operation needed

Editing Condition Node

Click the node to open the editor:

Supported Condition Types

TypeDescriptionExample
Item DetectionCheck if item is heldHas "Key"
Affection DetectionCheck character affectionSakura affection ≥ 50

Condition Configuration

Each condition contains:

FieldDescription
Condition TypeItem or affection
Target ObjectSpecific item or character
Comparison≥, ≤, =, >, <
Target ValueValue to compare
Jump When MetTarget node when condition met

Default Path

If no condition is met, goes to the default connected node.

Use Cases

  • Check if player obtained key item
  • Enter different plots based on affection
  • Implement simple branching logic

Conditional Branch Node

Basic Information

  • Function: Support complex multi-condition logic
  • Difference from Condition Node: Can combine multiple conditions

Editing Conditional Branch Node

Comparison with Condition Node

FeatureCondition NodeConditional Branch Node
Condition CountSingle conditionMultiple conditions
Logic RelationNoneSupports AND/OR
Branch Count2 (met/not met)Multiple
ComplexitySimpleComplex

Configuring Branches

  1. Add Branch: Each branch represents a condition combination
  2. Set Conditions: Add multiple conditions to branch, connect with AND/OR
  3. Specify Target: Set node to jump to when conditions met
  4. Default Branch: Jump target when no conditions are met

Example

Branch 1 (AND logic):

  • Has "Key" AND Sakura affection ≥ 50
  • Jump: Enter secret room

Branch 2:

  • Has "Key"
  • Jump: Wait at door

Default:

  • Jump: Cannot enter

Interaction Node

Basic Information

  • Function: Plotti's core feature, providing dynamic dialogue with characters
  • Feature: Supports mix of free dialogue and preset options

Introduction

Interaction Node is Plotti's most powerful feature, allowing creation of complex dialogue trees including:

  • Fixed options (manual options)
  • Free dialogue (Agent options)
  • State triggers and updates

Due to rich functionality, we cover Interaction Node in detail on a separate page.

View Interaction Node Tutorial →


Adding Nodes

Method 1: Left Sidebar

Click buttons in the "Add Node" section of the left sidebar, nodes will be added to canvas center.

Method 2: Node Menu

Click the menu button at the top right of an existing node, select "Add Node After".


Connecting Nodes

Creating Connections

  1. Move mouse to the connection point at bottom of source node
  2. Hold and drag to the top of target node
  3. Release mouse to complete connection

Deleting Connections

  1. Click to select the connection line
  2. Press Delete or Backspace key

Connection Rules

RuleDescription
DirectionOnly from bottom to top
Self-connectionCannot connect node to itself
Multi-inputA node can have multiple inputs
Multi-outputA node can have multiple outputs

Deleting Nodes

  1. Click to select node
  2. Press Delete or Backspace key
  3. Confirm deletion

Note: Start node cannot be deleted.


Next Steps