Guild Wars 2 runs great in Wine, and almost every aspect of it works perfectly fine. Wine does not support transparent compositing very well. This means that all the other windows native Guild Wars 2 overlay tools will render with a black background instead of a transparent one.
Burrito is a native executable and does not run inside of Wine, therefore it is compleetly capable of being transparent and taking advantage of all of the features linux offers.
Helping out comes in many forms, reporting issues on github is the easiest place to get started. Just make sure your issue does not already exist before sumbitting it.
If you are a programmer there are many places where you can contribute. Different components of Burrito's codebase are written in different languages that best suit the needs of that component.
Godot
and gdscript
C
C++
and Python
Burrito Link is a program that runs inside wine and serves as a bridge between Guild Wars 2 and Burrito. There are several different methods of running it. We reccomend running it as either a GW2 plugin, or as an arcdps plugin.
The recommended way to run Burrito Link is as a Guild Wars 2 plugin. To install Burrito Link as a plugin copy the burrito_link/d3d11.dll
file into your Guild Wars 2 game data folder.
<wine_prefix>/drive_c/Program Files/Guild Wars 2/d3d11.dll
If you downloaded burrito to ~/Downloads/burrito
and your Guild Wars 2 Wine prefix is ~/Games/guild-wars-2
, then the command to install Burrito Link is
$ cp ~/Downloads/burrito/burrito_link/d3d11.dll ~/Games/guild-wars-2/drive_c/Program Files/Guild Wars 2/d3d11.dll
d3d11.dll
, then you cannot install Burrito Link as a normal Guild Wars 2 plugin. See the arcdps installation method instead.Arcdps already uses the file d3d11.dll
to load itself with Guild Wars 2. Luckily arcdps has a built-in method of loading other dll file plugins. To install Burrito Link as an arcdps plugin, copy the burrito_link/arcdps_burrito_link.dll
file into your Guild Wars 2 game data folder
<wine_prefix>/drive_c/Program Files/Guild Wars 2/arcdps_burrito_link.dll
If you downloaded burrito to ~/Downloads/burrito
and your Guild Wars 2 Wine prefix is ~/Games/guild-wars-2
, then the command to install Burrito Link is
$ cp ~/Downloads/burrito/burrito_link/arcdps_burrito_link.dll ~/Games/guild-wars-2/drive_c/Program Files/Guild Wars 2/arcdps_burrito_link.dll
The standalone executable is not recommended if you are able use any of the other options. It requires setting up many environment variables to match your Guild Wars 2's wine prefix so that burrito_link.exe
can effectively run inside of the same world as the game.
This guide will assume that you have Guild Wars 2 installed via Lutris. If you have installed Guild Wars 2 some other way you will have different steps to replicate the output
$ lutris --list-games
Now we need to extract the environment variables and Wine executable path Lutris uses for Guild Wars 2. To do this we will have Lutris create a standalone launcher script, then we will change the script to run the Burrito Link binary instead of Guild Wars 2.
$ lutris guild-wars-2 --output-script `pwd`/run_burrito_link.sh
Change the last line of the script to point to burrito_link.exe
. It probably looks something like this:
/home/myuser/.local/share/lutris/runners/wine/lutris-5.7-11-x86_64/bin/wine '<burrito_download_path>/burrito_link.exe'
We can now execute the script to run the Burrito Link..
$ ./run_burrito_link.sh
Once the Burrito Link is running, you can launch Burrito by double clicking on the executable, or by launching it from the terminal.
$ ./burrito.x86_64
If you have a mutli-monitor setup it is possible that the Burrito window launched on the wrong monitor. If you are using Gnome (Ubuntu, Pop!_OS, etc) all you have to do is hold down the super/windows key and then click and drag the Burrito window into place. Once it is in the correct position, it will stay there until it is closed.
Just like that, you now have an overlay. You can now load a marker file to use in your game. If you are feeling creative, you can also use the marker editor to make your own marker files.
For multi-monitor setups Burrito can sometimes launch on the wrong monitor. This can usually be fixed manually by opening the burrito menu and dragging the window on top of Guild Wars 2.
Some xwayland implementations do not do mouse passthrough properly. Unfortunately there is no easy fix for this, we recommend switching to X11 if possible, or another wayland compositor.
Some KDE desktop environments require transparent compositing to be enabled via the KDE settings.