Syntax: allies add|drop <player...>
Syntax: allies config <player> <flags...>
Enabled by: CPEnableAllies
Files modified: auxdata.hst
Since: PHost 1.0 (conditional privileges: 2.0)
The three sub-commands of the allies command are used to set up formal alliances.
- The add sub-command offers an alliance to the specified players, or acknowledges a pending offer. An alliance is active when both players have used add to declare each other as friends. The parameter list contains the player numbers, 1 for Feds to 11 (not B!) for Colonies.
- The drop sub-command cancels an alliance resp. withdraws an offer. Like add, it takes a list of player numbers as parameters.
- The config sub-command sets the privileges of an ally. The first parameter is the race, the following are alliance levels. The alliance must have been established completely for this command to take effect, but you can send it in the same turn you offer your alliance initially.
As usual, the privilege codes can be abbreviated up to their first letter.Parameter Action +priv Offer privilege unconditionally ~priv Offer privilege conditionally -priv Withdraw privilege +/-ships Offer/withdraw ship level +/-planets Offer/withdraw planet level +/-mines Offer/withdraw mine level +/-combat Offer/withdraw combat level +/-vision Offer/withdraw vision level
Examples:
| allies add 8 | offer alliance to player 8, or accept alliance offered by player 8 |
| a a 8 | same |
| allies config 8 +mines +vision | offer mine and vision level to player 8 |
| allies config 8 ~com | offer combat level conditionally, that is, player 8 can only use it when he offers it, too |
| a c 8 ~c | same |
| a d 1 | drop alliance with player 1 |
For details about alliance mechanics, see the page about alliances.
Conflict Resolution: Commands are executed in order received, therefore the last one takes effect.
Relevant Configuration Options: CPEnableAllies, DelayAllianceCommands.
Relevant PControl Stages: depending on DelayAllianceCommands, all alliance commands are performed just before Auxhost1 or just after Auxhost2.
See also: enemies command
