Skip to content

Installation

To play Cubyz, you can either download a ready-to-run release or compile the latest development version yourself.

Requirements

Cubyz is a very well optimized game, but there is still a limit to what hardware it can run on. As a safe baseline we recommend minimal specification listed below. The hardware should be enough to play Cubyz reasonably smoothly in Full HD resolution. If you satisfy hardware requirements listed bellow.

GPU Requirements

Cubyz requires a graphics card with hardware support for OpenGL 4.6 along with up-to-date drivers.

Please Note

Any hardware below these minimum specifications is not officialy recommended, and your gameplay experience may suffer. If your game runs poorly or doesn't start at all, consider reaching out on our Discord.

Downloading a release version

To download a release version, head to the Cubyz release page on GitHub and download the latest version for your operating system.

Once downloaded, extract the archive file using your file explorer or your favorite command-line tool.

Inside the extracted folder, make sure you see these three key files:

  • Cubyz (or Cubyz.exe)
  • launchConfig.zon
  • assets

These files must stay in the same folder for the game to run.

To launch Cubyz, run the executable:

chmod +x Cubyz # make binary executable
./Cubyz

Simply double-click Cubyz.exe, or run it via terminal:

Command Prompt 

Cubyz.exe

PowerShell 

.\Cubyz.exe

Building from Source

The Easy Way (no tools needed)

NOTE: This builds the absolute latest experimental version of the game. It may contain bugs!

  1. Download the latest source code zip.
  2. Extract the .zip file.
  3. Open the extracted folder and run the launch script for your system:
./run_linux.sh

run_windows.bat

Congrats: You just compiled your first program!

The Better Way (Using Git)

NOTE: This method makes updating the game incredibly easy without re-downloading files every time.

First, select your operating system below to install Git and download the code:

Open PowerShell or Command Prompt as Administrator and run: 

winget install --id Git.Git -e --source winget

Once Git is ready, open a normal terminal and run: 

# Download the repository
git clone https://github.com/pixelguys/Cubyz

# Enter the game folder
cd Cubyz

# Compile and run
run_windows.bat


# Install Git
sudo pacman -S git

# Download the repository
git clone https://github.com/pixelguys/Cubyz

# Enter the game folder
cd Cubyz

# Compile and run
./run_linux.sh

# Install Git
sudo apt update && sudo apt install git -y

# Download the repository
git clone https://github.com/pixelguys/Cubyz

# Enter the game folder
cd Cubyz

# Compile and run
./run_linux.sh

# Install Git
sudo dnf install git -y

# Download the repository
git clone https://github.com/pixelguys/Cubyz

# Enter the game folder
cd Cubyz

# Compile and run
./run_linux.sh

How to Update Later

Whenever you want to pull the latest updates, you don't need to download anything manually again. Just open your terminal inside the Cubyz folder and run:

git pull

Crashes

If Cubyz crashes or doesn't run, you can ask the community for help by joining the Cubyz Discord Server or creating an issue on the Cubyz issue board.