Difference between revisions of "Shipyard.plist"

From Elite Wiki
m (Corrected a misapprehension.)
m (think)
Line 3: Line 3:
   
 
== chance ==
  
== chance ==
−
The likelihood that the ship is available for purchase at a station. (See also [[Shipyard.plist#techlevel|techlevel]].)
 +
The likelihood that the ship comes fitted with potential extra fittings and equipment.
   
−
'''Example:'''
 +
'Example:
 
<key>chance</key>
  
<key>chance</key>
 
<real>0.25</real>
  
<real>0.25</real>
  +
   
 
== optional_equipment ==
  
== 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 [[Shipyard.plist#standard_equipment|standard_equipment]] section, or you will be ripping your customers off.
  
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 [[Shipyard.plist#standard_equipment|standard_equipment]] section, or you will be ripping your customers off.
   
−
'''Example: '''
 +
Example:
 
<key>optional_equipment</key>
  
<key>optional_equipment</key>
 
<array>
  
<array>
Line 20: Line 21:
 
</array>
  
</array>
   
−
'''Note:''' Some equipment is universally available. For example all ships can buy fuel and equip a [[Galactic Hyperdrive|galactic hyperdrive]]. Refer to ''equipment.plist'' for specifics.
 +
'''Note:''' Some equipment is universally available. For example all ships can buy fuel and equip a [[Galactic Hyperdrive|galactic hyperdrive]]. Refer to [[equipment.plist]] for specifics.
  +
   
 
== price ==
  
== price ==
 
How much the ship costs to purchase. Be sure to consider [[Shipyard.plist#standard_equipment|standard_equipment]] when you determine ship price.
  
How much the ship costs to purchase. Be sure to consider [[Shipyard.plist#standard_equipment|standard_equipment]] when you determine ship price.
   
−
'''Example:'''
 +
Example:
 
<key>price</key>
  
<key>price</key>
 
<integer>65000</integer>
  
<integer>65000</integer>
  +
   
 
== standard_equipment ==
  
== 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 [[Shipyard.plist#optional_equipment|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.
  
Equipment that comes fitted as standard with your ship. Any extras included in this section are ''free'', and should not appear in the [[Shipyard.plist#optional_equipment|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.''
 +
Example: All models of this ship come with a heat shield, pulse laser and a single missile.
  +
 
<key>standard_equipment</key>
  
<key>standard_equipment</key>
 
<dict>
  
<dict>
Line 45: Line 47:
 
</dict>
  
</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.''
 +
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>
  
<key>standard_equipment</key>
 
<dict>
  
<dict>
Line 55: Line 57:
 
<integer>0</integer>
  
<integer>0</integer>
 
</dict>
  
</dict>
  +
   
 
== techlevel ==
  
== techlevel ==
−
Minimum tech. level of a system for the ship to be on sale. (See also [[Shipyard.plist#chance|chance]].)
 +
Minimum tech level (TL) of a system for the ship to be on sale.
   
−
'''Example:'''
 +
Example:
 
<key>techlevel</key>
  
<key>techlevel</key>
 
<integer>4</integer>
  
<integer>4</integer>
  +
   
 
== weapon_facings ==
  
== weapon_facings ==
 
What weapon mounts are available on the ship. This is a bit-mask, so pick the mounts and add the numbers:
  
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.''
  
  +
1 - Forward<br />
  +
2 - Aft<br />
  +
4 - Port<br />
  +
8 - Starboard<br />
  +
  +
Example: Fore and aft weapon mounts only.
 
<key>weapon_facings</key>
  
<key>weapon_facings</key>
 
<integer>3</integer>
  
<integer>3</integer>
   
−
'''Example:''' all weapon mounts.''
 +
Example: All weapon mounts.
 
<key>weapon_facings</key>
  
<key>weapon_facings</key>
 
<integer>15</integer>
  
<integer>15</integer>

Revision as of 10:52, 2 July 2006

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?

Retrieved from "http://backup.witchspacewiki.org/index.php?title=Shipyard.plist&oldid=4290"