Difference between revisions of "Shipyard.plist"

From Elite Wiki
(chance: Corrected information.)
m (added category Oolite scripting)
Line 91: Line 91:
  
  
 
+
--------------------------------------------------------------------------------
 
[[Category:Oolite]]
 
[[Category:Oolite]]
 +
[[Category:Oolite scripting]]

Revision as of 09:42, 1 November 2008

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


chance

Affects the likelihood of the ship appearing in the shipyard, and also the likelihood of extra equipment being fitted. The difference between the local tech level and the ship’s tech level also factor into this.

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>