Package net.demilich.metastone.game.spells

Class CastRandomSpellSpell

java.lang.Object

net.demilich.metastone.game.spells.Spell

net.demilich.metastone.game.spells.CastRandomSpellSpell

All Implemented Interfaces:

Serializable, HasDesc<SpellDesc>

Direct Known Subclasses:

RandomSpellTargetSpell

public class CastRandomSpellSpell
extends Spell

Casts a random spell from the SpellArg.CARD_SOURCE, SpellArg.CARD_FILTER and SpellArg.CARDS provided.

If SpellArg.EXCLUSIVE is true, the source does not have to be in play in order for the spell to be cast.

The source of the spell written on the card that is randomly chosen is the entity doing the casting, not the card itself.

For example, to implement "Whenever a player casts a spell, cast a copy of it for them with random targets.":

   {
     "eventTrigger": {
       "class": "SpellCastedTrigger",
       "sourcePlayer": "BOTH"
     },
     "spell": {
       "class": "CastRandomSpellSpell",
       "cardFilter": {
         "class": "AndFilter",
         "filters": [
           {
             "class": "SpecificCardFilter",
             "secondaryTarget": "EVENT_SOURCE"
           },
           {
             "class": "CardFilter",
             "cardType": "SPELL"
           }
         ]
       },
       "cardSource": {
         "class": "UncollectibleCatalogueSource"
       },
       "targetPlayer": "ACTIVE"
     }
   }
 

Observe that the CardFilter is a SpecificCardFilter that is configured, using its "secondaryTarget" option, to only be true for cards that are equal to EntityReference.EVENT_SOURCE, i.e., the card that was casted. Only one card (the card that was casted) will match, so that's the card that will be randomly cast.

See Also:

• for a similar spell that works with minions, weapons and heroes and uses the card as the source of the effects
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
CastRandomSpellSpell()

Method Summary

Modifier and Type	Method	Description
static SpellDesc	create(int value)
protected void	onCast(GameContext context, Player player, SpellDesc desc, Entity source, Entity target)	Implementations of onCast are the meat-and-bones of a spell's effects.

Methods inherited from class net.demilich.metastone.game.spells.Spell

cast, castForPlayer, checkArguments, getDesc, isNativeStateful, setDesc, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

CastRandomSpellSpell

public CastRandomSpellSpell()

Method Details

create

public static SpellDesc create(int value)

onCast

protected void onCast(GameContext context,
 Player player,
 SpellDesc desc,
 Entity source,
 Entity target)

Description copied from class: Spell

Implementations of onCast are the meat-and-bones of a spell's effects. This should actually call a variety of methods in GameLogic, generate cards using SpellUtils.getCards(GameContext, Player, Entity, Entity, SpellDesc), interpret SpellArg keys in the desc, etc.

Observe that subclasses of Spell mostly just need to implement this function. Also, observe that instances of Spell are stateless: all the state is provided as arguments to this function.

Specified by:

onCast in class Spell

Parameters:

context - The game context

player - The casting player

desc - The collection of SpellArg keys and values that are interpreted by the implementation of this function to actually cause effects in a game

source - The entity from which this effect is happening (typically a card or a minion if it's a battlecry).

target - The particular target of this invocation of the spell. When a spell hits multiple targets, like an AoE damage effect, this method is called once for each target in the list of targets.

See Also:

• for an example of a complex spell implementation.