Add QuantScapers OSRS Economy Toolset

[tjessberger]

Summary

QuantScapers is an in-client OSRS Economy Toolset for players who want to understand Grand Exchange conditions before making their own decisions.

Rather than focusing on a single flip list, QuantScapers combines market awareness, opportunity scanning, item research, risk checks, and personal tracking in one RuneLite sidebar:

• Market Overview: highlights meaningful 24-hour gainers, losers, and actively traded items while filtering out thin-volume noise.
• Flip Scanner: ranks candidates using after-tax profit, ROI, volume, estimated fill time, price freshness, and budget filters.
• Alch Scanner: evaluates high-alchemy opportunities using current item and nature-rune prices, including profit, ROI, and estimated GP per hour.
• Item Research: provides current prices, volume context, trade tickets, freshness indicators, and plain-language BUY, DECENT, RISKY, or AVOID verdicts.
• Deep-Probe Audits: checks hourly price history for sell-price hit rate and seven-day margin stability.
• Local Watchlist: lets players save up to 25 items, compare current prices with saved values, and reuse completed audits.

The differentiation is the complete decision-support workflow: discover what is moving, scan for a use case, investigate the item, check execution risk, and track it locally without leaving RuneLite. QuantScapers does not promise profits or replace player judgment.

Player safety and privacy

• No Grand Exchange automation: the plugin never places, edits, or cancels an offer.
• No account, paywall, telemetry, cloud sync, player-data collection, or QuantScapers backend connection.
• Watchlist data, audit results, and settings remain local in RuneLite.
• Website and X links open in the player's browser only when clicked.
• Trade tickets are guidance for manual entry; copy actions use the local clipboard only.

Network usage

The plugin connects only to the OSRS Wiki Real-time Prices API at https://prices.runescape.wiki/api/v1/osrs.

• No price request is made until the player supplies a valid contact email.
• Every request includes that email in the User-Agent for API identification.
• While the panel is open, the scheduled market snapshot refreshes every 30 seconds and pauses when the panel is closed.
• The item mapping is cached for 24 hours and the five-minute market feed is cached for 60 seconds.
• Tab changes, searches, filters, the Overview, and the Watchlist reuse the scheduled snapshot rather than triggering additional price requests.
• Automatic timeseries audits are capped at three calls per 30 minutes.
• User-requested manual audits are capped at ten calls per 10 minutes, and completed results are cached locally for reuse.

Testing

• Unit and integration tests: ./gradlew test
• Local RuneLite UI testing completed by the plugin owner before the final pin.

[runelite-github-app]

New plugin quantscapers: https://github.com/tjessberger/quantscapers-runelite/tree/4ce06c8c455c9962f45af91f4865db216a1b4e06

[runelite-github-app]

This plugin requires a review from a Plugin Hub maintainer. The reviewer will request any additional changes if needed.

---

Internal use only: Reviewer details Maintainer details

[tjessberger]

Updated the pinned plugin version and submission description before maintainer review. QuantScapers has expanded from a flip-focused interface into an OSRS Economy Toolset with a market overview, Flip and Alch scanners, item research, Deep-Probe Audits, and a local Watchlist.

This update does not add network destinations, telemetry, accounts, or trade automation. It still uses only the OSRS Wiki Real-time Prices API with the existing contact-email User-Agent and request limits.