Environment variables

The port reads a few hundred environment variables. Some are for players (upscaler, frame rate, controls). Most are diagnostics and developer switches. This page lists every variable found in src/, gpu/, bbsc/, scripts/, launcher/, run.sh, packaging/ and tools/, with what the code does with it. The information comes from the code on main (0.51-linux.16). When a comment and the code disagree, the code wins.

How to set them

In the launcher: go to Advanced → Developer → Extra variables (NAME=value, space-separated). The settings key is extra_env in the launcher's settings.json. The field is parsed in game_environment() (launcher/bbport_launcher.py:693):

for item in s["extra_env"].split():
    if "=" in item:
        key, value = item.split("=", 1)
        env[key] = value

• The field is split on whitespace. Each piece is split at its first =: BB_UPSCALER=fsr4 BB_AUDIO_GAIN=1.5 RADV_DEBUG=nohiz.
• There is no quoting. A value cannot contain spaces, and quotes are kept literally as part of the value (BB_X="a" gives "a" with the quotes). Use separators the variable itself accepts, such as ; or ,.
• A piece without = is ignored without any message. If a name appears twice, the last one wins.
• Any name is accepted, including third-party ones (RADV_DEBUG, MANGOHUD, VK_*, __GL_*).
• The result goes to run.sh. Both the launcher's Play button and --play (Steam shortcut, Steam Deck game mode) use it.

From a terminal (source checkout): BB_GAME_DIR=/path/to/CUSA03173 BB_FPS=60 bash run.sh. Without the launcher, nothing sets the launcher's variables. run.sh then uses its own defaults (game folder ../CUSA03173, uncapped frame rate, and so on).

From a terminal (AppImage): BB_UPSCALER=fsr4 ./Bloodborne-bbport-x86_64.AppImage --play starts the game with the launcher's saved settings. Mind the precedence below: the launcher's own settings replace a variable of the same name from the shell. Extra variables replace both. The AppImage keeps its data (bbport.ini, saves, logs) in BB_DATA_DIR, by default ~/.local/share/bbport.

bbport.ini: many graphics options live in bbport.ini and the in-game menu, not in the environment. A few variables override those keys at start: BB_UPSCALER, BB_UPSCALE_PRESET, BB_FSR_SHARPNESS, BB_JITTER, BB_REACTIVE* and BB_OBJECT_MOTION (gpu/shim/bbport_settings.cpp:192-208). Values set this way stay in force until the next start.

Precedence

The environment is built in this order. A later step wins.

1. The environment the launcher (or the AppImage) was started with.
2. The launcher's own settings (game_environment(), launcher/bbport_launcher.py:619-698).
3. Some are always written: BB_GAME_DIR, BB_MODS_*, BB_PROMPTS, BB_GESTURES_NO_MOTION, BB_PATCHES_*, BB_LANGUAGE, BB_REGION, BB_MENU_LANGUAGE, BB_FULLSCREEN, BB_PRESENT_MODE, BB_SKIP_NETWORK_CHOICE, BB_FPS, BB_DISCORD and BB_STEAM_OVERLAY. For these, a shell value is replaced.
4. Others are written only when the setting is on or not empty: BB_HDR, BB_FPS_LIMIT, BB_DRAW_PIPE, BB_READBACKS, BB_PREUPLOAD, BB_PC_MODEL, BB_GPU_PROFILE, BB_PAD_DEADZONE (only when the dead zone is not 4 %), BB_PAD_LIGHTBAR and others. For these, a shell value survives while the setting is off.
5. Hunter's Atlas (atlas_environment(), launcher/bbport_launcher.py:598): always BB_ATLAS_ENABLED (0 when the map is off or not prepared); with the map on also BB_MAP_DIR, BB_MAP_ART_DIR, BB_MAP_FONT, BB_MAP_CATALOG, BB_MAP_CONFIG, BB_MAP_TRAVEL_ENABLED, BB_MAP_ITEMS_ENABLED, BB_MAP_ITEM_CATEGORIES, BB_MAP_FOG_ENABLED=0 and BB_MAP_NPC_MODE=all.
6. Online (only when Play online is on and the online module exists): scripts/online.py environment() adds BB_ONLINE, BB_SHADNET_*, BB_UPNP, BB_COMMUNITY_SERVER, BB_SEAMLESSHUNT_TOMBS, SHADPS4_P2P_* and the BBSC options (scripts/bbsc.py).
7. Extra variables come last and override everything above, including the launcher's own settings and the BBSC options.
8. run.sh mostly fills in defaults with ${VAR:-default}, so a value you set is kept. It does force a few:
9. BB_AS_0_3=1 forces BB_GUEST_IN_PLACE=0, BB_HOST_COPY_WAITS=all and BB_PRODUCER_CHECK=1.
10. BB_SAVE_LOG=1 forces BB_FRAME_STATS=1.
11. BB_AUTO_RENDER_RES=1 makes run.sh unset BB_RENDER_RES, BB_OUTPUT_RES and BB_UI_RES, so do not set it by hand.
12. When bbport.ini asks for a non-1080p output without live resolution and BB_RENDER_RES is unset, run.sh exports BB_RENDER_RES, BB_OUTPUT_RES and BB_DMEM_MB itself.
13. BB_BBSC_LIB is unset unless BB_BBSC=1 and BB_ONLINE=1.
14. SHADPS4_HTTP_HOST_OVERRIDES_JSON is rewritten whenever online play is on.
15. BB_PRESENCE_DIR is rewritten when Discord is on, and BB_TROPHY_DIR when the trophy list is prepared.
16. MANGOHUD is dropped while Steam's own performance overlay (mangoapp) runs.
17. run.sh exports defaults that differ from the code's built-in ones: BB_COPY_GPU_BUFFERS=1, BB_GPU_WRITE_TWINS=1, BB_GPU_WRITE_TWINS_MAX=65536, BB_PREUPLOAD=1, BB_UFFD=0, BB_GUEST_IN_PLACE=$BB_PC_MODEL, BB_VBLANK_HZ (from BB_FPS) and BB_PC_MODEL (1 on AMD, 0 elsewhere).
18. libbbsc sets BBSC_MOD_SEAMLESS=0 and SHADPS4_BBSC_FIVE_HUNTERS=0 itself on a public game server (The Hunter's Dream, nodreamforthehunter.com, shadps4.net or scej-network.jp; Seamless Hunt is not one), whatever was asked (bbsc/emulator/mod/linux/bbsc_mod_linux.cpp:360, the list in bbsc/emulator/mod/bbsc_http.cpp:245).

Value formats vary from one variable to another:

• The shadPS4-style Flag() (gpu/shim/core/emulator_settings.h:14) takes any value starting with 1, y or t as on.
• Most port switches look at a leading 1, or treat everything but 0 as on.
• A few logs and traps turn on when set to any value, 0 included.
• BBSC switches are off only with 0.

The Values column gives the rule for each variable. Where it says "(default X)", that is the behaviour when the variable is unset. In the tables:

• Launcher: marks variables the launcher writes from a setting. Use the setting rather than the extra field.
• Internal: marks variables set by run.sh or the package. Leave them alone.

Most useful

Variable	What it does
BB_UPSCALER	Upscaler at start: off, fsr3, fsr4, fsr411, taa, dlss (overrides bbport.ini/menu).
BB_UPSCALE_PRESET	Upscaler preset at start: 0 Native AA, 1 Quality, 2 Balanced, 3 Performance, 4 Ultra Performance.
BB_FSR_SHARPNESS	Upscaler sharpening strength, 0–2 (default 0.5).
BB_RENDER_RES	Fixed render resolution WxH patched in at start (presets then need a restart).
BB_FPS	Frame-rate patch: uncap (default), 60, 90 or 30 (launcher: Frame rate → Mode).
BB_FPS_LIMIT	FPS cap; 0 or unset = no limit (launcher: FPS limit).
BB_PRESENT_MODE	Vulkan present mode: Mailbox (default), Fifo (vsync), FifoRelaxed or Immediate.
BB_DISPLAY	Monitor for the window/fullscreen: number or part of its name.
BB_GPU_ID	Which GPU to use, by Vulkan device index.
BB_PC_MODEL	Memory model: 1 = new (default on AMD), 0 = the 0.3 one (default elsewhere).
BB_DRAW_PIPE	Two-stage GPU pipeline, 20–30 % faster: 1 on, 0 off (default on with 8+ CPU threads).
BB_PREUPLOAD	Background upload into VRAM: 0 off, 1 rewritten memory only (run.sh default), 2 everything (~3 GB more VRAM).
BB_ASYNC_PIPELINES	0 makes the game wait for shader compiles instead of skipping a draw for a frame or two.
BB_ANISO	Anisotropic filtering ratio (default 16; 0 = the game's own).
BB_DLSS	0 turns DLSS support off on NVIDIA.
RADV_DEBUG / BB_AUTO_NOHIZ	AMD GCN 3–5 on RADV: run.sh sets RADV_DEBUG=nohiz unless BB_AUTO_NOHIZ=0.
BB_PAD_DEADZONE / BB_PAD_DEADZONE_OUTER	Inner (default 5) and outer (default 127) stick dead zones, of 127 (launcher: Controls → Stick dead zone (%), the inner one).
BB_MOUSE_DEADZONE	Minimum stick deflection used for mouse look (default 16 of 127).
BB_AUDIO_GAIN	Master volume multiplier, up to 8 (default 1.0).
BB_SAVE_LOG	1 saves the log and per-frame statistics to <data>/logs/ (for bug reports).
MANGOHUD	1 shows the MangoHud overlay.

Display & window

Variable	Values (default)	What it does	Where
BB_CJK_FONT	path to a font file (unset: fontconfig's choice for zh-cn)	Font merged into the in-game menu font for Simplified Chinese texts; without one, fc-match picks a system font (Noto Sans CJK, WenQuanYi...), else Chinese text shows as boxes.	gpu/shim/bbport_overlay.cpp:1145
BB_DISPLAY	monitor number (1, 2, ... in SDL order) or part of its name (unset: SDL's primary display)	Launcher: Graphics > Display > Monitor. The monitor the window and fullscreen go to (issue #69); bb-gpu-capabilities --displays lists them, and the log says which one was taken. No match: the primary one.	gpu/shim/window.cpp:16, launcher/bbport_launcher.py:644
BB_FULLSCREEN	1 or 0 (windowed)	Launcher: Graphics > Display > Fullscreen. Creates the game window fullscreen when the value starts with 1.	gpu/shim/window.cpp:116, launcher/bbport_launcher.py:639
BB_GPU_ID	Vulkan device index (-1: automatic ranking)	Which GPU the game uses, by its index in the Vulkan device list; out of range asserts. bb-gpu-capabilities follows it too.	gpu/shim/core/emulator_settings.h:22, gpu/shadps4/video_core/renderer_vulkan/vk_instance.cpp:146, tools/gpu_capabilities.c:257
BB_HDR	1/y/t or unset (off)	Launcher: Graphics > Display > Allow HDR (set only when on). Allows an HDR swapchain (the colour-space extension and an HDR surface format) when the display offers it.	gpu/shim/core/emulator_settings.h:60, gpu/shadps4/video_core/renderer_vulkan/vk_swapchain.cpp:246, launcher/bbport_launcher.py:652
BB_LIVE_RES	0 | 1 (default: bbport.ini live_resolution, else off)	For output sizes other than 1080p: 1 = live resolution changes (guest at 1080p, host targets scaled at run time, change without restart; slower), 0 = startup resolution patch. Overrides bbport.ini live_resolution=0/1/auto. Outputs wider than 16:9 always take the startup patch.	run.sh:75-122
BB_MENU_LANGUAGE	en, ru, es, it, fr, de, pt_BR, zh_CN (first two letters compared; unset: LC_ALL/LC_MESSAGES/LANG/LANGUAGE)	Launcher: the launcher's own language. Language of the in-game menu until one is chosen in it (bbport.ini menu_language wins).	gpu/shim/bbport_settings.cpp:165, launcher/bbport_launcher.py:638
BB_NVIDIA_EGL	0 = off (default on)	Packaged builds with the host NVIDIA driver: sets __EGL_VENDOR_LIBRARY_FILENAMES to the host's EGL vendor files, NVIDIA first (issue #107); 0 leaves it unchanged.	launcher/bbport_vulkan.py:116-124
BB_NVIDIA_LIB_DIR	directory (default none)	Packaged builds: an extra directory searched for the host NVIDIA Vulkan driver library.	launcher/bbport_vulkan.py:74-76
BB_OUTPUT_RES	WxH	Internal (run.sh exports it from bbport.ini output_res for non-1080p outputs without live resolution; unset again on restart). Output size the upscaler fills when the scene is rendered at a startup-patched size (BB_RENDER_RES); also passed to scripts/patches.py.	gpu/shadps4/video_core/renderer_vulkan/vk_temporal_upscaler.cpp:199, run.sh:119, run.sh:190
BB_PRESENT_MODE	Mailbox, Fifo, FifoRelaxed, Immediate (Mailbox)	Launcher: Graphics > Display > Present mode. Vulkan present mode; a mode the driver lacks falls back to Fifo. Any other value logs an error and uses Mailbox.	gpu/shim/core/emulator_settings.h:25, gpu/shadps4/video_core/renderer_vulkan/vk_swapchain.cpp:281, launcher/bbport_launcher.py:640
BB_PRESENT_THREAD	0 = off; else on (on)	Swapchain work runs on a separate swap thread next to the present thread; 0 runs it on the present thread.	gpu/shadps4/core/libraries/videoout/driver.cpp:76-81
BB_RENDER_RES	WxH (unset = live resolution path; scene at the menu's preset)	Explicitly sets the game's render resolution with a patch at start (the older path). Fixes the scene size: presets and resolution then need a restart, and TAA at another size is refused. Above 1920x1080 run.sh raises BB_DMEM_MB to 9152.	gpu/shadps4/video_core/renderer_vulkan/vk_temporal_upscaler.cpp:208, run.sh:71, run.sh:119
BB_UI_RES	WxH (unset: 1920x1080)	Internal (run.sh exports it from patches.py --print-scaled for outputs wider than 16:9 on the startup patch, unless bbport.ini aspect_patch=0; unset again on restart). The game's UI coordinate space: 1080 high and as wide as the output's aspect ratio (2580x1080 for 3440x1440), the HUD canvas width patches.py writes (ultrawide_writes). The UI composition recognizes UI draws by this size and scales them to the output; scripts/hud_layout.py lays out the menu movies for it.	gpu/shadps4/video_core/renderer_vulkan/ui_composition.h:24, run.sh:119-122, run.sh:124
LC_ALL / LC_MESSAGES / LANG / LANGUAGE	locale	In-game menu language when BB_MENU_LANGUAGE is unset; the launcher also derives its UI and game language from the system locale.	gpu/shim/bbport_settings.cpp:151-163, launcher/bbport_i18n.py:4984-5010
VK_ADD_DRIVER_FILES	ICD JSON list	Packaged builds: prepended to the bundled driver list.	launcher/bbport_vulkan.py:72-73
VK_DRIVER_FILES	ICD JSON list (default: loader's)	Vulkan loader's driver list. run.sh --software sets Lavapipe; packaged builds set it to the host NVIDIA ICD plus bundled Mesa unless you set it (or VK_ICD_FILENAMES) yourself; dropped when it points into Steam's pressure-vessel.	run.sh:4-13, launcher/bbport_vulkan.py:66-80, packaging/bbport-entry.c:37-49
VK_ICD_FILENAMES	ICD JSON list	Older name of VK_DRIVER_FILES; if set, packaged builds leave driver selection alone.	launcher/bbport_vulkan.py:66-67
__EGL_VENDOR_LIBRARY_FILENAMES	file list	If set, packaged builds do not replace it with the host's EGL vendor files (see BB_NVIDIA_EGL).	launcher/bbport_vulkan.py:119

Graphics & upscalers

Variable	Values (default)	What it does	Where
BB_ANISO	integer (16); 0 = the game's own samplers	Mipmapped linear samplers of graphics draws get this anisotropic filtering ratio instead of the PS4's (sharper floors, stairs and walls at grazing angles).	gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.cpp:3584
BB_AUTO_NOHIZ	0 = off (default 1)	On GCN 3–5 GPUs under RADV (Polaris, Vega and their APUs) run.sh sets RADV_DEBUG=nohiz to avoid black halos/missing geometry from depth compression; 0 disables that. Ignored if you set RADV_DEBUG yourself.	run.sh:212
BB_DLSS	0 = off; unset = on when available	NVIDIA DLSS through the optional bridge library (libbbport_dlss.so + NVIDIA's libnvidia-ngx-dlss). 0 disables it; without the libraries or on other GPUs nothing changes.	gpu/shadps4/video_core/renderer_vulkan/vk_dlss.cpp:176, gpu/shadps4/video_core/renderer_vulkan/vk_dlss.h:8
BB_FSR1	1/y/t or 0 (off)	shadPS4's FSR 1 pass in the presenter (spatial upscale of the final image); separate from the port's upscalers (bbport.ini upscaler).	gpu/shim/core/emulator_settings.h:59, gpu/shadps4/video_core/renderer_vulkan/vk_presenter.cpp:175
BB_FSR411_DIR	directory (unset = fsr4_411 next to run.sh)	Internal (run.sh sets it to /fsr4_411 when that exists). Where the FSR 4.1.1 assets built by tools/fsr4cap/build_assets.sh are looked up.	gpu/shadps4/video_core/renderer_vulkan/vk_fsr4.cpp:244, run.sh:34, launcher/bbport_launcher.py:449
BB_FSR411_VARIANT	int8 / fp8emu (unset = FP8 when the GPU supports it and its assets exist, else INT8)	Forces which FSR 4.1.1 model variant runs: int8 skips FP8; fp8emu uses the emulated-FP8 set (needs FP16 cooperative matrices).	gpu/shadps4/video_core/renderer_vulkan/fsr411/fsr411.cpp:295
BB_FSR4_DIR	directory (fsr4_shaders)	Where the FSR 4 (v07) SPIR-V passes and weights from tools/fetch_fsr4_assets.sh are loaded from.	gpu/shadps4/video_core/renderer_vulkan/vk_fsr4.cpp:26, gpu/shadps4/video_core/renderer_vulkan/vk_fsr4.h:7
BB_FSR4_LINEAR	0 = off; unset/other = on	FSR 4 gets the game's tonemapped sRGB frame decoded to linear light and the output encoded again. 0 (or toggle bit 63): the encoded frame as before (A/B).	gpu/shadps4/video_core/renderer_vulkan/vk_temporal_upscaler.cpp:1846
BB_FSR4_OPT	0 = originals; unset/other = optimized	FSR 4 uses the fixed/faster passes from fsr4_shaders/opt/ (tools/fsr4_optimize.sh) when present. 0 keeps AMD's original passes.	gpu/shadps4/video_core/renderer_vulkan/vk_fsr4.cpp:126
BB_FSR_SHARPNESS	number 0–2 (bbport.ini sharpness, default 0.5)	Upscaler sharpening (RCAS) strength; overrides the bbport.ini/menu value "sharpness" at start. Above 1 an extra sharpen pass adds the rest.	gpu/shim/bbport_settings.cpp:199, gpu/shadps4/video_core/renderer_vulkan/vk_temporal_upscaler.cpp:1269
BB_INTEL_TONEMAP_FIX	0 | 1 (default: on for Intel CPUs, off otherwise)	Applies the community "Intel Black Tonemap Fix" patch (tone mapping turns black on Intel CPUs, DLC areas most); 0/1 forces it off or on.	scripts/patches.py:59-62, scripts/patches.py:100
BB_INTERP_INT_FIX	1 = on, 0 = off (unset = on for GPUs without fragment-shader barycentrics, e.g. older NVIDIA/Pascal)	Forces the integer-interpolation workaround in translated shaders on or off.	gpu/shadps4/video_core/renderer_vulkan/vk_pipeline_cache.cpp:414
BB_JITTER	0/1 (1; overrides bbport.ini jitter)	Camera jitter for the temporal upscalers.	gpu/shim/bbport_settings.cpp:199, gpu/shadps4/video_core/renderer_vulkan/vk_temporal_upscaler.cpp:354
BB_MOTION_LARGE	0 = off; unset/other = on	Large bone palettes (16–64 KiB, the large beasts) get object motion vectors like small skeletons. 0 leaves them to camera vectors as before.	gpu/shadps4/video_core/renderer_vulkan/motion_history.h:46
BB_OBJECT_MOTION	0/1 (bbport.ini object_motion, off by default)	Per-object motion vectors for the temporal upscaler: less ghosting on characters, about 10% FPS. The variable overrides bbport.ini at start.	gpu/shim/bbport_settings.cpp:202, gpu/shadps4/video_core/renderer_vulkan/vk_object_motion.cpp:58
BB_OCCLUSION_QUERIES	1 = on (off; BB_PM4_SELFTEST=1 also turns it on)	Opt-in: the game's occlusion queries become real Vulkan occlusion queries. Off: counters are a fixed "everything visible" sequence (the 0.3 model), because with an upscaler jittered tests made light glows flash.	gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.cpp:253
BB_ZPASS_IN_ORDER	0 = off; unset/other = on	Without BB_OCCLUSION_QUERIES: the stand-in occlusion counts are written in order with the draws, after the DMA that zeroes the query's block, as on the PS4. Written ahead of it, the game's queries never finished and it made new ones until it read a null handle (issue #23). 0: written at decode, as before.	gpu/shadps4/video_core/amdgpu/liverpool.cpp:588
BB_RCAS	1/y/t or 0 (1)	RCAS sharpening in shadPS4's presenter FSR 1 pass (only with BB_FSR1); not the in-game Sharpening (RCAS) setting.	gpu/shim/core/emulator_settings.h:65, gpu/shadps4/video_core/renderer_vulkan/vk_presenter.cpp:176
BB_RCAS_ATTENUATION	integer, thousandths (250 = 0.25)	RCAS attenuation of shadPS4's presenter FSR 1 pass.	gpu/shim/core/emulator_settings.h:26, gpu/shadps4/video_core/renderer_vulkan/vk_presenter.cpp:178
BB_REACTIVE	0/1 (bbport.ini reactive, off by default)	Reactive mask for the upscaler (opt-in): on Bloodborne's thin mist it trades trails for jitter shimmer. Overrides bbport.ini at start.	gpu/shim/bbport_settings.cpp:200, gpu/shadps4/video_core/renderer_vulkan/vk_temporal_upscaler.cpp:947
BB_REACTIVE_MAX	0-1 (0.9; overrides bbport.ini reactive_max)	Upper bound of the TAA reactive mask (never fully reactive).	gpu/shim/bbport_settings.cpp:201, gpu/shadps4/video_core/renderer_vulkan/vk_temporal_upscaler.cpp:1064
BB_REACTIVE_SCALE	0-16 (1; overrides bbport.ini reactive_scale)	Reactive mask = relative colour change times this scale.	gpu/shim/bbport_settings.cpp:200, gpu/shadps4/video_core/renderer_vulkan/vk_temporal_upscaler.cpp:1064
BB_REACTIVE_THRESHOLD	0-1 (0.2; overrides bbport.ini reactive_threshold)	Reactive mask is zero below this colour change.	gpu/shim/bbport_settings.cpp:201, gpu/shadps4/video_core/renderer_vulkan/vk_temporal_upscaler.cpp:1064
BB_UPSCALER	off / fsr3 / fsr4 / fsr411 / taa / dlss / none (unset = bbport.ini upscaler / in-game menu)	Overrides the upscaler chosen in bbport.ini/menu at start; any unknown value means off. none also disables the upscaler machinery entirely (no camera tracking, the menu cannot turn it on). scripts/patches.py only distinguishes fsr3 from everything else.	gpu/shim/bbport_settings.cpp:192, gpu/shadps4/video_core/renderer_vulkan/vk_temporal_upscaler.cpp:190, scripts/patches.py:511
BB_UPSCALE_PRESET	0 Native AA, 1 Quality, 2 Balanced, 3 Performance, 4 Ultra Performance (overrides bbport.ini preset)	Upscaler preset at start. Note: run.sh's startup render size still comes from bbport.ini; only patches.py --print-preset-size honours it.	gpu/shim/bbport_settings.cpp:202, scripts/patches.py:513
RADV_DEBUG	RADV flags (run.sh may set nohiz)	Mesa RADV debug flags; if you set it, run.sh's automatic nohiz for GCN 3–5 (BB_AUTO_NOHIZ) is skipped.	run.sh:212

Performance & memory

Variable	Values (default)	What it does	Where
BB_ASYNC_PIPELINES	0 = off; anything else / unset = on	New graphics pipelines of passes drawn every frame compile on worker threads while their draws are skipped for a frame or two, instead of the game standing still for the driver. 0: compiled on the GPU thread, the game waits.	gpu/shadps4/video_core/renderer_vulkan/vk_pipeline_cache.cpp:734, gpu/shadps4/video_core/renderer_vulkan/vk_pipeline_cache.h:212
BB_ASYNC_PIPELINE_THREADS	integer ≥1 (unset = CPU threads / 4, clamped 1–4)	Number of worker threads for BB_ASYNC_PIPELINES.	gpu/shadps4/video_core/renderer_vulkan/vk_pipeline_cache.cpp:643
BB_ASYNC_SUBMIT	0 = off; unset/other = on	Submissions go out from the recording threads once their segments are recorded, instead of the GPU thread waiting for them (~65 µs each). Only with recording worker threads.	gpu/shadps4/video_core/renderer_vulkan/vk_scheduler.cpp:150
BB_CONSTANTS_IN_PLACE	1 = on (off)	With BB_GUEST_IN_PLACE: small read-only buffers (constants) are read by the GPU where the game wrote them instead of being copied when the draw is decoded or recorded. Experiment toggle bit 1 inverts it at run time.	gpu/shadps4/video_core/buffer_cache/buffer_cache.cpp:507, gpu/shadps4/video_core/buffer_cache/buffer.h:57
BB_CONSTRAM_PIPE	0 = off; unset/other = on	With the two-stage draw pipe: before the command processor writes guest memory with the CPU (constant RAM dump), it waits only for the queued packets that read those bytes, not all of them.	gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.cpp:900, gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.h:114
BB_COPY_GPU_BUFFERS	first char 1/y/t = on; run.sh exports 1 when unset (code default without run.sh: off)	Internal. The command buffers of each submission are copied when the game submits them and decoded from the copy (the game reused that memory before the GPU thread got to it: "Unimplemented PM4 type 0" after loading a save). 0 decodes guest memory directly.	run.sh:276, gpu/shim/core/emulator_settings.h:56, gpu/shadps4/video_core/amdgpu/liverpool.h:252
BB_COPY_MERGE_KB	integer KiB (64)	Maximum gap between buffer copies of the game's copy shader (HLE path) that are merged into one batch.	gpu/shadps4/video_core/renderer_vulkan/vk_shader_hle.cpp:203
BB_COPY_SHADER_NATIVE	0 = HLE; unset/other = native	With the game's memory in place, the game's buffer copy shader runs as itself (translated). 0: the copy list is read on the CPU and copied by the port (older HLE path). Experiment bit 2 inverts it at run time.	gpu/shadps4/video_core/renderer_vulkan/vk_shader_hle.cpp:272
BB_COPY_THREADS	0-16 (a quarter of the available hardware threads, 1-4)	Number of threads that split large guest memory copies.	gpu/shim/bbport_copy.cpp:30, src/runtime_memory.c:738
BB_DIRECT_SEGMENT	0 = off; unset/other = on	With BB_ASYNC_SUBMIT, commands recorded on the GPU thread (e.g. upscaler passes) get their own command-buffer segment instead of waiting for the recording threads (~90 µs). 0: the wait.	gpu/shadps4/video_core/renderer_vulkan/vk_scheduler.cpp:647
BB_DMEM_MB	MiB, 5056–16384 (default 5056; run.sh sets 9152 for render sizes above 1080p)	Direct memory size reported to the game (retail PS4: 5056 MiB); the resolution patches above 1080p need more or the game exits at start.	src/runtime_memory.c:22-30, run.sh:132, run.sh:132
BB_DRAW_PIPE	1 = on, 0 = off (unset = on with 8+ CPU threads)	Launcher: Advanced > Performance > "Two-stage GPU pipeline" (Auto/On/Off). Two-stage GPU command pipeline (decode and record on separate threads): 20–30% faster; turn off if unstable.	gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.cpp:830, launcher/bbport_launcher.py:657
BB_FAULT_SKIP_TEXTURES	0 = off; unset/other = on	A write fault on a page no tracked image protects skips the texture cache lock (guest threads no longer wait 0.3–0.6 s behind texture uploads). 0: every fault takes the lock, as before.	gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.cpp:4328
BB_FAULT_WINDOW	KiB, clamped 4-1024 and rounded up to a power of two (256)	Size of the window unprotected around a guest write fault (write tracking), so neighbouring writes do not fault again. Window at or below one tracker page = feature off.	gpu/shadps4/video_core/buffer_cache/buffer_cache.cpp:691-698
BB_FPS_LIMIT	frames per second; 0 or unset = no limit	Launcher: Graphics > Frame rate > FPS limit (set only when > 0). Frames per second the present thread lets through.	gpu/shim/core/emulator_settings.h:51, launcher/bbport_launcher.py:655
BB_FRAMES_AHEAD	integer ≥0 (1); 0 = no bound	The GPU command thread runs at most this many guest frames ahead of the GPU, so GPU-bound frames finish at an even rate instead of in bursts.	gpu/shadps4/video_core/renderer_vulkan/vk_presenter.cpp:475
BB_GARLIC_VRAM	0 = off; any other value on (unset = on, except on integrated GPUs)	With the PC memory model, Garlic memory (what the GPU reads a lot: geometry, textures) gets a VRAM copy kept current like a default heap; 0 keeps it in place too. Ignored when the fixed arena is in use.	gpu/shadps4/video_core/buffer_cache/buffer_cache.cpp:474-479, 2189-2192
BB_GC_IDLE_SECONDS	seconds, clamped 1-63 (20)	Texture collector: below the pressure mark an image is evicted once unused for this long (the textures of an area left behind).	gpu/shadps4/video_core/texture_cache/texture_cache.cpp:1345, 1367-1371
BB_GC_PRESSURE_IDLE_SECONDS	seconds, clamped 0-63 (5)	Texture collector: under VRAM pressure an image is evicted once unused for this long (over the critical mark for 1 s first, then by submissions).	gpu/shadps4/video_core/texture_cache/texture_cache.cpp:1379-1388
BB_GC_PRESSURE_PERCENT	percent, clamped 10-75 (60)	Texture collector, dedicated GPUs below 8 GB: the pressure mark is at least this share of the budget (was 40 %, about what the game holds outside textures, so such cards were under pressure all session). The critical mark is unchanged.	gpu/shadps4/video_core/texture_cache/texture_cache.cpp:62-76
BB_GC_KEEP_GPU_WRITTEN	0 = off; else on (on)	Texture collector: images the GPU wrote stay in VRAM until past the critical mark and unused for a minute, linear ones like tiled ones (issue #30). 0: linear ones are downloaded and freed under mere pressure, as before.	gpu/shadps4/video_core/texture_cache/texture_cache.cpp:1453
BB_GC_TILE_BACK	0 = off; else on (on)	Texture collector: past the critical mark, a GPU-written tiled image unused for a minute is tiled back into the game's memory before it is freed (issues #13, #14). 0 = dropped unwritten as before, which left the Hunter's Dream black. Multisampled images are always dropped.	gpu/shadps4/video_core/texture_cache/texture_cache.cpp:1435-1470, 201-250
BB_GPU_COMMAND_WRITES	0 = off; unset/other = on	With BB_GUEST_IN_PLACE: the game's WRITE_DATA commands are performed by the GPU in stream order, as the PS4 command processor does, instead of a CPU store at decode time. 0: CPU store.	gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.cpp:212, gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.h:204
BB_GPU_LABELS	0 = off; 1 = on; unset = on except on AMD GFX8 (Polaris, RX 4xx/5xx)	With BB_GUEST_IN_PLACE and honest labels: end-of-pipe labels (fences) are written by the GPU itself into the game's memory. 0: by a CPU thread after the GPU. GFX8 stalled with GPU-written labels (upstream #203), so it gets the CPU's unless 1.	gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.cpp:301-316
BB_GPU_SPIN_US	microseconds, negative = 0 (200 with 12+ hardware threads, else 0)	The GPU command thread spins this long before sleeping when it runs out of work, so the next of the ~20 submissions of a frame is picked up without a condition-variable wake-up. 0 = no spinning (saves CPU on small machines).	gpu/shadps4/video_core/amdgpu/liverpool.cpp:163-171
BB_GPU_TIMESTAMPS	0 = off; unset/other = on	With BB_GUEST_IN_PLACE: the game's GPU timestamps (100 MHz clock) are written by the GPU in stream order. 0: written by the CPU.	gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.cpp:290
BB_GPU_WRITE_TWINS	1 = on; run.sh exports 1 when unset (code default without run.sh: off)	Internal. A guest write into a page holding bytes the GPU is still writing (counters, small compute outputs) does not wait for the GPU: the guest's bytes are kept as a "twin". Not with BB_READBACKS=2.	run.sh:279, gpu/shadps4/video_core/buffer_cache/buffer_cache.cpp:291-306
BB_GPU_WRITE_TWINS_MAX	bytes per page; run.sh exports 65536 when unset (code default without run.sh: 1024)	Internal. Only pages with at most this many GPU-written bytes get twins; larger outputs (vertices the CPU reads back, FaceGen) keep waiting for the GPU.	run.sh:279, gpu/shadps4/video_core/buffer_cache/buffer_cache.cpp:296, 308-313
BB_GUEST_GPU_MEMORY	1 = on (off; implied by BB_GUEST_IN_PLACE=1 on a capable GPU)	Guest direct memory comes from GPU-visible Vulkan chunks (dma-buf, or host import on NVIDIA) instead of the memfd, so the GPU reads the game's data in place. Disables BB_UFFD (dma-buf cannot be write-protected by userfaultfd).	gpu/shim/bbport_guest_memory.cpp:700-718, gpu/shadps4/video_core/page_manager.cpp:723-728, run.sh:195
BB_GUEST_IN_PLACE	1 = on, anything else = off	Internal (run.sh: = BB_PC_MODEL, forced 0 by BB_AS_0_3=1; set by hand overrides the memory model). The GPU uses the game's direct memory where it is (GPU-visible chunks) instead of copies in VRAM, and command-processor writes/labels/timestamps are done by the GPU in order. Part of the new memory model (BB_PC_MODEL=1).	gpu/shadps4/video_core/buffer_cache/buffer_cache.cpp:515, gpu/shadps4/video_core/buffer_cache/buffer.h:38, run.sh:239
BB_GUEST_MEMORY	dmabuf, host, or unset (AMD: dma-buf chunks; other GPUs: host memory import first)	How the game's direct memory is made GPU-visible in the new memory model: dma-buf chunks or imported host memory (VK_EXT_external_memory_host). host fails instead of falling back when import does not work.	gpu/shim/bbport_guest_memory.cpp:668
BB_GUEST_VRAM	1 or unset (off)	Experiment: the game's direct memory in VRAM the CPU maps through the PCI BAR (Resizable BAR), as GDDR is the PS4's one memory: no VRAM copies.	gpu/shim/bbport_guest_memory.cpp:37
BB_HONEST_FLUSH_US	integer µs (2000; a header comment says 1000)	With honest labels: at the end of a guest submission, recorded work that signals wait for is submitted at most once per this interval while the GPU still has work.	gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.cpp:400
BB_HONEST_IDLE_BACKLOG	integer bytes (65536)	With honest labels: work is not submitted early "because the GPU is idle" while this many bytes of draws are still queued for the recording thread.	gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.cpp:416
BB_HONEST_IDLE_FLUSH	0 = off; unset/other = on	With honest labels: signalled work is submitted at once when the GPU has finished everything submitted (instead of waiting for BB_HONEST_FLUSH_US).	gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.cpp:412
BB_HONEST_LABELS	1 = on (unset = on only with BB_GUEST_IN_PLACE)	Fences/labels (EOP, EOS, mem semaphores) are written once the GPU has finished the work before them, as the hardware does, instead of when that work is recorded.	gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.cpp:98, gpu/shadps4/video_core/amdgpu/liverpool.cpp:448
BB_HOST_COPY_WAITS	all (unset = only when needed)	Internal (run.sh sets all with BB_AS_0_3=1). all: before every guest write, wait for all host copies (the old 0.3 behaviour). Default: wait only when a host copy may still read the written range.	gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.h:130, run.sh:239
BB_INDIRECT_GUARD	0 = off; unset/other = on	Guards indirect compute dispatches: implausible group counts (garbage from particle simulations that caused device lost) are zeroed and the dispatch skipped, and counted in the log. 0: the game's counts as they are.	gpu/shadps4/video_core/renderer_vulkan/vk_indirect_guard.cpp:57, gpu/shadps4/video_core/renderer_vulkan/vk_indirect_guard.h:11
BB_INDIRECT_DRAW_GUARD	0 = off; unset/other = on	Guards indirect draws: a vertex (or index) count times the instance count past BB_INDIRECT_DRAW_GUARD_MAX (garbage that would keep the GPU busy past the driver's timeout, issue #19) is zeroed and the draw skipped, and counted in the log. An open render pass is paused for the check and continued. 0: the game's arguments as they are.	gpu/shadps4/video_core/renderer_vulkan/vk_indirect_draw_guard.cpp:60, gpu/shadps4/video_core/renderer_vulkan/vk_indirect_draw_guard.h:13
BB_INDIRECT_DRAW_GUARD_MAX	integer 1–4294967295, decimal or 0x hex (16777216); invalid keeps the default	Most vertices (or indices) times instances one indirect draw may run before BB_INDIRECT_DRAW_GUARD skips it.	gpu/shadps4/video_core/renderer_vulkan/vk_indirect_draw_guard.cpp:42
BB_INDIRECT_GUARD_MAX	integer 1–4294967295, decimal or 0x hex (4194304); invalid keeps the default	Most workgroups one indirect dispatch may launch before BB_INDIRECT_GUARD skips it.	gpu/shadps4/video_core/renderer_vulkan/vk_indirect_guard.cpp:35
BB_LAYER_MEMORY	1 = on, 0 = off (unset = chosen by the memory model per GPU)	The layer's memory module: the game's memory bound in place with VRAM copies, without sparse binding (NVIDIA's sparse binding stalls the GPU for seconds). 0: AMD's sparse arena. See BB_PC_MODEL.	gpu/shim/bbport_guest_memory.cpp:546, run.sh:204
BB_LAYER_MIRROR_FLOOR_PERCENT	percent, max 90 (25)	Layer memory module: share of the driver's VRAM budget the VRAM mirrors keep against the texture collector; above it they yield to images, below it images yield.	gpu/shadps4/video_core/buffer_cache/buffer_cache.cpp:3930
BB_LAYER_MIRROR_GROWTH_MB	MiB; 0 = none (64)	Layer memory module: the most room a growing VRAM mirror gets above its current end.	gpu/shadps4/video_core/buffer_cache/buffer_cache_layer.cpp:610-616
BB_LAYER_RELOAD_RESET	0 = off; else on (on)	Layer memory module: a block the GPU once wrote in place that the loaders then write whole may have a VRAM copy again (dynamic blocks piled up over area loads and lamp travel, lowering the frame rate). 0: kept in place for good, as before.	gpu/shadps4/video_core/buffer_cache/buffer_cache.cpp:2596
BB_LAYER_UNMAP_RESET	0 = off; else on (on)	Layer memory module: blocks the game unmaps whole lose what kept them in place (CPU writes, GPU writes in place, failed watches); memory mapped there again starts as new. 0: as before.	gpu/shadps4/video_core/buffer_cache/buffer_cache.cpp:3308
BB_LAYER_READ_TRAPS	1 = on (off)	What the GPU writes into a VRAM copy only is made no-access for the CPU until it is copied back, so the CPU never reads stale data. Off by default for now.	gpu/shadps4/video_core/buffer_cache/buffer_cache_layer.cpp:1285
BB_LAYER_WATCH	0 = off; else on (on; needs BB_LAYER_WRITE_TRAPS)	Layer memory module: blocks the CPU writes unannounced get VRAM copies too, write-trapped and uploaded again after the CPU's next write.	gpu/shadps4/video_core/buffer_cache/buffer_cache_layer.cpp:410-424
BB_PC_MODEL	1 = new | 0 = 0.3 model (default: 1 on AMD GPUs, 0 elsewhere)	Launcher: Advanced → "Memory and translation model" (Auto leaves it to run.sh). Memory model: 1 = the GPU uses the game's memory in place and the command processor's work is translated (implies BB_GUEST_IN_PLACE=1); 0 = 0.3 model (VRAM copies, write tracking). A value in extra variables wins over "Auto".	run.sh:212, run.sh:199, launcher/bbport_launcher.py:671
BB_PC_MODEL_ANY_GPU	1 or unset (off)	Lets the new memory model's sparse arena run on non-AMD GPUs that would otherwise fall back to the 0.3 model (NVIDIA: rebinding memory held the GPU for seconds).	gpu/shim/bbport_guest_memory.cpp:513, gpu/shim/bbport_guest_memory.h:35
BB_PIPELINE_CACHE	1/y/t or 0 (1)	The port's pipeline cache: shaders are compiled again at startup from the stored list (warm-up). 0 turns it off.	gpu/shim/core/emulator_settings.h:64, gpu/shadps4/video_core/renderer_vulkan/vk_pipeline_serialization.cpp:330
BB_PIPE_SIGNALS	0 = off; unset/other = on (with honest labels and the draw pipe)	Fences, GPU-idle/frame signals and their submissions are handed to the draw recording thread as ordered tasks instead of draining it first (~15 waits a frame).	gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.cpp:376, gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.h:234
BB_PIPE_SPIN_US	integer µs ≥0 (200 with 12+ CPU threads, else 50)	How long the draw-pipe consumer spins waiting for work before sleeping. Lower values leave more CPU to the game on few-core machines (Steam Deck).	gpu/shadps4/video_core/renderer_vulkan/vk_draw_pipe.h:209
BB_PREP_WORKERS	integer 0–16 (half the CPU threads, clamped 1–8)	Number of idle-priority worker threads that prepare draws speculatively ahead of the GPU thread (pipeline and resource selection). 0 = none.	gpu/shadps4/video_core/renderer_vulkan/vk_draw_prep.cpp:54
BB_PREUPLOAD	0 = off, 1 = rewritten memory already in VRAM only (no new VRAM), 2 = all of the game's GPU memory (~3 GB more VRAM); without run.sh unset = 0	Launcher: Advanced > Performance > "Background pre-upload into VRAM" (run.sh exports 1 when unset). Background upload of the game's GPU memory into VRAM ahead of use: fewer hitches when areas load. Always off with BB_GUEST_IN_PLACE (the GPU reads the game's memory itself).	gpu/shadps4/video_core/buffer_cache/buffer_cache.cpp:386, run.sh:197, launcher/bbport_launcher.py:661
BB_PREUPLOAD_MB	integer MiB per frame (16)	Most memory the background pre-upload (BB_PREUPLOAD) puts into VRAM per frame.	gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.cpp:1625
BB_READBACKS	0 = off, 1 = relaxed, 2 = precise (1 = relaxed)	Launcher: Advanced > Performance > "GPU data readbacks by the CPU" (Relaxed = unset, Off = 0, Precise = 2). shadPS4's GPU readback mode. Relaxed by default: without readbacks FaceGen reads stale GPU-written vertices (vertex explosions). 2 also read-protects GPU-written pages and disables BB_GPU_WRITE_TWINS.	gpu/shim/core/emulator_settings.h:27-29, launcher/bbport_launcher.py:659, 524-525
BB_READBACK_LINEAR	1/y/t or 0 (off)	shadPS4's readback of linear (untiled or narrow) images to guest memory.	gpu/shim/core/emulator_settings.h:66, gpu/shadps4/video_core/texture_cache/texture_cache.cpp:786
BB_READBACK_QUEUE	0 = off; unset/other = on	Uses a separate compute/transfer queue to read back GPU data finished long ago, without waiting behind the queued frame. 0 turns it off.	gpu/shadps4/video_core/renderer_vulkan/vk_instance.cpp:499
BB_STAGING_KEEP_MB	integer MiB (512)	How much of the staging upload ring is kept (and populated at startup) instead of being trimmed when idle; re-creating blocks during streaming bursts caused stutter.	gpu/shadps4/video_core/renderer_vulkan/vk_staging_buffer_pool.cpp:27
BB_SUBMIT_AHEAD	integer >= 0 (2)	The first K submissions of a frame do not wait for the previous frame, so translation overlaps the GPU (1080p Yahar'gul: 101 -> 154 FPS). 8 or more leaked the game's heap; if the heap grows anyway K becomes 0 for the session.	gpu/shadps4/core/libraries/gnmdriver/gnmdriver.cpp:134-149
BB_TEXTURE_HELPER	1 = on, 0 = off (unset = off)	A spinning helper thread binds textures for the draw recording thread. Measured neutral on 16 threads, so opt-in.	gpu/shadps4/video_core/renderer_vulkan/vk_rasterizer.cpp:2195
BB_UFFD	first char 1 = on (run.sh: 0)	Internal (run.sh exports 0 when unset). Write tracking with userfaultfd write-protection instead of mprotect (no address-space write lock); falls back to mprotect if the kernel lacks it. Off by default: the Steam Deck crashed with it. Ignored with BB_GUEST_GPU_MEMORY=1.	run.sh:272, gpu/shadps4/video_core/page_manager.cpp:545-551, 723-737
BB_VBLANK_HZ	Hz; 0 or >120 = uncapped (60 if unset in the library)	Internal (run.sh derives it from BB_FPS (uncap 480, 90 90, else 60). Vblank rate. Above 120 Hz (or 0) a finished frame is presented at once instead of on the next vblank tick; 60/90 are the fixed-timestep presets.	gpu/shim/core/emulator_settings.h:30, run.sh:280
BB_VK_RECORD_THREAD	0 = off; unset/other = on	Vulkan commands are recorded on dedicated recording threads. 0 records on the calling thread (suspected in vertex explosions, issue #39).	gpu/shadps4/video_core/renderer_vulkan/vk_scheduler.cpp:120
BB_VK_RECORD_THREADS	integer 1–8 (3 with 12+ CPU threads, 2 with 8+, else 1)	Number of Vulkan recording threads; the command stream is cut into segments recorded in parallel.	gpu/shadps4/video_core/renderer_vulkan/vk_scheduler.cpp:97
BB_VK_SEGMENT_KB	integer KiB ≥1 (64)	Size of command-stream segments handed to the recording threads (~60 draws per 64 KiB).	gpu/shadps4/video_core/renderer_vulkan/vk_scheduler.cpp:127
BB_VMA_BLOCK_MB	integer MiB ≥1 (64; VMA's own default is 256)	Size of Vulkan memory allocator blocks. Smaller blocks are returned to the driver sooner when freed.	gpu/shadps4/video_core/renderer_vulkan/vk_instance.cpp:906
BB_VMA_DEDICATED_MB	MiB; 0 = never (4)	Images of this size or more get dedicated memory, returned to the driver when freed (shared VMA blocks left ~0.9 GB of holes after texture evictions).	gpu/shadps4/video_core/texture_cache/image.cpp:107-113
BB_VRAM_IDLE_SECONDS	seconds (60)	Mirrored (VRAM-copied) blocks not bound for this long go back in place.	gpu/shadps4/video_core/buffer_cache/buffer_cache.cpp:1823, gpu/shadps4/video_core/buffer_cache/buffer_cache.h:412
BB_VRAM_PRESSURE_IDLE_SECONDS	seconds (3)	Near the critical VRAM mark, blocks no binding used directly for this long (an area left behind) go back in place first, longest unused first.	gpu/shadps4/video_core/buffer_cache/buffer_cache_layer.cpp:903-913
BB_VRAM_PRESSURE_PERCENT	percent, max 95; 0 = off (85)	How full VRAM is against the driver's budget: "tight" from this percent, "full" 5 points above (fewer VRAM copies then).	gpu/shadps4/video_core/buffer_cache/buffer_cache.cpp:2045
BB_VRAM_PROMOTE_PERCENT	percent (90)	Past this share of the driver's VRAM budget no new VRAM copies are made; candidates wait and are read in place meanwhile (issue #32: 8 GB cards).	gpu/shadps4/video_core/buffer_cache/buffer_cache.cpp:3944
MESA_SHADER_CACHE_MAX_SIZE	size (run.sh default 4G)	Mesa's shader cache size, larger than Mesa's default.	run.sh:31
__GL_SHADER_DISK_CACHE	run.sh default 1	NVIDIA's shader disk cache on (run.sh default; keeps compiled pipelines between sessions).	run.sh:25-30
__GL_SHADER_DISK_CACHE_SIZE	bytes (run.sh default 10737418240)	NVIDIA's shader cache size (10 GiB by default here).	run.sh:30
__GL_SHADER_DISK_CACHE_SKIP_CLEANUP	run.sh default 1	NVIDIA's shader cache without its size cleanup (as Steam sets it).	run.sh:29

| BB_WINDOW_RECT | x,y,w,h as fractions of the game's display, e.g. 0,0,1,0.5 (default off) | Local co-op: the window's place and size on the game's display (BB_DISPLAY), without borders, instead of fullscreen. Needs X11 (SDL_VIDEO_DRIVER=x11): Wayland lets no window place itself. | gpu/shim/window.cpp |

Controls & input

Variable	Values (default)	What it does	Where
BB_GAMEPAD	SDL GUID, part of the name, or the device path (/dev/hidrawN, /dev/input/eventN; the log's gamepad connected line shows it) (default: first controller)	Launcher: Controls → Gamepad → "Controller". Preferred controller, so wheels and other always-connected devices do not take over. The path tells two pads of the same model apart (local co-op).	src/runtime_pad.c (preferred_gamepad), launcher/bbport_launcher.py:642
BB_GAMEPAD_STRICT	1 (default off)	Local co-op: only the BB_GAMEPAD controller, never the first one or the one in use instead; with no BB_GAMEPAD, no controller at all.	src/runtime_pad.c (gamepad_strict)
BB_KEYBOARD	0 (default on)	Local co-op: this game ignores the keyboard and the mouse, and never takes the mouse.	src/runtime_pad.c (keyboard_enabled)
BB_PAD_BACKGROUND	1 (default off)	Local co-op: the controller keeps driving the game while another window has the focus, and the game keeps its sound then (bbport.ini's mute_unfocused is ignored). Launcher: the Multiplayer → Local tab sets it, with BB_WINDOW_RECT, BB_GAMEPAD, BB_GAMEPAD_STRICT, BB_KEYBOARD, BB_AUDIO and BB_DATA_DIR for each player (launcher/bbport_coop.py).	gpu/shim/window.cpp, gpu/shim/bbgpu.cpp (bbgpu_audio_muted)
BB_MOUSE_DEADZONE	0–100 of 127 (default 16)	Minimum right-stick deflection used for mouse look, so slow mouse movement still turns the camera past the game's dead zone.	src/runtime_pad.c:760
BB_PAD_CENTER	lx,ly,rx,ry (default: measured)	Overrides the measured neutral position of each stick axis.	src/runtime_pad.c:27, src/runtime_pad.c:113-118
BB_PAD_CENTER_CAL	0 = off (default on)	Disables measuring each axis' neutral and travel (for third-party pads whose axes are biased).	src/runtime_pad.c:28, src/runtime_pad.c:110
BB_PAD_DEADZONE	0–126 (default 5)	Launcher: Controls → "Stick dead zone (%)" (percent × 127 / 100; written only when not 4 %). Inner stick dead zone, as shadPS4's analog_deadzone.	src/runtime_pad.c:113, launcher/bbport_launcher.py:645
BB_PAD_DEADZONE_OUTER	1–127 (default 127)	Outer stick dead zone: travel up to this value maps to full deflection (helps pads that never reach full).	src/runtime_pad.c:26, src/runtime_pad.c:115
BB_PAD_LIGHTBAR	RRGGBB hex colour, an optional leading # (unset: SDL's own, the player's colour)	Launcher: Controls → "Controller light bar colour" (set only when on). Every controller with a light bar (DualShock 4, DualSense) shows this colour, set when it is opened.	src/runtime_pad.c:297, launcher/bbport_launcher.py:649, launcher/bbport_launcher.py:1461
BB_PROMPTS	playstation | xbox | switch | keyboard (default playstation)	Launcher: Controls → Gamepad → "Button prompts" (Automatic follows the controller). Button prompts of the game's menus, made from the game's files at start.	run.sh:136, scripts/menu_prompts.py:57, launcher/bbport_launcher.py:631
BB_STEAM_INPUT_X11	0 = keep Wayland (default on)	Launched from Steam with Steam Input on a Wayland desktop, the game window goes through Xwayland (SDL_VIDEO_DRIVER=x11): Steam sends its virtual controller's input only to a focused window it can see, and it sees only X11 windows (issue #12). Not when SDL_VIDEO_DRIVER is set.	run.sh
BB_STEAM_OVERLAY	1 = on (default 0)	Launcher: Setup → Game → "Steam overlay", under "Add to Steam" (saved as soon as it changes). Started from Steam, the game gets Steam's 64-bit gameoverlayrenderer.so in LD_PRELOAD, read from the nearest process above that still has it (the AppImage's sharun clears LD_PRELOAD in every program it runs), and nothing else Steam preloads. On a Wayland desktop the window goes through Xwayland (SDL_VIDEO_DRIVER=x11), since Steam draws its overlay only on X11 windows; not when SDL_VIDEO_DRIVER is set (issue #28).	run.sh:370, launcher/bbport_launcher.py:687, launcher/bbport_launcher.py:1260

Audio

Variable	Values (default)	What it does	Where
BB_AUDIO	none, or unset (sound on)	none keeps the game silent: the runtime uses a silent timer instead of an SDL audio device, and the trophy chime is off too.	src/runtime_audio.c:83, gpu/shim/bbport_overlay.cpp:832
BB_AUDIO_DUMP	file path prefix (default off)	Writes the raw converted PCM of each audio port to .port.ch..	src/runtime_audio.c:252
BB_AUDIO_GAIN	float >0 and ≤8 (default 1.0)	Master gain applied to the game's audio output.	src/runtime_audio.c:173
BB_AUDIO_STATS	any value = on (default off)	Per-port audio timing statistics (gaps between submissions) in the log.	src/runtime_audio.c:251
BB_AUDIO_TRACE	1 = on (default off)	Logs AJM decoder configurations and failing jobs, plus sound file opens and failed reads (missing game sounds).	src/runtime_ajm.c:77, src/runtime_file.c:222
BB_SOUND_HACK	0 = off (default on)	Bloodborne "sound hack": sets the flag at 0x204E of userdata0010 in each save before the game reads it, otherwise some sounds (e.g. weapon sounds) never play; 0 leaves saves untouched.	src/runtime_savedata.c:72-79

Game & patches

Variable	Values (default)	What it does	Where
BB_FPS	uncap | 60 | 90 | 30 (default uncap)	Launcher: Graphics → Frame rate → "Mode". Frame-rate patch: uncap = delta-time patch with 480 Hz vblank and sprint fix; 60/90 = fixed-timestep patches (90 adds the sprint fix); 30 = unpatched. Also picks BB_VBLANK_HZ when that is unset.	run.sh:77, run.sh:77, scripts/patches.py:17-21
BB_GAME_MENU	0, or unset (on)	0 leaves the game's System menu as it is: no port pages (Display, Game effects, Game patches) built into the game's own menu.	gpu/shim/bbport_game_menu.cpp:596, gpu/shim/bbport_game_menu.h:5
BB_GESTURES_NO_MOTION	0 | 1 (default 0)	Launcher: Controls → Gamepad → "Gestures menu without motion-control icons". Dommo's stripped-down gestures menu (no motion-control icons), made from the game's files at start.	run.sh:137, scripts/menu_prompts.py:15, launcher/bbport_launcher.py:632
BB_GX_COMMAND_HEAP	0 = off (default 1)	Patch that enlarges the game's two per-frame GX command heaps to 1 MiB (crashes when a frame fills the 256 KiB heap); 0 keeps the game's size.	scripts/patches.py:83-91
BB_LANGUAGE	PS4 system language number: 0 Japanese, 1 English, 2 French, 3 Spanish, 4 German, 5 Italian, 8 Russian, ... (runtime default 1)	Launcher: Setup > Game language (Auto: from the desktop locale). The system language the runtime reports to the game; also picks the trophy names' language and the in-game menu's default language.	src/runtime_services.c:70, gpu/shim/bbport_game_menu.cpp:104, launcher/bbport_launcher.py:635
BB_MODS_ENABLED	0 | 1 (default 1)	Launcher: Mods → Mods → "Load mods". Whether mods are merged into the game's files for this launch.	run.sh:166, launcher/bbport_launcher.py:629
BB_PATCHES	patch names separated by ";" (default none)	Extra patch names (from patches/Bloodborne.xml) applied at start.	run.sh:190, run.sh:190
BB_REGION	eu | na | empty (default: the dump's param.sfo)	Launcher: Setup → "Game region". The game's region for this launch; picks the regional text (e.g. Spanish from Spain or Latin American).	run.sh:189, scripts/content_profile.py:3-5, launcher/bbport_launcher.py:636
BB_SKIP_GAME_CHECK	1 = skip (default check)	Skips the check that the game files are the supported 1.09 dump (wrong eboot, missing update, broken extraction).	scripts/game_check.py:11, scripts/game_check.py:72, scripts/prepare.py:288
BB_SKIP_NETWORK_CHOICE	0 | 1 (default 1)	Launcher: Multiplayer → Online → "Skip the "play online / offline" choice" (default on). Patch: the title screen goes straight to the main menu, online when online play is on (BB_ONLINE=1), as PLAY ONLINE on a PS4, offline otherwise; 0 shows the online/offline dialog.	scripts/patches.py:73-80, launcher/bbport_launcher.py:650
BB_TROPHY_KEY	32 hex characters (default none)	Launcher: Trophies → "Trophy key". The PS4 trophy key; decrypts trophy names and descriptions in the game's language (without it they are in English).	run.sh:351, scripts/trophies.py:495, launcher/bbport_launcher.py:689
BB_USER_NAME	text (Hunter)	The PS4 user name reported to the game and the online module; also the default answer to a text-input dialog when the on-screen keyboard is unavailable.	src/runtime_services.c:55, gpu/bbnet/include/core/user_manager.h:38

Saves & files

Variable	Values (default)	What it does	Where
BBSC_SAVE_DIR	folder path; default unset	Folder holding userdata0000.. on hosts that keep saves elsewhere (bbhost); BBSC counts its slots as the active save and copies it in its save backups. On the port BBSC looks in ./user (working folder) otherwise.	bbsc/emulator/src/core/bloodborne_re.cpp:5931, bbsc/emulator/src/core/bloodborne_re.cpp:14468
BB_CONFIG	path (run.sh: /bbport.ini; the GPU library alone: ./bbport.ini)	Internal (run.sh default $BB_DATA_DIR/bbport.ini). Path of bbport.ini, the settings file read by the GPU library (in-game menu settings), the controls (key./pad. lines) and the launcher.	run.sh:21, gpu/shim/bbport_settings.cpp:21, src/runtime_pad.c:519
BB_DATA_DIR	directory (default: the port directory; AppImage/Nix: $XDG_DATA_HOME/bbport)	Internal. Writable directory for generated files (out/), saves (user/), bbport.ini, mods, patches and logs.	run.sh:16-18, launcher/bbport_launcher.py:56, packaging/appimage-sharun.sh:74
BB_DLC_DIR	directory (default none)	Launcher: Setup → "DLC folder". Folder with the dumped add-ons (one folder each, e.g. SPEXPANSIONDLC03); linked as /addcont/