Trade-goods.plist - Revision history

Wildeblood: /* name */

2025-06-08T09:26:53Z

‎name

Phkb: Updating BB links

2024-02-29T03:37:23Z

Updating BB links

Cholmondely: /* market_script */ Added note

2024-01-15T22:41:18Z

‎market_script: Added note

Cholmondely: /* Preamble */ Added a little more to (hopefully) clarify matters

2023-12-13T18:23:09Z

‎Preamble: Added a little more to (hopefully) clarify matters

Cholmondely: /* Secondary Market Definitions */ Added explanatory notes.

2023-12-13T18:15:50Z

‎Secondary Market Definitions: Added explanatory notes.

Cholmondely: Added Switeck's clarification

2023-06-25T08:39:46Z

Added Switeck's clarification

Cholmondely: Added general preamble (hopefully accurate!); added Cim's pm on invariant markets, and another example of a Trade-goods.plist

2023-06-22T18:03:02Z

Added general preamble (hopefully accurate!); added Cim's pm on invariant markets, and another example of a Trade-goods.plist

Show changes

Cholmondely: /* Links */ Added another and a useful quote from cim

2022-11-10T19:34:34Z

‎Links: Added another and a useful quote from cim

Massively Locked: /* short_comment */ fixed link

2022-10-27T04:22:52Z

‎short_comment: fixed link

Cholmondely: /* Setting an orbital main station's slaves on sale to zero */ Tweaks

2022-05-09T07:10:23Z

‎Setting an orbital main station's slaves on sale to zero: Tweaks

@@ Line 87: / Line 87: @@
 === name ===
-A string containing the name of the trade good. This may contain []s for [[descriptions.plist]] expansion.
+A string containing the name of the trade good. This may contain [keys]s for [[descriptions.plist]] expansion.
 === peak_export ===

@@ Line 84: / Line 84: @@
 The name of a Javascript file to use as a [[Oolite Market Scripts|market script]] for this trade good when calculating main station quantities and prices.
-'''Note:''' [http://www.aegidian.org/bb/viewtopic.php?p=235837#p235837 What's the difference between the market script specified in planetinfo.plist and the one called for by trade-goods.plist?] (2015)
+'''Note:''' [https://bb.oolite.space/viewtopic.php?p=235837#p235837 What's the difference between the market script specified in planetinfo.plist and the one called for by trade-goods.plist?] (2015)
 === name ===
@@ Line 174: / Line 174: @@
 === Links ===
-*[http://www.aegidian.org/bb/viewtopic.php?f=2&t=21512 Secondary Market Definitions Defined] (2023)
+*[https://bb.oolite.space/viewtopic.php?f=2&t=21512 Secondary Market Definitions Defined] (2023)
 == Examples ==
@@ Line 488: / Line 488: @@
 == Links ==
 *[[Oolite JavaScript Reference: Market Scripts]]
-*[[Commodities.plist]] - the precursor (which still mostly works!). If it doesn't see [http://www.aegidian.org/bb/viewtopic.php?p=246145#p246145 here] (2015)
+*[[Commodities.plist]] - the precursor (which still mostly works!). If it doesn't see [https://bb.oolite.space/viewtopic.php?p=246145#p246145 here] (2015)
-*[http://aegidian.org/bb/viewtopic.php?f=2&t=16828 Proposal for 1.82: support for economic changes] ([[User:Cim|Cim]], 2014)
+*[https://bb.oolite.space/viewtopic.php?f=2&t=16828 Proposal for 1.82: support for economic changes] ([[User:Cim|Cim]], 2014)
-*[http://aegidian.org/bb/viewtopic.php?f=2&t=16735 Cim on introducing the Trade-goods.plist and deprecating the commodities.plist] (2014)
+*[https://bb.oolite.space/viewtopic.php?f=2&t=16735 Cim on introducing the Trade-goods.plist and deprecating the commodities.plist] (2014)
 {{QuoteText|Text=Trade goods work is coming along fairly well. As well as plist-coded prices for trade goods, which should handle the simple cases (including a few things not possible with commodities.plist), you can now specify a "market script" which allows you to set prices per trade-good, per station, or per system. If you try to do all three, the following happens: <br>
 ) The per-trade good script sets a standard price and quantity for the system's economy and any other data it considers <br>
@@ Line 497: / Line 497: @@
 ) The per-trade good script runs again in "secondary station" mode, to modify the price and quantity again <br>
 ) The per-station script runs to make final adjustments to price and quantity <br>
-Generally one OXP wouldn't do all three, though.|Source=([http://aegidian.org/bb/viewtopic.php?p=226722#p226722 Cim in Progress Thread (2014)])}}
+Generally one OXP wouldn't do all three, though.|Source=([https://bb.oolite.space/viewtopic.php?p=226722#p226722 Cim in Progress Thread (2014)])}}
 === Using the Trade-goods.plist ===
-*[http://www.aegidian.org/bb/viewtopic.php?f=4&t=20576 How to get the displayName for a commodity in the Main Station Market?] (2020)
+*[https://bb.oolite.space/viewtopic.php?f=4&t=20576 How to get the displayName for a commodity in the Main Station Market?] (2020)
-*[http://www.aegidian.org/bb/viewtopic.php?f=6&t=17269 Thinking about Planet Income classification] (2015)
+*[https://bb.oolite.space/viewtopic.php?f=6&t=17269 Thinking about Planet Income classification] (2015)
 {{QuoteText|Text=
 In 1.81 this is a lot easier to OXP - you can introduce as many economies as you like, though you are limited to eight economy symbols (so if you wanted lots of economy types, you might end up with Poor Industrial, Avg Industrial and Rich Industrial sharing a symbol on the map). The trade good pricing scripts can then be used to set up different price categories in different economies (and introduce additional trade goods, or split an existing good into multiple categories, which may be necessary if you're adding more economies).
-Resetting economies across the planets is a big change in terms of lines of code, but is also very easy to automate. If OXPers are looking for a scripting tool to use for this sort of automation, then NodeJS or io.js is free and also uses Javascript as its language, so you don't need to learn a new one - and may even be able to share code between your build scripts and your OXP, though I haven't tried that yet.|Source=([http://aegidian.org/bb/viewtopic.php?f=6&t=17269 Cim in Planet Income thread (2015)])}}
+Resetting economies across the planets is a big change in terms of lines of code, but is also very easy to automate. If OXPers are looking for a scripting tool to use for this sort of automation, then NodeJS or io.js is free and also uses Javascript as its language, so you don't need to learn a new one - and may even be able to share code between your build scripts and your OXP, though I haven't tried that yet.|Source=([https://bb.oolite.space/viewtopic.php?f=6&t=17269 Cim in Planet Income thread (2015)])}}
 [[Category:Oolite]]
 [[Category:Oolite scripting]]

@@ Line 83: / Line 83: @@
 === market_script ===
 The name of a Javascript file to use as a [[Oolite Market Scripts|market script]] for this trade good when calculating main station quantities and prices.
 === name ===

@@ Line 2: / Line 2: @@
 == Preamble ==
-This defines commodities in the game.
+This merely re-defines the trade commodities in the game (''eg'' introducing new ones, or changing elements of the vanilla game ones). See [[SW Economy]] for an example of what can be done.
-To tweak the pricing/availability of commodities in (eg.) a station, you need to define the market inside the station's [[Shipdata.plist]] - or include a "hook" inside that shipdata.plist to a javascript [[Oolite_Market_Scripts|Oolite Market Script]] (which allows more complex definitions).
+The trade-goods.plist file replaces and extends the old [[commodities.plist]] and [[illegal_goods.plist]] files from Oolite 1.81 onwards to allow greater flexibility in trade good definitions, including defining entirely new goods. But it does not remove slaves from a particular station or make them cost twice as much as they do at the main orbital station.
-The trade-goods.plist file replaces and extends the old [[commodities.plist]] and [[illegal_goods.plist]] files from Oolite 1.81 onwards to allow greater flexibility in trade good definitions, including defining entirely new goods.
+To do other things, ''eg''. to tweak the pricing/availability of commodities in a particular station, you need to define the market inside that station's [[Shipdata.plist]] - or include a "hook" inside that shipdata.plist to a javascript [[Oolite_Market_Scripts|Oolite Market Script]] (which allows more complex definitions).
 == Overview ==

@@ Line 129: / Line 129: @@
 == Secondary Market Definitions ==
 Secondary market definitions are entered in the [[shipdata.plist#market_definition|market_definition]] key in shipdata.plist, which is an array of dictionaries, each defining rules which modify the prices and quantities from the main station market, and possibly adjust the market capacity and legality of the good. The following modifications are applied for each trade good, assuming no market_script is defined:
@@ Line 168: / Line 170: @@
   secondary_quantity = (adjusted_quantity + quantity_adder) * (quantity_multiplier + (quantity_randomiser * rnd)))
 As an exception, if quantity_adder and quantity_multiplier are both <= 0, then the result is always 0 regardless of quantity_random.
 == Examples ==

@@ Line 332: / Line 332: @@
 If you just use a market_definition in shipdata.plist for the station, then you're merely setting variations on the primary system market.
-If you want the station prices to be independent of (or more loosely tied to) the system it's in, then you need to use a [[Oolite_Market_Scripts|market script].
+If you want the station prices to be independent of (or more loosely tied to) the system it's in, then you need to use a [[Oolite_Market_Scripts|market script]].
@@ Line 427: / Line 427: @@
 So you can see this one has a mix of using, mutating and overruling the definitions set by the system market and OXP commodity definitions ... with this method you could have a whole bunch of OXPs setting up themed stations, and a whole different bunch adding their own custom commodities, and they'd barely have to know about each other to ensure reasonable consistency and compatibility from someone installing any combination of them. (- by [[User:Cim|Cim]], 2023)
 == Using the new Trade-goods.plist ==

@@ Line 112: / Line 112: @@
 === short_comment ===
-A string that will be displayed on the F8 commodity list screen in the optional extra column. This can be modified later by [[Oolite_JavaScript_Reference:_Manifest#setComment|manifest.setShortComment()]]. As the meaning of this value will depend on the OXPs installed, it is unlikely to be useful to specify an initial value in the plist.
+A string that will be displayed on the F8 commodity list screen in the optional extra column. This can be modified later by [[Oolite_JavaScript_Reference:_Manifest#setShortComment|manifest.setShortComment()]]. As the meaning of this value will depend on the OXPs installed, it is unlikely to be useful to specify an initial value in the plist.
 === sort_order ===

@@ Line 274: / Line 274: @@
 === Setting an orbital main station's slaves on sale to zero ===
-[[User:Phkb|Phkb]] provided this example which requires a planet.info plist & a .js file - there are other ways to achieve the same result
+[[User:Phkb|Phkb]] provided this example which requires a ''planetinfo.plist'' & a new ''.js file'' - there are other ways to achieve the same result
 ====  planetinfo.plist ====
 (in the "Config" folder)