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:

+Nallow access to race N, N is 1 through 12
-Ndisallow access to race N, N is 1 through 12
+allow access to all races
-disallow access to all races
Nsame as +N

This list of race number terms is interpreted sequentially from left to right. Some examples:

+ -6Enable all races but disable race 6
- +3 +5Disable all races but enable races 3 and 5
+3 +5Allow to races 3 and 5 (note that PHost up to version 4.0h/3.4j would also automatically disallow it to everyone else)
7Enable 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.

This is a testing version.
It may be incomplete, and have more bugs (or features) than the public live version at planetscentral.com.