Conditions Guide

Conditions Guide

Area Visible

DESCRIPTION: Condition based on the “explored” status of an area.

EFFECTIVE: The first time (only) any part of the specified area is explored (viewed, removing the black map covering). This condition is true even if the area is completely covered by fog-of-war. This condition can never be reset (see notes).

SETTINGS:

Players – List of players to which the condition applies.
Required : Yes
Valid Values : One or more players, trigger player

XYL – A location on the map.
Required : Yes
Valid Values : Valid (X, Y, Level) coordinates

Radius – Radius distance in hexagons around the target location (where zero is the target hexagon only).
Required : No (default zero, or target hexagon only)
Valid Values : Positive number

NOTES:

  • If trail of darkness is fixed, it may allow resetting of this condition. Currently trail of darkness (which obscures map areas with the “unexplored” black cover) does not seem to work.

Day

DESCRIPTION: Day-range condition.

EFFECTIVE: On the specified day or during a day-range (see notes).

SETTINGS:

DayMin – First day of day-range
Required : Yes
Valid Values : Positive number

DayMax – Last day of day-range
Required : No
Valid Values : Number

NOTES:

  • If DayMax is less than DayMin, the condition will only be true on DayMin.

Diplomatic Relation

DESCRIPTION: Condition based on the diplomatic relations between two players.

EFFECTIVE: Every time the diplomatic relation between the two specified players matches any of the Relation settings.

SETTINGS:

PlayerA – One of the two players in the diplomatic relation.
Required : Yes
Valid Values : One player, trigger player

PlayerB – One of the two players in the diplomatic relation.
Required : Yes
Valid Values : One player, trigger player

Relations – The current diplomatic relation between the two players.
Required : Yes
Valid Values : Pre-defined diplomatic relations. Choose one or more from: drPeace, drWar, drAlliance, drUnknown.

NOTES:

  • PlayerA and PlayerB can not both be set to “trigger player.”

Flagged

DESCRIPTION: Condition based on the true/false status of an internal flag.

EFFECTIVE: Every time the flag represented by FlagID is “True,” but see notes.

SETTINGS:

FlagID – User-defined value for identifying flag variable.
Required : Yes
Valid Values : positive number

NOTES:

  • Do not confuse this event with flags on structures and cities. This is purely a programming tool for keeping track of things.
  • See “Control flag” event for more information.
  • The Flagged condition does not always work when the flag is changed (true to false, or false to true) by a Control Flag event. If the Control Flag event occurs before the event containing this condition, and if both events are triggered by the same trigger, then the event containing this condition is ignored. (For example, if both events are triggered by the same Enter Area occurrence). The event will be evaluated normally on the next occurrence of the trigger, as long as the flag is not again changed before the event is evaluated. The workaround for this is to be sure the flag is changed after any events based on it. See our article, How Triggers Work, for a detailed example.

Flagged

DESCRIPTION: Condition based on the true/false status of an internal flag.

EFFECTIVE: Every time the flag represented by FlagID is “True,” but see notes.

SETTINGS:

FlagID – User-defined value for identifying flag variable.
Required : Yes
Valid Values : positive number

NOTES:

  • Do not confuse this event with flags on structures and cities. This is purely a programming tool for keeping track of things.
  • See “Control flag” event for more information.
  • See article, How Shadow Magic v1.2+ Flags Work with Triggers.

Game Over

DESCRIPTION: Condition based on game being over for one player.

EFFECTIVE: On turn when game is over for the player.

SETTINGS:

Player – Any one player in the game.
Required : Yes
Valid Values : One player

NOTES:

  • This condition has not been fully tested.

Gold

DESCRIPTION: Condition based on the amount of gold that one or more players currently have.

EFFECTIVE: Every time any player listed has the specified amount of gold.

SETTINGS:

Players – List of players which must have this condition.
Required : Yes
Valid Values : One or more players, trigger player

GoldMin – Minimum amount of gold for condition to be true.
Required : Yes
Valid Values : Number

GoldMax – Maximum amount of gold for condition to be true.
Required : No (see notes)
Valid Values : Number

NOTES:

  • If GoldMax is less than GoldMin, then each player must have exactly GoldMin.

Item In Area

DESCRIPTION: Condition based on a specific item being in a specific area.

EFFECTIVE: Every time the item is in the specified area.

SETTINGS:

XYL – A location on the map.
Required : Yes
Valid Values : Valid (X, Y, Level) coordinates

Radius – Radius distance in hexagons around the target location (where zero is the target hexagon only).
Required : No (default zero, or target hexagon only)
Valid Values : Positive number

ItemID – ID number of an item.
Required : Yes
Valid Values : ID of any item in the items list

Item Owned

DESCRIPTION: Condition based on a specific item being “owned” by a player.

EFFECTIVE: Every time the item is currently being held by a hero or wizard of any one of the specified players.

SETTINGS:

Players – List of players which can have heroes or wizard holding the item.
Required : Yes
Valid Values : One or more players, trigger player

ItemID – ID number of an item.
Required : Yes
Valid Values : ID of any item in the items list

Mana

DESCRIPTION: Condition based on the amount of mana that one or more players currently have.

EFFECTIVE: Every time any player listed has the specified amount of mana.

SETTINGS:

Players – List of players which must have this condition.
Required : Yes
Valid Values : One or more players, trigger player

ManaMin – Minimum amount of mana for condition to be true.
Required : Yes
Valid Values : Number

ManaMax – Maximum amount of mana for condition to be true.
Required : No (see notes)
Valid Values : Number

NOTES:

  • If ManaMax is less than ManaMin, then each player must have exactly ManaMin.

Random

DESCRIPTION: A random roll against a percent chance.

EFFECTIVE: Every time the random roll is equal to or less than the value in Percentage.

SETTINGS:

Percentage – Value representing the percent chance of the condition being true.
Required : Yes
Valid Values : Number between (and including) 0 and 100.

Structure Owned

DESCRIPTION: Condition based on a specific structure having a player’s flag.

EFFECTIVE: Every time the structure is currently flagged (owned) by any one of the specified players.

SETTINGS:

Players – List of players which can own the structure for the condition to be true.
Required : Yes
Valid Values : One or more players, trigger player

StructureID – ID number of the structure.
Required : Yes
Valid Values : ID of any city, tower, node, or resource site on the map

Structure Razed

DESCRIPTION: Condition based on a specific structure being in a destroyed state.

EFFECTIVE: Every time the structure is currently destroyed (in a “razed” state).

SETTINGS:

StructureID – ID number of the structure.
Required : Yes
Valid Values : ID of any city, tower, node, or resource site on the map

Unit In Area

DESCRIPTION: Condition based on a specific unit being in a specific area.

EFFECTIVE: Every time the unit (or hero) is currently in the specified area.

SETTINGS:

XYL – A location on the map.
Required : Yes
Valid Values : Valid (X, Y, Level) coordinates

Radius – Radius distance in hexagons around the target location (where zero is the target hexagon only).
Required : No (default zero, or target hexagon only)
Valid Values : Positive number

UnitID – ID number of a unit.
Required : Yes
Valid Values : ID of any unit placed on the map or of a hero defined in the heroes list.

NOTES:

  • Unfortunately, there is no way to determine the ID of a unit unless it is placed on the map. Spawned units can not be IDed.
  • A hero can be specified even if it has not been placed on the map. The hero is not considered dead until after it has been killed (imagine that), and is not considered dead just because it has not spawned or been placed on the map.

Unit Killed

DESCRIPTION: Condition based on a specific unit being dead.

EFFECTIVE: Every time after the specified unit is killed.

SETTINGS:

UnitID – ID number of a unit.
Required : Yes
Valid Values : ID of any unit placed on the map or of a hero defined in the heroes list.

NOTES:

  • Unfortunately, there is no way to determine the ID of a unit unless it is placed on the map. Spawned units can not be IDed.
  • A hero can be specified even if it has not been placed on the map. The hero is not considered dead until after it has been killed (imagine that), and is not considered “dead” just because it has not spawned or been placed on the map.

BACK TO SCENARIO DESIGN MAIN MENU