Difference between revisions of "MarketObserver"

From Elite Wiki
(Usage with other installed oxps)
(Updating BB links)
 
(49 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]]
 
[[File:market_observer_commodities_markets.png |200px|thumb|right|marketObserver feat. Commodity Markets]]
 
[[File:market_observer_cm_hc.png |200px|thumb|right|marketObserver feat. Commodity Markets and HyperCargo]]
 
  
 +
== 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.
  
==What it does==
+
== Core Features ==
  
This oxp monitors the prices of markets and keeps a list of minimum, maximum, average prices, purchases and profit made. Market screen is enhanced with this information and ads. Player is given a Trader's Rating based on profit made. Rating is shown in ships manifest.
+
=== 1. Market Reference Gatherer Engine ===
  
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 feature monitors the prices of system markets and keeps a list of average prices. This data is printed to the market screen.
  
Purchase log is collected from purchaces in the standard market. Profit is calculated when selling a commodity that's purchase has been logged. When selling, the log is purged starting from the highest prices paid. Profit is calculated only if there is something in the log. Meaning, no profit is calculated from salvaging or contracting etc, unless some purchased cargo is lost.
+
=== 2. System Price Difference Viewer ===
  
==Usage with other installed oxps==
+
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.
  
* [[Commodity Markets OXP]] by Thargoid
+
=== 3. Purchase Log ===
  
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.
+
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.
  
* [[HyperCargo OXP]] by Thargoid
+
=== 4. Ads From YAH / Now separated to a Market Ads OXP ===
  
Units of commodities in Hypercargo system are shown in the market screen.
+
*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.
  
==Feats==
+
=== 5. Trader's Rating ===
  
* Enhanced compatibility with [[Commodity Markets OXP]].
+
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.
* Enhanced compatibility with [[HyperCargo OXP]] by Thargoid
+
*First rank at 1,500₢. Highest rank at 1,000,000₢.
* Min and max prices from all dockables.
 
* Average from main stations.
 
* Purchase log. Latest is seen, all are logged and stored.
 
* Trader's rating based on profit made from trading in standard market. First rank at 1500 cr. Highest rank at 1000000 cr.
 
* Ads from YAH are randomly shown in the market screen.
 
* User defineable variables (in Config/script.js file):
 
  
-resetMarketData (reset gathered market data on start)
 
  
-this.$noteOxpPrices (include or exclude oxp station prices to min and max)
+
== Requirements ==
  
-this.$traderRankFeat (toggle trader rank feature on or off)
+
* Oolite version 1.82 or higher.
  
==Requirements==
+
== Credits ==
  
* Oolite version 1.77.
+
* All ads are selected and cropped from Your Ad Here! oxp and Your Ad Here! forum thread. Ads are made by different Oolite players.
  
==Credits==
+
== Download ==
  
* All ads are selected, cropped and resized from Your Ad Here! oxp. Ads are made by different Oolite players.
+
* 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.
  
==Download==
+
== Installing ==
* Download version 1.8 (for Oolite 1.77) from [https://www.box.com/s/u0hij6k0jzid4ujp2xi2 the box].
 
  
==Quick Facts==
+
Install the OXP by copying marketObserver.oxp to your AddOns-folder.
{{Infobox OXPb| title = marketObserver
+
 
|version = 1.8
+
== Tweaks ==
|release = 2013-02-21
+
You may care to consult [[How to tweak OXZ's]]
|license = CC BY-NC-SA 3.0
+
=== 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);
 +
 
 +
== Market Aide ==
 +
 
 +
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)!
 +
 
 +
== Quick Facts ==
 +
{{Infobox OXPb| title = Marker Observer
 +
|version = 3.7
 +
|release = 2020-10-12
 +
|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 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.