Archea

Archea is a 3D Falling Sand Simulation I am developing because I am bored and love falling sand simulations. I also needed an excuse to learn graphics programming and to make a custom game engine. This project has been a bit of a challenge so far and has been through multiple rewrites. See Journey Of Archea

You can watch me work on this project live on Twitch.
You can watch the stream VODs on my YouTube.
If you don't feel like watching the streams (I don't blame you, they are long), you can watch my dev log videos instead

Development Setup

Clone the repository. Use --recurse-submodules when cloning to fetch submodules

git clone --recurse-submodules https://github.com/insberr/archea

If you forgot to clone with --recurse-submodules, you can fetch submodules by:

git submodule init
git submodule update

Make sure to follow the specific OS instructions.

(SOON) For VSCode, there should be a run and debug configuration already provided.

JetBrains CLion will automatically set up the build configs.

Linux

TODO: Make it so you don't have to do this. Also, you need to do this in order to run the compiled program.

First you need to install OpenGL development libraries. This is really easy on linux.

sudo apt install libglew-dev libglfw3-dev libglm-dev

Windows

TODO: Provide prebuilt packages because using vcpkg is annoying.

Install packages with vcpkg (builtin to CLion)

• glew
• glfw3
• glm

MacOS

Unless you can get OpenGL4.6 or later working on MacOS, you are out of luck. The shader code uses OpenGL4.6 features and the program will crash when you run it.

Cross Compiling

I have to look up how to do these.

Compile for Windows on Linux

TODO

Compile for Linux on Windows

TODO: Maybe just use WSL?

Wording

1. Particle - Refers to a voxel which is simulated (i.e. sand, water)
2. Voxel - The cubes you see in the world, duh

Journey Of Archea

Here is the journey I went through and some history LOL.

I started out trying to make a 2D falling sand simulation in Godot using C# with a friend. We made some progress but kept dealing with performance issues. We stopped working on it shortly after.

Later I started trying to make a 3D simulation in rust using the Bevy game library. I quickly learned two things:

1. I needed to make my own engine specifically for the simulation.
2. Rust wasn't working well for me. I needed to switch to a language I was more comfortable with.

So I decided to switch to c++ and start learning graphics programming. I started out by following a YouTube tutorial to learn directx11. (My learning_d3d11 repository).

I started making a 2d falling sand game in directx11 and quickly made it 3D because I am impatient.
Then decided my code was too messy.
I started looking for ways to render the particles and discovered ray marching. Ray marching seemed interesting so I started experimenting with it in shader toys.
I started learning opengl and messing with ray marching. Once I had a handle on that I came back here (to Archea) and started rewriting it in c++.
3 Days later I have a basic engine working, ray marching working, opengl working, ImGui set up, and a very basic simulation of particles.

I have been spending way too much time working on the shader. I really need to start working on the simulation itself.