Voxel sandbox game with a large render distance, procedurally generated content and some cool graphical effects.
Find a file
Wunka 5bed5b53df
clear and free the chest (#3186)
Fixes: #3183
`deinit` for windows is called twice. once on world exit and once on
game exit.
Thats why we need to not only free but also clear
2026-06-07 21:40:55 +02:00
.github Update linter version (#3166) 2026-06-05 21:25:55 +02:00
assets/cubyz The Mantle (concept(?)) (#2464) 2026-06-05 20:53:57 +02:00
docs Move texture stuff to the content guidelines, and add some guidelines for SBBs (#3021) 2026-05-03 20:41:00 +02:00
mods/cubyz/rotations Allow rotation modes to give a custom collision model to Model.init (#3088) 2026-06-02 19:33:47 +02:00
scripts Don't hardcode the path to bash (#2626) 2026-03-04 07:53:07 +01:00
src clear and free the chest (#3186) 2026-06-07 21:40:55 +02:00
.gitignore Update Zig to version 0.16.0 (#2924) 2026-04-18 11:40:36 +02:00
.zigversion Update Zig to version 0.16.0 (#2924) 2026-04-18 11:40:36 +02:00
build.zig Import refactor part 2: command and rotations (#3068) 2026-05-10 16:01:27 +02:00
build.zig.zon Update the music repo to the version which removed unused files (#3151) 2026-06-02 19:03:49 +02:00
debug_linux.sh Don't hardcode the path to bash (#2626) 2026-03-04 07:53:07 +01:00
debug_windows.bat Update to the new Zig version (0.16.0-dev.1424+d3e20e71b) (#2009) 2025-11-23 20:52:23 +01:00
LICENSE Use the GPL-3 LICENSE 2023-10-23 23:23:02 +02:00
README.md Move texture stuff to the content guidelines, and add some guidelines for SBBs (#3021) 2026-05-03 20:41:00 +02:00
run_linux.sh Don't hardcode the path to bash (#2626) 2026-03-04 07:53:07 +01:00
run_windows.bat Update to the new Zig version (0.16.0-dev.1424+d3e20e71b) (#2009) 2025-11-23 20:52:23 +01:00

Cubyz

Cubyz is a 3D voxel sandbox game (inspired by Minecraft).

Cubyz has a bunch of interesting/unique features such as:

  • Level of Detail (→ This enables far view distances.)
  • 3D Chunks (→ There is no height or depth limit.)
  • Procedural Crafting (→ There are infinite possibilites for tool crafting.)

About

Cubyz is written in Zig, a rather small language with some cool features and a focus on readability.

Windows and Linux are supported. Mac is not supported, as it does not have OpenGL 4.3.

Check out the Discord server for more information and announcements.

There are also some devlogs on YouTube.

History

Until recently (the Zig rewrite was started in August 2022) Cubyz was written in Java. You can still see the code in the Cubyz-Java repository and play it using the Java Launcher. // TODO: Move this over to a separate repository

Originally Cubyz was created on August 22, 2018 by zenith391 and ZaUserA. Back then, it was called "Cubz".

However, both of them lost interest at some point, and now Cubyz is maintained by IntegratedQuantum.

Run Cubyz

This section is about compiling a dev version, if you just want a precompiled version, go to releases

The Easy Way (no tools needed)

  1. Download the latest source code
  2. Extract the zip file
  3. Go into the extraced folder and double click the run_linux.sh or run_windows.bat depending on your operating system.
  4. Congratulations: You just compiled your first program!

It doesn't work?

  • If it doesn't work and keeps running for more than 10 minutes without doing anything it can help to kill and restart the process. A few people seem to experience this, and I have not found the cause. It might also help to delete the zig-cache folder.
  • If you see an error message in the terminal, please report it in the Issues tab or on the Discord server.
  • Otherwise you can always ask for help on the Discord server. If you are unable to get it compiling on your machine, you can also ask on the Discord server and we may compile a release for you.

The Better Way

  1. Install Git
  2. Clone this repository git clone https://github.com/pixelguys/Cubyz
  3. Run run_linux.sh or run_windows.bat, if you already have Zig installed on your computer (it must be a compatible version) you can also just use zig build run
  4. When you want to update your local version you can use git pull. This keeps everything in one place, avoiding repeatedly downloading the compiler on every update.

Contributing

Code

Check out the Contributing Guidelines

Gameplay Additions

Check out the Game Design Principles

Content Additions

Check out the Content Guidelines