Blue Protocol Star Resonance - Custom Card and Avatar Icons

Updated for global release files 2025-11-29.
This process involves modifying with files on a live service game, use at your own risk. It is also found to now use AntiCheatEngine, which was not present in either global or TW CBT.
From testing in CBT, using the CN reference patch bundle folder does not appear to read files. Using github method to verify files causes bundles to be deleted. Instead the process will modify the files directly.

References

Files are from video, refer to next section if prefer to download from source.

Tools / Requirements

Unpack / Rebuild - application and script used to unpack and rebuild the pkg files
1. QuickBMS - https://aluigi.altervista.org/quickbms.htm
2. Script - https://github.com/bartlomiejduda/Tools/blob/master/NEW%20Tools/UNITY_TOOLS/Multiple_UnityFS_files_in_one_archive_script.bms
Modding - applications used to edit data
1. Graphic editor - any, should be able to export JPG/PNG format at 1500x2500
2. UABE Avalonia - https://github.com/nesrak1/UABEA
3. WindowResizer - https://github.com/imkuang/WindowResizer

Instructions

Use these names where <pkg> or <unity3d> are called:

<m43.pkg>
<file705.unity3d>

Setup
1. Make sure game is closed, including launcher (check task bar tray)
2. Recommended to create 3 folders - backup, unpacked, modification
3. Navigate to the game directory and copy <pkg> to the backup and modification folder
  a. <..\Blue Protocol Star Resonance\game\release_1.6\game_mini\BPSR_Data\StreamingAssets\container\m##.pkg>
4. Move all applications and tools in the modification folder
  a. QuickBMS, script, UABE Avalonia, and WindowResizer
5. Find / create your image and put in modifications folder
  a. Avatar portrait / chat icon should be sized to 1500x1500
  b. Avatar card / dungeon image should be sized to 1500x2500
  c. Sizes are recommended for resolution purposes, but can be any 1:1 and 3:5 (will need to adjust WindowResizer steps)
Extract
1. Open QuickBMS <quickbms.exe>
2. Navigate and select the script <Multiple_UnityFS_files_in_one_archive_script .bms>
3. Navigate to the backup directory and select <pkg>
4. Navigate and select the unpacked folder from step 0.2
5. Allow script to complete. Press enter to close the quickbms shell
  a. The unpacked folder should now have around files titled <file###.unity3d>.
6. Create a copy of <unity3d> into both backup and modification folder
Modify
1. Open UABE Avalonia <UABEAvalonia.exe>
2. "File" -> "Open" , then select the <unity3d> file from the modifications folder. Can also drag and drop instead
  a. Decompress to memory for convenience
3. Select "Info" at the bottom right
4. Select the "personalzone_player_bg_3" so that it is highlighted
5. Select "Plugins", "Edit Texture", then "Ok"
6. Select "Load" and navigate to your PNG from step 0.5 (either, this step will be repeated for the other)
7. Select "Save"
  a. "Texture Edit" and "Plugins" window will close and back to the "Assets Info" window
8. "File" -> "Save", then close the "Assets Info" window
  a. Dialog box may appear stating to complete changes in bundle window. Just click Ok
9. In the "UABEA" bundle window, select "File" -> "Save"
10. Recommended to leave program open if wanted to test various images / upload to both PFP and card
Repack
1. Copy the <unity3d> from the modifications folder into the unpacked folder and replace the file
2. Open QuickBMS reimport3 <reimport3_localizations.bat>
  a. Reason being is the pkg will increase in size, which reimport.bat cannot perform
3. Navigate and select the script <Multiple_UnityFS_files_in_one_archive_script .bms>
4. Navigate to the modification directory and select <pkg>
5. Navigate and select the unpacking folder from step 0.2
6. Allow script to complete. Press enter to close the quickbms shell
  a. The <pkg> in the modification folder should be bigger than original (103479KB)
7. Copy the modifications <pkg> into the game directory and replace
Photo
1. Launch BPSR, go near the photo booth but do not enter, and set the game into window mode. Increase settings to max if needed
2. Right click on WindowResizer <WindowResizer.exe> and run as administrator
3. Select "开始查找窗口" (top right button) then click into BPSR game
  a. Confirm that BPSR shows in the 2nd box
4. In the two 窗口宽度 boxes, enter 545x2152 (top and bottom respectively), the press the 设置 button (to the right of the boxes)
5. In BPSR, enter the photo mode, select any low emote (sit/lay/play dead), and change the background to the 3rd image
  a. Image should appear and repeated vertically
6. Drag the picture window to the top
  a. If this is the portrait, you may press V to take the photo here and skip to step 4.12
7. In WindowResizer, set the resolution to 545x3130 and apply
8. Drag the picture window to the top
9. In WindowResizer, set the resolution to 545x6191 and apply
10. Drag the picture window to the top
11. Press V to take the photo
12. In WindowResizer, set the resolution to 1920x1080 (or any normal resolution) and apply
13. Confirm the photo is to taste and redeem
  a. You can continue to modify image and files while game is open starting from step 2.1. Game does not need to be closed when replacing the .pkg as long as you are not in the photo mode
  b. Upload will take some time before it reflects to all players
Cleanup
1. Close game and launcher
2. Copy the backup <pkg> back into the game directory to restore file integrity

Changelog

20251129 - Removed hard callouts to file names, updated from m39 > m43 and file99 > file705.
20251008 - Removed CBT files, added global release
20250912 - Added TW CBT files

Blue Protocol Star Resonance - Custom Card and Avatar Icons

References

Tools / Requirements

Instructions

Changelog

Warning