User Tools

Site Tools


plugin-card-action-pack-2

MYTH_CGC_ActionPack2 is a plugin that adds new Card Actions, Passives and the new Modifier keywords.

Current Version: 1.0.0

This plugin is currently Patreon Only.

Card Actions

Shuffle zoneName
Replace 'zoneName' with a zone. This will shuffle the specified zone.
Transform X into Y
Replace X with a number, and Y with a skill ID.
This will make the player select X cards from their hand, and the selected cards will transform into a card with the specified Skill ID.
The card will then have all of the Actions and Passives of the new Skill ID.
If you're using Independent Card Variables, the transformed card will still have access to its old Var values.
Transform This into X
Replace X with a skillID.
This will transform the card currently being used into a card with the specified Skill ID.
Transform Selected into X
Replace X with a skillID.
When used in conjunction with ActionPack1, this will transform cards selected through a Select Card Action into cards with the specified Skill ID.
Copy X to zoneName
Replace X with a number and 'zoneName' with a zone.
This will make the player select X cards from their hand, and the selected cards will be copied into the specified zone.
This is a duplication effect, which means unlike Add, which creates a whole new card, the new copy has all of the Var values from the original.
Copy Selected to zoneName
Replace 'zoneName' with a zone.
When used in conjunction with ActionPack1, this will copy the cards selected through a Select Card Action into the specified zone.
Copy This to zoneName
Replace 'zoneName' with a zone.
This will copy the card currently being used into the specified zone.
Draw X from zoneName
Replace X with a number and 'zoneName' with a zone.
This will take a card from the top of the specified zone and add it to the Hand. It works just like “Move X from zoneName to Hand”

Card Passives

Prevent [cardAction]
This prevents a card from being the target of a given Card Action.
Prevent Discard

This card cannot be selected for the Discard action

Prevent Move to Discard

This card cannot be moved to the discard zone through any means

Prevent Move

This card cannot be moved from its starting zone.
Specially implemented is:

Prevent Perma Remove

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.

Transform This into X if [expression]
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.

Transform this into 5 if user.handSize > 7

This will transform the card into a card with the Skill ID 5 if the user's hand has more than 7 cards.

Modifiers

Modifiers are keywords you can add to a Card Action to change how it works. If Card Actions are verbs, Modifiers are adjectives and adverbs. You can add a Modifier to nearly any Card Action and its effect will be applied to that Card Action.

There are 3 types of Modifiers - Start, Middle, and End Modifiers.

Start Modifiers need to be placed at the beginning of the Card Action.
End Modifiers need to be placed at the end of the Card Action.
Middle Modifiers should be placed somewhere in the middle.

They are organized this way to avoid confusing Modifiers with other Modifiers or Card Actions that share similar language.

Discard Random 1

This takes a default Card Action, “Discard 1”, and adds the “Random” Modifier, changing its behavior. The “Random” Modifier randomly selects a card instead of making the player choose.

A Card Action can have any number of Modifiers on it at once.

Start Modifiers

Perma
This modifies a Card Action whose effects are undone at the end of battle to retain those effects.

Perma Add 8 to Hand

The Add Card Action normally adds cards only for the duration of the battle, but with the Perma Modifier these cards remain after battle.

Perma Transform This into 8

Transformed cards revert at the end of battle, but with the Perma Modifier this card would remain transformed.

Perma Remove Selected

The Perma Modifier would remove the selected cards from the actor's library permanently.

Force
This overrides the Prevent Card Passive, allowing the Card Action to happen even on a Card that would normally Prevent it.
Bypass
This modifies any Card Action that makes a card enter or exit a zone such that its Enter/Exit Zone Forced Actions do not trigger.

Bypass Discard Until 0

This would discard the player's entire hand without triggering any Enter/Exit effects that cards may otherwise possess.

Middle Modifiers

Overflow zoneName
Replace 'zoneName' with a zone.
This modifies any Card Action that targets cards from a zone. If the amount of targets exceeds the amount of cards in that zone, cards will be selected from the specified Overflow zone to make up the difference.

 Discard 5 Overflow Deck

Discard 5 would make the player choose 5 cards to discard. Normally, if the player only has 3 cards they would automatically discard those 3 and the Action would resolve. However, with “Overflow Deck” added then 2 more cards would be taken from the Deck and added to the Discard.

Move 7 from Discard Overflow Hand to Deck

This would return 7 cards from the Discard pile to the Deck. If the player only had 3 cards in their Discard, the player would then have 4 of their cards taken from their Hand to move to the Deck.

Transform 3 Overflow Deck into 8

If the player had fewer than 3 cards in their Hand, the remainder would be taken from the top of the Deck to be Transformed.

Top
Middle
Bottom
Random
These modify any Card Action that targets cards from a zone. When a player would normally make a manual selection, these automate the selection. When an Action would normally target the first card in a zone (like Draw) these can override that.

Top makes the Action target the first card in the zone.
Middle makes the Action target the median card in the zone.
Bottom makes the Action target the last card in the zone.
Random makes the Action target a random card in the zone.

Draw Bottom 1

While Draw normally draws from the top, this would instead cause the player to draw from the bottom of the Deck
.

Discard Random 3

This selects 3 random cards in the player's hand and discards them, rather than making the player choose.

Move Bottom 2 from Discard to Hand

This would return the 2 most recently discarded cards to the player's hand. Note that by default the Discard displays its cards in opposite order, so what a player would intuitively know as the “top” of the Discard is actually its Bottom.

End Modifiers

Top
Middle
Bottom
Random
These Modifiers do something different depending on if they are in the Middle of a Card Action or at the End.
These modify any Card Action that sends cards to a specific zone. Normally, cards are moved to the bottom of a zone. These can override that.

Top moves a card to be the first card in a zone.
Middle moves a card to be in the middle position in a zone.
Bottom does not change the behavior.
Random moves the card to a random position within the zone, “shuffling” it in.

Discard 1 Random

This makes the player select a card from their hand, and moves the card to a random position inside the discard.

Copy Selected to Deck Top

This modifies the Copy Selected Card Action so that the new copies are added to the top of the deck instead of the bottom.
Note that because Top/Bottom/Random is a different Modifier depending on where it is in the Card Action, you can use both at once.

Move 2 from Deck Bottom to Discard Top

This would take cards from the bottom of the Deck and put them at the top of the Discard

plugin-card-action-pack-2.txt · Last modified: 2024/06/09 14:17 by banerjeesw