[Script System][Suggestions] ToggleHeroAIArmySharing(hero, toggle) and more

Tested with Ironfist version 1.2.1+ (version of December 15, 2016).

*

ToggleAIArmySharing(toggle)
toggle: can be set to "0" or "1".
- "0" does not allow all the AI heroes (computer player) to share their troops.
- "1" allows all the AI heroes (computer player) to share their troops.

Enables or disables AI (computer player) army sharing.

*

When "ToggleAIArmySharing" is used, all heroes of all AI players can no longer share their troops.

*

Suggestions:

"ToggleHeroAIArmySharing" additional version:

ToggleHeroAIArmySharing(hero, toggle)
hero: the hero you wish to select.
toggle: can be set to "0" or "1".
- "0" does not allow the specified AI hero (computer player) to give or receive troops.
- "1" allows the specified AI hero (computer player) to give or receive troops.

Enables or disables AI (computer player) army sharing for the specified hero only.

***** Updated on March 11, 2017 *****

"TogglePlayerAIArmySharing" additional version:

TogglePlayerAIArmySharing(player, toggle)
player: the player you wish to select.
toggle: can be set to "0" or "1".
- "0" does not allow the specified AI player (computer player) to exchange troops beetween heroes.
- "1" allows the specified AI player (computer player) to exchange troops beetween heroes.

Enables or disables AI (computer player) army sharing for the specified player only.

What is the intended use case?

Let's say I make a scenario with one human player and three AI players.

At the beginning of the scenario, AI player heroes can exchange their troops normally.

The human player is offered a strategic objective. He may choose to accomplish it or not.
If the objective is not achevied, all heroes of one of the AI players receive additional troops, but they must not be able to exchange troops between them.
Here, "TogglePlayerAIArmySharing (player, toggle)" is used.

After a certain time, all the heroes of this same AI player again see their armies reorganized, and they can again exchange the troops between them normally.
Here, "TogglePlayerAIArmySharing (player, toggle)" is used again.

At the same time, one of the heroes of another AI player is given a fairly substantial army, and he alone must not be able to exchange the troops of his army.
In this case, "ToggleHeroAIArmySharing (hero, toggle)" is used.