> For the complete documentation index, see [llms.txt](https://infinitypbr.gitbook.io/magic-pig-games/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/action-validator.md).

# Action Validator

v1.0

{% hint style="info" %}
The <mark style="color:yellow;">Action Validator</mark> is especially useful when writing your own actions, either by yourself or with your friendly AI. It will help guide best practices and catch potential mistakes.
{% endhint %}

Open the <mark style="color:yellow;">Action Validator</mark> window with *Tools/Juicy Actions/Action Validation*. The window will take a few moments to load as it gathers and analyses all of the Actions in the project.

<figure><img src="https://2431624982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MY3N_li2jPq7az6mYfq%2Fuploads%2FTjIb2EQxs4HFWNT48SDr%2FScreenshot%202026-01-06%20at%204.56.45%E2%80%AFPM.png?alt=media&amp;token=8ae3f722-7b04-4a6e-9f1b-7492668a0e26" alt=""><figcaption><p>Don't worry, these warnings will be fixed before <mark style="color:yellow;">Juicy Actions</mark> is shipped!</p></figcaption></figure>

All <mark style="color:yellow;">Actions</mark> will be displayed, and you can choose how they are ordered, and filter with a `string`.

Warnings will be dispalyed in yellow. Hover over the *Lifecycle* and *Validation* warnings to learn more with a tooltip.

<figure><img src="https://2431624982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MY3N_li2jPq7az6mYfq%2Fuploads%2FyjmytbKLddE3RK7jeAgt%2FScreenshot%202026-01-06%20at%205.05.09%E2%80%AFPM.png?alt=media&amp;token=98da9c4b-6aa4-4252-9ee6-e1e60ce02e62" alt="" width="375"><figcaption></figcaption></figure>

After loading the window, the console will produce a report. This report can be very useful to your favorite AI overlord who may be helping you fix up your scripts — just copy/paste the report and ask your minion to help out. You may wish to remind your AI companion that the `Action.cs` class has many helpful comments on how to properly set up new <mark style="color:yellow;">Actions</mark>.

<figure><img src="https://2431624982-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MY3N_li2jPq7az6mYfq%2Fuploads%2FJCcFzY4V36qY2c5bjY7e%2FScreenshot%202026-01-06%20at%205.03.07%E2%80%AFPM.png?alt=media&amp;token=d63209d7-bec1-4fb5-8a2b-b17b5fa756b9" alt=""><figcaption></figcaption></figure>

## Suppressing Warnings

There may be cases where an action has a valid reason to break the guidelines. If thats the case, you can add these comments to your script and the <mark style="color:yellow;">Action Validator</mark> will ignore any issues.

| Comment                                      | Effect                                                                                                         |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| `// VALIDATION_IGNORE: Random`               | Suppress all <mark style="color:yellow;">Random</mark>-related warnings                                        |
| `// VALIDATION_IGNORE: Time`                 | Suppress all <mark style="color:yellow;">Time</mark>/<mark style="color:yellow;">Clock</mark>-related warnings |
| `// VALIDATION_IGNORE: Blackboard`           | Suppress <mark style="color:yellow;">Blackboard</mark> warnings                                                |
| `// VALIDATION_IGNORE: TimeBeforeNextAction` | Suppress `timeBeforeNextAction` constructor check                                                              |
| `// VALIDATION_IGNORE: HasDuration`          | Suppress warnings about `HasDuration()` not being exactly `true` or `false`                                    |
| `// VALIDATION_IGNORE: DurationZero`         | Supress warnings when the `transitionDuration` defaults to `0`                                                 |
| `// VALIDATION_IGNORE: Logging`              | Suppress warnings about not using the logging methods on the `Action.cs` parent class                          |
| `// VALIDATION_IGNORE: SimpleMode`           | Suppress warnings about not having a "Simple Mode".                                                            |
| `// VALIDATION_IGNORE: Lifecycle`            | Suppress warnings about end of lifecycle methods missing                                                       |
| `// VALIDATION_IGNORE: BaseValue`            | Suppress warnings about `HasBaseValue()` and related required method overrides                                 |
| `// VALIDATION_IGNORE: Executor`             | Suppress ALL <mark style="color:yellow;">Executor</mark> usage warnings                                        |
| `// VALIDATION_IGNORE_ALL`                   | Suppress ALL validation warnings for the file                                                                  |