MonsterGuide
Client-side in-game monster guide for R.E.P.O. with spawning info, searchable monster stats, local images, and persistent player notes.
About this mod Author’s original text
MonsterGuide
Client-side in-game monster guide for R.E.P.O. using BepInEx 5.
MonsterGuide adds a dark field-guide style overlay with a spawning table, searchable monster stats, local PNG image support, and per-monster player notes.
This mod is original code and UI work for MonsterGuide. It does not include or copy Monster Archive code, layout, branding, writing, or assets.
Controls
- Open/close guide: F5 by default.
- Escape also closes the guide.
After first launch, edit BepInEx/config/mechgaming13.MonsterGuide.cfg to change keybinds.
Images
Images are loaded from:
BepInEx/plugins/MonsterGuide/Images/
Use PNG files matching the monster image field in Data/monsters.json, for example animal.png, apex_predator.png, or banger.png.
The bundled monster images are sourced from the R.E.P.O. Wiki monster pages/category and are stored offline in the Images folder. Per-file image attribution is included in Images/IMAGE_ATTRIBUTION.md.
If an image is missing, MonsterGuide shows a No image available placeholder.
If you use wiki images or images from another source, keep attribution in your package README and follow that source's license. Do not use images copied from another mod unless you have permission.
Notes
Player notes are saved per monster to:
BepInEx/config/MonsterGuide/notes.json
The file is human-readable JSON and is not erased when monster data changes.
Data Source
Monster facts and spawning table values are sourced from:
R.E.P.O. Wiki - Monsters
Fandom community content is available under CC-BY-SA unless otherwise noted. The bundled data uses factual table values and original placeholder appearance text.
Manual Install
Install the package contents into your R.E.P.O. profile. The important files are:
BepInEx/plugins/MonsterGuide/MonsterGuide.dll
BepInEx/plugins/MonsterGuide/Data/monsters.json
BepInEx/plugins/MonsterGuide/Images/
Current R.E.P.O. builds may require HideManagerGameObject = true in BepInEx/config/BepInEx.cfg if BepInEx plugins are being destroyed during startup.
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.
Install these first, or the mod will not work: