Card Game Combat - Documentation

User Tools

Site Tools

You are here: start » card-passives
card-passives

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
card-passives [2023/01/03 07:53] – [The Require Passive] banerjeeswcard-passives [2024/09/10 05:13] (current) – [Action Pack 2] isiahgames
Line 3: Line 3:
 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. 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.
  
-**Remove this** - This causes the card with this notetag to remove itself from play after use rather than discard it. +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. 
- +<code>
-**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. +
- +
-===== Skill Notetags ===== +
- +
-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>     <Card Passives>
     Passive     Passive
Line 26: Line 10:
     Passive     Passive
     </Card Passives>     </Card Passives>
 +</code>
 +
 +===== Core Engine =====
 +The list of Passives available in [[plugin-core|MYTH_CGC_CoreEngine]] are as follows:
 +| <code>Will End Turn</code> | This will cause the card to end the turn upon use. |
 +| <code>Discard if unplayed</code> | Will discard this card if the turn ends while this card is in the hand. |
 +| <code>Remove if unplayed</code> | Will remove this card from play if the turn ends while this card is in the hand. |
 +| <code>Require [expression]</code> | Cannot be played unless the expression evaluates to true. Code expression. Multiple requirements can be placed in one card. Use the word 'user' to refer to the user of the card.\\ \\ Example:<code>Require user.handSize > 2
 +Require user.handSize < 10
 +Require $gameSwitches.value(3)</code>This will make a card playable only if the user's hand contains more than 2 and less than 10 cards. In addition, can only be played if Game Switch 3 is set to ON. |
 +| <code>Start in [zoneName]</code> | Will be in the specified zone at start of battle, before start-of-battle actions. |
 +| <code>Start of Turn: Skill X</code> | At the Start of Turn, if this Card is in Hand, execute Skill ID X. |
 +| <code>End of Turn: Skill X</code> | At the end of Turn, if this Card is in Hand, execute Skill ID X. |
 +| <code>Enter [zoneName]: Skill X</code> | When this Card enters the specified zone, execute Skill ID X. |
 +| <code>Exit [zoneName]: Skill X</code> | When this Card enters the specified zone, execute Skill ID X. |
 +
 +===== Action Pack 2 =====
 +The list of Passives available in [[plugin-card-action-pack-2|MYTH_CGC_ActionPack2]] are as follows:
 +|  <code>Prevent [cardAction]</code>  | This prevents a card from being the target of a given Card Action.\\ \\ Examples:<code>Prevent Discard</code>This card cannot be selected for the Discard action\\ <code>Prevent Move to Discard</code>This card cannot be moved to the discard zone through any means\\ <code>Prevent Move</code>This card cannot be moved from its starting zone.\\ Specially implemented is: <code>Prevent Perma Remove</code>This card can be removed from play but it will return at end of battle like a normal Remove. See "Perma" Modifier for details below. |
 +|  <code>Transform This into X 
 +    if [expression]</code>  | Replace X with a skill ID and expression with code that evaluates to true or false.\\ \\ This passive transforms the card into a card of the specified Skill ID if the expression is true.\\ \\ The condition works just like the Require passive, but it's evaluated whenever there is a change in game state, as long as this card is in the hand.\\ \\ Example:<code>Transform this into 5 if user.handSize > 7</code> This will transform the card into a card with the Skill ID 5 if the user's hand has more than 7 cards. |
 +
 +===== Independent Card Variables =====
 +The list of Passives available in [[plugin-icv|MYTH_CGC_IndependentCardVariables]] are as follows:
 +| <code>Var(X) init Y</code> | This will set the initial value of Var(X) to the number specified in Y.\\ All values initialize at 0 by default, and this overrides that behavior for this Var index of all cards belonging to this skill.\\ \\ When Var values are reset, either through the "Reset Var after battle?" plugin parameter or through functions listed below, they return to their initial values. |
 +
 +===== Card Fusion =====
 +The list of Passives available in [[plugin-card-fusion|MYTH_CGC_Fusion]] are as follows:
 +| <code>[zoneName] Fusion Recipe: 
 +    X, Y, Z, A, B...</code> | Replace [zoneName] with the name of a Zone\\ \\ Replace X, Y, etc with skill IDs.\\ \\ When the specified zone contains cards of the specified IDs, a Card Fusion will take place that removes those cards from the zone and replaces them with this card.\\ \\ <code>Hand Fusion Recipe: 4, 4, 4</code>The above will make the game check if the Hand contains 3 copies of a card with the skill ID 4, and if it does those three cards will be fused into the card that contains this Card Passive.\\ <code>Discard Fusion Recipe: 5, 7, 9, 10, 11</code>The above will require that 5 different, specific cards are in the Discard, and if they are, they will fuse into the card that contains this Card Passive.\\ \\ Note that a Card can have any number of Fusion Recipes, in any number of zones, including Extra Zones. |
  
 ===== Require ===== ===== Require =====
Line 39: Line 53:
  
 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|Damage Formula]]. 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|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.1672728811.txt.gz · Last modified: 2023/01/03 07:53 by banerjeesw