Tool GAME RIPPER (decrypt and extract Ren'Py, Godot, Unity, Unreal, WolfRPG, RPGM XP/VX/Ace/MZ/MV, SRPGStudio, Bakin, PGMMV, GMS, APK, JAR, WASM, EXE etc.)

[justaplayer69]

Hey justaplayer69 are you planning on adding functionality for decrypting godot GDScript files?

I have not, because I did not need this, but if you guys want this feature, I can take a look.

I tried to use your tool but it just saved every gdscript file as gde(encrypted gdscript). I know that i can manually define the decryption key

That's a different key. There's a decryption key to decrypt the pack files, this is what you can specify manually. This is solely used to extract files, gdscript is a totally different kind of beast.

but the thing is i dont know it and i hoped that your tool could automatically detect it somehow.

I'll look into it.

I tried to use

You must be registered to see the links

but it failed to find it. I also tried statically searching for it in the executable but i couldnt find it with ghidra.

Yep, not easy to use, and even if it worked, godot-key-extract looks for the unpacking decryption key and not the gdscript key.

The game im trying it on is https://f95zone.to/threads/anomalous-coffee-machine-v0-8-00-deluxe-horubrain.220446/

Thanks, I'll take a look, but no promises. I haven't researched yet how gdscripts are encoded, it is possible that they are not using any key rather a bytecode or something. I'll let you know when I've figured it out and if it's doable.

where does the unpatch files located after I click unpack all?

Depends on the engine.

For RPG Maker, they are extracted next to the encrypted file but with normal extension (eg. img/pictures/AAA.rpgmvp will be saved to img/pictures/AAA.png). For Pixel Game Maker, the encrypted assets will be simply replaced with unencrypted assets (because they are using the same file name, and the engine can work with unencrypted assets just fine).

For WolfRPG, Unity, Ren'Py and other archive based engines, a directory by the same name as the archive is created and files are extracted under (for example Data.wolf will be unpacked into the Data\ directory; files in Game\archive.rpa will be extracted under Game\archive\ etc.).

The exception to this rule is Godot, those archives are extracted to the filenames as Godot references them (it's just leading dots are replaced with an underscore). For example if a Godot resource is referenced as "res://.godot/imported/AAA.ctex", then that will be extracted to _godot\imported\AAA.ctex, and the converted image is saved as _godot\imported\AAA.png. Keep in mind that this is just an example, games might use different paths for resources, however "_godot\imported" folder seems to be the most common variant.

Finally, assets embedded in binaries are extracted as "file@hexoffset.format". For example if there's a png image in the executable at offset 4096, that will be saved to "game.exe@0001000.png". If an archive is embedded, then a directory is created and files are saved under just like with non-embedded archives.

 

[justaplayer69]

Hi Henry1887,

I did some digging on GDScript files. It looks like they have only one level of encryption, so there's no script key needed, they use the same as any other asset. The reason why the decrypted script looked like gibberish to you is because it is a bytecode (a highly version dependent one on top of that). I might be able to add a bytecode decompiler into GR, but until then, two steps needed:

1. unpack the game with GAME RIPPER (this will take care of the key autodetection and decryption)
2. use gdtool (

You must be registered to see the links

) or gdsdecomp (

You must be registered to see the links

) to convert the decrypted bytecode .gds file into a plain text script file

Gdtool is a command line tool and gdsdecomp is a windowed one. If the game isn't encrypted (or uses the old encryption method), then you can use gdsdecomp as-is. Otherwise if it's using the newer encryption, then first decrypt the script files with GR.

 

[Henry1887]

Hi Henry1887,

I did some digging on GDScript files. It looks like they have only one level of encryption, so there's no script key needed, they use the same as any other asset. The reason why the decrypted script looked like gibberish to you is because it is a bytecode (a highly version dependent one on top of that). I might be able to add a bytecode decompiler into GR, but until then, two steps needed:

1. unpack the game with GAME RIPPER (this will take care of the key autodetection and decryption)
2. use gdtool (

You must be registered to see the links

) or gdsdecomp (

You must be registered to see the links

) to convert the decrypted bytecode .gds file into a plain text script file

Gdtool is a command line tool and gdsdecomp is a windowed one. If the game isn't encrypted (or uses the old encryption method), then you can use gdsdecomp as-is. Otherwise if it's using the newer encryption, then first decrypt the script files with GR.

the unpacked script from your tool is not bytecode for me. It is in a .gde format and not .gds
Am i doing something wrong when unpacking the game?

 

[justaplayer69]

the unpacked script from your tool is not bytecode for me. It is in a .gde format and not .gds

Not sure what you mean by that, but GAME RIPPER just decrypts the assets and saves them verbatim. If the format is recognized, then a second converted file is saved too, however this doesn't influence the saving of the original asset as-is. If the script is saved as .gde (whatever that might be), then this is so because that's what stored in the game files.

 

[Henry1887]

Not sure what you mean by that, but GAME RIPPER just decrypts the assets and saves them verbatim. If the format is recognized, then a second converted file is saved too, however this doesn't influence the saving of the original asset as-is. If the script is saved as .gde (whatever that might be), then this is so because that's what stored in the game files.

Well you said that game ripper takes care of the decryption and .gde is a encrypted gdscript format so I thought your tool would automatically decrypt it?

 

[justaplayer69]

Well you said that game ripper takes care of the decryption and .gde is a encrypted gdscript format so I thought your tool would automatically decrypt it?

Yes. It does remove the asset encryption. If there's an additional level of encryption on scripts, then that's not removed (yet). I've just started researching GDScript, and I haven't seen such 2nd level decrypter in the other tools (just bytecode disassemblers). Of course this doesn't mean there's none, it's just I haven't found it yet.

 

[djacoaio]

Dunno, it works for me. I would have to reproduce the issue to tell more.

Which PR version are you ripping? With what GR version and on which platform? Can you see the audio files on the "SFX" tab?
Please run GR with the -v flag ("gameripper.exe -v") that will create gameripper.log file and attach that log here. I'll be able to tell more if I can see the messages.

i used the gameripper v1.7, with PR reward 2024_11, heres the log, i could see the sfx tab

 

[justaplayer69]

Hi djacoaio,

Hmmm, there's no audio-related error message in your log, so it should work. I've also tested with PR reward 2024_11, I've attached my log. I see no difference with your log (except the timestamps), and audio is working for me perfectly.

A few thoughts:
- not all animations have audio, just some (actually I had to scroll down a lot to find the first one with a sound effect, see attachments)
- there's no audio if you press the "Scan for sprites" button (because sprite sheets store no such info)
- maybe another app was running and blocking the audio?
- have you accidentally muted your machine or experiencing contact problems with your headphone?

I'm truly sorry, I have no clue why there's no audio for you. I see no obvious reasons why it shouldn't work. Also it does work for me, and I can't fix something that I can't reproduce.

(ps: the only thing I've noticed is that something is wrong with your UTF-8 encoding setting, but I doubt this should affect the sound effects.)

 

[justaplayer69]

Well you said that game ripper takes care of the decryption and .gde is a encrypted gdscript format so I thought your tool would automatically decrypt it?

I've checked the Godot source code. There's no additional gdscript encryption whatsoever (just the usual asset encryption), but plugins might implement it.

So I'm guessing this .gde is handled by some 3rd party plugin maybe?

(Technical details: core/io/file_access_encrypted.cpp implements just one level of AES decryption method, same as any other asset. However there's a "export_plugins.write[ i ]->set_export_preset(p_preset);" call which might override the method to add further level(s) of encryption. It seems an additional key is used for these and stored in a common manner, but without knowing the method implemented in the plugin there's no chance of decrypting.)

 

[thewhitespirit]

Hi. Great tool, thanks a lot, appreciate it.
Here's some notes/questions, if I may.

Version: GAME RIPPER ROM V1.7
Platform: windows 10

1. Navigation with mouse in sprites kinda does not work.
When switching sprites with up/down keys, it works fine.
When trying to use mouse, the program does something. Seems like it adds a new animation out of random sprites at the end of the list? And on every click it adds a new one with more frames than the previous one? Eventually after many clicks the frame count goes high and program hangs. Any mouse button triggers this effect (LMB, RMB, MMB, back/forward buttons) except mouse wheel.
Do you have any ideas on why this might happen? Any info I need to provide (logs or something)?

Spoiler: video

You don't have permission to view the spoiler content. Log in or register now.

2. Tbh these buttons' text isn't easy to read unless I zoom the screen in

Spoiler: button screenshot

You don't have permission to view the spoiler content. Log in or register now.

3. Any way to force the app with a language at startup? Like command line arg or something? No big deal at all, but it would be nice to use a language different from the system one without pressing F1 every time.

 

[justaplayer69]

Hi. Great tool, thanks a lot, appreciate it.
Here's some notes/questions, if I may.

Of course, thanks for your feedback!

1. Navigation with mouse in sprites kinda does not work.
When switching sprites with up/down keys, it works fine.
When trying to use mouse, the program does something. Seems like it adds a new animation out of random sprites at the end of the list? And on every click it adds a new one with more frames than the previous one?

This is a feature which supposed to work when Shift is held down with the click. If this is constantly triggered on your Win10, then this is an SDL bug (to be precise, SDL_GetModState() returning a modifier key being pressed when it's not actually pressed). I'll find a workaround for this.
(For the records, the feature in question: click on the first frame, then shift+click on the last frame and all sprites in between these two will be added as a new animation to the end of the list.)

2. Tbh these buttons' text isn't easy to read unless I zoom the screen in

I have already increased the contrast between the font's color and the shadow, maybe I'll increase it a little bit more. It is using the Commodore 64 palette BTW.

3. Any way to force the app with a language at startup? Like command line arg or something?

Not yet, but I can definitely add this easily.

 

[thewhitespirit]

This is a feature which supposed to work when Shift is held down with the click. If this is constantly triggered on your Win10, then this is an SDL bug (to be precise, SDL_GetModState() returning a modifier key being pressed when it's not actually pressed).

Double checked that no modifier is pressed, and tested this on another win10 machine just to be sure - yes, it's constantly triggered.

(For the records, the feature in question: click on the first frame, then shift+click on the last frame and all sprites in between these two will be added as a new animation to the end of the list.)

Nice. This definitely will be useful for some short loops.

Not yet, but I can definitely add this easily.

I'd appreciate it.

 

[thewhitespirit]

unknown engine format, fallback to brute force scanning

It even does that. Awesome! Now I can finally take a look at Maumau CGs.
(CGs are fully exported, but some have black/white/transparent padding around 1/3 of the image height. Interesting. This makes me curious whether it is the way they were stored or some brute force consequences. Anyway, happy to finally be able to take a closer look at them. )

On another note, seems like Decrypt / Unpack all dumps the sprites right into the game folder. I think it would be nice to use a subdirectory for that, something like 'game folder/gameripper_export/', to keep exports isolated from the game files.

 

[justaplayer69]

It even does that. Awesome!

Thanks!

This makes me curious whether it is the way they were stored or some brute force consequences.

It's how they are stored. Brute force scanning operates on encoded bitstream level (so it looks for PNG, OGG etc. bitstreams), but borders are added when those are decoded. It is pretty common btw, that's how multiple layers of CGs are positioned on each other in many games.

On another note, seems like Decrypt / Unpack all dumps the sprites right into the game folder. I think it would be nice to use a subdirectory for that, something like 'game folder/gameripper_export/', to keep exports isolated from the game files.

Yeah, this is something that I'm considering a lot lately. Originally GR was written for PGMMV, which uses the same file names for both encrypted and unencrypted assets, that's why I haven't implemented this from the start. Later as more and more engines were added, it become obvious that this is unique to PGMMV, other engines use different file names, so yeah, separate directory is something that's on my TODO list, but unfortunately a lot of work at this point.

 

[justaplayer69]

Hi all,

I'm experiencing issues with f95zone.to. After more than 1.5 years, it suddenly told me that my email address is invalid.

I've specified a new email address, I've received the verification email, but when I clicked on the confirmation link in mail, nothing happened (instead of showing the "confirm" button, it just redirected me to the main page). I've asked for a new link several times, until one link was finally working and I could click on that "confirm" button.

If this continues, then I'm afraid I'll run out of email addresses pretty soon, and I won't be able to participate in the f95zone community. I want to let you know that if in the future I suddenly become silent this is the cause.

Rest assured, I'll be still working on GAME RIPPER regardless, I'll keep the gitlab repo up-to-date, and I'll be still reading this topic, it's just I won't be able to reply. But let's hope for the best that f95zone confirmation links will work and that this was just a temporary, one-time technical issue.

 

[faulk]

Hey, just here to thank you.

I'm a fap hero / cock hero editor ( you can find my work on xvideos if it's not dmca ) and I'm using it for my next project, very usefull to extract things from things properly.

Can I suggest some things :

Of course, I guess what everyone want is more compatibility, but :

----------------------------------------------------------------------------

Do you think there is a way to "batch animate" png ?

Like, your button animation seems to works kinda well for most of things, but, I would like to be able to do it, "one clic" on every animation.

Maybe you can do like this :
Create a button "Batch animation" with three options : Select all / Select Selected format ( png, jpg ... ) / Select selected picture.

Then, the software use the auto detection grid you allready use for solo animation, and do it for every selected image.

This, honestly, could save a ton of time for me, but also a lot of people who just wanna upload animated gif.

----------------------------------------------------------------------------

Also, is there a way to add a "speed regulation" of animation ? For example, to speed or or slow down animations.


Anyway, good work on this, one of the most usefull tool on this website.

 

[justaplayer69]

Hey, just here to thank you.

I'm glad you like GR!

Do you think there is a way to "batch animate" png ?

Ah, I forgot. This feature is already implemented, click on the "Scan for sprites" button (it's on the first tab).

Like, your button animation seems to works kinda well for most of things, but, I would like to be able to do it, "one clic" on every animation.

Yeah, "most of things", but not always. If an animation is detected incorrectly, then press the "Backspace" key, this will convert it back into a sprite sheet so that you can press the "Animate" button and specify the frames manually.

Create a button "Batch animation" with three options : Select all / Select Selected format ( png, jpg ... ) / Select selected picture.

Then, the software use the auto detection grid you allready use for solo animation, and do it for every selected image.

Not sure about the options. Many engine use specific formats (GMS has bz2qui, and Unity about two dozen different kinds, RAW, DDS, ETC, ATC, CRN etc.), so selecting by format is not really viable.

The "Scan for sprites" feature simply iterates on all sprite sheets and converts all into an animation if possible. The only drawback is that the ordering of the detected sprites differs from the ordering that you see initially, I'll look into that. I probably forgot to call sort, going to be an easy fix.

Also, is there a way to add a "speed regulation" of animation ? For example, to speed or or slow down animations.

No, but I can add something like this. Currently the animations use whatever is specified (if the engine stores that), and defaults to 10 frames per sec otherwise. Exporting this duration to gif is a different story though, because gif stores centisecond delays, and most software doesn't care about this parameter at all (for example Firefox has a fixed frame rate too, no matter what's specified in the gif's header). Anyway, the frame's duration is already converted and saved on a best effort basis, so if frame rate can be extracted from the game files, it should already influence the exported gif's duration.

Anyway, good work on this, one of the most usefull tool on this website.

Thanks!

 

[justaplayer69]

New release, v1.8! Some stability fixes, but mostly user feature requests including SRPG Studio support.

Windows: https://attachments.f95zone.to/2025/03/4654617_gameripper-windows.zip
Linux: https://attachments.f95zone.to/2025/03/4654618_gameripper-linux.zip
Source: https://attachments.f95zone.to/2025/03/4654619_gameripper-src.zip
Repo: gitlab.com/gameripper/gameripper

Changelog:
- Modifier key issue on Win10 should be fixed
- Force a specific language on the command line with the "-l (lang)" flag
- Increased contrast on button labels (hopefully more readable)
- The "Decrypt / Unpack All" button now saves files under the "unpacked" directory
- The "Scan for sprites" button generates animations in the same order as the original order
- You can change the animation speed with the + and - keys (also saved into anim GIF)
- Lots of minor fixes on engine and asset format detection code
- Added support for SRPG Studio (runtime.rts, data.dts, *.srk files, encryption key autodetection)
- Unity: support non-standard LZ4 compression in streams
- GMS: removed some false positives (specifically Godot games were misdetected)
- Kirikiri: properly detect engine when there's a "plugins" directory
- RGSSA: fixed progressbar

About the shift issue on Windows, I was unable to reproduce it, so I couldn't test this, but I've added some failsafes. Should work.

About button label contrast, again, it was already fine on my monitor, but this is very monitor setup specific, hard to get it right. Should be better now though.

About the animation speed, it is stored in anim GIFs, but keep in mind that most players don't care about this parameter in GIF files.

It turned out that Unity is buggy as hell, it is using a stream compression that the official LZ4 code can't uncompress... After lots of trial and error, I finally managed to get a code that works.

SRPG Studio ripping works now for unencrypted and encrypted versions, with default and custom encryption key as well.
EDIT: special thanks to notamuted for figuring out SRPG custom keys and uneasy_speedy for providing test data! Thanks to them, SRPG key is now autodetected in GR.

 

[justaplayer69]

Hi, thewhitespirit

since I couldn't test this because it was working fine for me, I'm curious. Did the workaround in v1.8 solve your "navigating with mouse" issue? Or do I have to investigate further? Could you please test it and report it back?

 

[thewhitespirit]

Did the workaround in v1.8 solve your "navigating with mouse" issue?

Hi. Thanks for the update.
Navigation with mouse works fine now on win10. Let me know if you need more testing (or specific tests to see which failsafe does the job or something).

- Modifier key issue on Win10 should be fixed

Yessss.

- Force a specific language on the command line with the "-l (lang)" flag

Lang flag works, thank you.

- Increased contrast on button labels (hopefully more readable)
<...>
About button label contrast, again, it was already fine on my monitor, but this is very monitor setup specific, hard to get it right. Should be better now though.

Seems a bit better now, thanks.
Still less readable than base white text elsewhere, or tab labels, I think.

Spoiler: color suggestion?

You don't have permission to view the spoiler content. Log in or register now.

- The "Decrypt / Unpack All" button now saves files under the "unpacked" directory

Nice.
Pixel Game Maker MV decryption still uses the original png/ogg/js locations though, which is inconsistent with the rest of the engines now. Is there a specific reason for that? Would it make sense to use "unpacked" directory for these as well? Just dump raw png/ogg/ect. isolated in "unpacked" while preserving the folder structure, and then let the user do whatever they need — inspect & delete, or replace game files with the unencrypted ones if needed.

- You can change the animation speed with the + and - keys (also saved into anim GIF)
<...>
About the animation speed, it is stored in anim GIFs, but keep in mind that most players don't care about this parameter in GIF files.

Nice. Changing preview speed is definitely nice.
With that, it would probably make sense to add a way to reset the speed to default, and display current animation speed (to know what it is and to maybe match it with other anims). Not sure if it's worth to spend time on though.