Package net.demilich.metastone.game.actions

Class PlayCardAction

java.lang.Object

net.demilich.metastone.game.actions.GameAction

net.demilich.metastone.game.actions.PlayCardAction

All Implemented Interfaces:

Serializable, Cloneable, Notification

Direct Known Subclasses:

PlayChooseOneCardAction, PlayHeroCardAction, PlayMinionCardAction, PlaySpellCardAction, PlayWeaponCardAction

public abstract class PlayCardAction
extends GameAction

A play card action stores a card and an optional target.

When a Card is Card.play()'d, the action that is returned by that method doesn't have a GameAction.getTargetReference() even if it requires a target. ActionLogic.rollout(GameAction, GameContext, Player, Collection) will inspect the PlayCardAction, checking its GameAction.getTargetRequirement() to see if it's supposed to ask a target from the player.

This means that Card.play() action instance isn't yet a valid action that can be played, unless its CardDesc.getTargetSelection() is TargetSelection.NONE. If the target selection isn't NONE, the action should be rolled out into multiple actions, one corresponding to each valid target.

See Also:

• to see how a card's actions can be manipulated with a spell.
• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static org.slf4j.Logger	logger

Fields inherited from class net.demilich.metastone.game.actions.GameAction

chooseOneOptionIndex

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	PlayCardAction()
	PlayCardAction(EntityReference cardReference)

Method Summary

Modifier and Type	Method	Description
boolean	canBeExecutedOn(GameContext context, Player player, Entity entity)
PlayCardAction	clone()
void	execute(GameContext context, int playerId)	Plays a card from the hand.
String	getDescription(GameContext context, int playerId)	A user-renderable description of what occurred in this notification.
Card	getSource(GameContext context)
List<Entity>	getTargets(GameContext context, int player)	For visualization purposes, what are the targets of this notification?
abstract void	innerExecute(GameContext context, int playerId)	Represents the consequences of playing a spell card, minion card, hero card, hero power card, etc.

Methods inherited from class net.demilich.metastone.game.actions.GameAction

equals, getActionType, getChooseOneOptionIndex, getId, getSource, getSourceReference, getTargetReference, getTargetRequirement, hashCode, isClientInterested, isOverrideChild, isPowerHistory, setActionType, setChooseOneOptionIndex, setId, setOverrideChild, setSourceReference, setTarget, setTargetReference, setTargetRequirement, toString, withTargetReference

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

logger

public static org.slf4j.Logger logger

Constructor Details

PlayCardAction

protected PlayCardAction()

PlayCardAction

public PlayCardAction(EntityReference cardReference)

Method Details

clone

public PlayCardAction clone()

Overrides:

clone in class GameAction

canBeExecutedOn

public boolean canBeExecutedOn(GameContext context,
 Player player,
 Entity entity)

Overrides:

canBeExecutedOn in class GameAction

execute

public void execute(GameContext context,
 int playerId)

Plays a card from the hand. Evaluates whether the card was countered, increments combos, and deducts mana.

Specified by:

execute in class GameAction

Parameters:

context - The game context

playerId - The player who actually plays the card

See Also:

• for an important implementation for playing cards.

innerExecute

public abstract void innerExecute(GameContext context,
 int playerId)

Represents the consequences of playing a spell card, minion card, hero card, hero power card, etc.

Unlike execute(GameContext, int), this method will not deduct mana, will not be counterable, and will not increment combos. In other words, this method omits the effects of playing a card from the hand.

However, by using the action, a TargetSelection will still occur.

The EntityReference.TARGET will refer to whatever is the GameAction.getTargetReference().

The GameAction.getTargetRequirement() indicates whether or not these effects require a target to be selected.

Parameters:

context -

playerId -

getSource

public Card getSource(GameContext context)

Specified by:

getSource in interface Notification

Overrides:

getSource in class GameAction

getTargets

public List<Entity> getTargets(GameContext context,
 int player)

Description copied from interface: Notification

For visualization purposes, what are the targets of this notification?

Specified by:

getTargets in interface Notification

Overrides:

getTargets in class GameAction

Parameters:

context - game context

player - the player

Returns:

A reference to the entity that is the visualizable target of this notification.

getDescription

public String getDescription(GameContext context,
 int playerId)

Description copied from interface: Notification

A user-renderable description of what occurred in this notification.

Specified by:

getDescription in interface Notification

Overrides:

getDescription in class GameAction

Parameters:

context - the game context

playerId - the player ID

Returns:

a description string