SCRIPTING
The map editor's scripting system allows you to write events that will improve game play for the selected map. With scripted events, you can set special victory and loss conditions, change the ownership of adventure objects, give or take resources from the player, display story text, and much more. Below are some short definitions for the various actions and conditions available in the scripting system, as well as a 'how-to' section giving several examples of how to script an event.

Event Types
Timed Event: Allows you to create events that activate on certain days.
Triggerable Event: Allows you to create events that are activated by other scripted events.
Continuous Event: Allows you to create events that are activated by some game action or event (such as taking a town, solving a quest, etc.).
Placed Event: Allows you to create events that are activated when a player's army moves over an 'Event' adventure object placed on a certain spot on the map.
ограни
Event Scripts
Construct Building: Builds a structure in this town.

Change Owner: Changes the owner of this object to another designated player.

Clear Loss Condition Text: Erases the text displayed in the Loss Condition section of the Scenario Information.

Clear Loss Message: Erases the text displayed to the player when they lose the game.
Clear Victory Condition Text: Erases the text displayed in the Victory Condition section of the Scenario Information.

Clear Victory Message: Erases the text displayed to the player when they win the game.

Combat: Creates an army who enters into combat with a designated player army.

Conditional Statement: Creates a conditional script. An example of a conditional statement would be, "If the player owns this town, then give the player 10,000 gold."

Decrease Current Spell Points: Reduces a designated hero's current spell points by a certain amount.

Decrease Damage: Reduces a designated hero's damage statistic by a certain amount.

Decrease Luck: Reduces a designated army's luck by a certain amount.

Decrease Maximum Hit Points: Reduces a designated hero's hit points by a certain amount.

Decrease Maximum Spell Points: Reduces a designated hero's total spell points by a certain amount.

Decrease Morale: Reduces a designated army's morale by a certain amount.

Decrease Dwelling Population: Reduces the current population of a designated creature dwelling by a certain amount.

Decrease Speed: Reduces a designated hero's speed statistic by a certain amount.

Delete Adventure Object: Removes a certain adventure object from the map. The 'Bomb' marker adventure object indicates which object will be removed.

Disable Standard Victory Condition: Turns off the normal victory condition for a certain player.

Display Text: Reveals a piece of text to the player.

Enable Standard Victory Condition: Allows a certain player to fulfill the normal victory condition and win.

Give Artifacts: Gives a certain artifact or artifacts to an indicated army.

Give Creatures: Gives a certain number of a creature type to an indicated army.

Give Materials: Gives a quantity of resources to a certain player.

Give Skill: Gives a skill of your choice to an indicated hero.

Give Spell: Gives a certain spell to an indicated hero.

Increase Current Movement: Increases the current movement points of an indicated army.

Increase Current Spell Points: Increases the current spell points of an indicated hero.

Increase Damage: Increases the damage statistic of an indicated hero.

Increase Experience: Increases the experience of an indicated hero by a certain amount.

Increase Experience Level: Increases the level of an indicated hero.

Increase Luck: Increases the luck of an indicated army.

Increase Maximum Hit Points: Increases the maximum hit points of an indicated hero.

Increase Maximum Spell Points: Increases the maximum spell points of an indicated hero.

Increase Morale: Increases the morale of an indicated army.

Increase Dwelling Population: Increases the number of creatures in an indicated creature dwelling.

Increase Skill: Increases the level of an existing skill for an indicated hero.

Increase Speed: Increases the speed statistic for an indicated hero.

Do Nothing: Causes no action to take place.

Lose: Causes a certain player to lose the game.

Ask Question: Allows you to ask a yes/no question and attach scripts to each answer.

Remove Script: Removes the indicated scripted event.

Remove This Object: Allows you to remove an object from the Adventure Map.

Sequence: Allows you to create a list of related scripts that will activate in order.

Set Boolean Variable: Allows you to set up a true/false variable.

Set Loss Condition Text: Allows you to enter the text for the Loss Condition for a map.

Set Loss Message: Allows you to enter the Loss Condition message that will be displayed to the player.

Set Numeric Variable: Allows you to create a variable that can keep track of, or count, a certain action (like when an army passes a specific point).

Set Victory Condition Text: Allows you to enter the text for the Victory Condition for a map.

Set Victory Message: Allows you to enter the Victory Condition message that will be displayed to the player.

Take Artifacts: Removes a specific artifact or artifacts from an army.

Take Creatures: Removes a specific number of a creature type from an army.

Take Materials: Removes a specific amount of a resource or resources from a player.

Trigger Custom Event: Allows you to activate a previously created event.

Win: Causes a certain player to win the game.


Boolean exp​ression (Condition) Types

And: Allows you to create multiple conditions for a single event.

Has Alignment: Checks if a certain army is of a specific alignment.

Has Certain Hero: Checks if a specific hero is part of a certain army.

Can Give Skill: Checks to see if the hero(es) in an army can accept a certain skill into their skill slots.

Equals: Checks if two exp​ressions are equal to each other.

False: Checks if a condition is false.

Greater Than: Checks if one exp​ression is greater than another.

Greater Than or Equals: Checks if one exp​ression is greater than or equal to another.

Has Artifact: Checks if an army possesses a certain artifact.

Certain Hero is Dead: Checks if a specific named hero is dead.

Certain Hero is in Prison: Checks if a specific named hero is imprisoned.

Less Than: Checks if an exp​ression is less than another.

Less Than or Equals: Checks if an exp​ression is less than or equal to another.

Not: Allows you to negate a specific variable so you can check on all conditions but a specific one.

Or: Allows you to create an optional condition where one of two things can be true but not both.

Player is Certain Alignment: Checks if a certain player is of a specific alignment.

Player is Certain Color: Checks if the current player is a certain color.

Player is Computer: Checks if a certain player is a computer player.

Player is Eliminated: Checks if a certain player has been defeated completely.

Player is Human: Checks if a certain player is a human player.

Player Owns Certain Hero: Checks if a certain player possesses a specific named hero.

Player Owns Certain Town: Checks if a certain player possesses a specific named town.

True: Checks if a condition is true.

Variable: Allows you to set the name of a variable.

Numeric exp​ression Types

Number of Creatures in Army: Indicates the amount of a specific creature type in an army.

Current Day: Indicates a current day counting from the day the game began.

Current Day of Week: Indicates the current day of the week counting from the first day and ending on day seven.

Divided By: Allows you to divide one exp​ression by another.

Experience Level: Indicates the level of a certain hero(es) in an army.

Skill Mastery: Indicates a hero's level of mastery of a specific skill in an army.

Number: Indicates a specific number.

Material Quantity: Indicates an amount of a specific resource.

Minus: Allows you to subtract one exp​ression from another.

Month: Indicates the current month counting from the first month of the game.

Negate: Allows you to make an exp​ression negative.

Player ID: Indicates a specific player.

Plus: Allows you to add one exp​ression to another.

Random Number: Generates a random number and allows you to set the minimum and maximum range.

Remainder: Indicates that number that is left over after dividing one exp​ression by another.

Times: Allows you to multiply one exp​ression by another.

Total Number of Creatures in Army: Indicates only the total number of creatures in a specific army, including all creature types.

Total Number of Heroes in Army: Indicates only the total number of heroes in a specific army.

Variable: Allows you to set the name of a variable.

Week: Indicates the current week counting from the first week of the game.

Week of Month: Indicates the current week counting from the first week of the current month.