Skip to content

Hot reloading

alex edited this page Feb 5, 2021 · 9 revisions

This guide explains how to have Mamar communicate with Project64 to play songs without recompiling the game.

Setup

Copy or symlink papermario-hot-reload.js to C:\Program Files (x86)\Project64 2.3\Scripts\papermario-hot-reload.js (if you're using a portable build of Project64, you need to find where it is extracted). You may need to create the Scripts directory.

Make sure Project64 is using the interpreter core (Options - Advanced - Always use interpreter core).

Usage

Make sure Mamar is running.

In Project64, open Paper Mario (U), then go to Debugger - Scripts... and double-click on papermario-hot-reload.js. If you get a pop-up saying "readex error," it means it is unable to connect to Mamar.

In Mamar, open your song of choice. Press Play to have it play in-game.

If, for any reason, you restart Mamar or Project64, you'll need to re-run both the Project64 script by double-clicking it in Debugger - Scripts... again and Mamar. (Opening a new ROM in Project64 doesn't reset the connection, only closing the entire program.)

Clone this wiki locally