rexlManu/bdo-settings
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
1 commit 1 branch 0 tags 184 KiB
  • Shell 100%
Find a file
Exact
Emmanuel Lampe 970cb38465 Add portable BDO UI settings snapshot
2026-09-05 00:02:18 +02:00
ui Add portable BDO UI settings snapshot 2026-09-05 00:02:18 +02:00
.gitattributes Add portable BDO UI settings snapshot 2026-09-05 00:02:18 +02:00
.gitignore Add portable BDO UI settings snapshot 2026-09-05 00:02:18 +02:00
README.md Add portable BDO UI settings snapshot 2026-09-05 00:02:18 +02:00
restore-linux.sh Add portable BDO UI settings snapshot 2026-09-05 00:02:18 +02:00

README.md

BDO UI settings

Personal Black Desert Online UI and per-character layout snapshot for Steam app 582660.

Contents

  • ui/UserCache/: account and character XML files used by BDO for UI positions, quick slots, key bindings, cooldown slots, and related preferences.
  • ui/layout-backups/: layouts manually exported from BDO, including the account and cooldown backups.
  • restore-linux.sh: restores the snapshot into a Steam/Proton prefix after making a backup.

The numeric directories are BDO account, region, and character identifiers. Keep the directory structure unchanged when restoring settings for the same account.

This repository deliberately excludes GameOption.txt, screenshots, logs, crash dumps, cookies, face textures, marketplace favorites, and other generated or machine-specific files. BDO also caches a few display values inside UserCache, so verify resolution and fullscreen mode after restoring on a machine with a different monitor.

Restore on Linux with Steam/Proton

Close BDO and its launcher, then run:

./restore-linux.sh

The default destination is:

~/.local/share/Steam/steamapps/compatdata/582660/pfx/drive_c/users/steamuser/Documents/Black Desert

For a different Steam installation or prefix, pass the Black Desert directory explicitly:

./restore-linux.sh "/path/to/pfx/drive_c/users/steamuser/Documents/Black Desert"

The script moves the previous UserCache into a timestamped sibling backup and copies the saved layout XML files into place. Start BDO normally afterward. If BDO's account-level layout does not activate automatically, use its in-game UI restore/import function with one of the files copied from ui/layout-backups/.

Restore on Windows

  1. Exit BDO and the launcher.
  2. Open %USERPROFILE%\Documents\Black Desert.
  3. Back up the existing UserCache directory.
  4. Replace it with this repository's ui\UserCache directory.
  5. Copy the XML files from ui\layout-backups into the Black Desert directory.
  6. Start BDO and verify the display mode and resolution.

If Windows redirects Documents through OneDrive, use %USERPROFILE%\OneDrive\Documents\Black Desert instead.

Updating the snapshot

Exit BDO before copying updated files. Only commit XML files from UserCache and manual _backup-*.xml layouts; keep runtime caches and personal game data out of the repository.