51 | | A new feature that is currently in development (ticket:198). Equipment slots represent the additional limited "special equipment" slots that a unit has, such as heavy weapons in Warhammer 40,000. These slots define limited groups of equipment at a finer level of granularity than mutex groups and can be combined with mutex groups for even more powerful combinations/restrictions. |
| 51 | A new feature that was released in v0.1b4. Equipment slots represent the additional limited "special equipment" slots that a unit has, such as heavy weapons in Warhammer 40,000 (e.g. "may have up to three heavy guns, assault guns or flamers, or any combination thereof"). These slots define limited groups of equipment at a finer level of granularity than mutex groups and can be combined with mutex groups for even more powerful combinations/restrictions. Equipment slots can also be used with standard equipment limits for more detailed combinations (e.g. the slot may allow up to five items, but if there are three types of equipment in that slot with an item limit of three then the unit can take up to three of one item and two of another, or three of one item and one each of the other two, two of two items and one of the third, or any other combination that doesn't exceed three for each item and five in total). |
53 | | The {{{<equipmentSlots>}}} tag is a container for {{{<equipmentSlot>}}} tags. equipmentSlot tags currently define a name, limit number and limit type. The type is either an absolute number (e.g. "3") or the numerical part of a percentage (e.g. "50" for 50% with {{{isPercentage="true"}}}). If {{{isPercentage}}} isn't defined then an absolute number is assumed. |
| 53 | The {{{<equipmentSlots>}}} tag is a container for {{{<equipmentSlot>}}} tags. equipmentSlot tags contain a {{{<maxLimit>}}} tag, which just acts as a container for one of the specific limit tags. |
| 54 | |
| 55 | ===== Limits ===== |
| 56 | |
| 57 | Equipment slots can currently have one of four limit types, some of which are more useful than others for equipment slots. Note that as these limits are centrally defined then an extra namespace is required and all limits must be prefixed with the namespace (see the example files). |
| 58 | |
| 59 | * {{{<percentageLimit>}}} defines percentage limit and a rounding direction (up or down) relative to the size of a unit |
| 60 | * {{{<sizeConstrainedLimit>}}} defines an upper limit that is also constrained by the unit size (i.e. if a unit has a unit size of 5 to 20 and can take ten of a weapon but no more than one weapon per trooper then the sizeConstrainedLimit will be the smaller of the unit size or the 10, the equipment limit) |
| 61 | * {{{<absoluteLimit>}}} defines a fixed numeric limit that isn't constrained by the unit size (i.e. in the example above a unit of 5 troopers would still be able to take 10 of the item) |
| 62 | * {{{<unitSizeLimit>}}} a shortcut for "all of the unit" (i.e. a 100% percentage limit) |
64 | 71 | * {{{roundDirection}}} - defines whether to round the number of items taken up or down if a min/maxPercentage limit for a unit doesn't reach a whole number (which is likely to be a common occurrence). Used in situations such as Lord of the Rings where "up to one third of the unit, rounding up, can take bows". |
65 | 72 | * {{{costMultiplier}}} - the multiplier of the base price for the equipment item. Useful to allow units to get equipment (e.g. swords) for free but charge champions the full price, or where a unit type (e.g. goblins) get the equipment for half-price. |
66 | 73 | * {{{costRounding}}} - how to round any fractions of prices for the total cost of the equipment (especially when multipliers are in place). Can be up, down, [http://en.wikipedia.org/wiki/Rounding#Round_half_to_even Banker's rounding] (rounding to the closest whole with a bias towards the even number for halves), up to a half, down to a half, or 'Banker's half rounding' (rounding to the closest half with a bias towards the whole for quarter values) |