https://github.com/xprees/unity-graph-core
Unity Graph Core library based on xNode
https://github.com/xprees/unity-graph-core
graph unity
Last synced: 5 months ago
JSON representation
Unity Graph Core library based on xNode
- Host: GitHub
- URL: https://github.com/xprees/unity-graph-core
- Owner: xprees
- License: apache-2.0
- Created: 2025-10-09T14:30:27.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2025-12-10T14:56:08.000Z (7 months ago)
- Last Synced: 2025-12-10T23:42:14.785Z (7 months ago)
- Topics: graph, unity
- Language: C#
- Homepage: https://www.npmjs.com/package/cz.xprees.graph-core
- Size: 326 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Graph-Core package - `cz.xprees.graph-core`
# [](https://www.npmjs.com/package/cz.xprees.graph-core)
This package provides the core functionality for the xprees Graph system, which is based on [Siccity/xNode](https://github.com/Siccity/xNode) node
system.
We used it to create:
- Dialog system
- Quest system
- Email conversation tree
- And more...
## Features
- **Runtime node system** - Allows for creating and managing no-code solutions in Unity.
- **Graph editor** - Provides a visual editor for creating and managing graphs.
- **Preset of most used nodes** - Includes a set of commonly used nodes for quick setup.
- **Easily extensible** - Supports simple extension of existing nodes, graphs, graph-parsers, etc.
Usage example
## Installation
Add to your Unity project following **OpenUPM** and **xprees-NPM** scoped registries. So you can install the package with the all dependencies
automatically with [Unity Package Manager](https://docs.unity3d.com/6000.1/Documentation/Manual/upm-scoped.html).
Either do it manually or by using the Unity Package Manager UI.
`Packages/manifest.json`
```json
{
"scopedRegistries": [
{
"name": "OpenUPM",
"url": "https://package.openupm.com",
"scopes": [
"com.cysharp.unitask",
"com.github.siccity",
"com.dbrizov.naughtyattributes"
]
},
{
"name": "xprees-NPM",
"url": "https://registry.npmjs.org",
"scopes": [
"cz.xprees"
]
}
]
}
```
After adding the scoped registries, you can install the package easily via the Unity Package Manager UI by searching for `cz.xprees.graph-core`.
### Git URL
Install in the package manager using the following Git URL
```git
https://github.com/xprees/unity-graph-core.git
```
## Usage
For the basics of node systems, refer to the [Siccity/xNode wiki](https://github.com/Siccity/xNode/wiki)
1. Create your graph by extending the `Graph` class.
2. Create your graph parser by extending the `GraphParser` class.
3. Create your nodes by extending the `BaseNode`, `SingleOutputBaseNode` class.
- Adding `IPassthrougNode` interface will mark the node for the parser to **directly go-on to next node** after triggering the _PassThrough_ one.
Otherwise, the parser will wait for the next `MoveNext()` invocation.
### Building a graph
1. Each graph must have a **One** `Start` node (Single entry point), and can have **Many** `End` nodes.
2. Each "flow" in the graph should end with an `EndNode`.
3. You can create custom nodes which are triggered by outside code, such as events, which can then be used in asynchronous flows.