Vire is a C++ voxel rendering engine. It is written in C++14 and uses OpenGL for graphics.
If you'd just like to just download and try, there are precompiled binaries available for Windows and Linux which you can download here:
All controls are re-bindable using the config files.
- Look Around: Move Mouse
- Move: WASD
- Jump: Space
- switchmov?: Left Shift
- Toggle GUI: F1
- Toggle Spin Mode: F2
- Toggle Fullscreen: F11
- toggle_coll?: Keypad 0
- Toggle Fullbright: Keypad 1
- Toggle Cursor: `
- Place Block: RClick
- Destroy Block: LClick
- Pick Block: Side Mouse Button
Though MacOS is currently unsupported, there are plans to support it in the future. This is due to the fact that Apple has deprecated OpenGL with the later versions of MacOS, limiting the use of the library to version 4.1.0. Currently, Vire uses 4.4.0, so once we can downgrade to a lower OpenGL version, MacOS support will be added!
⚠️ You might not need to compile: you only need to compile from the source if you want to set up a dev environment, or if something isn't working right. The precompiled binaries are automatic, and always up to date with the main branch, so unless you need it for some reason (such as contributing to the repo), you don't really have to compile from source
To compile the project, you will need the following dependencies:
name | package debian based | package arch based | package fedora based |
---|---|---|---|
g++ | g++ | gcc | gcc-c++ |
libGL | libgl-dev | libglvnd | mesa-libGL-devel |
libGLEW | libglew-dev | glew | glew-devel |
libglfw | libglfw3-dev | glfw-wayland / glfw-x11 | glfw-devel |
libglm | libglm-dev | glm | glm-devel |
libX11 | libx11-dev | libx11 | libX11-1.7.3.1-1.fc36 |
libXxf86vm | libxxf86vm-dev | libxxf86vm | libXxf86vm-devel |
libXrandr | libxrandr-dev | libxrandr | libXrandr-devel |
libpthread | libpthread-stubs0-dev | glibcs | libpthread-stubs-devel |
libXi | libxi-dev | libxi | libXi-devel |
libdl | libc6-dev | glibc | glibc-devel |
libXinerama | libxinerama-dev | libxinerama | libXinerama |
libXcursor | libxcursor-dev | libxcursor | libXcursor |
libm | libc6-dev | glibc | glibc-devel |
sudo apt-get -y install g++ libgl-dev libglew-dev libglfw3-dev libglm-dev libx11-dev libxxf86vm-dev libxrandr-dev libpthread-stubs0-dev libxi-dev libc6-dev libxinerama-dev libxcursor-dev libc6-dev
Then git clone
this repository or download and extract the zip
Finally, you should be able to cd into the repo and run make buildlinux
The program can be started using the file in the new bin/linux folder, or through the command make run
To compile on Windows, you'll need to follow these steps:
- Download MSYS2 from https://www.msys2.org/ and follow steps 1-7 on the main page
- Run this command in the MSYS2 shell:
pacman -S mingw-w64-x86_64-glfw mingw-w64-x86_64-glew mingw-w64-x86_64-glm
- Add the folder
msys64/mingw64/bin
to PATH - Either
git clone
this repository or download and extract the zip - In the MinGW shell,
cd
to the repository and runmake buildwin_msys
The program can be started using the .exe in the new bin/windows folder, or through the command make run
To contribute to the project, submit a pull request.