Overview
Nodes, Ports & Connections
Nodes
Nodes are the fundamental building blocks of Master Combat Core graphs. Each node represents a single unit of logic such as a condition check, an action, a calculation, or a data fetch.
Common node categories include:
- Trigger Nodes – Entry points for graph execution
- Condition Nodes – Boolean checks (health %, attribute value, state, etc.)
- Action Nodes – Perform effects (damage, heal, apply buff, spawn entity)
- Utility Nodes – Math, comparisons, flow helpers
Ports
Ports define how nodes communicate with each other.
Port Types
-
Flow Ports
Control execution order (green for conditions, yellow for triggers) -
Value Ports
Pass typed data (blue for Entity, white for numbers, etc.) -
Execution Ports
Execute data modification, game behavior, send events, etc. (red connections)
Ports are strictly typed to prevent invalid connections.
Connections
Connections link output ports to compatible input ports.
Rules:
- Flow ports can only connect to flow ports
- Value ports must match data types
- One output can feed multiple inputs
Connections are evaluated at runtime based on graph execution flow.
Best Practices
- Keep nodes small and focused
- Use Groups and Sticky Notes for clarity
- Reuse nodes can improve performance
For example, one condition node connect with other nodes have better performance
than two same condition node connected with other nodes.
