User Tools

Site Tools


card-passives

Table of Contents

Card Passives

Card Passives work similar to Actions, but rather than executing when the card is played, they affect the properties of the card in various other ways.

Skills

Just like Card Actions, Card Passives can be added to a Skill notetag in a similar format. Unlike Actions, however, they cannot be added to items.

    <Card Passives>
    Passive
    Passive
    Passive
    </Card Passives>

The list of Passives available in IsiahCardGameCombat are as follows:

Remove this This causes the card with this notetag to remove itself from play after use rather than discard it.
Discard if Unplayed This causes the card with this notetag to discard itself if the user’s turn ends while it is in their hand.
Remove if Unplayed This causes the card with this notetag to remove itself from play if the user’s turn ends while it is in their hand.
Start in Hand This causes the card to enter the user’s hand at the start of battle, before the Battle Start Actions execute.
Require [expression] This passive will disable the card from being playable unless the given expression evaluates to true. Multiple Require passives can be in the same card.
Start of Turn: Skill X At the Start of Turn if this Card is in Hand, then execute Skill ID X.
End of Turn: Skill X At the end of Turn if this Card is in Hand, then execute Skill ID X.
Enter zoneName: Skill X When this Card enters the specified Zone - Deck, Discard, or Hand - execute Skill ID X.
Exit zoneName: Skill X When this Card exits the specified Zone - Deck, Discard, or Hand - execute Skill ID X.

Require

Anything after the word “Require” is evaluated as code. It can contain multiple expressions, but it is recommended to separate things into multiple Require passives for better clarity.

The variable ‘user’ can be used to refer to the actor that the card belongs to.

Because it is code, you could do something like:

  Require $gameSwitches.value(30)

And require that the 30th Game Switch be set to ON for a card to be playable.

The example image in the Card Passive Skill Notetags section requires that the actor playing the card have more than 2 cards in their hand, and that they’ve removed less than or equal to 7 total over the course of the battle. For more information about the handSize and removedCards variables, refer to Damage Formula.

End Turn

Note: If you are using YEP_InstantCast, you can ignore this section and refer to that plugin, as its rules override that of this plugin.

In default RMMV, using any skill will end that actor’s turn. With this plugin, the default behavior now treats all skills as “instant” skills, meaning they will not end the player’s turn unless otherwise specified.

Any skill with the notetag <willEndTurn> will end the player’s turn.

IMPORTANT: make sure to add this notetag to the skill used in the End Turn Skill # parameter.

card-passives.txt · Last modified: 2023/06/02 01:28 by isiahgames