rainmakerv3/BB_Launcher
Watch
1
0
Fork
You've already forked BB_Launcher
 0
mirror of https://github.com/rainmakerv3/BB_Launcher.git synced 2026-10-15 17:34:27 +02:00
Code Issues Projects Releases Packages Wiki Activity
Dedicated launcher/mod manager combo app for Bloodborne on shadPS4
616 commits 2 branches 80 tags 309 MiB
  • C++ 57.5%
  • CMake 25%
  • C 10.3%
  • QML 6.5%
  • QMake 0.4%
  • Other 0.2%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
rainmakerv2 0fdce9f094 start 16.13
2026-10-10 18:33:00 +08:00
.ci Bump to clang format 19 same as shad 2025-02-19 09:26:15 +08:00
.github CI: go back to prerelease running only for master 2026-07-01 10:47:54 +08:00
cmake redo cmake presets, fix toml11 compile option 2025-11-02 07:42:00 +08:00
dist Change the button icons to the presumably most used things 2026-07-04 06:02:36 +08:00
documents Readme reworks, added Windows building docs and workflow ignores 2026-02-04 01:26:03 +03:00
externals zar support pt 1: booting and mod manager 2026-08-08 00:44:12 +08:00
modules start 16.13 2026-10-10 18:33:00 +08:00
qtstatic add libs w/ placeholder code 2025-11-25 13:45:03 +08:00
settings fix 2026-10-10 18:10:14 +08:00
WebView2SDK add libs w/ placeholder code 2025-11-25 13:45:03 +08:00
.clang-format First release 2025-01-02 10:54:38 +08:00
.gitignore Build with static libs to eliminate all DLLs 2025-11-10 22:21:42 +08:00
.gitmodules zar support pt 1: booting and mod manager 2026-08-08 00:44:12 +08:00
CMakeLinuxPresets.json redo cmake presets, fix toml11 compile option 2025-11-02 07:42:00 +08:00
CMakeLists.txt zar support pt 1: booting and mod manager 2026-08-08 00:44:12 +08:00
CMakePresets.json debug tweaks 2026-06-02 13:15:59 +08:00
CMakeWindowsPresets.json redo cmake presets, fix toml11 compile option 2025-11-02 07:42:00 +08:00
LICENSE Create LICENSE - unmodified from GPL3 template 2025-01-10 20:05:23 +08:00
main.cpp cleanup startup code 2026-04-08 12:12:52 +08:00
README.md Update credits section in README.md 2026-05-24 05:57:35 +08:00

README.md

BBLauncher

A dedicated shadPS4 launcher focused entirely on Bloodborne, designed to simplify setup, modding, updates, and quality-of-life features while staying fully open source.

Installation & Usage

Windows

  1. Install Visual C++ Redistributable (x64): https://aka.ms/vs/17/release/vc_redist.x64.exe (Required for shadPS4 as well.)
  2. Extract BBLauncher to any folder.
  3. Run BBLauncher.
  4. Click Manage Builds and download shadPS4.
  5. Set the shadPS4 install folder (for example: CUSA03173, depending on your game serial).

Skipping the GUI

Once the install folder is configured, the GUI can be skipped by launching BBLauncher with the following argument:

-n

On macOS, use:

--args -n

Mod Installation

  1. Place mods inside the following directory:
BBLauncher/Mods
  1. Use the mod folder icon in the launcher for quick access.

Recommended Setup

It is highly recommended to install Bloodborne using a separate update folder. This allows BBLauncher’s Mod Manager to apply optimizations more effectively. If a reinstall is needed, only the update needs to be reinstalled, not the entire game.

Mod Folder Structure

Inside the Mods folder:

  • Each mod must be inside its own folder.
  • That folder should contain only valid Bloodborne directories, such as:
    • dvdroot_ps4
    • or individual subfolders like sfx, parts, map, etc.

Features

  • Fixes the 60 FPS crash sound glitch
  • Automatic save backups at configurable intervals
  • Built-in Mod Manager
    • Inspired by Generic Mod Manager (Nexus)
    • Automatically structures folders
    • Includes error checking
  • Download mods directly from the launcher
  • Update shadPS4 from within the app
  • Remap controls and change shadPS4 settings
  • Download and enable Bloodborne patches
  • View save information and restore backups via GUI
  • Trophy viewing and unlocking

Common Issues

"The procedure entry point…" error on launch (Windows): If you encounter this error, re-download both shadPS4 and BBLauncher. Starting from BBLauncher v12.00, external DLLs are no longer required, so this issue should no longer occur.

Linux file location change: As of v10.02, the BBLauncher data folder (previously located next to the AppImage) has been moved to:

/usr/share/BBLauncher

To keep your existing mods and settings, simply copy your old files into this directory.

Version History

Full release history is available here:

https://github.com/rainmakerv3/BB_Launcher/releases

Building

Windows (VSCode)

https://github.com/rainmakerv3/BB_Launcher/documents/building-windows.md

Docker:

https://github.com/rainmakerv3/BB_Launcher/documents/building-docker.md

Open Source

BBLauncher is fully open source. You are welcome to build it yourself, contribute, or explore the source code:

https://github.com/rainmakerv3/BB_Launcher

Credits

  • FMOD stream thread, Daviex, LucasPicoli, Az, and mbuzzo1 for code contributions
  • Missake and Brad for testing
  • Noxde and Kyoski for extensive help with save file research
  • Par274 for documentation and code contributions