MonTally docsPokeMMO Integration
Set up MonTally's native PokeMMO integration, import tracker data, and understand real-time sync modes
PokeMMO Integration
MonTally includes a native PokeMMO integration designed to go beyond the traditional OCR workflow.
Instead of only reading the screen, MonTally can connect to PokeMMO directly and synchronize encounter data using the built-in tracker flow.
What This Integration Does
With the PokeMMO integration, MonTally can:
- detect when PokeMMO is running
- launch PokeMMO from inside MonTally
- connect a bundled tracker companion
- read current encounter tracker state
- import that state into the active profile
- continue following new encounters in real time
Recommended Setup
Use a PokeMMO profile for this workflow.
That keeps your PokeMMO data isolated from the default OCR-based tracker and makes game-specific options easier to manage.
How to Connect PokeMMO
- Open Settings
- Switch to a PokeMMO profile
- Click Connect PokeMMO
- Let MonTally launch or reconnect the game
- Enter the game and load your character
After the game finishes loading, MonTally should be able to read the tracker state.
Sync with PokeMMO
Once connected, you can use Sync with PokeMMO.
This imports your current PokeMMO tracker data into the active profile.
Use this when:
- you already have encounter counts in PokeMMO
- you want MonTally to continue from the current in-game state
- you do not want to restart the hunt from zero
Match PokeMMO in Real Time
MonTally includes a special option:
- Match PokeMMO in real time
When enabled:
- MonTally behaves as a mirror of PokeMMO tracker data
- manual edits, manual additions, and deletions are restricted
- the active profile becomes a live synced view instead of a freeform counter
Use this if your priority is strict parity with PokeMMO.
If you prefer importing once and then continuing with more freedom, keep mirror mode disabled.
Connection States
Inside Settings, the PokeMMO button can show different states:
- Connect PokeMMO No active connection has been detected yet
- Connecting PokeMMO... MonTally is launching or reconnecting the game
- Connected to PokeMMO MonTally detects the integration as active
If MonTally says it is connected but you still cannot sync:
- enter the game first
- wait until the in-game tracker data is available
- try syncing again
Requirements
For the integration to work properly:
- PokeMMO must be installed
- MonTally must be able to find the PokeMMO installation
- Java must be available, either from PokeMMO's bundled runtime or a valid system Java
Recommended Java Version
To avoid compatibility issues, the recommended fallback runtime for MonTally's PokeMMO integration is:
- Java 21 SDK
Official download:
- Oracle JDK 21 downloads: https://www.oracle.com/java/technologies/downloads/#java21
If you are on Windows, download the Windows x64 Installer from that page.
MonTally tries to resolve Java in this order:
- a dedicated configured Java path
- PokeMMO bundled runtime
JAVA_HOME- system Java on
PATH
So it is not literally “any Java”; it needs a Java runtime that can actually launch the PokeMMO client correctly. Old Java versions such as Java 8 are not sufficient for this workflow.
Current Encounter Import
The first sync is important because it establishes the baseline MonTally should use for that profile.
After importing:
- existing encounter counts are written into the profile
- the tracker baseline is stored
- future updates can be applied incrementally
That is how MonTally avoids restarting a hunt from zero.
Real-Time Updates
After the baseline exists, MonTally can continue to:
- poll tracker entries
- apply encounter deltas
- process special events such as shiny events
This is what makes the integration feel live instead of static.
Special Event Handling
MonTally can also react to special tracker events, including shiny-related updates.
Those events are processed separately from normal encounter entry updates so the profile stays consistent.
Troubleshooting PokeMMO Integration
MonTally cannot find PokeMMO
Usually caused by:
- non-standard installation path
- missing installation
- environment not pointing to the expected location
MonTally cannot launch PokeMMO
Usually caused by:
- missing bundled runtime
- missing or invalid Java
- a broken path to the PokeMMO installation
Connected but sync is unavailable
Usually caused by:
- the game has not fully loaded yet
- the character is not in-game yet
- the tracker has no current entries to read
The wrong profile is updating
Usually caused by:
- using the default profile instead of the PokeMMO profile
- auto-switching disabled when expecting automatic routing
Recommended Workflow
For the cleanest experience:
- create or use the PokeMMO profile
- connect PokeMMO from MonTally
- enter the game
- sync current encounters once
- decide whether you want:
- imported baseline plus normal MonTally continuation
- or full real-time mirror mode