Troubleshooting¶
Open Graph is missing¶
Check that:
- Game Creator 2 is installed and compiled;
- ActionFlow 2 imported without compilation errors;
- the selected GameObject has a Trigger, Actions, Conditions, or compatible Story Engine Rule component;
- Unity is not still compiling.
Open the component's context menu and try Open in ActionFlow 2.
A newly installed module does not appear¶
ActionFlow 2 discovers module-provided Events and Instructions after Unity compiles the project. Wait for compilation to finish, then reopen the node picker or graph window.
If asset parameter types do not update after adding a module, check the first compilation error in the Console.
Game Creator does not compile after changing Unity versions¶
Install official Game Creator Core and module releases compatible with the chosen Unity version and each other. Download the appropriate official packages again if a cached copy is incompatible. Retain the first compilation error and contact the affected package's developer if the issue remains.
Follow Unity and Game Creator compatibility for installation guidance. Test a Unity upgrade in a separate project copy.
A scene asks to save after viewing the Game Creator Inspector¶
Some Game Creator Inspector controls can mark a scene as changed without changing its values. Review any other edits before saving or discarding the scene.
A LogicBlock asset will not open¶
Check that LogicBlock is installed and Unity has finished compiling. Use Assets › Open in ActionFlow 2 on a Block asset.
ActionFlow 2 checks compatibility before allowing editing. If the version is unsupported, it shows a message and leaves the asset unchanged. Update to a compatible LogicBlock version rather than modifying the asset manually.
The graph opens but node bodies keep loading¶
Wait for Unity to finish importing or recompiling scripts. If loading does not finish:
- close and reopen that graph;
- check the Console for the first error;
- confirm that all required Game Creator modules are present;
- restart the Unity Editor if assemblies were changed outside Unity.
Do not repeatedly edit the graph while node settings are unavailable.
A prefab instance does not match its source¶
Look for:
- Game Creator value overrides;
- structural overrides in instruction or branch lists;
- an instance graph-layout override;
- a warning that the source prefab changed while the graph was open.
Use Open Asset Graph to compare the source. Review the instance's overrides before reverting the changes you intend to discard.
If a Local Variables component instead reports Another Variable Component has the same ID, see Local Variable IDs on prefab instances.
Undo behaves differently in Play Mode¶
Structural authoring is disabled in Play Mode. Ordinary Unity Undo and Redo continue to work. If a command would change a graph edit, ActionFlow 2 stops Play Mode and keeps that edit unchanged. Repeat the command in Edit Mode to apply it. This also applies after closing a graph window.
Runtime highlighting does not appear¶
- Keep the relevant graph window open.
- Confirm the trigger actually fired.
- Check that the Console has no runtime exceptions.
- Stop and re-enter Play Mode after a script reload.
- Test with a short trigger-to-instruction path to isolate the issue.
The graph is read-only¶
ActionFlow 2 may intentionally block editing when:
- Unity is entering or leaving Play Mode;
- the target has unsupported or damaged flow data;
- a related prefab source changed while the graph has unresolved local edits;
- the graph cannot save or refresh its current changes safely.
Read the warning shown in the graph before reloading or reverting data.
Before reporting a problem¶
Include:
- Unity version;
- ActionFlow 2 version;
- Game Creator 2 version and installed modules;
- whether the target is a scene object, prefab instance, variant, nested prefab, or prefab asset;
- the first relevant Console error and stack trace;
- exact reproduction steps;
- a screenshot of the full graph window.