{"id":14990721,"url":"https://github.com/josefalbers/terrainzigger","last_synced_at":"2025-04-12T02:43:46.477Z","repository":{"id":252487986,"uuid":"840595966","full_name":"JosefAlbers/TerrainZigger","owner":"JosefAlbers","description":"TerrainZigger: A procedural 3D terrain generator and visualizer written in Zig using Raylib","archived":false,"fork":false,"pushed_at":"2024-08-15T14:47:36.000Z","size":7284,"stargazers_count":16,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T22:22:12.333Z","etag":null,"topics":["3d","3d-engine","3d-game","3d-graphics","3d-models","procedural-generation","procedural-terrain","raylib","raylib-zig","wasm","zig","ziglang"],"latest_commit_sha":null,"homepage":"https://albersj66.itch.io/terrainzigger","language":"Zig","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JosefAlbers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-10T05:36:35.000Z","updated_at":"2025-03-21T06:11:20.000Z","dependencies_parsed_at":"2024-08-15T16:32:08.753Z","dependency_job_id":"f3fadf5e-2d04-4647-b63c-e04970402092","html_url":"https://github.com/JosefAlbers/TerrainZigger","commit_stats":{"total_commits":4,"total_committers":1,"mean_commits":4.0,"dds":0.0,"last_synced_commit":"915e12b7edecc68db17cfc460b05180574f0430a"},"previous_names":["josefalbers/terrainzigger"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JosefAlbers%2FTerrainZigger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JosefAlbers%2FTerrainZigger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JosefAlbers%2FTerrainZigger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JosefAlbers%2FTerrainZigger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JosefAlbers","download_url":"https://codeload.github.com/JosefAlbers/TerrainZigger/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248507875,"owners_count":21115692,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d","3d-engine","3d-game","3d-graphics","3d-models","procedural-generation","procedural-terrain","raylib","raylib-zig","wasm","zig","ziglang"],"created_at":"2024-09-24T14:20:39.517Z","updated_at":"2025-04-12T02:43:46.453Z","avatar_url":"https://github.com/JosefAlbers.png","language":"Zig","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TerrainZigger\n\nTerrainZigger 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.\n\n![TerrainZigger](https://raw.githubusercontent.com/JosefAlbers/TerrainZigger/main/assets/terrain_zigger.gif)\n\n## Features\n\n- Procedural terrain generation using Fractional Brownian Motion (FBM)\n- Real-time 3D rendering with Raylib\n- Interactive camera controls for exploring the terrain\n- Dynamic water level adjustment\n- On-the-fly terrain regeneration\n- Customizable terrain parameters\n\n## Prerequisites\n\nTo build and run TerrainZigger, you'll need:\n\n- [Zig](https://ziglang.org/) (version 0.13.0 recommended)\n- [Raylib](https://www.raylib.com/)\n\n## Building and Running\n\n1. Clone the repository:\n   ```\n   git clone https://github.com/JosefAlbers/TerrainZigger.git\n   cd TerrainZigger\n   ```\n\n2. Build the project:\n   ```\n   zig build-exe terrain_zigger.zig -lc $(pkg-config --libs --cflags raylib)\n   ```\n\n3. Run the executable:\n   ```\n   ./terrain_zigger\n   ```\n\n## Controls\n\n- **R** or **Right Mouse Button**: Regenerate terrain\n- **Left Mouse Button**: Rotate camera\n- **Mouse Wheel**: Zoom in/out\n- **Z**: Reset camera\n- **, (Comma)**: Decrease water level\n- **. (Period)**: Increase water level\n\n## Customization\n\nYou can adjust various parameters in the `terrain_zigger.zig` file to customize the terrain generation:\n\n- `TERRAIN_SIZE`: Changes the size of the terrain grid\n- `INITIAL_WATER_LEVEL`: Sets the initial height of the water plane\n- `CUBE_SIZE`: Modifies the size of individual terrain cubes\n\nFeel free to experiment with the `fbm` function parameters in `generateTerrain` to create different terrain styles.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is open source and available under the [MIT License](LICENSE).\n\n## Acknowledgments\n\n- Terrain generation algorithm inspired by [Perlin Noise](https://en.wikipedia.org/wiki/Perlin_noise)\n- 3D rendering made possible by [Raylib](https://www.raylib.com/)\n\n---\n\nHappy terrain generating! 🏞️","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosefalbers%2Fterrainzigger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjosefalbers%2Fterrainzigger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosefalbers%2Fterrainzigger/lists"}