Polylogue

A lightweight, decoupled dialogue management system for Godot 4 with a custom scripting language, integrated IDE, and fully modular UI.

✨ Features

• Custom Dialogue Language
  A clean, writer-friendly scripting syntax inspired by Python and GDScript.

• Native Godot Integration
  Built as a native plugin with zero external dependencies. Direct access to your game's state and custom functions.

• Strict Decoupling
  The compiler and runtime (Engine) are completely independent from visual presentation (UI/Balloon).

• Integrated IDE
  Full-featured editor built directly into Godot. Syntax highlighting and real-time feedback.

• Localization First
  Built-in tools to auto-generate translation keys and export dialogue to CSV. One-click integration with Godot's translation system.

• Modular UI System
  Pre-built balloon components with a typewriter effect, smart text spacing, and customizable button scenes. Mix and match to fit the game's style.

• State Management
  Variables, conditionals, and native function calls—everything needed to weave game logic into the narrative.

• Scene-Based Architecture
  Organize dialogue into scenes with branching, choices, and smart fall-through logic.

📦 Project Structure

polylogue/
├── addons/polylogue/
│   ├── core/              # Tokens, Error Handling, Language Spec
│   ├── compile/           # Lexer, Parser, AST
│   ├── runtime/           # Engine, Player, Interpreter, ExecutionMemory
│   ├── ui/                # Balloon components and samples
│   ├── editor/            # Integrated IDE
│   ├── tools/             # Localization and utilities
│   ├── resources/         # Custom resources
│   ├── assets/            # Images, icons, etc.
│   └── plugin.gd
├── docs/
├── demo/
└── README.md

📚 Documentation

• Installation & Quick Start — Get up and running in minutes
• Scripting Guide — Complete language reference with examples
• Advanced User Guide — API, customization, and localization deep-dive
• Demo — Sample projects demonstrating key features

🛠️ Requirements

• Godot 4.0+
• No external dependencies
• GDScript knowledge (not required, but helpful)

💬 Philosophy

Polylogue follows these core principles:

1. Decoupling First
   Logic and presentation are completely separate. Your dialogue engine doesn't know about buttons or text colors.

2. Writer-Friendly
   The scripting language prioritizes readability. Writers should feel comfortable without a programmer's help.

3. Game-First Integration
   Direct access to your game state, custom functions, and native Godot features.

4. Minimal Magic
   No hidden behaviors or surprise side effects. What you write is what executes.

📄 License

Polylogue is licensed under the MIT License. See the LICENSE file for details.

📞 Support

• 📖 Documentation: Check the /docs folder
• 🐛 Issues: Report bugs on GitHub Issues
• 💬 Discussions: Ask questions on GitHub Discussions