FAQ
Quick answers; more in the README.
Will this get me banned / is it cheating?
It's a companion calculator, like a wiki you can hold next to the game. It doesn't change the game
or your save; it only reads. That said, no tool can *promise* how a developer feels; it reads local
files only and never touches the network while playing.
Does it modify my save file?
No, never. Save files are opened read-only, and live reads happen on a temporary copy. Pinned by
an automated test.
Does it need an internet connection?
No. The app has no network code: it does not phone home, upload saves, check for updates or show
ads, and it works fully offline. Your browser only opens when you click a link yourself, such as
the Report button in the About box.
Is the math actually correct? How is it verified?
Every formula comes from the game's own datamined code (SciresM's reverse engineering, cross
checked against wiki.gg's tables; sources are listed in the footer) and is pinned by automated
tests in the repository, including tests/test_wiki_math.py. A change that drifts
from the game data fails the test suite instead of shipping. Saves are only ever read, and a
save-safety test requires them to stay byte-identical.
How do I open and hide the overlay?
Windows: press Ctrl+Shift+B anywhere. Linux and other platforms: use the tray icon (a global
hotkey is not available there). The 🧿 button toggles click-through so mouse clicks reach the
game, and the ✕ button hides the overlay.
What do I need to run it?
Just the download: the Windows and Linux binaries bundle everything, so there is no Python or
installer step (Linux: download, chmod +x, run; NixOS users can nix run the repo instead). You
need a real Mewgenics save for full functionality.
Windows says “unknown publisher”. Is it a virus?
No. Code-signing certificates cost money, so small open-source projects ship unsigned. Click
More info → Run anyway, or build it yourself from the public source.
It doesn't find my save / looks wrong after an update
Mewgenics is early access and patches often, and a save format change can confuse the parser.
The app auto-detects saves on Windows and Linux/Proton. If it misses yours, pick the .sav with
the 📁 button, or set MEWGENICS_SAVES_ROOT. If it still looks wrong, report it with the
Feedback button and include the game patch number; it gets fixed fast.
How do I report a bug?
Open the About box (ℹ️) in the app and click Report a problem. No account is needed. The Copy
debug info button puts your version, OS and save details on the clipboard to paste into the
form; if the app crashed, the tail of overlay.log helps too.
Does it work alongside MewgenicsBreedingManager or CatScan?
Yes. It's built on MBM's genetics engine (credited) and reads the same saves; use whichever tool
suits the moment. They complement each other.
