Troubleshooting
The package does not compile
Section titled “The package does not compile”- Confirm Game Creator 2 was imported before Animation Montages.
- Inspect the first Unity Console error rather than later cascading errors.
- Confirm the package directory is present.
- If the project uses custom assembly definitions, review the assembly references.
- Verify assembly names against the installed Game Creator version.
The Montage does not play
Section titled “The Montage does not play”- Confirm the target Character has an Animation Montage Player.
- Confirm the Action targets that Character and a Montage asset.
- Confirm an animation clip is assigned.
- Review layer, Avatar Mask, interruption, and Character-busy settings.
- Test with no parameter overrides to isolate invalid runtime data.
A Notify fires at the wrong visual moment
Section titled “A Notify fires at the wrong visual moment”Normalized timing preserves the percentage, not the pose. Preview the asset after changing the animation clip or playback speed and move the Notify to the correct contact frame.
A Window remains active or closes unexpectedly
Section titled “A Window remains active or closes unexpectedly”Check both normal completion and interruption:
- confirm the start and end percentages;
- inspect the On Open and On Close instructions;
- test canceling inside the range; and
- confirm that cleanup also runs when playback is stopped or replaced.
Test both normal completion and each interruption path used by the project.
Another Montage interrupts too early
Section titled “Another Montage interrupts too early”Review Interruptible, Require Cancel Window, Priority, Conflict Behavior, and the cancel/interrupt blend values. Then confirm that the expected Cancel-category Window is active.
A Transform target is not restored
Section titled “A Transform target is not restored”Review Restore On End, parent targeting, and destroy-on-end settings. Test natural completion,
Stop, Cancel, a Branch jump, and an external interruption separately.
Frequently asked compatibility questions
Section titled “Frequently asked compatibility questions”Does the extension modify Game Creator 2 core files?
Section titled “Does the extension modify Game Creator 2 core files?”No. Animation Montages integrates through Game Creator 2 public APIs.
Can it run alongside other Game Creator 2 modules?
Section titled “Can it run alongside other Game Creator 2 modules?”Yes. Test the specific module combination used by the project when upgrading either dependency.
Does it support Unity 6 and all render pipelines?
Section titled “Does it support Unity 6 and all render pipelines?”Yes. See the supported versions and render pipelines in Installation.
Does playback allocate memory?
Section titled “Does playback allocate memory?”Playhead updates are designed to avoid allocations. Profile the complete gameplay flow on the target platform when optimizing performance.
How is speed changed at runtime?
Section titled “How is speed changed at runtime?”Use Set Montage Speed in visual scripting or the writable player.Speed property in C#.
If the issue remains, prepare the details listed on Support.