Misc

Troubleshooting

Issue	Solution
The game forgets the saves.	A plugin is required to change the save location. This is due to a quirk where NW.js unpacks the files from package.nw and removes them when the game shuts down. See below for plugins.
I've enabled source code compilation and the game crashes on startup.	Some versions of NW.js have some behind the scenes changes that could break compiled JavaScript files. A newer version NW.js should work. If not (or you cannot use a newer version), open the Metadata Editor and add `--no-flush-bytecode` in the JavaScript flags. If you are using native code with NW.js, make sure that it matches OS and CPU architecture.

Plugins that have issues with JS Source compilation

This is a list of known plugins that don't work correctly, when the "Compile source files" setting is turned on. This can be due to unexpected behaviour or code that assumes that the file is .js. If you know of any that don't work correctly, let me know.

Plugin Name	Engine	Comments
Hakuen Studio plugins (versions 5.x and newer)	RPG Maker MV/MZ	From 5.x and onwards, some of the plugins attempt to find their name via `document.src` (Eli_Book, for example, does that via the `Eli.PluginManager.getPluginName()` function). However, the tool patches the game so it can load the binary files, thus affected plugins break. This has been addressed in recent updates for these plugins. If you notice that the game shows a black screen, change the affected lines for the affected ones (for example, `const parameters = PluginManager.parameters(Eli.PluginManager.getPluginName())` with hard coded names (for example, `const parameters = PluginManager.parameters("Eli_Book")`
SRD_BattleCustomizer	RPG Maker MV	The first part of the plugin cannot load parameters from the second part, with the "Compile source files" turned on. To fix this, put the second part first.

Plugin List for changing save location

Below is a list of plugins that change the location of saves. If you are using compression in the project, you will need either of them so the game can properly save.

NOTE

This list is informational. Please check if the license for the plugin fits for your game.

Engine Version	Plugin	Cross-platform?	Link
RPG Maker MV/MZ	Advanced Save Handler (reccomended)	Yes	Github Page
RPG Maker MV/MZ	Advanced Change SaveLocation	No (Windows only)	Plugin Page

Developer Guidance To Home