Swapping the Xbox icons for DualShock4 icons

A quick how-to on replacing the Xbox button icons with DS4 ones. This is, in essence, a modding guide.

Swapping the files

https://github.com/Brolijah/YACpkTool/
https://www.dropbox.com/s/pjgeoo7043ax1ej/sysp_pc_NEW
Extra: My controller config to match the PS4's controls.[www.dropbox.com]

1. Obtain my CPK tool to use for patching or simple extracting and repacking. If you'd prefer building it yourself or inspecting the source code, by all means. I've provided a compiled version of the tool under Releases.
2. Navigate to your Steam installation of Hollow Realization. For example:

X:\Steam\steamapps\common\SAOHR

3. Find inside the pkg folder the CPK representing the language you play. Backup your language file of choice to a place you won't lose it. My primary language is English, so I'm using usa.cpk. Hopefully it won't make much a difference which language you're playing with.
NOTE: From here, you can either extract the entire CPK, swap out /sys/sysp_pc for my sysp_pc_NEW and build the whole thing again, or you can use the patching functionality of my tool. Patching the CPK is incredibly faster than the former, so the following instructions will be explaining how to do that.
4. To keep things simple, place my sysp_pc_NEW file in the same directory as your backup. Then, copy the folder path to your clipboard.
5. Extract my CPK tool to somewhere, and open up the command prompt in that place. (CMD.exe)
6. Enter the following command using the file name of your backup and instead of my example folder path, paste in your folder path you copied earlier:

YACpkTool.exe -d "X:\path\to\backup" -i usa.cpk -R sys/sysp_pc sysp_pc_NEW -o usa_patched.cpk

7. Depending on your CPU, this can take either a few seconds or up to one minute. A very quick process nonetheless. If all has gone well, copy usa_patched.cpk to SAOHR\pkg and rename it back to usa.cpk and boot up the game.

Below is an example of how I use the tool following my own instructions:
Here's some example shots of it in-game:
Unfortunately, I don't have a solution for their indiscriminate usage of Right-Shift vs Right Stick and Left-Shift vs Left Stick. (The regular icons for those just have RS and LS on them.)

Other Information

Why?

I play using a DualShock4 and I also played through this entire game on the PS4 + DLC. I have a preference for these icons and also just because I can. It's a fun side hobby dissecting games.
As a side note, the button icons are arranged so that they are matched with what was the PS4's controls. What I mean by that is the Select button icon (or whatever XBO calls it these days) is currently press down on the Right Side of the Touch Pad. It's just a preference.
Anyway, I was trying to understand some of the data files for weapons and got frustrated with that, so I decided to take a detour with something simpler.

Then I realized there wasn't a very simple way to inject files into CPKs with how they're done now. So I made that tool over the course of a week, cleaned it up, stupid-proofed (hopefully) and shared it with some modders I know on Discord and now here. (Yes, I made a general purpose CPK tool to turn Ys and Bs into Triangles and Circles in a single command.)

What is the result?

I reused the already existing DS4 icons left behind in the files and did some tweaking with Photoshop to make it look decent. The old DS4 icons were roughly 30x30 apiece for the main buttons and d-pad, and the others were slightly different. All in all, they were smaller and needed to be upscaled.
For those who are interested, here are links to my PSD and resulting TGA files I edited:
My PSD project file.[www.dropbox.com]
TGA file prior to flipping the RB channels.[www.dropbox.com]
TGA file after flipping the RB channels.[www.dropbox.com]

How did you do this?

... and assuredly the follow-up question "How can I make my own texture swaps?" There is no easy easy way to do this. It takes patience and basic understanding of hex editing and reverse engineering. If people care enough, it'd take a heap more research and reverse engineering than I am willing to do.

I don't have a perfect enough understanding of PhyreEngine's proprietary file formats to assuredly teach people how this is done. At the very least, I can show where in this file the texture starts at, where I got the width and height. Actually, using this information, I was able to extract all the BGs and CGs from this game. So as far as texture information goes, applying what you see here would help you in other files:
To achieve that number 458752, multiply the Height * Width * Number of Channels * (Bit depth / 8). So 2048 * 56 * 4 * (8/8) = 458752

This texture like a few others has the Red and Blue channels flipped. Some other files have their texure data out of alignment (O_o). The BGs and CGs aren't swizzled by any means, so those won't drive you nuts.

[NPercyC]

easy step for noob like you and me.

1. download first and second link
2. Open CMD
3. Open File Explorer and go to path you just see in CMD
4. extract first zip file to that folder
5. open Steam Library > Right click > Manage > Browse local files
6. open pkg folder and copy sysp_pc_NEW to pkg folder
7. type YACpkTool.exe -d "D:\SAOHR\pkg" -i usa.cpk -R sys/sysp_pc sysp_pc_NEW -o usa_patched.cpk but change to your pkg folder's path
8. just delete usa.cpk and rename patched file to usa.cpk
9. delete 3 files you just extracted and sysp_pc_NEW. you don't need it

have fun

[NoWayG5]

In your path to backup you ca't have spacebar in folder names (FOR EXAMPLE: can't find path if you have "New folder" you need to delete spacebar in name : "Newfolder")

[AGT_ZURU]

I do have a Suggestion, how about, somebody who's got the Compressed Version, with the DS4 Icons, just Uploads that and we can take it from there.

Most people are using the 'usa.cpk' File, so that would be a start.

If I figure out how to Compress it all, and get a stable result, then I will do it to all of the Languages and Upload the lot from there.

[AGT_ZURU]

OK, so the 'Drag And Drop' Method (Credit to @Kitsuma ):
https://www.youtube.com/watch?v=bF8SKnvumfo

The Result is an Uncompressed CPK File, so my Question is how to Compress it back to its Original Size. The 'Drag And Drop' Method does work though, so if File Compression isn't an issue to you, go for it.

Original Size: 702 MB~
New Size: 1,985 MB~ (almost 2 GB)

Trying to make sense of the CMD Method... This is not so easy for the Novices...

[Ruah]

Instructions unclear, deleted windows.

[matheusfigueroa7]

HOW LOW THIS BUSINESS IS IN 2021 I DONT KNOW

[Traven Kirkwall]

i get the same error

[RedynZ]

I've reinstalled the game, However i keep encounter anew error, never had this before last times i did this. Error: Invalid output path specified. Exiting process. The cd is correct, the path are also correct. But i keep getting same error over and over

[elle]

"This app cant run on your pc"

[vampy81]

thank you kind sir