Difference between revisions of "MarketObserver"

From Elite Wiki
(Quick Facts)
(Updating BB links)
 
(24 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Overview==
+
[[File:Obs_wiki.png|400px|thumb|right|Market Observer]]
[[File:marketObserver_main.png‎ |200px|thumb|right|marketObserver Main Station interface]]
 
[[File:Market_observer.png‎ |200px|thumb|right|marketObserver feat. mO-Commodity Markets and HyperCargo]]
 
[[File:market_observer_commodities_markets.png |200px|thumb|right|marketObserver with in-system trade helper]]
 
[[File:market_observer_cm_hc.png |200px|thumb|right|marketObserver with mo-Commodity Markets only]]
 
  
 +
== Overview ==
  
This oxp enhances the market screen with valuable data. To keep this enhancement free, ads from various advertisers are shown in the market screen. Two optional addons are included, that will expand marketObserver.
+
This oxp enhances the market screen with valuable data. To keep this enhancement ''free'', ads from various advertisers are shown in the market screen.
 +
*The [[Vanilla game]]'s F8 screen merely shows 5 columns: commodity name, the price, amount for sale & amount in your hold, and the legality for each commodity.
 +
*This oxp adds another 4 columns:
 +
:*the galaxial average price (for comparison)
 +
:*the difference between the station price and the galactic average
 +
:*the % difference
 +
:*the price(s) at which you previously bought the commodities already in your hold.
 +
*You now have all the important information on the screen in front of you when deciding to buy or sell.
  
==Core Features==
+
== Core Features ==
  
'''1. Market Reference Gatherer'''
+
=== 1. Market Reference Gatherer Engine ===
  
This feature monitors the prices of markets and keeps a list of minimum, maximum and average prices seen in game. Average price is calculated from main station's market and data is collected when exiting witchspace. Only changed data is noted. Min and max prices from main station are collected at the same time. Min and max from oxp stations are collected when docking and entering the market screen. This data is printed to the market screen. Printing of this feature can be toggled on or off from the script. (this.$gathererFeat in Config/script.js file)
+
This feature monitors the prices of system markets and keeps a list of average prices. This data is printed to the market screen.
  
* Gathered market data can be resetted with resetMarketData variable in Config/script.js file.
+
=== 2. System Price Difference Viewer ===
* Untouched min/max values are slowly brought closer to the average to fade out peaks. Cutting starts, when values have been untouched for 10 days. Timeout can be altered from the script. (this.$timeOut in Config/script.js file)
 
* After 100 updates, the basis of average calculations is set to 100 to better reflect changing markets. The limit can be altered from the script. (this.$basisLimit in Config/script.js file)
 
  
'''2. In-System Trade Helper'''
+
This feature prints the difference of station prices compared to the averages as absolute and percentage value to the market screen. Gives a quick overview of what is cheap and what expensive.
  
This feature prints the prices of the main station to the market screen when visiting other stations. This feature can be turned on or off. (this.$inSystemTraderFeat in Config/script.js file)
+
=== 3. Purchase Log ===
  
'''3. Price Difference Viewer'''
+
Purchase log is collected from purchases at the standard market. Helps to determine if it's worth while to sell or not.
 +
*Complete details of '''multiple purchases''' is available in the detailed commodity view (f8-f8).
 +
*When selling, the log is purged starting from the ''most expensive'' purchases. The most expensive purchase is printed to the market screen.
 +
*'''Lost cargo''' is purged from the log when docking at any station.
  
This feature prints the difference of the prices compared to the averages as percentage to the market screen when visiting a main station. This feature can be turned on or off. (this.$percentageFeat in Config/script.js file)
+
=== 4. Ads From YAH / Now separated to a Market Ads OXP ===
  
'''4. HyperCargo Viewer'''
+
*Various ads from Your Ad Here! OXP are shown in the bottom of the market screen.
 +
*Note that these ads can be ''useful''! They often give information about Oolite options. And some are jolly funny to boot!
 +
*Market Ads OXP has an api for adding even more ads to the mix: Simply call worldScripts["market_ads_service"]._setHorzAd('filename_of_your_horizontal_ad') in startUp and that's it. Ads need to be in 256x128 resolution.
  
If [[HyperCargo OXP]] by Thargoid is installed, the contents of the HyperCargo system are printed to the market screen. This feature can be turned on or off from the script. (this.$hyperCargoFeat in Config/script.js file)
+
=== 5. Trader's Rating ===
  
'''5. Purchase Log'''
+
Market Observer monitors the profit you gain from buying and selling at the standard market and gives you a rating. Profit is calculated when selling a commodity whose purchase has been logged. No profit is calculated from salvaging or contracting ''etc'', unless some purchased cargo is lost. Player is given a Trader's Rating based on profit made. Rating is shown on the (F5) ship manifest and, if Market Ads is installed, on the (F8) market screen.
 +
*First rank at 1,500₢. Highest rank at 1,000,000₢.
  
Purchase log is collected from purchaces in the standard market. When selling, the log is purged starting from the most expensive purchases. Logs most expensive purchase is printed to the market screen. Printing of this feature can be turned on or off. (this.$purchaseLogFeat in Config/script.js file)
 
  
If cargo is lost, lost cargo is purged from the log when docking a main station.
+
== Requirements ==
  
'''6. Ads From YAH'''
+
* Oolite version 1.82 or higher.
  
Various ads from Your Ad Here! OXP are shown in the bottom of the market screen. This feature can't be toggled off, it keeps this enhancement free :).
+
== Credits ==
  
==Addons==
+
* All ads are selected and cropped from Your Ad Here! oxp and Your Ad Here! forum thread. Ads are made by different Oolite players.
  
'''1. Commodity Markets OXP addon''' (Overrides In-System Trade Helper and Price Difference Viewer features)
+
== Download ==
  
If mO-Commodity Markets OXP is installed, market screen's price column is divided to sell price and buy price. This adds a little bit of difficulty and realism to the game. Buy price is always a little higher than sell price.
+
* Download the latest version (for Oolite 1.82) from the expansion manager. Market Observer for the statistical functionality and Market Ads for, eh, ads.
 +
* Download version 2.3.2 (for Oolite 1.79) from the expansion manager. Oxz version includes the trader's rating addon.
 +
* Download version 2.2.3 (for Oolite 1.77) from [https://app.box.com/s/usjm5rcs1nkf6mb3zrjz the box].
 +
* Only for the version 2.2.3. Download an update (1.2) to the Commodity Markets OXP addon from [https://app.box.com/s/xuvv1ikenpanjk4hk3sl the box]. This update preserves buy/sell prices over saves. Update by laxori666.
  
'''2. Trader's Rating OXP addon'''
+
== Installing ==
  
If mO-Trader's Rating OXP is installed, it monitors the profit you gain from buying and selling in the standard market and gives you a rating. Profit is calculated when selling a commodity that's purchase has been logged. No profit is calculated from salvaging or contracting etc, unless some purchased cargo is lost. Player is given a Trader's Rating based on profit made. Rating is shown in ships manifest.
+
Install the OXP by copying marketObserver.oxp to your AddOns-folder.
  
First rank at 1500 cr. Highest rank at 1000000 cr.
+
== Tweaks ==
 +
You may care to consult [[How to tweak OXZ's]]
 +
=== Tab Stops ===
 +
Switeck's [https://bb.oolite.space/viewtopic.php?p=284063#p284063 tab-stop tweak] prevents some larger numbers overlapping:
 +
I didn't like how when I had a mad number of cargo contracts going that the amounts for Gold/Platinum/Gems could almost overlap with the for sale amount.
 +
 +
So I edited Market Observer's Tab stops for displaying that page...
 +
It's in the gui-settings.plist file inside Config folder. (Have to unzip the OXZ first to access this!)
 +
 +
I changed from:
 +
"market_tabs" = (0,101,227,307,326,431);
 +
 +
to...:
 +
"market_tabs" = (0,101,227,287,326,421);
  
==Requirements==
+
== Market Aide ==
  
* Oolite version 1.77.
+
Here is a [https://bb.oolite.space/viewtopic.php?f=6&t=4902 2008 description] from the Dark Ages before Spara's Market Observer. Spara first wrote [[MarketAide OXP]] in 2012 which merely posted the minimum, average & maximum prices for each commodity (taken from the '''OoliteRS''' sheet which came with your original game download). He then developed Market Observer the next year which creates the min/avg/max prices dynamically based on the markets you have personally visited. There was also a brief flirtation with a ''Troomp.oxp'' (see [[SothisTC]] for details)!
* Not compatible with [[Commodity Markets OXP]] by Thargoid, use mO-Commodity Markets addon.
 
  
==Credits==
+
== Quick Facts ==
 
 
* All ads are selected, cropped and resized from [[Your Ad Here!]] oxp. Ads are made by different Oolite players.
 
* mO-Commodity Markets addon is based on Thargoid's [[Commodity Markets OXP]].
 
 
 
==Download==
 
 
 
* Download version 2.2.9 (for Oolite 1.79) from the expansion manager Oxz version includes the trader's rating addon.
 
* Download version 2.2.3 (for Oolite 1.77) from [https://app.box.com/s/usjm5rcs1nkf6mb3zrjz the box].
 
* Download an update (1.2) to the Commodity Markets OXP addon from [https://app.box.com/s/xuvv1ikenpanjk4hk3sl the box]. This update preserves buy/sell prices over saves. Update by laxori666.
 
 
 
==Installing==
 
 
 
Install the OXP by copying marketObserver.oxp to your AddOns-folder. Install addons in similar fashion.
 
 
 
==Quick Facts==
 
 
{{Infobox OXPb| title = Marker Observer
 
{{Infobox OXPb| title = Marker Observer
|version = 2.2.9
+
|version = 3.7
|release = 2014-07-05
+
|release = 2020-10-12
|license = CC BY-NC-SA 3.0
+
|license = CC BY-NC-SA 4.0
 
|features = Statistics
 
|features = Statistics
 
|category = Equipment OXPs
 
|category = Equipment OXPs
|author = Spara
+
|author = [[User:Spara|Spara]]
|feedback = [http://aegidian.org/bb/viewtopic.php?f=4&t=13336 Oolite BB]
+
|feedback = [https://bb.oolite.space/viewtopic.php?f=4&t=13336 Oolite BB]
 
}}
 
}}
 +
 +
==Gameplay and Balance indicator==
 +
[[Image:tag-colour-blue.png|right]]
 +
No difference to combat or that sort of thing, but goodness... this little OXP unlocks the markets and trading for you. Unbelievably helpful and informative. A "must" for every new player.

Latest revision as of 02:07, 29 February 2024

Market Observer

Overview

This oxp enhances the market screen with valuable data. To keep this enhancement free, ads from various advertisers are shown in the market screen.

  • The Vanilla game's F8 screen merely shows 5 columns: commodity name, the price, amount for sale & amount in your hold, and the legality for each commodity.
  • This oxp adds another 4 columns:
  • the galaxial average price (for comparison)
  • the difference between the station price and the galactic average
  • the % difference
  • the price(s) at which you previously bought the commodities already in your hold.
  • You now have all the important information on the screen in front of you when deciding to buy or sell.

Core Features

1. Market Reference Gatherer Engine

This feature monitors the prices of system markets and keeps a list of average prices. This data is printed to the market screen.

2. System Price Difference Viewer

This feature prints the difference of station prices compared to the averages as absolute and percentage value to the market screen. Gives a quick overview of what is cheap and what expensive.

3. Purchase Log

Purchase log is collected from purchases at the standard market. Helps to determine if it's worth while to sell or not.

  • Complete details of multiple purchases is available in the detailed commodity view (f8-f8).
  • When selling, the log is purged starting from the most expensive purchases. The most expensive purchase is printed to the market screen.
  • Lost cargo is purged from the log when docking at any station.

4. Ads From YAH / Now separated to a Market Ads OXP

  • Various ads from Your Ad Here! OXP are shown in the bottom of the market screen.
  • Note that these ads can be useful! They often give information about Oolite options. And some are jolly funny to boot!
  • Market Ads OXP has an api for adding even more ads to the mix: Simply call worldScripts["market_ads_service"]._setHorzAd('filename_of_your_horizontal_ad') in startUp and that's it. Ads need to be in 256x128 resolution.

5. Trader's Rating

Market Observer monitors the profit you gain from buying and selling at the standard market and gives you a rating. Profit is calculated when selling a commodity whose purchase has been logged. No profit is calculated from salvaging or contracting etc, unless some purchased cargo is lost. Player is given a Trader's Rating based on profit made. Rating is shown on the (F5) ship manifest and, if Market Ads is installed, on the (F8) market screen.

  • First rank at 1,500₢. Highest rank at 1,000,000₢.


Requirements

  • Oolite version 1.82 or higher.

Credits

  • All ads are selected and cropped from Your Ad Here! oxp and Your Ad Here! forum thread. Ads are made by different Oolite players.

Download

  • Download the latest version (for Oolite 1.82) from the expansion manager. Market Observer for the statistical functionality and Market Ads for, eh, ads.
  • Download version 2.3.2 (for Oolite 1.79) from the expansion manager. Oxz version includes the trader's rating addon.
  • Download version 2.2.3 (for Oolite 1.77) from the box.
  • Only for the version 2.2.3. Download an update (1.2) to the Commodity Markets OXP addon from the box. This update preserves buy/sell prices over saves. Update by laxori666.

Installing

Install the OXP by copying marketObserver.oxp to your AddOns-folder.

Tweaks

You may care to consult How to tweak OXZ's

Tab Stops

Switeck's tab-stop tweak prevents some larger numbers overlapping:

I didn't like how when I had a mad number of cargo contracts going that the amounts for Gold/Platinum/Gems could almost overlap with the for sale amount.

So I edited Market Observer's Tab stops for displaying that page...
It's in the gui-settings.plist file inside Config folder. (Have to unzip the OXZ first to access this!)

I changed from:
"market_tabs" = (0,101,227,307,326,431);

to...:
"market_tabs" = (0,101,227,287,326,421); 

Market Aide

Here is a 2008 description from the Dark Ages before Spara's Market Observer. Spara first wrote MarketAide OXP in 2012 which merely posted the minimum, average & maximum prices for each commodity (taken from the OoliteRS sheet which came with your original game download). He then developed Market Observer the next year which creates the min/avg/max prices dynamically based on the markets you have personally visited. There was also a brief flirtation with a Troomp.oxp (see SothisTC for details)!

Quick Facts

Version Released License Features Category Author(s) Feedback
3.7 2020-10-12 CC BY-NC-SA 4.0 Statistics Equipment OXPs Spara Oolite BB

Gameplay and Balance indicator

Tag-colour-blue.png

No difference to combat or that sort of thing, but goodness... this little OXP unlocks the markets and trading for you. Unbelievably helpful and informative. A "must" for every new player.