https://github.com/grfigueira/easydialogueeditor
A lightweight and platform agnostic dialogue tree editor for games.
https://github.com/grfigueira/easydialogueeditor
c-plus-plus dialogue-editor game-development game-editor game-tools graph
Last synced: 7 months ago
JSON representation
A lightweight and platform agnostic dialogue tree editor for games.
- Host: GitHub
- URL: https://github.com/grfigueira/easydialogueeditor
- Owner: grfigueira
- License: mit
- Created: 2025-02-25T22:01:03.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2025-03-16T19:38:33.000Z (7 months ago)
- Last Synced: 2025-03-16T19:47:31.505Z (7 months ago)
- Topics: c-plus-plus, dialogue-editor, game-development, game-editor, game-tools, graph
- Language: C++
- Homepage:
- Size: 643 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# EasyDialogueEditor
**EasyDialogueEditor** is a lightweight dialogue tree editor for games.
It allows you to visually create dialogue trees and export them as JSON files.
It is not a dialogue system, but rather a way of visually creating and editing dialogue assets. As such, it will work on any dialogue system and game engine as long as you deserialize the JSON files on your end.
It supports **Speech phrase nodes** and **Player response nodes**.
The program is a single portable executable (~2.7MB) with no external dependencies.
Built with [ImGui](https://github.com/ocornut/imgui), [ImNodes](https://github.com/Nelarius/imnodes), and [SDL2](https://github.com/libsdl-org/SDL).
It currently only runs natively on **Windows**.
## How to build
### Prerequisites
- C++ Compiler (GCC, Clang, or MSVC)
- CMake
- Preferably Visual Studio 2022, but there are other ways to build the program.
### Building
Inside the cloned project run the following commands to generate a Visual Studio solution:
```
git submodule update --init --recursive
mkdir build
cd build
cmake .. -G "Visual Studio 17 2022" -A x64
```
Some dependancies are managed by [vcpkg](https://github.com/microsoft/vcpkg), therefore we need to bootstrap it and install the dependancies:
```
cd vcpkg
.\bootstrap-vcpkg.bat
```
Then, open the previously generated solution in Visual Studio 2022 and do the following:
- In the solution explorer, right click on `EasyDialogEditor` → "Set as Startup Project"
- Right click the **EasyDialogEditor** solution again → Properties → vcpkg → Set `Use Vcpkg Manifest` to **Yes**
> I should probably write a python script to automate all of this...
## FAQ (Frequently Asked Questions)
#### Q: Why does Windows flag EasyDialogueManager.exe from Releases as a potential virus?
R: Windows often gives that warning about downloaded executables, especially from unknown developers. This is common and there is not much I can do. You can always review the source code and compile it yourself if you have concerns.
#### Q: Is it compatible with Linux or macOS?
R: The program currently only runs natively on Windows. It should work on Linux if you run it with Wine.
## TODO
Planned upcoming features:
- [x] Event callback tags;
- [x] Save/Load graph states;
- [ ] Undo/Redo
- [ ] Character names in Speech nodes;
- [ ] Conditionals;