- Joined
- Dec 18, 2015
- Messages
- 569
- Reaction score
- 548
- First Language
- English
- Primarily Uses
- N/A
WARNING:
This is a step by step guide for MV users to update their NW.JS to dramatically increase the performance of their game.
(Updating NW.js for Mac may make RPG Maker MV compatible with OSX Catalina and Big Sur! OMG!)
MZ users can use the ideas presented in this guide to update their NW.js from 44 to 50 if they like, but I'm not sure how much of a performance update this will be. (To update MV from 29 to 50 (or in my case 49.2) is a massive update!) It's actually easier to update MZ since the engine folders are structured much better. Just find the "Resource" folder, and replace the proper NW.js folder with the new downloaded versions and it should work just like that. Of course, I advise making backups, etc. (do NOT rename nw.exe to Game.exe) Have fun!
I just updated my MZ to NW.js version 50, everything is working great. Deployed and test games run just fine. Do you guys want me to create a MZ section of this guide?
/////////////////////////////////
Youtube Video Version!
/////////////////////////////////
Upgrading your NW.js is a great way to massively improve your game performance, especially if you are using RPG Maker MV!
NW.js (previously known as node-webkit) lets you call all Node.js modules directly from DOM and enables a new way of writing applications with all Web technologies. New way of writing native applications using web technologies: HTML5, CSS3, and WebGL. Full support for the features in the browser.
/////////////////////////////////
Some Explanation:
RPG Maker MV comes default with NW.js Version 29.4
RPG Maker MZ comes default with NW.js Version 44
So, a great way to GREATLY improve the performance of your MV Game is to upgrade the default NW.js version 29.4 to a higher version.
You can easily use the same steps I’m going to outline below to get MVs NW.js to virtually any version. You can choose version 50 which is the newest, but I personally chose 49.2 (Higher than MZ) because this is the latest version that all three platforms PC, MAC, and Linux support STEAM integration with Orange Green works. (I’m not covering this in this guide)
Also please note, there might be some small quirts with the NW.js version you choose. For example, before I upgraded to 49.2 (which works flawlessly) I upgraded to 33.3 which had a small text glitch (text sometimes showed up slowly). Just keep in mind these things may happen (I tried 33.3 because I thought that’s the highest version Orange Green works could use, I was wrong, its 49.2, but I digress).
/////////////////////////////////
So to check what version of NW.js you are using, in the editor, when you are testing your game, press f8 (or function f8) to bring up the console.
Type “process.versions” and press enter to see what version or Nw.js or just “nw” that you are running.
(Example of when you update NW.js to 49.2 like I did!)
/////////////////////////////////
So now that you are all caught up with a general idea of how it works and how to check we can get to the final details of how to get this upgraded!
Keep in mind I will provide the PC and Mac instructions, I do not have a Linux Machine however I feel the process will be very similar to either the PC or Mac version of the update (they differ slightly)
Here we go!
/////////////////////////////////
1) You need to be able to locate RPG Maker MV’s Local files.
On STEAM, just RIGHT CLICK -> Properties -> Local Files -> Browse
Else you will have to find the application folder on your PC.
2) You will see these two folders:
a) nwjs-win (Windows platform)
b) nwjs-lnx (Linux platform)
c) nwjs-osx-unsigned (Mac platform, yes its zipped up, don’t worry about it)
So if you want to update all 3 versions, you have to keep these folders in mind.
(This is prob a great time to save a copy of these folders just in case you want to revert back, minus the zipped osx unsigned folder that we never touch)
3) Most likely since you are using a PC you will also see a “test” version of this folder. This is the folder used when you are testing the game in the editor.
So a PC user will see
a) nwjs-win
b) nwjs-win-test
4) Now Download the version of NW.js that you want from the internet. This should work https://nwjs.io/downloads/
If you want an older build (If you want to integrate STEAM functionality with Orange Green Works I recommend 49.2, you can find older versions here: https://dl.nwjs.io/ (Scroll down)
Get the SDK versions, minus the “symbol” listings, I would get all the 64 bit versions, so these minus the “win-ia32” version. (Or just the bottom “win-x64” version if you plan to just update the PC version, yes, the deployed and test version of rpg maker)
5) Now that you have everything you need. Now comes the hard part! But before we get too crazy. I would suggest saving all your work. Make a copy and back it up to the cloud just in case. (even though we are just updating RPG Maker MV itself lol).
However, do keep in mind, at least for the STEAM version, if you want to revert back to default, you will have to delete these folders (from part 2) and then just revalidate your files on STEAM (or reinstall if not on steam). This way you can go back to NW.js version 29 if you wish very easily.
/////////////////////////////////
The Hard Part!!!! (PC/Win Platform)
1) Unzip the downloaded nw.js files.
2a) Go to your “nwjs-win-test”, delete everything inside this folder (This is a great time to save copy to revert back to)
b) Add contents of the “nwjs-sdk-v0.49.2-win-x64” folder (Copy and paste this).
c) Now rename the “nw.exe” to “Game.exe”.
Done!
///
3a) Go to your “nwjs-win”, save the “package.json” and “www” folder (Take them out) (This is great time to save copy to revert back to).
b) Delete everything inside this folder, and replace with the contents of the “nwjs-sdk-v0.49.2-win-x64” folder.
c) Place the “package.json” and “www” folder back in. Now rename the “nw.exe” to “Game.exe”.
d) Now delete the “chromedriver” file. (this is just used for the test folder)
You are DONE!!!! Type “process.versions” into the console and check your awesome new NW.js version!
The deployed version and the test version that you run in the editor should work beautifully! Enjoy the MUCH improved performance! (I also recommend quickly updating your pixi to 4.8.9, check bottom for directions!)
/////////////////////////////////
The Hard Part!!!! (Mac Platform)
BONUS: Updating NW.js for Mac may make RPG Maker MV compatible with OSX Catalina and Big Sur! OMG!
You have to keep in mind that to see certain folders on the Mac you have to right click files and select “Show Package Contents” in order to see the contents of a folder. You have to do this with the “RPG Maker MV” folder (Literally right click on "RPG Maker MV" in the folder and click "show package contents".)
1) Unzip the downloaded nw.js files.
2a) Go to your “nwjs-osx-test”, delete everything in this folder (You will NEVER touch the “nwjs-osx-unsigned.zip”) (This is a great time to save copy to revert back to)
b) Add contents of the “nwjs-sdk-v0.49.2-osx-x64” folder (Copy and paste this).
c) Now rename the “nwjs” to “Game”.
d) Now delete the “chromedriver” file (this is simply not needed at all!)
You are DONE!!!! Type “process.versions” into the console and check your awesome new NW.js version! (I also recommend quickly updating your pixi to 4.8.9, updating your pixi to 4.8.9, check bottom for directions!)
The deployed version and the test version that you run in the editor should work beautifully! Yes there are less steps, you don’t have to do anything to the zipped ‘nwjs-osx-unsigned” folder. Yay Mac!
UPDATE:
Someone wrote this, said this helped!
Okay I've figured out what I missed. In case anyone else gets stuck. Once I exported a Mac build, I needed to do the following:
Go into the RPG Maker MV app (local files from Steam), just like the initial steps mentioned, and find...
The "MacOS" folder - > Copy this and replace the MacOS folder in your exported Game.app (the MacOS folder only has "nwjs" inside)
The "Frameworks" folder - Copy-paste this whole thing into your exported Game.app. (The new nwjs depends on it. It should sit in your Contents folder next to MacOS.)
That's it! Now it runs famously.
(This is for 0.49.2 NWJS.)
/////////////////////////////////
The Hard Part!!!! (Linux Platform)
Unfortunately I do not have a Linux machine, so I cannot give a detailed breakdown of how this all works. I would imagine it is very similar to the PC version. If anyone uses a Linux machine and gets this to work, please feel free to let me know so I can update this file, thanks!
I would imagine the process is very similar, replace the “nwjs-lnx” folder with the contents of the ““nwjs-sdk-v0.49.2-linux-x64” folder, rename the “nw” to “Game”, and delete the “chromedriver” file (this is just used for the test folder).
/////////////////////////////////
Known issue 1 with upgrading NW.js
Now, some people may experience a NW.js profile error.
(Got the explanation from here: https://steamcommunity.com/app/683760/discussions/1/2595630410189816847/#c2595630410191528351)
Yes this error is not related to the game actually at all, so it won't impact the game. The issue runs far deeper than this game actually.
This is due to your NW JS version having been changed at one point and then changed again after that. This is actually on your system and reinstalling/deleting the game won't fix it as the problem persists in your appdata, especially if you play multiple RPG Maker games by multiple people it may cause this if people play around with NW JS files.
//////
Mac instructions:
1) Click on desktop -> Go -> hold “alt/option key” -> Library ->Application Support -> Delete the NW folder.
2) In the “Application Support” find the “Default” folder, delete both “Web Data” and “Web Data-journal”.
Done!
/////////////////////////////////
Known issue 2 with upgrading NW.js
You will most likely see this (there are ways to suppress these, I didn't bother)
This means virtually nothing for 99% of devs. I know it’s annoying but you can ignore it.
They are a type of js file that helps you locate error locations in code. It has no impact on the game, it just possibly means the format isn't up to date. This doesn't impact anyone but programmers, and very little.
/////////////////////////////////
And that’s it, thank you very much!
I hope I helped at least a few fellow RPG Maker MV devs out there, this should dramatically improve your games performance.
/////////////////////////////////
:: BONUS :: Updating PIXI
The good news is: Updating Pixi is tons easier.
There is a Pixi file in your game folder. JS -> Libs-> Pixi.js (Google: "download pixi js")
Link: https://github.com/pixijs/pixi.js/releases?after=v4.4.5
(Scroll down and download version 4.8.9)
Just download and replace the pixi file in your JS -> Libs-> Pixi.js
DONE!
/////////////////////////////////
Second Big Discovery to Dramatically improve RPG Maker Game Performance! (GPU related!)
forums.rpgmakerweb.com
This is a step by step guide for MV users to update their NW.JS to dramatically increase the performance of their game.
(Updating NW.js for Mac may make RPG Maker MV compatible with OSX Catalina and Big Sur! OMG!)
MZ users can use the ideas presented in this guide to update their NW.js from 44 to 50 if they like, but I'm not sure how much of a performance update this will be. (To update MV from 29 to 50 (or in my case 49.2) is a massive update!) It's actually easier to update MZ since the engine folders are structured much better. Just find the "Resource" folder, and replace the proper NW.js folder with the new downloaded versions and it should work just like that. Of course, I advise making backups, etc. (do NOT rename nw.exe to Game.exe) Have fun!
I just updated my MZ to NW.js version 50, everything is working great. Deployed and test games run just fine. Do you guys want me to create a MZ section of this guide?
/////////////////////////////////
Youtube Video Version!
/////////////////////////////////
Upgrading your NW.js is a great way to massively improve your game performance, especially if you are using RPG Maker MV!
NW.js (previously known as node-webkit) lets you call all Node.js modules directly from DOM and enables a new way of writing applications with all Web technologies. New way of writing native applications using web technologies: HTML5, CSS3, and WebGL. Full support for the features in the browser.
/////////////////////////////////
Some Explanation:
RPG Maker MV comes default with NW.js Version 29.4
RPG Maker MZ comes default with NW.js Version 44
So, a great way to GREATLY improve the performance of your MV Game is to upgrade the default NW.js version 29.4 to a higher version.
You can easily use the same steps I’m going to outline below to get MVs NW.js to virtually any version. You can choose version 50 which is the newest, but I personally chose 49.2 (Higher than MZ) because this is the latest version that all three platforms PC, MAC, and Linux support STEAM integration with Orange Green works. (I’m not covering this in this guide)
Also please note, there might be some small quirts with the NW.js version you choose. For example, before I upgraded to 49.2 (which works flawlessly) I upgraded to 33.3 which had a small text glitch (text sometimes showed up slowly). Just keep in mind these things may happen (I tried 33.3 because I thought that’s the highest version Orange Green works could use, I was wrong, its 49.2, but I digress).
/////////////////////////////////
So to check what version of NW.js you are using, in the editor, when you are testing your game, press f8 (or function f8) to bring up the console.
Type “process.versions” and press enter to see what version or Nw.js or just “nw” that you are running.
(Example of when you update NW.js to 49.2 like I did!)
/////////////////////////////////
So now that you are all caught up with a general idea of how it works and how to check we can get to the final details of how to get this upgraded!
Keep in mind I will provide the PC and Mac instructions, I do not have a Linux Machine however I feel the process will be very similar to either the PC or Mac version of the update (they differ slightly)
Here we go!
/////////////////////////////////
1) You need to be able to locate RPG Maker MV’s Local files.
On STEAM, just RIGHT CLICK -> Properties -> Local Files -> Browse
Else you will have to find the application folder on your PC.
2) You will see these two folders:
a) nwjs-win (Windows platform)
b) nwjs-lnx (Linux platform)
c) nwjs-osx-unsigned (Mac platform, yes its zipped up, don’t worry about it)
So if you want to update all 3 versions, you have to keep these folders in mind.
(This is prob a great time to save a copy of these folders just in case you want to revert back, minus the zipped osx unsigned folder that we never touch)
3) Most likely since you are using a PC you will also see a “test” version of this folder. This is the folder used when you are testing the game in the editor.
So a PC user will see
a) nwjs-win
b) nwjs-win-test
4) Now Download the version of NW.js that you want from the internet. This should work https://nwjs.io/downloads/
If you want an older build (If you want to integrate STEAM functionality with Orange Green Works I recommend 49.2, you can find older versions here: https://dl.nwjs.io/ (Scroll down)
Get the SDK versions, minus the “symbol” listings, I would get all the 64 bit versions, so these minus the “win-ia32” version. (Or just the bottom “win-x64” version if you plan to just update the PC version, yes, the deployed and test version of rpg maker)
5) Now that you have everything you need. Now comes the hard part! But before we get too crazy. I would suggest saving all your work. Make a copy and back it up to the cloud just in case. (even though we are just updating RPG Maker MV itself lol).
However, do keep in mind, at least for the STEAM version, if you want to revert back to default, you will have to delete these folders (from part 2) and then just revalidate your files on STEAM (or reinstall if not on steam). This way you can go back to NW.js version 29 if you wish very easily.
/////////////////////////////////
The Hard Part!!!! (PC/Win Platform)
1) Unzip the downloaded nw.js files.
2a) Go to your “nwjs-win-test”, delete everything inside this folder (This is a great time to save copy to revert back to)
b) Add contents of the “nwjs-sdk-v0.49.2-win-x64” folder (Copy and paste this).
c) Now rename the “nw.exe” to “Game.exe”.
Done!
///
3a) Go to your “nwjs-win”, save the “package.json” and “www” folder (Take them out) (This is great time to save copy to revert back to).
b) Delete everything inside this folder, and replace with the contents of the “nwjs-sdk-v0.49.2-win-x64” folder.
c) Place the “package.json” and “www” folder back in. Now rename the “nw.exe” to “Game.exe”.
d) Now delete the “chromedriver” file. (this is just used for the test folder)
You are DONE!!!! Type “process.versions” into the console and check your awesome new NW.js version!
The deployed version and the test version that you run in the editor should work beautifully! Enjoy the MUCH improved performance! (I also recommend quickly updating your pixi to 4.8.9, check bottom for directions!)
/////////////////////////////////
The Hard Part!!!! (Mac Platform)
BONUS: Updating NW.js for Mac may make RPG Maker MV compatible with OSX Catalina and Big Sur! OMG!
You have to keep in mind that to see certain folders on the Mac you have to right click files and select “Show Package Contents” in order to see the contents of a folder. You have to do this with the “RPG Maker MV” folder (Literally right click on "RPG Maker MV" in the folder and click "show package contents".)
1) Unzip the downloaded nw.js files.
2a) Go to your “nwjs-osx-test”, delete everything in this folder (You will NEVER touch the “nwjs-osx-unsigned.zip”) (This is a great time to save copy to revert back to)
b) Add contents of the “nwjs-sdk-v0.49.2-osx-x64” folder (Copy and paste this).
c) Now rename the “nwjs” to “Game”.
d) Now delete the “chromedriver” file (this is simply not needed at all!)
You are DONE!!!! Type “process.versions” into the console and check your awesome new NW.js version! (I also recommend quickly updating your pixi to 4.8.9, updating your pixi to 4.8.9, check bottom for directions!)
The deployed version and the test version that you run in the editor should work beautifully! Yes there are less steps, you don’t have to do anything to the zipped ‘nwjs-osx-unsigned” folder. Yay Mac!
UPDATE:
Someone wrote this, said this helped!
Okay I've figured out what I missed. In case anyone else gets stuck. Once I exported a Mac build, I needed to do the following:
Go into the RPG Maker MV app (local files from Steam), just like the initial steps mentioned, and find...
The "MacOS" folder - > Copy this and replace the MacOS folder in your exported Game.app (the MacOS folder only has "nwjs" inside)
The "Frameworks" folder - Copy-paste this whole thing into your exported Game.app. (The new nwjs depends on it. It should sit in your Contents folder next to MacOS.)
That's it! Now it runs famously.
/////////////////////////////////
The Hard Part!!!! (Linux Platform)
Unfortunately I do not have a Linux machine, so I cannot give a detailed breakdown of how this all works. I would imagine it is very similar to the PC version. If anyone uses a Linux machine and gets this to work, please feel free to let me know so I can update this file, thanks!
I would imagine the process is very similar, replace the “nwjs-lnx” folder with the contents of the ““nwjs-sdk-v0.49.2-linux-x64” folder, rename the “nw” to “Game”, and delete the “chromedriver” file (this is just used for the test folder).
/////////////////////////////////
Known issue 1 with upgrading NW.js
Now, some people may experience a NW.js profile error.
(Got the explanation from here: https://steamcommunity.com/app/683760/discussions/1/2595630410189816847/#c2595630410191528351)
Yes this error is not related to the game actually at all, so it won't impact the game. The issue runs far deeper than this game actually.
This is due to your NW JS version having been changed at one point and then changed again after that. This is actually on your system and reinstalling/deleting the game won't fix it as the problem persists in your appdata, especially if you play multiple RPG Maker games by multiple people it may cause this if people play around with NW JS files.
- To fix this error click your file explorer and type in
- Then go into KADOKAWA\RPGMV\User Data\Default
- Delete both Web Data and Web Data-journal.
After this the NW JS gets updated when the game is ran again and the error will disappear.
//////
Mac instructions:
1) Click on desktop -> Go -> hold “alt/option key” -> Library ->Application Support -> Delete the NW folder.
2) In the “Application Support” find the “Default” folder, delete both “Web Data” and “Web Data-journal”.
Done!
/////////////////////////////////
Known issue 2 with upgrading NW.js
You will most likely see this (there are ways to suppress these, I didn't bother)
This means virtually nothing for 99% of devs. I know it’s annoying but you can ignore it.
They are a type of js file that helps you locate error locations in code. It has no impact on the game, it just possibly means the format isn't up to date. This doesn't impact anyone but programmers, and very little.
/////////////////////////////////
And that’s it, thank you very much!
I hope I helped at least a few fellow RPG Maker MV devs out there, this should dramatically improve your games performance.
/////////////////////////////////
:: BONUS :: Updating PIXI
The good news is: Updating Pixi is tons easier.
There is a Pixi file in your game folder. JS -> Libs-> Pixi.js (Google: "download pixi js")
Link: https://github.com/pixijs/pixi.js/releases?after=v4.4.5
(Scroll down and download version 4.8.9)
Just download and replace the pixi file in your JS -> Libs-> Pixi.js
DONE!
/////////////////////////////////
Second Big Discovery to Dramatically improve RPG Maker Game Performance! (GPU related!)
Dramatically Improve Game Performance for Devs and Players! (MV and MZ) (second big discovery, GPU related)
The reason why I am creating this thread is because I feel this is a VERY important aspect of RPG Maker games that is overlooked by most devs and players alike. This is my SECOND big discovery, my first discovery being "Massively improving RPG Maker Game performance by updating the NW.js" (Link...

Last edited: