Dev Tools

The Dev Tools mod provides an in-game debug and cheat panel for developers and power users. It is designed for mod development, testing, and troubleshooting — not for a vanilla gameplay experience. Keep this mod disabled if you want an unmodified playthrough.


Opening the Dev Menu

Press P at any time during gameplay to open the Dev Tools panel. Press P again or press Escape / X to close it.

The panel can be opened on the map, during events, and in most scenes. It is intentionally disabled in certain scenes to avoid breaking them.


Panel Sections

Cheats

Teleportation

Enter a Map ID and optional X/Y coordinates to teleport the player instantly. Useful for jumping to a specific map to test an event without walking through the dungeon. Map IDs match RPG Maker MV's internal map numbering (visible in the editor or via the debug console).

Variable Viewer

Browse and edit $gameVariables and $gameSwitches values in real time. Useful for diagnosing event logic bugs or manually setting a state to continue past a broken trigger.


FPS & Network Metrics Overlay

A separate companion mod (devFPSMetrics.js) provides an always-on HUD overlay in the top-left corner of the screen showing:

The overlay auto-hides when multiplayer is not active. To enable it, ensure devFPSMetrics.js is loaded in the mod list (it is loaded by default in dev builds).


Dev Flag: MATTIE.isDev

Many conditional code paths in the mod system check MATTIE.isDev. When this flag is true, extra logging and debug helpers are enabled across the entire mod suite.

You can toggle it at runtime by opening the browser console (F12) and typing:

MATTIE.isDev = true;

Or set it at the start of any mod file to have it always active in your dev environment.


Battle Logger

To enable detailed combat sync logging in the browser console:

MATTIE.multiplayer.devTools.battleLogger = true;

This prints every enemy HP sync packet, targeting decision, and battle phase transition to the console. Useful for diagnosing combat desyncs in multiplayer.


Safety Warning

The Dev Tools mod intentionally bypasses game balance and progression. Cheats used during a real playthrough will affect your save file permanently. Use a separate save slot when testing.