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 as GC2 Graph.
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.
For ActionFlow asset parameters, compatible property providers are generated at compile time. Check the first compilation error if the parameter catalog did not update after adding a module.
Game Creator does not compile after changing Unity versions¶
Install official Game Creator Core and module releases compatible with the chosen Unity version. Core 2.19.61 has existed in different uploads with the same visible version number; download the appropriate official package again if an older cached copy is incompatible. Retain the first compilation error and contact the affected package's developer if the issue remains.
ActionFlow 2 no longer includes the older vendor Unity API migration tools. Follow Unity and Game Creator compatibility for installation guidance. Keep Unity 6.3 and 6.6 projects and vendor packages separate.
ActionFlow reports an unsupported serialization source¶
A warning naming SerializationUtils.ApplyUnregisteredSerialization concerns
the separate fix that prevents unchanged Inspector refreshes from dirtying
scenes. The method did not match its exact supported original or patched form,
so ActionFlow left the source untouched.
Keep the full warning and installed Game Creator version when reporting this to ActionFlow support. Do not manually reshape vendor code to match a signature. This diagnostic concerns the scene-dirtying fix; it does not establish that GC2 is incompatible with your Unity version.
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 validates the LogicBlock schema before editing. An unsupported version fails closed and reports a diagnostic instead of guessing at the asset layout. 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 any import or domain reload. 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 serialized fields 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 stale-state warning caused by a newer prefab source change.
Use Open Asset Graph to compare the source. Revert only the specific layer 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. Stop Play Mode before invoking authoring Undo/Redo for graph changes.
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 serialized flow data;
- a related prefab source changed while the graph has unresolved local edits;
- the graph cannot safely synchronize its current model.
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.