Skip to content

Add Mystix Plugin#10956

Merged
pajlada merged 15 commits into
runelite:masterfrom
Dmurph24:plugin/mystix
Apr 9, 2026
Merged

Add Mystix Plugin#10956
pajlada merged 15 commits into
runelite:masterfrom
Dmurph24:plugin/mystix

Conversation

@Dmurph24
Copy link
Copy Markdown
Contributor

@Dmurph24 Dmurph24 commented Mar 9, 2026

Summary

Mystix syncs your RuneLite gameplay data to a companion mobile app, delivering push notifications and stat tracking to your phone.

What the plugin does

  • Time Tracking sync — Sends farming patch and bird house timer timestamps to the Mystix server, which schedules push notifications when timers complete (e.g., herb patch ready to harvest)
  • Gear & Items sync — Sends equipped items and inventory to the Mystix server
  • Loot Tracking sync — Send looted items and kill counts of NPCs to the Mystix server

All syncing is user-initiated, controlled by per-feature toggles, and requires an App Key generated in the Mystix app. No data is sent without a valid key configured. Mystix does not add any visual changes or change functionality to the RuneLite client aside from exporting data.

File Structure

  • The farmer, birdhouse tracking logic was not implemented as a public method in the main RuneLite repo. I reached out to geheur about this, and he recommend the best path forward is to copy over the libraries from RuneLite timers as my own. This is unfortunate, but the alternative was to submit a PR for making the RL timer methods public myself. Geheur said that option would be unrealistic to get approved. So everything in the src/main/java/com/mystix/runelite folder is not custom. I was told this is what other plugins needed to do to get around this timer public method issue.
  • Other than the farming timers, I built 1 monitor service for each of the data types that need to be synced to the Mystix server. They reuse logic when possible and are meant to be module and fairly each to review.
  • Model files correlate to the payloads that get sent to the Mystix server

Getting the app

  • iOS: Install via TestFlight: https://testflight.apple.com/join/mGc4jcXW (will be available soon - apple is reviewing actively)
  • Android: Requires your email added to the beta tester list. If you're a reviewer and would like access, leave a comment and I'll add you.

Setup

  1. Install the Mystix plugin from the Plugin Hub
  2. Open the Mystix app and get your App Key
  3. In RuneLite, go to Configuration > Mystix and paste your App Key

Privacy

For details on what data is collected and stored, see our Privacy Policy.

App Screenshots

IMG_6323 IMG_6327

@runelite-github-app
Copy link
Copy Markdown

runelite-github-app Bot commented Mar 9, 2026

@runelite-github-app
Copy link
Copy Markdown

runelite-github-app Bot commented Mar 9, 2026

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

@Dmurph24 Dmurph24 changed the title New Plugin: Mystix - Companion app sync for timers and skills Add Mystix Plugin Mar 12, 2026
@Dmurph24
Copy link
Copy Markdown
Contributor Author

Chatted with @pajlada and did a brief self-review to fix the following issues:

  • Fixed reflection issue in the LootMonitor.java
  • Switched to use OkHttp instead of HttpClient
  • Removed a few more unrelated files and moved around package.json and other like files to /scripts

@pajlada pajlada self-assigned this Apr 8, 2026
@pajlada pajlada merged commit 8689a01 into runelite:master Apr 9, 2026
2 of 3 checks passed
Infinitay pushed a commit to Infinitay/plugin-hub that referenced this pull request Apr 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants