Difference between revisions of "MarketObserver"

From Elite Wiki
(Updating BB links)
 
(45 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Overview==
+
[[File:Obs_wiki.png|400px|thumb|right|Market Observer]]
[[File:Market_observer.png‎ |200px|thumb|right|marketObserver feat. 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 Commodity Markets only]]
 
  
 +
== Overview ==
  
This oxp enhances the market screen with valuable data and gives the player a trader's ranking based on profit made from standard trading. To keep this enhancement free, ads from various advertisers are shown in the market screen.
+
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.
  
==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 and docking. 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 entering the market screen. This data is printed to the market screen. Printing of this feature can be toggled on or off. (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 ===
* Prices from oxp stations and rock hermits can be excluded with this.$noteOxpPrices variable in Config/script.js file.
 
  
'''2. Commodity Markets OXP Enhancer'''
+
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.
  
If Commodity Markets OXP by Thardoid is installed, the choice of market (buy/sell) is suppressed and both markets are integrated into one market. Buy prices and sell prices are shown side by side. This feature can be turned on or off. ($commMarketsFeat in Config/script.js file)
+
=== 3. Purchase Log ===
  
'''3. In-System Trade Helper'''
+
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 prices of the main station to the market screen when visiting other stations. If commodity markets is installed and the station has a commodity markets definition, commodity markets prices are shown instead. This feature can be turned on or off. (this.$inSystemTraderFeat 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. (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)
 
  
'''6. Trader's Rating'''
+
== Requirements ==
  
This feature monitors buying and selling and profit made. 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.
+
* Oolite version 1.82 or higher.
  
First rank at 1500 cr. Highest rank at 1000000 cr.
+
== Credits ==
  
This feature can be turned on or off. (this.$traderRankFeat in Config/script.js file)
+
* All ads are selected and cropped from Your Ad Here! oxp and Your Ad Here! forum thread. Ads are made by different Oolite players.
  
'''7. Ads From YAH'''
+
== Download ==
  
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 :).
+
* 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.
  
==Requirements==
+
== Installing ==
  
* Oolite version 1.77.
+
Install the OXP by copying marketObserver.oxp to your AddOns-folder.
  
==Credits==
+
== 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);
  
* All ads are selected, cropped and resized from [[Your Ad Here!]] oxp. Ads are made by different Oolite players.
+
== Market Aide ==
  
==Download==
+
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)!
* Download version 1.9 (for Oolite 1.77) from [https://www.box.com/s/u0hij6k0jzid4ujp2xi2 the box].
 
  
==Quick Facts==
+
== Quick Facts ==
{{Infobox OXPb| title = marketObserver
+
{{Infobox OXPb| title = Marker Observer
|version = 1.9
+
|version = 3.7
|release = 2013-02-23
+
|release = 2020-10-12
|license = CC BY-NC-SA 3.0
+
|license = CC BY-NC-SA 4.0
 
|features = Statistics
 
|features = Statistics
|category = Mechanics 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 03: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.