[Script System][Suggestions] IsPlayerActive(player) and more

Currently, there is no way to check/change certain properties of a player.

*

IsPlayerActive(player)

Returns "true" if the specified player is still present in the game, returns "false" otherwise.

SetPlayerActive(player)

Makes a player return/join in the game.
You can give him one hero, one town, etc.
Or make he have only one hero, but it can stay longer than 7 days on the map before losing.

IsPlayerControlledByAI(player)

Returns "true" if the specified player is controlled by an AI player, returns "false" otherwise.

YouLose(player)

The player loses the scenario.

YouWin(player)

The player wins the scenario.

MakeAlliance(p1, p2)

Makes an alliance between the player number "p1" and the player number "p2".

BreakAlliance(p1, p2)

Breaks an alliance between the player number "p1" and the player number "p2".

Hello,

Could you provide some examples in which these may be used? I'm not really sure how a mapmaker would want to use the scenario outcome commands or check if a player is controlled by an AI. Since scripts are intended to be map-specific, I'm having trouble seeing how such things would be necessary, due to the behavioral consistencies of these properties in a single map.

Thank You,
XT3RM1N8R

IsPlayerActive(player)

One of the scenario goals is to protect another player. If this player is eliminated from the game, the player in charge of his protection receives a penalty.

*

SetPlayerActive(player)

If one of the scenario objectives is accomplished. A new player joins the game (or an eliminated player go back in the game).

*

IsPlayerControlledByAI(player)

A scenario offers the possibility of choosing between several players (colors) for the human player, and this scenario can also be played by several human players; or a human player chooses to play several players at the same time; or the scenario is created so that the human player must choose to play several players at the same time.

This scenario gives different bonuses for players (colors) depending on whether they are controlled by a human player or by the AI.

*

YouLose(player)

One of the goals of a scenario is to always control at least five sulfur mines. If this goal is not met, the player loses the game.

*

YouWin(player)

One of the goals of a scenario is to have a military power at least ten times greater than one of the other players. If this goal is reached, the player wins the game.

*

MakeAlliance(p1, p2)

One of the objectives of a scenario is to control at least three towns of the same faction. If this goal is reached, another player gets in alliance with that player.

*

BreakAlliance(p1, p2)

If one of the scenario objectives is no longer effective, the alliance between the two players is broken.