Shipyard.plist

From Elite Wiki
Revision as of 22:12, 25 April 2006 by Iskander (talk | contribs) (Corrected a misapprehension.)

shipyard.plist provides Oolite with the information necessary to equip a player-purchaseable ship.


chance

The likelihood that the ship is available for purchase at a station. (See also techlevel.)

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 of a system for the ship to be on sale. (See also chance.)

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?