Unpacking/packing packs

Most modding can be done using the Filemaker.
It is a script parser that allows you to: Unpack/pack files, Convert Maya files to Game files, Automatically create dds textures, Make font textures etc.
It has a very simple gui, because the scripts it uses contain all relevant information.

For now we will use it to unpack a pack file.

Pack files

As you may have noticed the pack directory contains several pack files.

Each pack file results in either an story or fastsex element in the story menu and fastsex menu.

We can also use pack directories. A pack directory is an unpacked pack file. It contains all the files from the pack file.

If a pack directory is placed in the ./pack location of XStoryPlayer it works the same as a pack file. But now you can easily edit all files.

Unpacking

1. Goto the ./filemaker directory and open the 'start.ini' file. The start.ini file contains the script code that is parsed when running the filemaker.exe

2. Uncomment the unpack script part like this:

Pack pack1
{
  unpack = true;
 
  file    = "[RUNTIME]pack/pack_dungeon.bin";
 
  outpath = "[RUNTIME]pack/";
}

3. Now run the filemaker.exe, the dungeon pack will automatically be unpacked to the ./pack location

When it is finished you will hear a whistle blowing (Useful for parsing long taking script to get coffee).

4. You should now see ./pack/pack_dungeon directory with in it all files that are in the ./pack/pack_dungeon.bin pack file.

5. Start XStoryPlayer and open the fastsex menu. Here you should now see two dungeon elements instead of one.

6. Open the ./pack/pack_dungeon/story.txt file and change the names like this:

episode saiko
{
  name   = "Dungeon Mod"; // <<-- Change
  ...
}
 
episode monica
{
  name   = "Dungeon Mod"; // <<-- Change
  ...
}

7. Start XStoryPlayer again and you should now see that your pack is renamed to "Dungeon Mod".

8. Press F3 to stop XStoryPlayer directly and proceed with basic code scripting.