diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index a7b5e9b..bdf987e 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -15,7 +15,7 @@ jobs: - name: Setup Ruby uses: ruby/setup-ruby@v1 with: - ruby-version: '3.1' # Not needed with a .ruby-version file + ruby-version: '3.2' # Not needed with a .ruby-version file bundler-cache: true # runs 'bundle install' and caches installed gems automatically cache-version: 0 # Increment this number if you need to re-download cached gems - name: Build with Jekyll diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml index 6564156..91d6804 100644 --- a/.github/workflows/pages.yml +++ b/.github/workflows/pages.yml @@ -34,7 +34,7 @@ jobs: - name: Setup Ruby uses: ruby/setup-ruby@v1 with: - ruby-version: '3.1' # Not needed with a .ruby-version file + ruby-version: '3.2' # Not needed with a .ruby-version file bundler-cache: true # runs 'bundle install' and caches installed gems automatically cache-version: 0 # Increment this number if you need to re-download cached gems - name: Setup Pages diff --git a/assets/images/getting-started/fmodel_985mxhyhpn.png b/assets/images/getting-started/fmodel_985mxhyhpn.png new file mode 100644 index 0000000..1b9d19a Binary files /dev/null and b/assets/images/getting-started/fmodel_985mxhyhpn.png differ diff --git a/assets/images/getting-started/fmodel_ebd9hxtt5s.png b/assets/images/getting-started/fmodel_ebd9hxtt5s.png new file mode 100644 index 0000000..b651bf1 Binary files /dev/null and b/assets/images/getting-started/fmodel_ebd9hxtt5s.png differ diff --git a/audio/index.md b/audio/index.md index bcf9aee..9dda8c3 100644 --- a/audio/index.md +++ b/audio/index.md @@ -3,7 +3,11 @@ title: Audio layout: page nav_order: 4 has_children: true -games: ['P3F', 'P3P', 'P4G', 'P4G Vita', 'P5R'] +games: + - P3F + - P3P + - P4G + - P4G Vita + - P5R --- - -These guides are written primarily for music editing, however a similar process can be followed for editing other audio files like voice lines. \ No newline at end of file +These guides are mainly written for music editing, however a similar process can generally be followed for editing other audio files like voice lines. diff --git a/getting-started/extracting-files.md b/getting-started/extracting-files.md index 4736563..10da293 100644 --- a/getting-started/extracting-files.md +++ b/getting-started/extracting-files.md @@ -3,12 +3,16 @@ title: Extracting The Game's Files layout: page parent: Getting Started nav_order: 1 -games: ['P3P', 'P4G', 'P5R'] +games: + - P3P + - P4G + - P5R + - P3R --- - Before you start making your mod you'll need to extract the game's base files so you can find what you actually want to edit. ## Extracting CPKs + All of the game's files are stored in a number of CriWare CPK files such as `EN.CPK` and `data_e.cpk`. To unpack these you'll need to download [CriFsV2Lib.GUI](https://github.com/Sewer56/CriFsV2Lib/releases/latest), on the page download the file called `CriFsLib.GUI.zip` and extract it somewhere. @@ -17,30 +21,34 @@ Now run `CriFsLib.GUI.exe` and you'll be greeted with a window asking you to sel {% tabs cpk %} {% tab cpk P3P %} -- `data\umd0.cpk` - Main and Japanese Files -- `data_EN\umd0.cpk` - English Files -- `data\umd1.cpk` - Audio and Video Files -{% endtab %} + +* `data\umd0.cpk` - Main and Japanese Files +* `data_EN\umd0.cpk` - English Files +* `data\umd1.cpk` - Audio and Video Files + {% endtab %} {% tab cpk P4G %} -- `data.cpk` - Main and Japanese Files -- `data_e.cpk` - English Files -- `data_movie.cpk` - Video Files -{% endtab %} + +* `data.cpk` - Main and Japanese Files +* `data_e.cpk` - English Files +* `data_movie.cpk` - Video Files + {% endtab %} {% tab cpk P5R %} -- `CPK\BASE.CPK` - Main and Japanese Files -- `CPK\EN.CPK` - English Files -- `CPK\MOVIE_JE.CPK` - Video Files -- `SOUND_E.CPK` - English Audio Files -{% endtab %} -{% endtabs %} + +* `CPK\BASE.CPK` - Main and Japanese Files +* `CPK\EN.CPK` - English Files +* `CPK\MOVIE_JE.CPK` - Video Files +* `SOUND_E.CPK` - English Audio Files + {% endtab %} + {% endtabs %} It's recommended to dump both the main files and the English files at least to start with. {: .info } + > The main files will contain anything that doesn't change with the language (like models) plus the Japanese files. -> +> > The English (or other languages) files will **only** contain the files that are specific to that language (mostly text). After you've dragged your desired CPK into CriFsLib Extractor you'll be able to see the names of all files inside and either extract selected or all files. Right click any file, click **Extract All** and select an appropriate folder; after a little bit all of the files will be extracted into it. @@ -64,26 +72,70 @@ The easiest way to extract files from these archives is [Amicitia](https://githu ![]({%link assets/images/getting-started/personaeditor.png %}) ### Command Line + Although Amicitia is the most user friendly, it's not good for batch extracting files as you can only select one at a time. If you need to perform batch operations you can download [PackTools](https://github.com/tge-was-taken/AtlusFileSystemLibrary/releases/latest). Running it without any arguments will give you some help information. The command you'll likely want to use is `unpack` to extract files from an archive. For example, a simple command to extract all .bin files in a folder (and subfolders) is: {% tabs unpack %} {% tab unpack Command Prompt %} -``` bat + +```bat for /R "Path\To\Folder" %i in (*.bin) do "Path\To\PAKPack.exe" unpack %i ``` + {% endtab %} {% tab unpack Powershell %} -``` powershell + +```powershell Get-ChildItem "Path\To\Folder" -Recurse -Filter *.bin | Foreach {&"Path\To\PAKPack.exe" unpack $_.fullname} ``` + {% endtab %} {% endtabs %} ### Context Menu + The final way to extract files is using [PAKPack-Registry](https://github.com/LTSophia/PAKPack-Registry/releases/latest) which adds a context menu option to unpack and pack PAK archives. After downloading and extracting it just run `PAKPack Registry.exe` and you're good to go. Now whenever you right-click a file you'll have a **PAKPack** option at the top of the menu which can be used to extract the PAK. ![]({%link assets/images/getting-started/pak-context.png %}) + +# Persona 3 Reload + +P3R is different than all the other Persona games on pc so far, since it uses the Unreal Engine, and uses IO Store +That means all the data assets are stored in .pak file. +That means you need the program [Fmodel](https://fmodel.app/) to extract the data + +### Setting up Fmodel + +Once you have downloaded Fmodel, extract the exe and run it, +Now you need to add the P3R game files to the program. +Go to Directory -> Selector. A pop up window will appear where you can add undetected game. +Name it P3R and browse to where your .pak files are located. +This will differ depending on if you have the game on Steam or Gamepass/ where you have installed the game +The default steam path would be: `C:\Program Files (x86)\Steam\steamapps\common\P3R\P3R\Content\Paks` +Then you click the blue "+" to add the game to the list + +![]({%link assets/images/getting-started/fmodel_ebd9hxtt5s.png %}) + +Now P3R should be on your Detected game list. Make sure the engine version is "GAME_UE4_27" +Click Ok and now Fmodel should load all the files +Next you need to enter the AES key, since the .pak files are encrypted. +Go to Directory -> AES +Then for the Main Static Key you input: `0x92BADFE2921B376069D3DE8541696D230BA06B5E4320084DD34A26D117D2FFEE` +Click Ok and all the archives on the left should now be green +Select the loading mode to All +And click the load button +Now you got a tree view of all the asset files you can extract and preview + +![]({%link assets/images/getting-started/fmodel_985mxhyhpn.png %}) + +Now simply browse to an asset you want to extract +If we browse to `P3R/Content/Xrd777/Characters/Player/PC0001/Models/T_PC0001_C001_00_Col.uasset` and double click it. +We can see it is the texture for the MC's outfit. If you right click the asset you get some options how to extract it. +Since this example is a texture, we'd select Save Texture (.png) + +These different options is useful depending on what assets you are extracting +If you want to extract the MC's model then you'd select `SK_PC0001_C001` and then Save Model (.psk) diff --git a/using-mods/reloaded-load-order.md b/using-mods/reloaded-load-order.md index 51276fa..901cda5 100644 --- a/using-mods/reloaded-load-order.md +++ b/using-mods/reloaded-load-order.md @@ -1,16 +1,20 @@ --- -title: Reloaded Load Order +title: Reloaded-II Load Order layout: page parent: Using Mods nav_order: 1 -games: ['P3P', 'P4G', 'P5R'] +games: + - P3P + - P4G + - P5R + - P3R --- - In general your load order should not matter as most file types will be automatically merged by Persona Essentials, removing potential conflicts. The only major file types that are not automatically merged currently are BMDs which store messages and SPRs/SPDs which store sprites. ## How Does Load Order Work? -Reloaded loads mods starting at the top and working its way down. That means if two mods edit the same file(s) and Persona Essentials can't resolve the conflict, a mod lower in the list will take priority. + +Reloaded loads mods starting at the top and working its way down. That means if two mods edit the same file(s) and Persona Essentials can't resolve the conflict, a mod **lower** in the list will take priority. In the example below, if the Custom Sub Menu and Detailed Descriptions mods both edited the same file which couldn't be merged, Detailed Descriptions' file would end up being used as it is higher priority. @@ -21,8 +25,10 @@ One exception to this rule is when a mod uses a file emulator to allow automatic ## Is My Load Order Right? The easiest way to tell if your load order is good is to **play the game**. If you find that a mod isn't working then try these steps in order: + 1. Check the mod's Gamebanana page. There may be known incompatibilities that are listed in the description or a comment. 2. Move the mod that isn't working to the **bottom** of the list so it becomes high priority. If this works then you'll likely notice that a different mod breaks, in that case reach out to one or both of the authors to see if they can help make the two compatible. 3. Disable all other mods. -- If that fixes it, enable other mods a few at a time until you find which causes it to stop working. With that found, reach out to one or both of the authors to see if they can help make the two compatible. -- If it still doesn't work, ask for help in the [Persona Modding Discord server](https://discord.gg/naoto) or report the issue to the author directly. \ No newline at end of file + +* If that fixes it, enable other mods a few at a time until you find which causes it to stop working. With that found, reach out to one or both of the authors to see if they can help make the two compatible. +* If it still doesn't work, ask for help in the [Persona Modding Discord server](https://discord.gg/naoto) or report the issue to the author directly.