Godot IMSC Dialogue/Script Player

A lightweight yet powerful JSON dialogue/script player that can be easily integrated into any stage of game development.

You can create a JSON graph from scratch (following JSON schema) or use IMS Creators (Desktop version) to create ready-to-use dialogue graphs in a visual editor.

Works with any Godot 4 project and provides full control over dialog flow, branching, variables, triggers, and serialization.

Features

• 🎭 Speech nodes with optional choices (branching dialogs)
• 🔀 Conditional branching based on variables or expressions
• 📦 Variable management – set, get, and use in conditions
• ⚡ Trigger / Function nodes – invoke game logic and receive outputs
• 💾 Serializable state – save/load, undo/redo, replay
• 📝 Expression evaluation – math, comparison, and logical operators
• 🧩 Async support – triggers can be asynchronous
• 📜 Sub‑scripts – callScript nodes run nested graphs with isolated variables and in/out data flow
• 🧰 Custom nodes – register your own exec (flow) or data (expression) node types via register_custom_node
• ⏸️ Pause/Resume – pause execution during triggers or user input

Documentation

The usage guide and documentation is available on Github.

Example of dialogue graph:

{
  "start": "greeting",
  "nodes": {
    "greeting": {
      "type": "speech",
      "values": {
        "character": "Guard",
        "text": "Hello!"
      },
      "next": "ask"
    },
    "ask": {
      "type": "speech",
      "values": {
        "character": "Guard",
        "text": "What do you want?"
      },
      "options": [
        { "values": { "text": "I seek adventure." }, "next": "adventure" },
        { "values": { "text": "I want to trade." }, "next": "trade" },
        { "values": { "text": "Nothing, goodbye." }, "next": "end" }
      ]
    },
    "trade": {
      "type": "trigger",
      "subject": "trade",
      "next": "ask"
    },
    "adventure": {
      "type": "speech",
      "values": {
        "character": "Guard",
        "text": "Then go east, brave soul!"
      },
      "next": "end"
    },
    "end": { "type": "end" }
  }
}

Full schema description