Wishlist on Steam
Menu

Mods

Game support in Bururu comes from mods. A mod tells Bururu which program is the game, what to read while it runs, and what the controller does at each moment.

Mods today

Elite Dangerous

Haptics, trigger effects, lights and LEDs for weapons, boosts, hits, heat, jumps, docking and landings.

Reads the game's journal, your key bindings, the HUD on the screen and the keys bound to the game's actions.

Runs on Windows and Linux.

getbururu/bururu-elite

Star Citizen

Haptics, trigger effects and lights for the pilot seat, quantum travel, jumps, hangars, injuries and contracts.

Reads the game's Game.log.

Runs on Windows.

getbururu/bururu-starcitizen

Valheim

Haptics, trigger effects and the lightbar for your attacks, the bow, your block, raids and nights in bed.

Reads the game's log file.

Runs on Windows, Linux and macOS.

getbururu/bururu-valheim

ARC Raiders

Trigger effects and a lightbar colour next to the game's own haptics, on the USB cable for now.

Reads nothing but the controller.

Runs on Windows and Linux.

getbururu/bururu-arcraiders

All four are made by Bururu and are open source under the MIT licence. More are on the way, or make your own.

Games with a profile

The mod list also has profiles for 27 games. A profile says which controller the game should see, and whether the game supports the DualSense itself. Bururu uses it when the game starts, so there is nothing to pick. On Windows you can still choose another controller for a game on its page in Bururu, under Games.

Games that support the DualSense themselves, such as The Witcher 3 and Cyberpunk 2077, keep their own trigger effects and haptics. On the cable they read your DualSense as it is. On Bluetooth on Windows, Bururu shows them a DualSense on a cable and passes it all on to yours.

The 27 games
  • ARC Raiders
  • Assassin's Creed Shadows
  • Battlefield 6
  • Crimson Desert
  • Cyberpunk 2077
  • Death Stranding Director's Cut
  • Dragon's Dogma 2
  • Elite Dangerous
  • Ghost of Tsushima
  • God of War Ragnarok
  • Grand Theft Auto V Enhanced
  • Helldivers 2
  • Horizon Forbidden West
  • Horizon Zero Dawn Remastered
  • Marvel's Spider-Man 2
  • Marvel's Spider-Man: Miles Morales
  • Marvel's Spider-Man Remastered
  • Monster Hunter Wilds
  • Ratchet & Clank: Rift Apart
  • Returnal
  • Star Citizen
  • Stellar Blade
  • The Last of Us Part I
  • The Last of Us Part II Remastered
  • The Witcher 3
  • Uncharted: Legacy of Thieves Collection
  • Valheim

Getting mods

In Bururu, open Mods -> Browse. Bururu also suggests mods for the games it finds on your PC. Click Install, and later Update when a new version is out.

Installing a mod by hand

Every mod in the list has its releases on GitHub, so you can also get one yourself, without the mod list:

  1. Open the mod's GitHub page, such as getbururu/bururu-valheim, and then Releases.
  2. Download the .brr file of the newest release, such as valheim-0.2.0.brr. Bururu's own mods also have a SHA256SUMS file in each release, if you want to check the download.
  3. In Bururu, open Mods, click Install from file... and pick the file. If .brr files open with Bururu on your PC, a double-click on the file does the same.
  4. Bururu shows what the mod reads, the same as for a mod from the list. Click Install.

This works offline too, and for a .brr that someone sent you. When the file is the same as a version in the mod list, Bururu treats it as that version, and with the mod list on it offers that mod's updates. A mod from anywhere else gets no updates.

What a mod can read

A mod reads a game through what the game already shares: its log and journal files, its key bindings, the screen, whether its program runs, and the telemetry some games send over UDP on your PC. On Windows 11 it may also listen to the game's own sound, only from the game's programs and only while the game runs. Bururu looks at that sound as it comes and keeps none of it.

On Windows, and only for a game the mod list marks as offline with no anti-cheat, a mod may also read the game's memory. It only reads: no mod writes to a game's memory or changes the game's files.

On Windows a mod may also read what a game sends to Bururu's virtual controller, such as its rumble and trigger effects. That needs no permission, since the game sends it to Bururu itself.

Each mod lists what it wants to read. Bururu shows you that list before you install, and the mod gets only what is on it. Only one thing a mod reads can leave your PC: a mod may pass a game's telemetry on to an address it lists, such as a dashboard on another device. That address is on the list too.

The mod list

The list you see in Bururu is public: getbururu/mod-index on GitHub. Each mod lives in its author's own repository, with its source, so you can read what it does before you install it. A maintainer reviews every new version before it shows up in the list, and Bururu checks each download against the SHA-256 of the file that was reviewed. If a mod turns out to do harm, we can switch it off in every copy of Bururu that uses the mod list.

Found a problem with a mod? Report it.

You can turn the mod list off in Bururu's Settings. Your mods keep working, and Install from file... still works, but Bururu can no longer offer updates or warn you about a bad mod.

Make a mod

A mod is a folder of text files. Simple mods are a few JSON files, and Lua scripts add logic when you need it. Haptic effects, called feels, are .feel.json files that you can write by hand or make in the audio editor REAPER.

You need Bururu, a text editor and a DualSense. On Windows and Linux, use its USB cable: there the haptics play at full quality, and REAPER can play sound straight to them. On a Mac, use Bluetooth, since a DualSense on the cable has no HD haptics there. There is nothing to compile.

The modding guide comes with Bururu. In Steam, right-click Bururu, choose Manage -> Browse local files, and open docs/modding/README.md. Its quick start takes about ten minutes.

List your mod See the Elite Dangerous mod