IceFreez3r / marketplace-tracker

Firefox extension to track the Idlescape marketplace
3 stars 0 forks source link
firefox-extension idlescape userscript

Marketplace Tracker

An Idlescape extension

Automatically tracks the marketprices for Idlescape using the market API. Prices are analyzed and displayed at various places in the game.

Installation Options

Install the Firefox Extension from Mozillas Addon Store or

Install Tampermonkey for your browser (Firefox, Chrome, Opera) and then install the Userscript.

The userscript is mobile compatible. If you have a browser on your phone, that supports userscripts, you can use it there as well. I use Firefox for Android with Tampermonkey. Just note that the extension is not optimized for mobile use and the UI might look a bit weird at some places.

Modules

Marketplace

On the buy tab items are highlighted based on the quantile of their price.

Marketplace Buy

Highlights

Adds the option to mark items as favorite, which highlights them in the market overview and lets you filter for them with a single button click. Furthermore the heat item with the current best gold/heat ratio is also highlighted in the overview.

Marketplace Overview

Adds a toggle to show the quantile of prices for items in the overview, such that it is instantly visible, if an item is cheap or expensive at the moment.

Marketplace Overview Quantile

Popups

The total profit from offline progress, opened chests, dungeon loot, shared chests, ...

Adds up the value of all the items and displays total and (where applicable) per hour information.

Offline Tracker

This also works with the Resource Tracker from ISscripts.

Alerts

Allows to define lower and upper limits for the price of items and sends desktop notifications when the price is within the defined range.

Alert Tracker

Crafting

Shows the cost for buying all ingredients for a recipe compared to the cost of buying the crafted item directly. Also calculates the amount of gold you would need per XP when crafting the selected item.

Crafting Tracker

Enchanting

Shows the cost for buying all ingredients for crafting a scroll compared to the cost of buying the scroll directly.

Enchanting Tracker

Smithing

Same thing once again.

Smithing Tracker

Runecrafting

Same thing once again. Also works for cloth.

Runecrafting Tracker

Settings menu

All shown modules can be activated and deactivated through an additional settings menu. You can access it from the sidebar.

Sidebar button

Most of the modules come with their own settings.Just as an example you can decide how profits are displayed in each module or deactivate them all together. (Profits always already include the market fee. No need to bring a calculator.)

Settings Menu

Changes are applied instantly without a required reload.

You can also export and import settings and market data here. This is useful if you want to share your settings with others or if you want to use the extension on multiple devices.

Other

Note that API prices are always at least 10 minutes outdated due to how the API works. The extension doesn't sync it's API requests with the updates of the API, meaning longer times are possible.

When ever the minimum or maximum price is shown, it is actually the 5%/95% quantile of the collected data. This step is done to reduce the impact of outliers. Otherwise a direct player trade with a price of only 1 gold, that manages to get into the API data, would make all computations pretty useless.

The data is stored on your computer in the localStorage of the browser. There is no exchange of data with any server. The data is compressed (by about 99%) such that it doesn't hit the local storage quota.

API calls are only stored for two weeks, to make sure, that the data of the extension isn't outdated.

Planned Features

(without any particular order)

Contact

If you have any questions, suggestions or comments, please open an issue on GitHub or contact IceFreez3r, Z3krom991 or Pinguinflieger through the official Idlescape Discord. If you are a developer and want to contribute, please look into the contribution guide.