Steam Integration and Achievements Tutorial (Tested on MV)

PlayGG_Doctor · 2025-01-30T00:57:27+0900

Setting up Steam Integration and Achievements Intro So... you’re planning on releasing your RPG Maker MV game on STEAM in this, the year of our lord 2025. Steam integration is turning out to be trickier than you expected, but you can’t say “no” to those sweet, sweet features. Being able to pull player data like their playtime or Steam username seem like neat lil’ tricks, but you’re after the holy grail. One of the most popular ways for gamers to track their progress through your game and for you to reward them for achieving the unlikely: STEAM ACHIEVEMENTS. Sadly, the guides you’re finding online are old, outdated or incomplete. The official page for OrangeGreenworks is down, there’s a ton of confusion about what versions of SDKs and NW.js you need and the instructions from various sources are conflicting and confusing. Does any of the above sound familiar? If you are struggling, as I did, with all of the above, then YOU, my friend, have come to the right place. After much, MUCH trial and error, I was able to get integration and Steam Achievements to work on my game and I will now pass my knowledge on to YOU! Questions you may have at this point: What is Steam Integration? It’s your game’s ability to “talk” with Steam. Once it’s working, you will be able to pull some data directly from Steam and have it function as a variable or text in your game. This will let you do neat little tricks like call the player by their Steam name. However, if you’re like me, the functionality you’re most interested in is having a Steam Achievement pop up for the player when they perform a specific action in your game. This will require you to set up “Steam Integration”. Does my game need to be published/uploaded on Steam to do this? The short answer is NO, since you can run a local test to confirm that your game is, in fact, trying to pull data from Steam (you can test this by creating a dummy data file, I will explain later), but ultimately, to actually confirm that integration is working and to test if your achievements pop up on Steam, YES, you will need to already have your game uploaded to Steam. How do I get my game on Steam? NOPE. This guide will not be covering that. The short version is you have to pay $100 (as of the time of writing) and go through Steam’s many requirements to get your page created, your game tested, approved by Valve and published. I will not be touching on practically any of that, as I feel like there is plenty of information online on this topic, far more than I could find on the actual setting up of Steam Integration. This also goes for “creating the achievements” themselves on Steam. Quick rundown: There are 5 major components that are required in order for this to work and they all need to be both the right “versions” and "set up correctly". Any error with versions or installation of ANY component is very likely to result in one of countless errors or failures. Thankfully, I have done a lot of the legwork so you don’t have to! The components you'll need are: The correct version of each OS “Node” (various .node files). The OrangeGreenworks plugin (JS file). The correct version of Greenworks (JS file). The correct version of Steam’s SDK files (many files in this folder would normally need to be moved to a “lib” folder in your game files to allow for integration). The correct version of the NW.js (.exe file) Credit to all those who did work, without which I would not have been able to implement integration. Thanks to KillerGin for creating a great guide in 2021: Setting up STEAM Integration in RPG Maker MV This is a great starting point as it covers how you would normally obtain and install all the files you need. I believe it is just somewhat outdated since I tried the versions he recommends and it did not work for me. Thanks to LandsharkRAWR, however, for commenting on this thread and advising that he was able to succeed by using these versions: NWjs 49.1, steam SDK 1.43 and greenworks v83. Those versions worked for me and they’re the ones we will be using in this guide. Thanks to Hudell for creating the OrangeGreenworks plugin and its guide: OrangeGreenworks - Steam Integration with Achievements and Time Log Unfortunately, the link to the plugin is down as is the site where the instructions are hosted! Bummer! But thankfully, both have been saved locally and I will be providing them to you. **Pre-Guide Disclaimer** Before diving in, ***BACK UP EVERYTHING*** I cannot stress this enough; I am not responsible for any damage you cause to your own game or computer by following these instructions. They worked for ME on a Windows operating system, but I recommend you back up the entirety of your project to a safe location, ideally, both on your local computer and a second location (a cloud service or maybe an external drive) before attempting. This includes both your project folder as well as your RPG Maker MV local files since this process will require adjustments to both. You are proceeding with…

● ARCHIVED · READ-ONLY

Started by PlayGG_Doctor Jan 29, 2025, 03:57 PM 31 posts Page 2 of 2 View original ↗

PlayGG_Doctor

#21 Sep 26, 2025, 02:18 AM Source

DoctorLoops said:
Thanks for the step-by-step guide, @PlayGG_Doctor ! But I was wondering, does this method still currently work? I followed all the steps and (thankfully) my end result matches all the screenshots you provided, but after deployment for local testing, the game doesn't seem to run; even after creating the steam_appid.txt and adding the App ID of my game to it. The window just flickers open for a moment and then immediately closes. (Oddly, removing the greenworks.js file allows the game to run normally, but I assume this removes the entire Steam-communication functionality)

All I can think of is that maybe it can't run because my game isn't ON steam yet? I just submitted it yesterday and it's still in the Review queue, so I wonder if maybe the AppID is pointing to nothing.

EDIT: Welp, nevermind. When trying to test it locally through opening the Game.exe file, it still doesn't open. However, even though my game is still in the review queue, I'm able to test it through Steam and the achievements DO work. Not being able to playtest it via the Output file is a bit annoying, but as long as the achievements work, I'm fine with that! Thanks again for the guide!
I'm not sure if this is the issue but I just figured that on some OS, the file when run locally will be stopped by an antivirus or windows defender, etc. Some will give you the option to Run Anyway but maybe you have one that just stops it altogether when running locally.

I would recommend trying to RUN the GAME file AS ADMINISTRATOR and see if that allows you to test locally.
DoctorLoops

#22 Oct 5, 2025, 08:31 PM Source

PlayGG_Doctor said:
I would recommend trying to RUN the GAME file AS ADMINISTRATOR and see if that allows you to test locally.
For the sake of helping troubleshoot this for others who might find this thread in the future, I pulled up the local Output file and tried using "Run as Administrator", but unfortunately, no dice; the window pops up for a nanosecond and then immediately closes as usual :( The game runs fine when played on Steam though, so at least that's OK, but it's a little unwieldly needing to upload the builds onto Steam in order to test it separately from RPGMaker :LZYdizzy:
SloppyJoeStudios

#23 Dec 11, 2025, 12:33 PM Source

Hmmm.. am I just dull or did I miss something?
I downloaded the rar file you posted but I see no lib folder in that or any greenworks plugins?View attachment 354768
Hope you can help me. Thanks!

[EDIT]
something weird happened. Well I redownloaded it and now all is there. nevermind. Gonna try this now.
doller554

#24 Dec 11, 2025, 04:51 PM Source

SloppyJoeStudios said:
Hmmm.. am I just dull or did I miss something?
I downloaded the rar file you posted but I see no lib folder in that or any greenworks plugins?View attachment 354768
Hope you can help me. Thanks!

[EDIT]
something weird happened. Well I redownloaded it and now all is there. nevermind. Gonna try this now.
Glad it worked. I was about to say I have all of the files on my PC for this and could have sent them to you, but it sounds like you got it.
SloppyJoeStudios

#25 Dec 11, 2025, 05:20 PM Source

PlayGG_Doctor said:
I'm glad it worked for you! It was a giant hassle for me to figure out the figure out the first time. At one point, I was definitely resigned to not having Steam achievements in my game since I couldn't figure it out, but I did finally figure it out. After all the help I've received from the community while working on my game, only seemed right to share my findings.

It would be an honor to be included in your game's special thanks. Very kind!

Yes I found the files and tried all the steps but I hoped it would work on the later nw.js version I have that works great with mv3d but it didn't. Game didn't start after all the steps with version 0.68 on nw.js.
I'm however very grateful for you wanting to help ❤️

I guedd I have to abort this mission
PlayGG_Doctor

#26 Dec 11, 2025, 06:03 PM Source

SloppyJoeStudios said:
Yes I found the files and tried all the steps but I hoped it would work on the later nw.js version I have that works great with mv3d but it didn't. Game didn't start after all the steps with version 0.68 on nw.js.
I'm however very grateful for you wanting to help ❤️

I guedd I have to abort this mission
Hi SloppyJoeStudios,

Yes, sadly I was only able to get things to work with very specific versions of the NW.js as well as the Steam SDK. It may be possible to get it to work with some experimentation, but I think since OrangeGreenWorks is no longer supported, it may not be compatible with newer NWs without modification, and that sadly exceeds my level of expertise.
SloppyJoeStudios

#27 Dec 11, 2025, 06:05 PM Source

PlayGG_Doctor said:
Hi SloppyJoeStudios,

Yes, sadly I was only able to get things to work with very specific versions of the NW.js as well as the Steam SDK. It may be possible to get it to work with some experimentation, but I think since OrangeGreenWorks is no longer supported, it may not be compatible with newer NWs without modification, and that sadly exceeds my level of expertise.
I gave it a shot at least and I'm happy you shared all of this
Very heroic of you.
ZedhayN

#28 Jan 6, 2026, 09:13 PM Source

Hello. Please share your PayPal with me. I need to pay my debt for this !
PlayGG_Doctor

#29 Jan 8, 2026, 12:06 AM Source

Hey friend! No need to PayPal me, all in a day’s work for your friendly neighborhood plague doctor!

Pay it forward if you get the chance! Glad this guide was useful to you.
Leilanix

#30 Jan 16, 2026, 08:24 PM Source

Hey! I'm having some trouble, I followed the guide step by step, however my lib folder (both under the game folder and output folder) look like this? I am unsure if the different file types(?) are what's causing it to be weird but I downloaded the files and put them all in as it came. The game DOES run but when I check the console it shows these errors. I have tested it in steam and no achievement popups appear either. Any sort of help would be appreciated!
Pirokaon

#31 Feb 15, 2026, 03:20 PM Source

Nice!