This section covers building Veloren from rust source with
cargo and running it.
Note: all commands need to be run from the repository.
On Windows you will need Visual Studio Build Tools.
Note: Install "C++ tools" and "Windows 10 SDK", you won't need to install Visual Studio itself so scroll down and open "Tools for Visual Studio <year>" to find the latest buildtools.
On Linux you need to have
On Debian systems additional libraries may need to be downloaded, below is a non-exhaustive list:
And a one liner to download and install them all:
sudo apt install libglib2.0-dev libasound2-dev libcairo2-dev libpango1.0-dev libatk1.0-dev libgtk-3-dev libxcb-shape0-dev libxcb-xfixes0-dev libudev-dev libxkbcommon-x11-dev libxcb-xkb-dev
On Fedora you can follow this awesome guide.
Note: Feel free to open an issue incase these dependencies are incorrect.
Run this in a terminal to compile and run Veloren:
To compile without running, use
cargo build instead.
Note: The initial compilation will take from 5min up to 30min therefore grab a tea and some snacks and come back later.
cargo run --bin veloren-server-cli
tracing to collect logs. They can be filtered by setting the
RUST_LOG environment variable to the respective level (
For all available filtering options visit the docs.
Tip: this works both for the server and client
By default debug builds are created which compile faster but run a bit slower than optimized release builds. Unlike many other projects, we've set them up so they're fast enough to be playable. If you want to get optimized builds, add the
--release flag when calling
cargo. Keep in mind that compiling release might be very slow!
If you want get familiar with cargo we recommend the Cargo Book.