Wrye Avatar

Master Merchant

Collection of Elder Scrolls Mods

Sharlikran xEdit PokemonGo Yu-Gi-Oh! Fallout shelter Wiki Wrye-Code-Collection Wrye-Code-Collection Wiki xEdit documentation
Home

Master Merchant


Main Table of Contents

ESOUI Mod Documentation

Localized Suplimental Documentation

 

Under Construction

 

under_construction

 

The site is undergoing changes to the images for 3.7.x so the screen shots, icons, settings menus, and menu description may not resemble 3.5.30.

 

Contents

•  3.1 3.7.x Sorting Writs by voucher count

•  3.2 Setup Master Merchant 3.0

•  3.2.1 In a Nutshell

•  3.2.2 What is required

•  3.2.3 Importing older Master Merchant Data

•  3.2.3.1 MMxxData modules needed for importing

•  3.2.4 What to expect after you log in for the first time

•  3.2.5 Have the dependencies changed

•  3.2.6 Which modules do I need to activate for MM 3.7.x

•  3.2.6.1 Master Merchant

•  3.2.6.2 All the LibGuildStore Modules

•  3.3 Shopping List and Bonanza!

•  3.3.1 Shopping List

•  3.3.2 Bonanza!

•  3.3.3 Bonanza Name Filter

•  3.3.4 Bonanza Type Filter

•  3.3.5 Bonanza - Using BeamMeUp

•  3.4 Outliers

•  3.4.1 Controlling skewed Bonanza prices

•  3.5 MM Price vs TTC vs Bonanza

•  3.5.1 Evaluating the Bonanza price

•  3.5.2 Price Sold vs. Price Listed

•  3.5.3 Comparisons between Bonanza, TTC, and MM

•  3.6 Three states of LibHistoire cache

•  3.6.1 Unlinked

•  3.6.2 Linking in progress

•  3.6.3 Linking in progress, with 0 events left

•  3.6.4 Linked

•  3.7 Ten Day Scan

•  3.7.1 Select A Guild

•  3.7.2 Request one day at a time

•  3.7.3 Rescan Button

•  3.7.4 When E is no longer showing

•  3.7.5 LibHistoire GUI

•  3.8 Update Your Guild History Each Day

•  3.9 Unlinked Events Notification

•  3.10 Resolving Unlinked Events

•  3.11 Master Merchant Window

•  3.11.1 Guild Sales and Personal Sales

•  3.11.2 Item Report

•  3.11.2.1 What The Columns Mean

•  3.11.3 Seller's Report

•  3.11.3.1 Top Buyers and Sellers

•  3.11.3.2 Top Items

•  3.11.3.3 Personal Sales - Seller's Report

•  3.11.3.4 What The Columns Mean

•  3.11.4 Guild Sales Date Filter Ranges

•  3.11.5 Date Ranges

•  3.12 Statistics Window

•  3.13 Settings

•  3.13.1 Master Merchant

•  3.13.1.1 Master Merchant Window Options

•  3.13.1.2 Time Format Options

•  3.13.1.3 Alert Options

•  3.13.1.4 On-Screen and Chat Alert

•  3.13.1.5 Calculation Display Options

•  3.13.1.6 Guild & Account filter

•  3.13.1.7 Deal Calculator Options

•  3.13.1.8 Other Tooltip Options

•  3.13.1.9 Price To Chat Options

•  3.13.1.10 Inventory Options

•  3.13.1.11 Guild Store Options

•  3.13.1.12 Guild Master Options

•  3.13.1.13 MM Debug Options

•  3.13.2 LibGuildStore

•  3.13.2.1 Sales Management Options

•  3.13.2.2 Data Management Options

•  3.13.2.3 LGS Debug Options

•  3.13.2.4 Import MM Data

•  3.13.2.5 Import ATT Data

•  3.13.2.6 Import ATT Purchases

•  3.13.2.7 Refresh LibHistoire

•  3.13.2.8 Import ShoppingList Data

•  3.13.2.9 Import Pricing Data

•  3.13.2.10 Reset Data

•  3.14 Misc

•  3.14.1 Popup Item Data

•  3.14.2 Level Quality Selectors

•  3.14.3 Erroneous timestamp

•  3.14.4 What is being scanned

•  3.14.4.1 A few days of sales from 109 entries

•  3.14.4.2 4 days of sales from 8031 entries

•  3.14.5 Sales Week

•  3.15 Slash commands

•  3.15.1 Export Sales Report

•  3.15.2 Export Sales Activity

•  3.16 Technical Information

•  3.16.1 Backup LibGuildStore Data

•  3.16.2 Uninstall Master Merchant 2.x

•  3.16.3 Locating LibExecutionQueue

•  3.16.4 Unintentional ZOS Bug

•  3.17 Alternate Upgrade Method

•  3.17.1 Optional Mods For This Procedure

•  3.17.2 Optional Debug Settings

•  3.17.3 The Procedure

•  3.17.4 Version History

•  3.18 Depreciated

•  3.18.1 Backup Master Merchant Data

•  3.18.2 Background Scanning

•  3.19 Authors

•  3.20 Translators

 

Bonanza

 

Shop all of Tamriel with Beam Me Up and Bonanza. Master Merchant is not just for high end traders anymore. If you are shopping for the best deal you can find it in the Bonanza window.

 

3.1 - 3.7.x Sorting Writs by voucher count

 

/lgs clean, which is /LGS CLEAN but use lowercase.

 

To reorganize Writs by voucher after upgrading to 3.7.02 you need to use the slash command shown above. After the process is complete you should reload your UI.

 

3.2 - Setup Master Merchant 3.0

 

3.2.1 - In a Nutshell

 

•  Install Master Merchant 3.0

•  Log In

•  Wait for Refresh to finish

•  Perform a Ten Day Scan

•  Read how to Update Your Guild History Each Day

 

3.2.2 - What is required

 

You can still use ATT and MM at the same time if you chose. There is a toggle to disable the notification under Debug Options under the MasterMerchat settings.

 

•  Master Merchant 3.7.x

•  LibExecutionQueue

•  LibGuildStore

•  LibGuildStore Data File GS00Data, LibGuildStore Data File GS01Data, etc.

 

3.2.3 - Importing older Master Merchant Data

 

Download Importers for Master Merchant 3.0 which includes all the Master Merchant Data File modules MM00Data, Master Merchant Data File MM01Data, etc. and ShoppingList.

 

You can import older Master Merchant Data if you have backups for those who like being the library of congress of data. Just know that it will increase load times and the game will take longer to log out as well while saving the data.

 

3.2.3.1 - MMxxData modules needed for importing

 

The MMxxData (MM00Data, MM01Data, etc.) modules are used for importing data only. After your import your data, these old modules should be deactivated.

 

disable_mm

 

Because of how saved variables work you have to enable the old MMxxData modules to load the data into memory.

 

3.2.4 - What to expect after you log in for the first time

 

startup_refresh

 

once you log in the LibHistorie Refresh will start. You will know when the refresh has finished when you see, LibGuildStore Refresh Finished appear in the chat window. You will need to get your first ten days of data to complete the initial setup. Review the section Ten Day Scan.

 

Once the initial refresh is finished you can import sales from MM. This is to accommodate people who may have more history in their MM data files then they do in LibHistorie. You can also import from ATT for the same reason. If you have been using ATT and have never used MM then you could have 30 days of data in your ATT data files. After you import your ATT data and do a Ten Day with LibHistorie you will have the most data possible. You can also import purchases from ATT and the old standalone ShoppingList for MM. There will be notifications to disable the old MMxxData modules, the old ShoppingList standalone module, and ATT. There is an option to disable the ATT notification if you prefer to use both MM and ATT at the same time.

 

If you are experiencing issues after trying the following steps you can review the section Alternate Upgrade Method.

 

3.2.5 - Have the dependencies changed

 

LibGuildStore is provided with MM and is not a separate Minion download.

 

After Master Merchant 3.7.x LibGuildStore is where all the Guild Store related data is being kept. NA and EU information is now stored separately. This also allows importing from MM if you have more MM data then you do LibHistoire data. You would not want to overload MM but you could import any backups you have or backup files from other friends or guild members if you copy them to the SavedVariables folder.

 

Caution, the more data you import the longer MM will need to load.

 

3.2.6 - Which modules do I need to activate for MM 3.7.x

 

3.2.6.1 - Master Merchant

 

mm_shopping_list

 

3.2.6.2 - All the LibGuildStore Modules

 

all_libguildstore_modules

 

3.3 - Shopping List and Bonanza!

 

3.3.1 - Shopping List

 

shopping_list_view

 

Adds a new icon allowing you to view purchases you make from guild stores.

 

shopping_list The Shopping List icon allows you to select the installed extension and view purchases you have made from guild stores.

 

The by old Shopping List extension by MildFlavour is not longer used and can be disabled after you import your purchases.

 

3.3.2 - Bonanza!

 

bonanza_window

 

With MM 3.7.x the Bonanza bonanza_icon icon allows you to view items you have seen at traders as you shop for items to purchase.

 

3.3.3 - Bonanza Name Filter

 

bonanza_window_filter

 

3.3.4 - Bonanza Type Filter

 

bonanza_window_filter_type

 

3.3.5 - Bonanza - Using BeamMeUp

 

bonanza_window_beammeup

 

If you have BeamMeUp installed you can right click the Location column to travel to the zone the trader is located in with the usual BeamMeUp restrictions. If there are no players in the zone to jump to BeamMeUp will notify you and you may travel to a wayshrine that is not close to the trader.

 

3.4 - Outliers

 

less_then_five_outliers

 

With only 5 sales the obvious outlier is not ignored.

 

There must be at least 6 sales before Master Merchant can ignore outliers.

 

outlier_ignored

 

With 8 sales of the same item you can see that the obvious outlier is being ignored.

 

When ignoring outliers with 6 or more sales that does not mean the highest and lowest sale will be ignored. The lowest and highest price may be well within range and reasonable prices. The above example is a good example to show the remaining 7 are well within tolerance of one another.

 

3.4.1 - Controlling skewed Bonanza prices

 

People will intentionally try to sell items much higher then they are worth. Use the resources available rather then squint at the scatter plot.

 

bonanza_skewed_prices

 

While viewing a graph as shown above find out who is skewing the price and add them to the Guild & Account filter.

 

resolved_skewed_price

 

Once the seller is added to the Guild & Account filter you can see that the graph is much more useful.

 

The absence of the Bonanza price is not what corrected the graph. The Bonanza average changed because the seller of the item listed for 3000g is being ignored. Other listings of the same item for 200g would not have the same drastic effect as the listing for 3000g.

 

3.5 - MM Price vs TTC vs Bonanza

 

There are several examples because I feel Bonanza is new and it may be hard to understand the various ways to use it. I highly suggest reading all of the following sections.

 

example_1_hlaalu example_2_cuirass example_3_bow example_4_plating

 

•  The MM price is in yellow text, and it is the price the item sold for in one of the guilds you are in. It is not a price from other outside sources like other guilds on the server and it is not from TTC.

•  The TTC Price is from their own data collected by their EXE and transmitted to their server. They trim outliers using their own method and then make an average of the remaining data.

•  The Bonanza Price is in blue text and it is an average from a 24 hour snapshot of all the listings you have seen of that specific item from the traders you have visited.

 

Looking at the first example of the Hlaalu Bookcase you see it sold 1 time out of all the guilds I am in. So there is no way to get a reasonable price for it. Someone listed it 56 days ago for 100K and it sold. That is one of the drawbacks of the MM price. If you do not have many sales from the guilds you are in then the MM price won't be very helpful. Also from the first example you see that the TTC price is about 19K and the Bonanza price is 17K. There are 9 listings from TTC and 1 from another trader. Once you have more data the Bonanza price may change but you can more easily see that 17K to 19K would probably be a more reasonable price then 100K.

 

From the second and third examples you will note that the TTC price is useless for these items. The TTC price can sometimes be very helpful. The bonanza price is also higher then the MM price. This is where the Bonanza window will be needed because you will need to search for the exact item and look at the prices you have found. This is discussed in the section Evaluating the Bonanza price

 

The Bonanza price while similar to TTC is the average of what you have found at the traders you have visited in the last 24 hours. Bonanza itself is intended to be a shopping tool but since the data is there it is displayed on the graph for you to use as another way to evaluate what the item is currently selling for. If you only have 1 to 3 sales you can not compute an average from that I'd suggest 5 or more depending on how popular it is on traders at the time.

 

For the last example you will note that the Bonanza price for Chromium Plating is only about 22K above the MM price. With more data it may even fall exactly in line with the MM price. The TTC suggested price is 239Kwhich is 2K different then the Bonanza average. For items that normally do not have a lot of skew to the pricing data this will be common. For items that have more outliers skewing the pricing data you will need to evaluate the TTC and Bonanza prices to get a better idea of what may be a good price to sell the item for.

 

3.5.1 - Evaluating the Bonanza price

 

bonanza_tooltip_style_page low_end_prices high_end_prices

 

If those are too small, right click the image and show it in a new tab to see the full size.

 

Looking at the tooltip TTC shows 74K to 93K, the Bonanza average is 158K, and the MM price is 70K. Then the highest and lowest listing in TTC is 446 to 5M. With TTC you can not view the current prices being used for their suggestion. You can view the Bonanza prices to evaluate what other people are selling the item for. For this example you would open the Bonanza window and search for style zero cuirass.

 

As you see in the middle screenshot the prices range from 50K to 80K. In the last screen shot the highest prices are 1M to 3.9M. So now you have three prices all in about the same range. 1) 50K to 80K 2) 70K 3) 74 to 93K and all without opening external websites, google docs pages, or spreadsheets. It didn't require two monitors and it took only a few moments.

 

It is easy to see that 70K is probably the best average price to sell the style page for. If you want it to see faster because you want it out of your inventory, 50K won't bee too low that someone might flip it and even if they do you still made close to the going rate of 70K.

 

Just because the Bonanza price is not 70K and is showing 158K doesn't mean it is inaccurate. In this example it is being affected by all the prices above 1M. Although you can not see the data you will be able to view your own. For the data used in the screen shots 99 of the prices were above 100K which will affect the average significantly. This is why I recommend you evaluate the price in the manner described.

 

3.5.2 - Price Sold vs. Price Listed

 

The above items are meant to show items that have an unusual range for the TTC price or Bonanza price because it is the listed price. For items like style pages if there are 124 listings and 99 of them are 100K and above you may wonder if you could make more from selling the item. Maybe and maybe not. This is the difference between what the item sold for which is the MM price and what the item is listed for which it the Bonanza or TTC price. Think of how an author might write a book. They write the book so it is appealing to their audience. So imagine who will be buying your items. Do they have 6M to spend on something and plenty of gold left over? Does your buyer have 6M at all? Have they ever had 6M at one time? Are they willing to spend 6M for the item? It is simple common sense that if someone has 124 items to choose from they will buy the cheapest one. Just because something sold for 5M or 6M 60 days ago when the item was scarce and someone had that much to spend on the item doesn't mean people will pay that price when the item is less scarce.

 

The above examples don't represent things like crafting materials where the pricing is more consistent and the MM price is more reliable. With the example of crafting materials that is simple supply and demand. If you want to read an article on it be my guest and you can enjoy such wonderful words as equilibrium and elasticity, knock yourself out. There are a lot of crafting materials on guild stores so there is a large supply and there is a large demand for them. Because there is a consistent need for them people purchase the cheapest listed items and the price remains rather consistent.

 

This is not the case for everything. Take your time and use the different prices and tools to evaluate what you are selling, what others are selling it for, and what others are buying it for.

 

3.5.3 - Comparisons between Bonanza, TTC, and MM

 

style_page_thurvokun

 

To start with you will have people that list an item for something stupid and it just contaminates the TTC database. They should be prevented from uploading TTC prices from the TTC developers. When you have items with no data or items that people feel should sell for millions of gold then those are harder to evaluate.

 

That isn't what I will cover in this section because that kind of data is not usable.

 

Look at these examples of the Bonanza price

 

dreugh_wax_bonanza

 

Bonanza is within 1K approximately from TTC and the MM average.

 

blassed_thistle_bonanza

 

Bonanza is 1g away from the TTC average.

 

Most sales noobs feel you have to have millions of sales in your database, years and years of stuff, and preserve data like you are the library of congress or something. If you look at both of those screen shots TTC has data points in the thousands. 15,000 for the Dreugh Wax, and 2,800 for the Blessed Thistle. Yet I have the same price for the Blessed Thistle with only a few hundred data points.

 

I could write Lua code that anyone could copy and paste into an online Lua compiler that could show you how I can add a variety of numbers and come out with a certain average, say 100. Then I could add together another set of data that has different and more numbers, and still come within approximately 5g of the average I am looking for. A range of 95g - 105g more or less.

 

The example would be bias of course because I am demonstrating that if you when you add 100, 99, 90, 95 and so on.. together that you get a specific average. If you load more of the same numbers you will get the same average. I don't care how many times you add 100 + 100 + 100, it will be the same outcome.

 

In statistics this is called the Mode. So the value that appears most often. Commonly sold materials such as Chromium Grains, Dreugh Wax, Clam Gall, Blessed Thistle and such that the data is fairly consistent. When data is more consistent you don't need thousands of data points to get the proper average.

 

Don't make it work. If you visit 3 or 4 cities and search for key items at all traders then you should have enough data to work with. TTC and Bonanza should be close however, it depends on the pricing people use. Some people post the TTC Suggested price and some post the Average price. It depends on the demand of the item and the price.

 

The other benefit of Bonanza is that you can view the prices. Which is what I show in my documentation under Evaluating the Bonanza price. If you feel the price is not in line with TTC or listings from other traders then look. If other traders list a style page for 50K and that is the most common value then that is the going rate. You can then price your items to be competitive with other guilds.

 

So it may be a bit of information overload but without the need for two monitors, viewing the TTC website, viewing google docs, viewing spreadsheets, exporting prices from MM to paste on websites, just use the Master Merchant interface. It is simple and easy to switch views and search for things to compare information without leaving the game to look at outside sources for information.

 

3.6 - Three states of LibHistoire cache

 

3.6.1 - Unlinked

 

red_text_unlinked

 

In the Unlinked state you can either wait for the server to grant the requests for offline data that LibHistoire requests, or you can manually request guild history for the time you were offline.

 

3.6.2 - Linking in progress

 

yellow_text_linking

 

Once LibHistoire has what it feels it needs, then it will begin processing the guild history events and attempt to link to the last known event.

 

3.6.3 - Linking in progress, with 0 events left

 

process_stuck

 

If you ever see it processing 0 events for a while you will just need to wait for the events to link. If there are external factors involved then nothing will process until that is no longer affecting LibHistoire.

 

3.6.4 - Linked

 

green_text_linked

 

Once LibHistoire has linked to its stored events you should see green text. This means that LibHistoire has finished processing the guild history.

 

You can still request additional history and ask LibHistoire to check the guild history for any missing sales events using the rescan button.

 

3.7 - Ten Day Scan

 

If you are upgrading from MM 2.5.x or installing MM 3.x for the first time, you will need to do a Ten Day Scan of all the guilds you are in. This ensures that LibHistoire has stored sales data for you to start working with.

 

Initially I had suggested requesting all the data at once. This seems to cause an issue for some users. Read this section carefully.

 

3.7.1 - Select A Guild

 

When you first log in there won’t be much as far as guild history loaded in memory.

 

show_more

 

In order to manually request sales data you have to choose a guild and select All, not purchases. Then press E about every 3 seconds so you are not kicked from the game by the server.

 

3.7.2 - Request one day at a time

 

one_day_of_data

 

Look at the above image and use the right scroll bar to see when you have requested one day of data. Busier guilds with more data will have more sales per day. To keep from processing too much at once request one day at a time and click the Rescan button.

 

3.7.3 - Rescan Button

 

ten_day_scan_refresh

 

If you are familiar with MM 2.5.x the Rescan button is the equivalent of the old /mm missing. When you click Rescan LibHistoire will scan all the data loaded into memory so far and skip any duplicate events already saved in its data cache.

 

3.7.4 - When E is no longer showing

 

show_more

 

Once you have scanned 10 days of sales then the option to press E will not be shown. The server will only allow you to request 10 days of data. Once you have done so click the Rescan Button to make sure LibHistoire processes all the events.

 

3.7.5 - LibHistoire GUI

 

histy_gui

 

As you perform a ten day scan the LibHistoire GUI will update. It might even finish processing a certain amount of events. Do not click the small chain link showing in this screen shot. That will link to the current events loaded which for your first initial use of LibHistoire you do not want that to happen. You should only click the Rescan Button if you see it to ensure all events are scanned.

 

Scanning 10 days of history every few days or every week is pointless and a drain on the server.

 

3.8 - Update Your Guild History Each Day

 

histy_gui

 

Regardless of how long you have been offline you need to update your guild history. To obtain older sales data for any time you have been offline you can wait for the server to send the data to LibHistoire. How quickly the server provides the data depends on many things. Because of that I do not wait. I manually scan the guild history from the guild history tab by pressing E for Show More.

 

After I have enough guild history to cover the time I have been offline then I use the rescan button which asks LibHistoire to double check the sales loaded in memory are in the cache. Once LibHistoire has verified the sales data the text will turn green indicating that the sales events are linked.

 

3.9 - Unlinked Events Notification

 

With LibHistoire 1.2.0 there is a new notification when you log off.

 

log_off_notification

 

You could have any amount of time that has not been linked with your Guild History Events. If you chose to log off that is fine but pay close attention to the notification. Any gap in information will still be there when you log back in and you will have to start over. Refer to Resolving Unlinked Events and Update Your Guild History Each Day for more information.

 

If you open the Guild History have more then 10 days of missing events you will need to complete a Ten Day Scan.

 

3.10 - Resolving Unlinked Events

 

unlinked_sales

 

The above screen shot indicates that there is 28 days and 19 hours worth of missing time from unlinked events. When this happens you can only fix it by doing a Ten Day Scan.

 

To start request one day of data as shown in the screen shot for Request only a few days at a time. After you see one day of data then click the small chain link above sales as shown below.

 

chain_link

 

After you click the chain link then you will be given a confirmation screen and you will want to click Confirm or press E to confirm the action.

 

confirm_forcing
Since the server only stores 10 days of data, you will not be able to retrieve sales more then 10 days old.

 

Once the chain link is clicked LibHistoire will begin processing sales for the time you have loaded into memory. If you have done as suggested, it will process about 1 days worth of sales.

 

Then repeat the process mentioned in the Ten Day Scan by requesting a day or two of data and then click the small Rescan Button. Once the process is complete then remember to Update Your Guild History Each Day so this doesn't happen again.

 

This can happen in any guild however, this will occur in guilds with a high volume of sales per day more easily then in a guild with smaller amounts of sales.

 

3.11 - Master Merchant Window

 

mm_window

 

search_box Search Box

people_icon Cycles through: Seller, All sales totals by Seller. Item Sold, Top selling ITEMS. Buyer, All purchase totals by Buyer.

open_statistics_window Opens the Statistics Window.

toggle_seller_item Seller Info Guild Ranks, Item Info Your Info or All Info.

sales_icon Sales view shows Personal Sales or Guild Sales. Use the Seller Info/Guild Ranks toggle to change views from Item Report to Sellers Report.

shopping_list The Shopping List icon allows you to view purchases you have made from guild stores.

bonanza_icon The Bonanza icon allows you view trader listings you have seen at other guild stores.

reports_icon The Management view lets you see posted and canceled sales.

mail_icon Sends mail to the author with an optional donation amount.

money_bag The Moneybag icon means the purchaser is not a member of that guild.

 

Item Sold is only available from a Seller's Report.

Donations should be voluntary. People that struggle to make 25K gold a week, feel free to just say thanks. I'd rather receive a 50K donation from top sellers making millions a week.

 

3.11.1 - Guild Sales and Personal Sales

 

show_your_info show_all_info

 

First select what information you would like to see. Show Personal Sales will display info ONLY about You. Show Guild Sales will display data from all members of all of your guilds.

 

When the button says Show Guild Sales, that means you are currently viewing YOUR information and vice-versa. You can toggle back and forth between Personal Sales and Guild Sales while viewing any report.

 

3.11.2 - Item Report

 

item_report

 

If you have ever opened the Master Merchant window you have probably seen the list of your personal sales. This is an Item Report and if you click the People Icon you will change between the Buyer and the Seller.

 

3.11.2.1 - What The Columns Mean

 

•  Buyer: The purchaser of the item.

•  Guild: The guild associated with the sale of the item.

•  Item Sold: To the left of the Item Sold is the items icon. The number indicates how many of that item was sold.

•  Sale Time: The approximate time the item was sold. The game stores all sales using epoch time so the UI just approximates the sale after the first hour.

•  Price: The price the item sold for. You can view the individual price by clicking the Show Unit Price button.

 

show_unit_price Toggle between the Unit Price and Total Sale.

 

3.11.3 - Seller's Report

 

3.11.3.1 - Top Buyers and Sellers

 

sellers_report_people

 

3.11.3.2 - Top Items

 

sellers_report_items

 

3.11.3.3 - Personal Sales - Seller's Report

 

sellers_report_personal

 

You can also view a Seller's Report for your personal sales only the items will be YOUR top selling items.

Clicking the People Icon will cycle through Seller, Buyer, and Item Sold.

 

3.11.3.4 - What The Columns Mean

 

•  Rank: The rank of the member or item for the guild listed. For example, if you are viewing a seller's report and your rank is 7, it means you are the 7th biggest seller in the guild for the time selected. If you are viewing an item report for and Dreugh Wax is the 1st item in the list, then Dreugh Wax is the biggest seller for the guild showing.

•  Sales/Purchases: Total Sales or Purchases for that guild or member for the time selected.

•  Tax: Total Tax generated for that guild or member for the time selected.

•  Count: The number on the left is the number of transactions, while the number on the right is the number of items. For example @TradingDude had 10 Dreugh Wax transactions and sold 100 Dreugh wax total.

•  Percent: This shows what percent of total guild sales or purchases each member is responsible for.

 

3.11.4 - Guild Sales Date Filter Ranges

 

time_frames

 

•  Default: Default uses the amount of days for Default set in Calculation Display Options. However, if you open the Master Merchant window while holding a Focus key such as SHIFT, CTRL or both, then opening the window will use the amount of days you set for that Focus.

•  30 Days: 30 Days.

•  30-60 Days: 30 to 60 Days.

•  60-90 Days: 60 to 90 Days.

•  Custom: Custom uses the amount of days set in MasterMerchantWindowOptions

 

3.11.5 - Date Ranges

 

time_frames

 

There are several date ranges you can choose from. This Week, Last Week and Prior Week start from the ZOS trader flip for the current Sales Week. However, the last option is customizable under the Master Merchant settings under Calculation Display Options.

 

3.12 - Statistics Window

 

statistics_window

 

3.13 - Settings

 

3.13.1 - Master Merchant

 

3.13.1.1 - Master Merchant Window Options

 

main_wondow_options

 

•  Open With Mail: Whether or not to open the Master Merchant Window when you open your mail.

•  Open With Store: Whether or not to open the Master Merchant Window when you interact with a guild store.

•  Show Full Sale Price: Show the full price of the sale rather then the amount after the store cut is deducted.

•  Window Font: The font for the Master Merchant Window. You may have other fonts if you have mods that use LibMediaProvider like one of my other mods Advanced Nameplates.

•  Custom Filter Timeframe: The amount of days to use for the Custom dropdown for the Guild Sales Date Filter Ranges

 

If you sold a Crafting Motif 63: Dremora Bows for 11,000 currency_gold the master merchant window will show what you received in the mail which would be 10,230 currency_gold .

 

3.13.1.2 - Time Format Options

 

time_format_options

 

3.13.1.3 - Alert Options

 

alert_options

 

•  On-Screen Alerts: Show On-Screen popup alerts when you receive a sale. See examples below.

•  Show Alerts in Cyrodiil: Enable or Disable Alerts in Cyrodiil. Useful if you watch for specific PVP alerts and do not want MM Alerts to show up.

•  Chat Alerts: Show chat alerts when you receive a sale. See examples below.

•  Alert Sound: Choose the Alert sound to differentiate it from other mod added Alerts.

•  Show Multiple Alerts: Investigating

•  Offline Sales Report: Show Alerts for sales received while offline. See note.

•  Display Listing Message: Show chat alert when you list an item for sale.

 

Show Multiple Alerts and Offline Sales Report may not function as intended with the addition of LibHistoire. However, you will still see notifications of sales as they are received.

 

3.13.1.4 - On-Screen and Chat Alert

 

onscreen_alert

chat_alert

 

3.13.1.5 - Calculation Display Options

 

tool_tip_settings

 

WARNING: All sales have already been sorted by the Custom Timeframe at startup. See documentation for more information.

 

Custom Timeframe requires a reload because all of the sales have been placed into all the date ranges as shown in Date Ranges and therefore changing the value means that all the sales would have to be calculated again. This process is difficult to begin with so to avoid any miscalculations (attempting to clear all sales and stats variables) a reload is required.

 

3.13.1.6 - Guild & Account filter

 

add_seller_to_filter

 

Right click the dots on the graph to add the Seller to the Guild & Account filter.

 

There is a limit of 2000 characters for the filter. You will need to manage it from time to time.

 

ags_menu_filter

 

You can add the Guild or Seller to the Guild & Account filter from the trader menu with either vanilla or Awesome Guild Store installed.

 

filter_from_bonanza

 

You can add the Seller to the Guild & Account filter from the Bonanza window.

 

vanilla_trader_seller

 

The Seller is located on the tooltip if you do not have Awesome Guild Store installed.

 

3.13.1.7 - Deal Calculator Options

 

custom_deal_calc

 

•  Deal Calculator Type: Choose from MM Average, TTC Average, TTC Suggested, and the Bonanza Price.

•  Modify TTC Suggested Price by 25 percent: When enabled will add 25 percent to the Suggested Price used for the Deal Calculator and the ToolTip. This is the same value as shown in the TTC Tooltip. See the Modified Suggested Price spoiler below for an example.

 

There is no function to check if you set an incorrect value or not. Meaning if Okay Deal Range is 25 percent and the Reasonable Deal Range is 20 percent, nothing will tell you that's not going to work. You will need to keep the values in order yourself from lowest to highest.

 

example_ttc_suggested

 

3.13.1.8 - Other Tooltip Options

 

other_tooltip_options

tool_tip_examples
Tool Tip Examples

 

•  Level/Quality Selectors: Adds Level and Quality selectors to the tooltip window. You can bring up the window by clicking a link in chat or when you right click an item and choose Popup Item Data. See the Level Quality Selectors section for example of the selectors that appear on the tooltip window.

 

3.13.1.9 - Price To Chat Options

 

price_to_chat

 

3.13.1.10 - Inventory Options

 

inventory_options

 

•  Modify TTC Suggested Price by 25 percent: When enabled will add 25 percent to the Suggested Price shown in the inventory. This is the same value as shown in the TTC Tooltip. See the Modified Suggested Price spoiler above for an example.

 

3.13.1.11 - Guild Store Options

 

guild_store_options

mm_price_calculator
Price Calculator when not using AGS.

ags_profit_filter
AGS Profit filter.

ags_profit_margin
Profit margin.

ags_display_profit
Your Profit.

 

•  Show Stack Price Calculator: Adds UI to the guild store if you are not using Awesome Guild Store that aids you in setting the stack price of the item listed

•  Save Central Pricing Data: When Enabled all pricing data is stored and available to all guilds. When Disabled all pricing data is stored separate for each guild.

•  Display Profit Filter: Adds the Profit to the Time column for the guild store.

•  Display profit instead of margin: Enabled shows the profit value in gold pieces, and disabled shows a percentage.

 

The Price Calculator will not show up with Awesome Guild Store. The Profit Filter is AGS only. Adding the profit margin or the total profit will be shown with or without AGS.

Awesome Guild Store uses its own internal pricing routines and only uses the MM Pricing Data when there is not AGS information. Because of that it may appear that the MM pricing data is malfunctioning when it isn't.

 

3.13.1.12 - Guild Master Options

 

guild_master_options

 

3.13.1.13 - MM Debug Options

 

debug_options

 

•  Disable ATT Warning: If you enjoy using both MM and ATT together then please disable the warning that ATT files are active with this toggle.

 

3.13.2 - LibGuildStore

 

3.13.2.1 - Sales Management Options

 

lgs_sales_management

 

•  Use Sales History Size Only: This will ignore the minimum and maximum count for sales. If there are 4698 sales of an item with the day range selected for retaining data, then the sales will not be trimmed.

•  Sales History Size: The days range to retain data.

•  Min Item Count: The minimum count of sales for a specific item before the days range is considered. If you select 90 days to retain data, but you have seen only 1 sale and the only recorded sale is 120 days old it will not be trimmed.

•  Max Item Count: The maximum count of sales for a specific item before the days range is considered. If you select 90 days to retain data, and you choose 1000, then the oldest sale once the threshold is reached will be trimmed. Meaning if you have 1001 sales for an item, 1 will be trimmed and 1000 will remain.

•  Minimal Indexing: Does not add search words for items. It only adds the player search word for displaying personal sales. Searching in the Master merchant window is still possible but will take extra time.

 

3.13.2.2 - Data Management Options

 

lgs_data_management

 

3.13.2.3 - LGS Debug Options

 

lgs_debug_options

 

3.13.2.4 - Import MM Data

 

import_mm_data

 

3.13.2.5 - Import ATT Data

 

import_att_data

 

3.13.2.6 - Import ATT Purchases

 

import_att_purchaces

 

3.13.2.7 - Refresh LibHistoire

 

refresh_libhistoire

 

The Refresh button tells LibHistoire to send all the data it has in its cache. The more data in the cache, the longer it will take to transmit.

 

The refresh button is only a fail safe mechanism in case a user performs the initial Ten Day scan incorrectly and the data is not sent to MM for some reason. It should not be clicked every so often or every once and a while. Clicking this does not refresh the Master Merchant window or cause the server to send any Guild History.

 

3.13.2.8 - Import ShoppingList Data

 

import_shoppinglist_list

 

3.13.2.9 - Import Pricing Data

 

import_pricing_data

 

3.13.2.10 - Reset Data

 

reset_data

 

3.14 - Misc

 

3.14.1 - Popup Item Data

 

popup_item_data

 

This context menu is from having Master merchant and Awesome Guild Store installed. The menu will vary depending on the mods you have installed.

 

3.14.2 - Level Quality Selectors

 

I will try to update the selector so that there are graphics to click on but for now it is just text.

 

The images below show a Hat of a Mother's Sorrow and the Legendary version does not have buttons on the right because there is no Mythic version. The Epic version has selectors on both the left and right to view the Superior or the Legendary version.

 

While the selectors do not seem to be dependant on the sales in your Master Merchant Data, there may be unknown factors that prevent the selector from showing. The code is extremely old and dates back to the introduction of the Champion Points system.

 

Hat of a Mother's Sorrow

ms_legendary

 

Hat of a Mother's Sorrow

ms_epic

 

3.14.3 - Erroneous timestamp

 

When you see an erroneous timestamp, LibHistoire will handle this internally. It will not be processed until the timestamp is updated properly by the server.

 

1657months

71582789minutes

 

LibHistoire will send the sale to MM after it checks that the erroneous timestamp is no longer present.

 

3.14.4 - What is being scanned

 

When LibHistoire is scanning the guild history it is obtaining the sales from all the guild history that you have loaded into memory.

 

3.14.4.1 - A few days of sales from 109 entries

 

shot_history

 

LibHistoire simply scan entries from the guild history. With another mod installed called Shissu's Guild Tools a count of the amount of entries is showing. As shown there are 109 entries which only covers a few minutes of sales.

 

3.14.4.2 - 4 days of sales from 8031 entries

 

shot_history

 

However, as shown in the above screen shot there are 8031 entries which covers 4 days of sales. If you feel you are missing sales from 7 days ago then you will need more sales showing on the guild history tab.

 

3.14.5 - Sales Week

 

As of August 11 2020 the kiosk flip is now every Tuesday. All sales totals are calculated from the time indicated by ZOS.

 

You should not try to calculate your sales yourself. Each sale is saved with the exact time stamp the sale occurred. All sales even a few seconds prior to the kiosk flip would not show if you selected to see sales from This Week.

 

On the day of the kiosk flip sales for This Week will only reset after Zenimax transmits the new kiosk flip time. This can occur several hours after the kiosk flip.

 

3.15 - Slash commands

 

3.15.1 - Export Sales Report

 

mm_export_screen

 

Master Merchant can export a general summary of sales for use with spreadsheets. Full disclosure I am not a spreadsheet guru so I can not help with this feature. To use the export feature choose a guild to work with, then select the time and range like This Week or Last Week. Then use /mm export # to export the guild's information. As an example the screen shot shows a 2 for the 2nd guild in your list, therefore the syntax would be /mm export 2.

 

Once exported the data is saved in MasterMerchant.lua in your SavedVariables folder.

 

Without Taxes:

["EXPORT"] = 
{
["version"] = 1,
["YourGuildName"] = 
{
[1] = "@GuildMember&Sales&Purchaces&Rank",
},

 

With Taxes:

["EXPORT"] = 
{
["version"] = 1,
["YourGuildName"] = 
{
[1] = "@GuildMember&Sales&Purchaces&Taxes&Rank",
},

 

Taxes is new as of 3.2.7 and you toggle the feature on in addon settings.

 

Since I have never used this feature with a spreadsheet I do not know how easy that is to use as Lua saves it. You may need to copy and paste it into another text file and use regular expressions to clean that up.

 

Some of my GMs have explained if this format changed it would break what they currently use so it will not be altered.

 

3.15.2 - Export Sales Activity

 

export_sales

 

You would use /mm sales # to export the sales activity. As an example the screen shot shows a 2 for the 2nd guild in your list, therefore the syntax would be /mm sales 2.

 

Once exported the data is saved in MasterMerchant.lua in your SavedVariables folder.

 

["SALES"] = 
{
["version"] = 1,
["YourGuildName"] = 
{
[1] = "@Ashjunkie&@Lcs_Flores&|H0:item:46129:30:1:0:0:0:0:0:0:0:0:0:0:0:0:0:0:0:0:0:0|h|h&200&1630085615&false&4000&Real Guild Best Guild&Quicksilver Ingot&rr01 white normal materials",
},

 

3.16 - Technical Information

 

3.16.1 - Backup LibGuildStore Data

 

lgs_data_backup

 

To backup your LibGuildStore data you will need to navigate to the SavedVariables folder. Usually C:\Users\Your User Name\Documents\Elder Scrolls Online\live. The files can be easily found going to MyDocuments in windows first.

 

I am sorry I don't know where it is located on a Mac.

 

Once you are in the SavedVariables folders, you will need to copy the 18 GSxxData files named GS00Data.lua to GS17Data.lua as shown in the screen shot. Copy these to a separate folder outside of SavedVariables and do not place them in a subfolder under SavedVariables. You will also want to keep a copy of LibGuildStore.lua, LibHistoire.lua, and MasterMerchant.lua.

 

3.16.2 - Uninstall Master Merchant 2.x

 

Currently there is some confusion about how to uninstall Master merchant 2.x and install 3.x. First you need to open minion. If you see both versions installed as shown below, uninstall both. The reason you uninstall both is because MM 3.x is a continuation of 2.x. It is the same mod with the same file names and the same folder names. Minion will not understand how to handle this.

 

both_mm_installed

 

If you manually install your mods, of if you want to know which folders belong to Master merchant, click the spoiler.

 

mm_files_installed
To see a larger image, right click the image and choose View Image.

 

mm_remove_mod

 

When using Minion to uninstall Master Merchant right click and choose Uninstall.

 

mm_remove_mod_caution

 

Do not check that box or it will remove your MM data files! Only click Delete!

 

mm_uninstalled

 

As you see above, both versions of Master merchant are now uninstalled.

 

You have to close Minion because it will be confused about uninstalling both versions.

 

search_for_mm

 

Open Minion again and click Find More and search for Master Merchant 3.0 as shown above. Make sure the author's name is Sharlikran. Then click the Install button.

 

As noted on the description page you need to install LibAddonMenu, LibMediaProvider, LibGuildRoster, and LibHistoire.

 

I won't be showing how to install all the required libraries. If you need examples images of the two new libraries LibGuildRoster, and LibHistoire click the spoiler.

 

install_LibGuildRoster
To see a larger image, right click the image and choose View Image.

 

install_LibHistoire
To see a larger image, right click the image and choose View Image.

 

one_mm_only

 

After you install Master Merchant 3.0 verify it is the only Master Merchant showing in Minion.

 

3.16.3 - Locating LibExecutionQueue

 

LibExecutionQueue is included with Master Merchant as shown in the zip below.

 

leq_included

 

LibExecutionQueue is sorted alphabetically by the base game.

 

leq_unsorted

 

If you have LibVotansAddonList installed then it will look close to the base game.

 

leq_votans_sort

 

3.16.4 - Unintentional ZOS Bug

 

savedvarsapostrophe

 

Unfortunately from time to time ZOS introduces or reintroduces a bug in the saved vars where the apostrophe is converted to HTML code. Which will mean your sales may or may not display properly. Which is a game bug and you are out of luck until or unless they fix it.

 

Since this can occur I highly recommend changing your user name to only contain letters as it will make it easier for you in the long run.

 

This also includes creative names that contain things like Æ or æ. As those are not individual letters.

 

3.17 - Alternate Upgrade Method

 

Thanks to Shadowshire for sharing this workaround. While I did alter most of the steps I wanted to preserve his suggestion because it could provide a good alternative to importing LibHistoire data for those experiencing issues.

 

This alternate method will primarily use data from the old Master Merchant Data files located in SavedVariables as shown in the depreciated section, Backup Master Merchant Data.

 

It is recommended that only Master Merchant 3.7.x, ShoppingList (older standalone version), the original MMxxData modules, LibGuildStore, all GSxxData modules, and the required library files for Master Merchant are enabled to avoid potential interference while this procedure is performed.

 

It is recommended to store any backup copies of Master Merchant data outside of SavedVariables in its own folder. For example .\Documents\Elder Scrolls Online\live\Backups\MM_Backup_01

 

3.17.1 - Optional Mods For This Procedure

•  Circonians Addon Selector

 

Circonians Addon Selector will allow you to save your current active mods before performing this procedure.

 

3.17.2 - Optional Debug Settings

 

The sticky post for Master Merchant 3.0 mentions some slash commands for LibDebugLogger. When these settings are changed this helps provide additional debug information in the event of any errors. Only use these slash commands as a precaution if you have been having issues upgrading.

 

/debuglogger stack on
/debuglogger level debug

 

You should see a confirmation of each command in the chat window. For users with chat mods installed check your mods settings. System might be redirected to other tabs such as Zone chat.

 

3.17.3 - The Procedure

 

During this procedure Master Merchant will check for duplicate sales. Please remember it is recommended that you exit the game before you install any add-on or alter the SavedVariables folder.

 

Version 3.7.x will not alter the previous MMxxData files or any purchase data for the older standalone ShoppingList module. If you are concerned about loosing any data then please backup your MM file as shown under Backup Master Merchant Data. Purchase data for the standalone ShoppingList module is located in the same folder as the Master Merchant data files in SavedVariables under the name ShoppingList.lua.

 

Remove the data file LibHistoire.lua from the SavedVariables folder. If you did not make a backup it is recommended you move the file to another location where you can find it. Depending on the results of this procedure you may want to restore it even though the primary focus is to use the older MMxxData files.

 

Verify you have the most recent version of Master Merchant 3.0 installed.

 

Log in and from the character selection screen click the dropdown for All Characters. Choose a character from the dropdown. This will be the character you log into when performing the procedure. Uncheck all the mods except what is shown in the section Which modules do I need to activate for MM 3.7.x

 

If you have Circonians Addon Selector installed you will be able to enable all your preferred mods after all your data is imported.

 

After you log in and the user interface is shown, you should see Chat messages displayed by LibGuildStore and by Master Merchant, followed by one or more of the message "LibGuildStore Refresh Not Finished Yet". Wait for until you see Master Merchant Initialized and the total Sales, Purchases, Listings, and Posted and Canceled items that are being retained.

 

Press ESC and go to Settings then LibGuildStore to verify that the Sales Management Options are configured to meet your personal preferences.

 

Further down under LibGuildStore settings is a button to Import MM Data click it and wait for the data to be imported.

 

Version 3.7.x was released on 09/03/21 you will not have any sales newer then Sep 3rd and because of that you will need to perform a Ten Day Scan. When complete you will have all the MM data that existed up until 09/03/21 and then all the sales for the last 10 days. All the data from the Ten Day Scan will be saved in LibHistoire. As long as you Update Your Guild History Each Day you will begin to accumulate data the same as you did with 3.5.x.

 

At this point you can also Import ATT Data if that is available to you.

 

You will also want to Import Pricing Data and Import ShoppingList Data as well.

 

If you chose to use the debuglogger slash commands and you did not encounter any errors then it is recommended that you type into chat /debuglogger level info to avoid having unneeded debug messages from mods that use LibDebugLogger to output detailed debug messages. These detailed debug messages are not needed during normal operation.

 

At this point you will have to log out to the character screen and enable your preferred mods or use Circonians Addon Selector and restore the saved package of add-ons that you normally use.

 

If they are enabled, then disable the add-on ShoppingList, and each of the Master Merchant Data File MM00Data through Master Merchant Data File MM16Data files in the Libraries section to decrease load times

 

This will leave you with a gap in your sales from 09/03/21 until now. If that gap is too much for you then you can try to import your old LibHistoire information. To do that you will need to exit the game, backup your LibGuildStore data and your current LibHistoire data. Once you restore the copy of your old LibHistoire data that you moved to a safe place attempt to Refresh LibHistoire again. If you do not have better results then exit the game, restore your LibGuildStore and LibHistoire backups and you won't be able to use the old LibHistoire data.

 

3.17.4 - Version History

 

Apparently for version 2.2.0 there was an experimental turbo mode added to MM. From the change log it appears that this was removed by request from Zenimax. However, even I noticed when you tried to download 2.2.1 which had turbo mode removed, you received a file named Master Merchant 2.2.0.zip. If you tried to engage turbo mode it was still available even if it didn't work as expected.

 

Aug 01 2020 after the kiosk flip was announced Philgo68 posted that he would be uploading a new version, which would be 2.3.1. From the start it had a small bug in it that prevented it from working. Then after that was fixed people started reporting that the Master Merchant window would not update when you were viewing your personal sales but that all guild sales was still updating properly.

 

Upon examination of the code 2.3.1 had turbo mode removed which was not really removed in 2.2.1 (2.2.0). In addition to that on the description page it was mentioned that there was Simple Indexing and Simple Scanning. Oddly those options included new options in the Addons menu to toggle the features on and off. These options were not present in 2.2.1.

 

This makes me believe that 2.3.1 was really intended to be the proposed 2.2.1 but somehow the upload never went through properly. I am glad Philgo68 uploaded the version as it has helped me understand the code a bit more.

 

3.18 - Depreciated

 

3.18.1 - Backup Master Merchant Data

 

mm_data_backup

 

To backup your Master Merchant data you will need to navigate to the SavedVariables folder. Usually C:\Users\Your User Name\Documents\Elder Scrolls Online\live. The files can be easily found going to MyDocuments in windows first.

 

I am sorry I don't know where it is located on a Mac.

 

Once you are in the SavedVariables folders, you will need to copy the 17 MMxxData files named MM00Data.lua to MM16Data.lua as shown in the screen shot. Copy these to a separate folder outside of SavedVariables and do not place them in a subfolder under SavedVariables.

 

3.18.2 - Background Scanning

 

As of version 3.0.0 there is no /mm missing and no background scan. The background scan would get hung up by repeated attempts to request more sales data from the server. When the server denied the request MM would continue to wait for the request to be approved.

 

After starting a new library LibGuildHistoryCache I observed that the cache mod would see some new sales. Usually there were only a few sales maybe 1 or 2 and occasionally less then 10. The cache mod would update showing that the guild history events were not duplicates but MM would not see them as new sales.

 

One other calculation made was to try and get the first entry in the guild history and the last. This was used to attempt to determine whether or not to scan from the start of the guild history array, or the end. Whether or not you have 1, 100, or more then 1000 events the first event will always be the same. All guild history events are appended onto the end of the list.

 

For reasons like these MM no longer uses a background scan as it attempted to scan from a specific point in time and loop over the guild history events.

 

3.19 - Authors

 

Philgo68, Khaibit, dOpiate, sirinsidiator, Garkin, Aldanga, Sharlikran, Dolgubon

 

3.20 - Translators

 

mychaelo, svenpanne, tomkolp, mlsevero, Baertram, jupiter126, Otxics, Jakez