An assignment of the form
RacesAllowed = 1 2 3 4 5
indicates that the current hull and special function should be associated and available to races 1 through 5.
Unlike Hull and Function, this is an action statement. That is, it makes a connection between a hull and a special function. You can think of it this way, Hull and Function assignments are like typing numbers in edit fields of a dialog box, a RacesAllowed assignment is like pressing the 'OK' button of the dialog box. The Hull and Function assignments set up the parameters, the RacesAllowed assignment makes the actual connection.
The right-hand-side of this assignment consists of a list of race numbers that may either allow or disallow a race from having access to the current special function on the current hull. Acceptable values for each race number term are:
| +N | allow access to race N, N is 1 through 12 |
| -N | disallow access to race N, N is 1 through 12 |
| + | allow access to all races |
| - | disallow access to all races |
| N | same as +N |
This list of race number terms is interpreted sequentially from left to right. Some examples:
| + -6 | Enable all races but disable race 6 |
| - +3 +5 | Disable all races but enable races 3 and 5 |
| +3 +5 | Allow to races 3 and 5 (note that PHost up to version 4.0h/3.4j would also automatically disallow it to everyone else) |
| 7 | Enable to race 7 |
| + - + - + | Enable all races, same effect as simply '+' |
Note that the RacesAllowed assignment uses the PlayerRace config option to determine which players are given access to a special function on a hull. For example, with the following config setting:
PlayerRace = 1,1,1,1,1,5,3,3,3,3,3
then the assignment
Hull = Merlin Function = Cloak RacesAllowed = +1
will allow a Merlin to cloak if it is owned by players 1 through 5, since these players are all playing race #1.
RacesAllowed assignments are cumulative and will extend previous associations between the current hull and current special function. For example:
Hull = Meteor Function = Cloak RacesAllowed = +3 RacesAllowed = +4
This will allow both races 3 and 4 to cloak their MBRs.
► Note: In PHost versions up to 3.4j/4.0h, only the last statement will take effect. In those versions, only race 4 would be able to cloak their MBRs.
