Difference between revisions of "Commodities.plist"

From Elite Wiki
m (information about primary role and scripting category added)
Line 1: Line 1:
Commodities.plist is a dictionary with an entry for each type of market. Three are defined initially, 'default' containing the default (natch) information for each of the [[commodities]] in the universe, 'rockhermit' which has the prices and quantities available at a [[rock hermit]] and 'none' which has prices and price variation set to zero.  
+
Commodities.plist is a dictionary with an entry for each type of market. Three are defined initially, 'default' containing the default (natch) information for each of the [[commodities]] in the universe, 'rockhermit' which has the prices and quantities available at a [[rock hermit]] and 'none' which has prices and price variation set to zero. If you create a commodities.plist for your own station, you have to put your station's '''primary role''' here.
 
   
 
   
 
Each market is an array of 17 commodities, each in itself an array of 10 items:  
 
Each market is an array of 17 commodities, each in itself an array of 10 items:  
Line 36: Line 36:
 
== For Example: ==
 
== For Example: ==
  
* '''[[Radioactives]]'''
+
* '''[[Commodities#Radioactives|Radioactives]]'''
 
* MARKET_BASE_PRICE = 65
 
* MARKET_BASE_PRICE = 65
 
* MARKET_ECO_ADJUST_PRICE = -3
 
* MARKET_ECO_ADJUST_PRICE = -3
Line 44: Line 44:
 
* MARKET_MASK_QUANTITY = 7
 
* MARKET_MASK_QUANTITY = 7
  
If MARKET_RND is 133 and the economy is 3 ([[Mainly Agricultural]]) then:
+
If MARKET_RND is 133 and the economy is 3 ([[Planetinfo.plist#Economy|Mainly Agricultural]]) then:
  
 
* price = (65 + (133 & 7)  + (3 * -3)) & 255 = (65 + 5 - 9) & 255 = '''61'''
 
* price = (65 + (133 & 7)  + (3 * -3)) & 255 = (65 + 5 - 9) & 255 = '''61'''
Line 51: Line 51:
 
61 * 0.4 = '''24.4 credits per ton, 16 tons available.'''
 
61 * 0.4 = '''24.4 credits per ton, 16 tons available.'''
  
Since (MARKET_RND & MARKET_MASK_PRICE) will always be a value between 0 and 7, this sets the minimum price per ton of [[Radioactives]] at a [[Poor Agricultural]] economy at 17.6 Cr. and the maximum price per ton at a [[Rich Industrial]] economy at 28.8 Cr.
+
Since (MARKET_RND & MARKET_MASK_PRICE) will always be a value between 0 and 7, this sets the minimum price per ton of [[Commodities#Radioactives|Radioactives]] at a [[Planetinfo.plist#Economy|Poor Agricultural]] economy at 17.6 Cr. and the maximum price per ton at a [[Planetinfo.plist#Economy|Rich Industrial]] economy at 28.8 Cr.
  
  
 
[[Category:Oolite]]
 
[[Category:Oolite]]
 +
[[Category:Oolite_scripting]]

Revision as of 11:56, 27 November 2008

Commodities.plist is a dictionary with an entry for each type of market. Three are defined initially, 'default' containing the default (natch) information for each of the commodities in the universe, 'rockhermit' which has the prices and quantities available at a rock hermit and 'none' which has prices and price variation set to zero. If you create a commodities.plist for your own station, you have to put your station's primary role here.

Each market is an array of 17 commodities, each in itself an array of 10 items:

  1. The name of the commodity
  2. Units available at a market (this is calculated at each marketplace)
  3. Price per unit at a market (this is calculated at each marketplace)
  4. The base price per unit MARKET_BASE_PRICE
  5. An adjustment to price based on the economy MARKET_ECO_ADJUST_PRICE
  6. An adjustment to units availble based on the economy MARKET_ECO_ADJUST_QUANTITY
  7. The base quantity available to a market MARKET_BASE_QUANTITY
  8. A 'mask' which defines how the price varies MARKET_MASK_PRICE
  9. A 'mask' which defines how the quantity varies MARKET_MASK_QUANTITY
  10. The unit of quantity (0 == tons, 1 == kilos, 2 == grams)

At each market prices and quantities are calculated from values 4..9 and a random value from 0-255 (MARKET_RND) according to a complex series of steps:


// calculate the local price
price = (MARKET_BASE_PRICE + (MARKET_RND & MARKET_MASK_PRICE) + (economy * MARKET_ECO_ADJUST_PRICE)) & 255

// calculate the local quantity available
quantity = (MARKET_BASE_QUANTITY + (MARKET_RND & MARKET_MASK_QUANTITY) - (economy * MARKET_ECO_ADJUST_QUANTITY)) & 255

// if the quantity gets too high it's zeroed
if (quantity > 127) quantity = 0

// limit the quantity to 0..63 units
quantity &= 63

// price in credits is the final price x 0.4
price *= 0.4


Thus if you wish the price of a commodity to be higher in good economies you set MARKET_ECO_ADJUST_PRICE to a high positive value. If you require the price to vary less randomly you set MARKET_MASK_PRICE to a low value (1 or 0). You can work out the rest I'm sure!

For Example:

  • Radioactives
  • MARKET_BASE_PRICE = 65
  • MARKET_ECO_ADJUST_PRICE = -3
  • MARKET_ECO_ADJUST_QUANTITY = -3
  • MARKET_BASE_QUANTITY = 2
  • MARKET_MASK_PRICE = 7
  • MARKET_MASK_QUANTITY = 7

If MARKET_RND is 133 and the economy is 3 (Mainly Agricultural) then:

  • price = (65 + (133 & 7) + (3 * -3)) & 255 = (65 + 5 - 9) & 255 = 61
  • quantity = (2 + (133 & 7) - (3 * -3)) & 255 = (2 + 5 + 9) & 255 = 16

61 * 0.4 = 24.4 credits per ton, 16 tons available.

Since (MARKET_RND & MARKET_MASK_PRICE) will always be a value between 0 and 7, this sets the minimum price per ton of Radioactives at a Poor Agricultural economy at 17.6 Cr. and the maximum price per ton at a Rich Industrial economy at 28.8 Cr.