Phkb: /* License */ New version

2026-06-29T18:31:11Z

‎License: New version

Phkb: /* Comment */ Added more info about why this OXP was necessary

2026-06-29T18:03:02Z

‎Comment: Added more info about why this OXP was necessary

Cholmondely: Page created

2026-06-29T10:29:27Z

Page created

New page

[[File:Checking Trade Goods OXP (Inauguration).png|thumb|right|400px|F4 screen - starting the process]]
Utility: Visit ''all'' systems in chart and output trade good data to [[Latest.log]]

== Overview ==
Checking Trade Goods is a utility designed to aid OXP developers (or just the curious) when building and testing commodity-related OXPs. It automates the process of jumping to every system in a chart, collecting trade good information from the main station, and producing a summary report (in your [[Latest.log]]) at the end.

== Detail ==
This is a utility I put together that will automate the task of checking on prices around a chart. What it does is automate the process of jumping into every system in the chart, collecting prices and quantities for all trade goods, and then jumping to the next system. At the end, it auto-docks the player and dumps summary information into the latest.log. You can specify what types of things to output via an F4 interface screen. That interface screen is also where you initiate the process from.

By default, it's set to check the main station market. But if you extract the contents, in the script.js file, you can set the "this._stationRole" value to be the role of your station, and it will then check the market there.

=== Important things to note ===
:1. Don't run this with lots of OXP's installed. The best method is to have *just* the OXP's you need to check the market. This might include a single station OXP, for example.
:2. It will take about 15 minutes to jump to every system (on my rig, at least), so once it starts, just sit back and watch it go. You can check the status in the log file - you'll get a running commentary on how far through the process you are.
:3. If you find yourself drifting through space and nothing is happening, it was probably something that stopped a jump - best idea at that point is just to stop the game and restart. You might still need to decant some OXPs.
:4. It will jump to other galaxies if you have the latest version of 1.91 installed. You can select the galaxy you want to check from the F4 Interface screen.
:5. It *won't* check multiple galaxies at a time. Do one galaxy, then restart the game and do another.
:6. It *will* automatically jump into the systems of the Great Rift in G7. But it *won't* jump to any of the other unreachable systems in other galaxies.
:7. There is no point 7.

There are some more notes in the script.js file about the process. Hopefully it all makes sense.

[[File:Checking Trade Goods OXP (Selection).png|thumb|right|400px|F4 screen - fine-tuning the process (Oolite v.1.90)]]
[[File:Checking Trade Goods OXP (The Process).png|thumb|right|400px|The process!]]
[[File:Checking Trade Goods OXP (The Results).png|thumb|right|400px|The results (inside the [[Latest.log]]) ]]
=== Usage ===
You can select:
*"Galaxy-wide summary" (which collates everything in the chart to one data set)
*"Summary by Economy" (which collates everything in the chart to one data set per economy type)
*"Summary by Government" (which collates everything in the chart to one data set per government type)

The round trips assume Lave is always the starting point, and the starting points in the other charts are where you end up if you use a galactic jump from Lave. There are some duplicates in the routes as there is occasionally a need to backtrack. Data collection will exclude these duplicate jumps. Also, unreachable systems in galaxy ID 2, 5 and 8 will not be visited and their values not included in the results.

=== Starting system ===
:G1 [[Sector1/Lave|Lave]]
:G2 [[Sector2/Inoran|Inoran]]
:G3 [[Sector3/Divera|Divera]]
:G4 [[Sector4/Cebitiza|Cebitiza]]
:G5 [[Sector5/Zaxeed|Zaxeed]]
:G6 [[Sector6/Oratedge|Oratedge]]
:G7 [[Sector7/Tiared|Tiared]]
:G8 [[Sector8/Soladiar|Soladiar]]

=== Comment ===
'''Objection:''' I never understood why this OXP was needed: in theory one should be able to pull sample prices out of System.infoForSystem() without ever leaving the comfort of home.
'''Response:''' "In theory" being the key point. Given the number of ways commodity prices can be adjusted, the only way the guarantee you’re seeing the full result of all changes is to visit the system itself. That was the logic behind this OXP. (From [https://bb.oolite.space/viewtopic.php?p=306306#p306306 here (2026)])

== License ==
*Author: [[User:Phkb|Phkb]]
*License: CC-BY-NC-SA 4.0
*Oolite version: 1.79 or newer
*OXP version: 1.1

== Credits ==
With thanks to [[User:Switeck|Switeck]] for sharing his method of rapidly jumping from system to system.

== Download ==
[https://app.box.com/s/62dgu7vt8kchs8mpewd8cicukaknvndk CheckingTradeGoods.oxz]

== Links ==
*[https://bb.oolite.space/viewtopic.php?p=292681#p292681 Phkb's BB announcement] (2023)
=== Wiki pages for OXP programmers ===
This utility is useful for people faffing about with the following!
*[[Trade-goods.plist]]
*[[Oolite JavaScript Reference: Market Scripts]]

{{misc-OXP}} [[Category:Oolite utilities]]

@@ Line 52: / Line 52: @@
 *License: CC-BY-NC-SA 4.0
 *Oolite version: 1.79 or newer
-*OXP version: 1.1
+*OXP version: 1.2
 == Credits ==

@@ Line 43: / Line 43: @@
 === Comment ===
-'''Objection:''' I never understood why this OXP was needed: in theory one should be able to pull sample prices out of System.infoForSystem() without ever leaving the comfort of home.
+'''Objection:''' I never understood why this OXP was needed: in theory one should be able to pull sample prices out of System.infoForSystem() without ever leaving the comfort of home.<br>
 '''Response:''' "In theory" being the key point. Given the number of ways commodity prices can be adjusted, the only way the guarantee you’re seeing the full result of all changes is to visit the system itself. That was the logic behind this OXP. (From [https://bb.oolite.space/viewtopic.php?p=306306#p306306 here (2026)])
 == License ==

Checking Trade Goods OXP - Revision history

Phkb: /* License */ New version

Phkb: /* Comment */ Added more info about why this OXP was necessary

Cholmondely: Page created