Shipyard.plist
shipyard.plist provides Oolite with the information necessary to equip a player-purchaseable ship.
chance
The likelihood that the ship comes fitted with potential extra fittings and equipment.
'Example:
<key>chance</key> <real>0.25</real>
optional_equipment
This section lists equipment that the ship can be fitted with. Note that Oolite will offer variants of basic ship models with a selection of the optional equipment added, and the cost increased accordingly. Do not list equipment in both this section and the standard_equipment section, or you will be ripping your customers off.
Example:
<key>optional_equipment</key> <array> <string>EQ_ECM</string> <string>EQ_FUEL_SCOOPS</string> <string>EQ_ESCAPE_POD</string> </array>
Note: Some equipment is universally available. For example all ships can buy fuel and equip a galactic hyperdrive. Refer to equipment.plist for specifics.
price
How much the ship costs to purchase. Be sure to consider standard_equipment when you determine ship price.
Example:
<key>price</key> <integer>65000</integer>
standard_equipment
Equipment that comes fitted as standard with your ship. Any extras included in this section are free, and should not appear in the optional_equipment section, or the station sales screen may offer a model of the ship with equipment it already has. Be sure to factor in the cost of equipment that comes as standard when pricing your ships.
Example: All models of this ship come with a heat shield, pulse laser and a single missile.
<key>standard_equipment</key> <dict> <key>extras</key> <array> <string>EQ_HEAT_SHIELD</string> </array> <key>forward_weapon_type</key> <string>EQ_WEAPON_PULSE_LASER</string> <key>missiles</key> <integer>1</integer> </dict>
Example: All models of this ship come with a military laser, but nothing else as standard. If you have equipment listed as optional, the system may offer a tricked-out variant at a greater cost.
<key>standard_equipment</key> <dict> <key>extras</key> <array/> <key>forward_weapon_type</key> <string>EQ_WEAPON_MILITARY_LASER</string> <key>missiles</key> <integer>0</integer> </dict>
techlevel
Minimum tech level (TL) of a system for the ship to be on sale.
Example:
<key>techlevel</key> <integer>4</integer>
weapon_facings
What weapon mounts are available on the ship. This is a bit-mask, so pick the mounts and add the numbers:
1 - Forward
2 - Aft
4 - Port
8 - Starboard
Example: Fore and aft weapon mounts only.
<key>weapon_facings</key> <integer>3</integer>
Example: All weapon mounts.
<key>weapon_facings</key> <integer>15</integer>
Note: does something bad happen if the shipdata weapon positions and the weapon_facings don't match?