Skip to content

Instantly share code, notes, and snippets.

@LukeZGD
Last active October 8, 2024 07:09
Show Gist options
  • Save LukeZGD/64b0ecfb7eaccdfbb327ddfea4621723 to your computer and use it in GitHub Desktop.
Save LukeZGD/64b0ecfb7eaccdfbb327ddfea4621723 to your computer and use it in GitHub Desktop.
Nekopara Data Extraction for Vol. 1, 0, 2, 3, 4, and Extra

Nekopara Data Extraction for Vol. 1, 0, 2, 3, 4, and Extra

  • This guide can also be used in other VNs that have the Kirikiri/CatSystem2 engine

Tools Needed:

Usage of KrkrExtract (extraction of assets for all games except Vol. 3)

  • Note: old version (1.0.3.1) is used here, not sure if some of the steps here are needed for the newer version
  • Prerequisites: You need the KrkrExtract .exe and .dll. If on Windows 10, disable Windows Defender Virus & Threat Protection first BEFORE downloading! You can find this on: Windows Defender Security Center > Settings > Virus & Threat Protection Settings > Turn Off Real-time Protection
  • You may also add an exception to KrkrExtract.exe in Exclusions (also in Virus & Threat Protection settings)
  1. Put the KrkrExtract .exe and .dll in the game directory
  2. Drag the game .exe to KrkrExtract.exe. This should cause the game to open along with KrkrExtract
  3. Check Full Unpack (you can skip this if it crashes)
  4. Drag the .xp3 files to the KrkrExtract window, there will be a new folder called outPath with the extracted files
  • You may repeat step 4 on all .xp3 files

E-mote models (for all games)

  • Note: Nekopara Extra is the best source for the E-mote models, as it contains all of the models used in all Nekopara games (this may have changed now with Vol. 4, but I can't check yet)
  1. Extract the contents of emotewin.xp3 using KrkrExtract (replace emotewin.xp3 with emotedx.xp3 for Extra, psz.int for Vol. 3 using GARbro)
  2. You can now use EmtConvert from FreeMoteToolkit on a cmd window to convert the .psb's to pure .psb's (this step is not needed for Extra)
  • Usage: EmtConvert.exe <drag PSB/PSZ file> 742877301
  • You may repeat step 2 on all other .psb's
  • Pure .psb's can be used on the other tools in the FreeMoteToolkit. One usage is to view it with the FreeMoteViewer by dragging the pure .psb to FreeMoteViewer.exe

Scene/script files (for all games except Vol. 3)

  1. Extract the contents of data.xp3 using KrkrExtract
  2. Go to outPath/data.xp3/scn
  3. You can now open the .tjs file using a text editor, or open the .scn file using KrKrZSceneManager (ScnEditorGUI)

Opening .amv files (for all games except Vol. 3)

  • Note: old version is used here (AlphaMovieDecoderFakeOld); KrkrExtract also seems to have a built-in amv decoder now on the latest version
  1. Most if not all .amv files are in adultsonly.xp3 so extract that first with KrkrExtract
  2. You can now use AlphaMovieDecoder on a cmd window to extract the frames of the .amv files Usage: AlphaMovieDecoderFake.exe -amvpath=<drag AMV file>

Usage of GARbro (extraction of assets for Vol. 3 only)

  1. Open the .int file in GARbro
  2. You can now extract everything by selecting all, right-click, extract
  3. You can set up the extraction with the options: Extract images, Extract audio, Convert audio to common format, and Save images as your preferred format (PNG is recommended)
  4. You can now repeat these steps to all other .int files
  • For animated scenes in image_ev.int, you need to double-click the .hg3 (eg. CG3_04c_anime.hg3) and you can now extract all the frames in there

Scene/script files (for Vol. 3 only)

  1. Extract the contents of scene.int using GARbro
  2. You can now open the .cstl files in CatSceneEditor (CatSystemEditor)
Copy link

ghost commented Nov 27, 2020

Not directly a problem with this guide, but, if Volume 4 is added to the guide, it seems AlphaMovieDecoder may not be working properly with that game's videos, at the moment? The first frame of a H-scene comes out as black, and removing that black frame causes the video to not loop smoothly. Perhaps there may need to be an updated AlphaMovieDecoder, to fix this issue, and to have all frames be extracted correctly?

EDIT: Using the "Old" version of AlphaMovieDecoder has fixed my issues, it seems. Please ignore this,

@FunnyDannyG
Copy link

Everytime I drag the nekopara volume 4 exe file into Krkrextract, absolutely nothing happens. I am using the latest version of the game on steam and 1.0.3.1 of krkrextract. Am I doing anything wrong?
image

I ended up just using a cracked version of the game because apparently the drm on the steam version prevents it from launching properly.

@FunnyDannyG
Copy link

where did you find the crack ?

i just googled for it

@Wizzi131
Copy link

Wizzi131 commented Nov 29, 2020

hi could somebody explain how to use the alphamoviedecoder, because the instructions are quite unclear at least to me and cant seem to get it to work at all. Specifically what does it mean by use alphamoviedecoder on a command window.

@LukeZGD
Copy link
Author

LukeZGD commented Nov 29, 2020

hi could somebody explain how to use the alphamoviedecoder, because the instructions are quite unclear at least to me and cant seem to get it to work at all. Specifically what does it mean by use alphamoviedecoder on a command window.

Open a cmd window, drag AlphaMovieDecoder exe to the cmd window, add a space, add -amvpath=, drag the amv to the cmd window, press enter

Same thing goes for EmtConvert: open a cmd window, drag EmtConvert exe to the cmd window, add a space, drag psb/psz file, add a space, add 742877301, press enter

@Wizzi131
Copy link

Wizzi131 commented Nov 29, 2020

hi could somebody explain how to use the alphamoviedecoder, because the instructions are quite unclear at least to me and cant seem to get it to work at all. Specifically what does it mean by use alphamoviedecoder on a command window.

Open a cmd window, drag AlphaMovieDecoder exe to the cmd window, add a space, add -amvpath=, drag the amv to the cmd window, press enter

Same thing goes for EmtConvert: open a cmd window, drag EmtConvert exe to the cmd window, add a space, drag psb/psz file, add a space, add 742877301, press enter

Thanks a lot for the explanation, tho I'm not sure whats going on here as I get an error with a bunch of question marks. Sorry to be of bother but do you have any idea what this might mean? and how to fix it perhaps.

Inkedbandicam 2020-11-29 16-38-36-235_LI (2)

EDIT: nvm figured it out, just me being dumb. thanks for the help again lol

@TheElectreKid
Copy link

Everytime I drag the nekopara volume 4 exe file into Krkrextract, absolutely nothing happens. I am using the latest version of the game on steam and 1.0.3.1 of krkrextract. Am I doing anything wrong?
image

I ended up just using a cracked version of the game because apparently the drm on the steam version prevents it from launching properly.

Do you still have the files for Vol. 4? I wanna try it out on the Kirikiroid2 emulator

@FunnyDannyG
Copy link

Do you still have the files for Vol. 4? I wanna try it out on the Kirikiroid2 emulator

it's the first result on google for "nekopara volume 4 crack" i dont want to link to anything here lol

@RalkeyOfficial
Copy link

krkr doesn't work on nekopara v4. it just simply crashes. any1 got an explanation or fix?

@GribanovIvan
Copy link

KrKrExtract closes? No - all fine
Yes - you use 1.0.3.1? No - use 1.0.3.1
You are uses 1.0.3.1 and that not working? No - all fine
Yes - do not use steam version, download crack
You know where download crack? Yes - do it
No - Pirate Bay

@JohnSmith2007
Copy link

JohnSmith2007 commented Dec 26, 2020

KrKrExtract closes? No - all fine
Yes - you use 1.0.3.1? No - use 1.0.3.1
You are uses 1.0.3.1 and that not working? No - all fine
Yes - do not use steam version, download crack
You know where download crack? Yes - do it
No - Pirate Bay

These statements are all bullshit. Please just update the software so i can get dem SWEET, SWEET hEnTaI scenes from Vol. 4

@JohnSmith2007
Copy link

krkr doesn't work on nekopara v4. it just simply crashes. any1 got an explanation or fix?

Krkr doesn't crash for me and I as able to extract the files from the xp3 files
The thing is all the scenes are png's not gifs or mp4's you will have to do that manually

are you shitting me? so i have to go through each png to string them together to form a gif?

@JohnSmith2007
Copy link

Also, @LukeZGD, please remove the "4" from the repository title until it gets updated so it'll actually work with Nekopara Vol. 4, because several of these programs don't work with it, on both tha retail and cracked versions of the game.

@fumiichan
Copy link

fumiichan commented Feb 5, 2021

For Nekopara volume 4

KiriKiriExtract 4.x doesn't work on almost visual novels I had on my PC. It is complete bullshit. 1.0 is fine, but it will just throw internal error so making it unusable.

EDIT: KirikiriExtract 5.0.0.0-rc1 should work.

You can unpack vol4.xp3 just fine on Garbro without encryption.
Screenshot of Garbro viewing image from vol4.xp3

Unpack it and you get access to .psb files and you can do the rest with freemote. Do not convert, there's no need to convert it.
Usage: FreeMoteViewer.exe <path to psb file>
Screenshot of Freemote Viewer viewing Coconut's PSB Model

krkr doesn't work on nekopara v4. it just simply crashes. any1 got an explanation or fix?

Krkr doesn't crash for me and I as able to extract the files from the xp3 files
The thing is all the scenes are png's not gifs or mp4's you will have to do that manually

are you shitting me? so i have to go through each png to string them together to form a gif?

No you don't need to do them by hand. You can use ffmpeg to string them together into a gif. See here

krkr doesn't work on nekopara v4. it just simply crashes. any1 got an explanation or fix?

No don't use it. It's complete garbage. Use Garbro.

@HAHALOSAH
Copy link

Screen Shot 2021-12-18 at 12 12 23 PM
is this normal?

@afterdelight
Copy link

How to convert .amv files to gif with the right fps?

@AtlasC0R3
Copy link

AtlasC0R3 commented Feb 6, 2023

No clue if there's still interest in this type of stuff, but I found a way to make the extractor work with the Steam version of the game. Without the need for shady cracks. But you do you, the game is crazy simple to run with a run-of-the-mill Steam emulator too.

TL;DR go in Steam, game properties, set launch options to "E:\SteamLibrary\steamapps\common\NEKOPARA Vol. 1\KrkrExtract.exe" %command%, run game via Steam
For Linux/Proton users, rename the extractor to the game's executable file, rename the game's executable to game.exe and set game.exe inside Steam's launch options.

Normally what happens when dragging the normal game's EXE into the extractor, the extractor does indeed inject into the game and launches it, but the game itself realizes it was not launched with the Steam DRM, and thus the game asks Steam itself to launch the game (to correct a user mistake presumably, y'know you did launch the game after all...) then terminates the EXE.. leading the extractor nowhere, and the user to the game that Steam just properly launched (without the extractor obviously).

You can make Steam launch the extractor instead of the game however. By going inside the game's launch options, and putting the full path of the extractor, followed by %command%, Steam will instead launch the extractor within the DRM environment, then the extractor will launch the game with itself injected to it, and the game will happily launch since it is into the DRM environment.
EDIT: Or you can literally just rename the executable files inside the game's directory so that Steam launches the extractor, and using the launch arguments to then instructs said extractor to launch the actual game's executable. For example: name KrkrExtract to the game's executable (example, nekopara_vol1.exe), rename original game file to something like game.exe and then in the launch arguments just add game.exe.

I have not been able to get this to work under Linux with Proton however. I cannot get the main startup.tjs file to properly decrypt, I honestly wish to find a solution to that problem as it's really what's been preventing me from running the game via, say, krkrsdl2.
I only personally tested this on Vol. 1 as well! It is very well possible that this doesn't work with future releases, but I honestly have no clue how that could happen.

@King12689
Copy link

King12689 commented Feb 28, 2023

hello and good day @LukeZGD the krkrExtract.exe you mentioned above isnt working i tried the steps u meantioned above about the krkrExtract but the tool
doesnt boot can you help me to convert this? and also what do you mean in the "Usage of KrkrExtract (extraction of assets for all games except Vol. 3)" what do you mean the tools doesnt work in vol3? if so how didi you do it? bro pls help me

@King12689
Copy link

i follow all the instruction but the krkrExtract didnt work i did all the steps in extracting xp3 files but i cant because the krkrExtract didnt work
im whacking my brain here how to make it work i really want to play this VN i only need to convert the vol 3 and vol 4 and that would be great if that happens but i think it will be too difficult to me for now pls can someone give me full instruction about this and why does krkrExtract doesnt working

@R1A1Y
Copy link

R1A1Y commented Jun 18, 2023

What can we do with ScnEditorGUI? Can we view or do anything with the scenes we edit?

@TacticalJunkie
Copy link

any idea where you can find the Japanese subtitles. I'm trying to train a voicemodel for Azuki?

@King12689
Copy link

after extracting all of this how are we supposed to play this in android?

@HollowSamurai
Copy link

Nekopara vol.3 have frames in .hg3 files, how can i pack this frames in hg3 file?

@King12689
Copy link

how to repack this? into game? should we repack this into xp3 or what? pls answer

@King12689
Copy link

i dont know what to do next about this sir @LukeZGD i extracted all the .init files all of them then whats next? there are hg3 files should i extract them all? and also what to do next? and also should we repack this all as xp3?

@King12689
Copy link

because we are too confused

@Solar-Chris
Copy link

For anyone with trouble Extracting the data using KrkrExtract

https://youtu.be/ovdZl9nEqJU?si=PrQxXEVUk17yE8wT

And for those Who're still trying to Decrypt the Psb files

https://youtu.be/v7e9isF7UbU?si=cxPWHMhfKioQt2_o

@supersrini51816
Copy link

hi could somebody explain how to use the alphamoviedecoder, because the instructions are quite unclear at least to me and cant seem to get it to work at all. Specifically what does it mean by use alphamoviedecoder on a command window.

Open a cmd window, drag AlphaMovieDecoder exe to the cmd window, add a space, add -amvpath=, drag the amv to the cmd window, press enter

Same thing goes for EmtConvert: open a cmd window, drag EmtConvert exe to the cmd window, add a space, drag psb/psz file, add a space, add 742877301, press enter

Hello, I get this error message every time I try to extract the amv file. I'm not sure what I am doing wrong. スクリプトで例外が発生しました
file://./c/users/----/downloads/nekopara_vol_4/nekopara vol 4/neko4_h02c1a.amv はXP3 アーカイプではないか、対応できない形式です。アーカイプファイルを指定すべき場面で通常のフ
アイルを指定した場合、あるいは対応できないアーカイプファイルを指定した場合などにこのエラーが発生しますので、確認してください

@Belxsi
Copy link

Belxsi commented Oct 6, 2024

hi could somebody explain how to use the alphamoviedecoder, because the instructions are quite unclear at least to me and cant seem to get it to work at all. Specifically what does it mean by use alphamoviedecoder on a command window.

Open a cmd window, drag AlphaMovieDecoder exe to the cmd window, add a space, add -amvpath=, drag the amv to the cmd window, press enter
Same thing goes for EmtConvert: open a cmd window, drag EmtConvert exe to the cmd window, add a space, drag psb/psz file, add a space, add 742877301, press enter

Hello, I get this error message every time I try to extract the amv file. I'm not sure what I am doing wrong. スクリプトで例外が発生しました file://./c/users/----/downloads/nekopara_vol_4/nekopara vol 4/neko4_h02c1a.amv はXP3 アーカイプではないか、対応できない形式です。アーカイプファイルを指定すべき場面で通常のフ アイルを指定した場合、あるいは対応できないアーカイプファイルを指定した場合などにこのエラーが発生しますので、確認してください

The same problem, no one has figured out how to work with amv files yet?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment