Skip to content

Instantly share code, notes, and snippets.

@LukeZGD
Last active March 20, 2024 07:25
Show Gist options
  • Star 50 You must be signed in to star a gist
  • Fork 6 You must be signed in to fork a gist
  • 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)
@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

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