# Troubleshooting

***

### Action Not Executing

1. Check if the action is enabled (checkbox is checked)
2. Verify the FlowPlayer is active and enabled
3. Check the Console for error messages
4. Ensure all required references are assigned

***

### Trigger Not Firing

1. Verify the FlowPlayer reference is assigned on the trigger component
2. For collision/trigger zone triggers, ensure the GameObject has a Collider (and Rigidbody for collisions)
3. Check tag/layer filters are configured correctly
4. If using Trigger Once, verify the trigger hasn't already fired (call `ResetTrigger()` to re-enable)
5. Check cooldown setting — the trigger may be throttled

***

### Condition Not Evaluating Correctly

1. Verify the target component is assigned
2. Check the member/method name is spelled correctly
3. Ensure the member is accessible (public or SerializeField)
4. For predicates, ensure the method is parameterless and returns bool

***

### Animation Not Playing

1. Verify Animator/Animation component is assigned
2. Check the animation name matches exactly (case-sensitive)
3. For Animator, ensure the state exists in the controller
4. For legacy Animation, ensure clip is set to Legacy

***

### Audio Issues

1. Verify AudioSource is assigned
2. Check AudioClip is assigned (either on source or in action)
3. Ensure AudioListener exists in scene
4. Check volume levels (AudioSource, AudioListener, and action)

***

### Transform Tween Not Working

1. Check target Transform is assigned
2. Verify duration is greater than 0
3. For relative movement, ensure the offset values are correct
4. Check if another script is modifying the same transform

***

### Juice Effects Not Visible

1. Ensure the target Transform is assigned
2. Verify punch amount/intensity values are not zero
3. Check that punch duration is greater than 0
4. For ScreenShake, verify the Position Axes are not all zero

***

### Variable Trigger Not Responding

1. Ensure VariableStorage exists (it auto-creates as a singleton)
2. Verify the Variable Name matches exactly (case-sensitive)
3. Check that the Variable Type matches the type being set
4. For OnConditionMet mode, verify the comparison operator and value

***

### Serialization Lost After Script Changes

If actions lose their data after modifying action scripts:

1. Avoid renaming serialized fields
2. If renaming is necessary, use `[FormerlySerializedAs("oldName")]` attribute
3. Do not change the class namespace without migration


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://beelabs-dev.gitbook.io/beelabs-docs/flow-of-action/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.