https://github.com/josefalbers/terrainzigger
TerrainZigger: A procedural 3D terrain generator and visualizer written in Zig using Raylib
https://github.com/josefalbers/terrainzigger
3d 3d-engine 3d-game 3d-graphics 3d-models procedural-generation procedural-terrain raylib raylib-zig wasm zig ziglang
Last synced: about 1 year ago
JSON representation
TerrainZigger: A procedural 3D terrain generator and visualizer written in Zig using Raylib
- Host: GitHub
- URL: https://github.com/josefalbers/terrainzigger
- Owner: JosefAlbers
- License: mit
- Created: 2024-08-10T05:36:35.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-15T14:47:36.000Z (almost 2 years ago)
- Last Synced: 2025-03-25T22:22:12.333Z (about 1 year ago)
- Topics: 3d, 3d-engine, 3d-game, 3d-graphics, 3d-models, procedural-generation, procedural-terrain, raylib, raylib-zig, wasm, zig, ziglang
- Language: Zig
- Homepage: https://albersj66.itch.io/terrainzigger
- Size: 6.95 MB
- Stars: 16
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TerrainZigger
TerrainZigger is a 3D terrain generator written in Zig using the Raylib library. It creates procedurally generated landscapes with dynamic water features, offering an interactive 3D visualization.
## Features
- Procedural terrain generation using Fractional Brownian Motion (FBM)
- Real-time 3D rendering with Raylib
- Interactive camera controls for exploring the terrain
- Dynamic water level adjustment
- On-the-fly terrain regeneration
- Customizable terrain parameters
## Prerequisites
To build and run TerrainZigger, you'll need:
- [Zig](https://ziglang.org/) (version 0.13.0 recommended)
- [Raylib](https://www.raylib.com/)
## Building and Running
1. Clone the repository:
```
git clone https://github.com/JosefAlbers/TerrainZigger.git
cd TerrainZigger
```
2. Build the project:
```
zig build-exe terrain_zigger.zig -lc $(pkg-config --libs --cflags raylib)
```
3. Run the executable:
```
./terrain_zigger
```
## Controls
- **R** or **Right Mouse Button**: Regenerate terrain
- **Left Mouse Button**: Rotate camera
- **Mouse Wheel**: Zoom in/out
- **Z**: Reset camera
- **, (Comma)**: Decrease water level
- **. (Period)**: Increase water level
## Customization
You can adjust various parameters in the `terrain_zigger.zig` file to customize the terrain generation:
- `TERRAIN_SIZE`: Changes the size of the terrain grid
- `INITIAL_WATER_LEVEL`: Sets the initial height of the water plane
- `CUBE_SIZE`: Modifies the size of individual terrain cubes
Feel free to experiment with the `fbm` function parameters in `generateTerrain` to create different terrain styles.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is open source and available under the [MIT License](LICENSE).
## Acknowledgments
- Terrain generation algorithm inspired by [Perlin Noise](https://en.wikipedia.org/wiki/Perlin_noise)
- 3D rendering made possible by [Raylib](https://www.raylib.com/)
---
Happy terrain generating! 🏞️