====== Card Actions ======

Card Actions are effects that can happen at the start of a battle, at the start of a turn, or when you play a Card or use an Item. These effects can be used in sequence to create more versatile effects.

In place of a number in all Card Actions, you can also use \V[x] to use a Game Variable, just like with message boxes.
Example:
    Draw \v[4]
Will draw 3 cards if Game Variable 4 is set to 3, 1 card if Game Variable 4 is set to 1, and so on.

===== Skills/Items =====

**Card Actions** can be added to a Skill or Item by using the following notetag format:
<code>
<Card Actions>
    Action
    Action
    Action
</Card Actions> 
</code>
The actions will execute in the order they are listed for the User of the Card.

**Card Target Actions** execute actions for the Target of the skill/item using the following notetag format:
<code>
<Card Target Actions>
    Action
    Action
    Action
</Card Target Actions>
</code>
These can be used for example to have an ally draw cards as part of a Card effect.

**Note**: Since Enemies do not have Cards or Decks (as of [[plugin-core|MYTH_CGC_CoreEngine]] v1.6.0), they can't process Card Target Actions. This feature is currently limited to an Actor and their allied Party members.


===== Battle Start/Turn Start =====

{{https://img.itch.zone/aW1nLzE1NDk2OTI4LnBuZw==/original/tRkguc.png?nolink}}

Using the **Battle Start Actions** parameter, Card Actions can be executed at the start of a battle. Simply input each command on a new line like so:

    Shuffle Deck
    Draw 5

This example will shuffle the deck at the start of the battle and draw 5 cards to the player.

**Turn Start Actions** works the same way, except that these Card Actions are executed at the beginning of every turn except for the first turn:

    Discard Until 0
    Draw 5

This example will cause the player to discard their entire hand and draw 5 new cards.

The Battle Start Actions will execute on turn 0, and the Turn Start Actions will execute at the start of every turn after that.

===== Card Actions on Empty =====

Each Zone has a parameter called Card Actions on Empty which is a list of Card Actions that execute automatically when that zone is made empty. 

The default Card Actions on Empty for the Discard zone are as follows:

    Move all from discard to deck
    shuffle deck

No other zones have default Card Actions on Empty.

These Card Actions are added to the beginning of the current list of Card Actions, effectively interrupting them so that the effect of the zone can be resolved first. For instance, if you play a card with the Draw 4 Card Action while there were 3 cards in the Deck, the game would draw the 3 remaining cards, execute the Deck's Card Actions on Empty, and then attempt to draw 1.

===== List of All Card Actions =====

Below is a list of every Card Action sorted by which plugin provides it.
==== Core Engine ====
The list of Actions available in the [[plugin-core|Core Plugin]] are as follows:


{{page>plugin-core#actions}}

==== Card Types ====
If you’re using [[plugin-card-types|Card Types]] plugin, you also have access to these Card Actions:

{{page>plugin-card-types#actions}}

**Note**: As of 1.6.2, card type names are no longer case-sensitive.
==== Action Pack 1 ====
If you are using the plugin [[plugin-card-action-pack-1|Action Pack 1]], you also have access to these Card Actions:

**Selection Card Actions**

{{page>plugin-card-action-pack-1#selection_card_actions}}


**Movement Card Actions**

{{page>plugin-card-action-pack-1#movement_card_actions}}


**Clear Card Actions**

{{page>plugin-card-action-pack-1#clear_card_actions}}

==== Action Pack 2 ====
If you are using the plugin [[plugin-card-action-pack-2|Action Pack 2]], you also have access to these Card Actions:

{{page>plugin-card-action-pack-2#card_actions}}

In addition, you have access to [[plugin-card-action-pack-2#modifiers|Card Action Modifiers]].
==== Independent Card Variables ====
If you are using the plugin [[plugin-icv|Independent Card Variables]], you also have access to these Card Actions:

{{page>plugin-icv#card_actions}}

==== Card Summons ====

If you are using the plugin [[plugin-card-summons|Card Summons]], you also have access to these Card Actions:

{{page>plugin-card-summons#card_actions}}

===== Card Action Modifiers =====

For the time being, Modifiers are only present in Action Pack 2. [[plugin-card-action-pack-2#modifiers|See its section on Modifiers.]]