Repository navigation
Releases
v0.1.0 🌄 Vulkan Terrain Renderer
🚀 Major Architecture & Performance Update
This release introduces a major upgrade to the Vulkan terrain renderer and GPU hydraulic erosion pipeline.
✨ Highlights
- 💧 Optimized GPU hydraulic erosion workflow
- 📉 Added terrain slope pre-pass to skip low-impact droplets on flat areas
- ⚡ Added droplet early-exit logic and erosion statistics buffers
- 🧪 Added GPU-side research data collection for step count, movement distance, flow, and erosion amount
- 🏔️ Improved terrain material blending using height, slope, flow, normal direction, and noise
- 🌫️ Added atmospheric fog
- ☀️ Added directional shadow-map prototype
- 🛠️ Added ImGui debug controls for terrain and rendering parameters
- 🧱 Refactored terrain, compute, shadow, and rendering code structure
📈 Erosion Performance History
Same historical test scene:
4.886600 s → 3.957070 s → 1.700000 s → 1.039470 s
Performance varies with GPU power mode, terrain size, droplet count, and erosion settings.
⚠️ Notes
This is an experimental development release. Shadow rendering, terrain materials, and water rendering are still actively being refined.
🔮 Next Steps
- FFT ocean simulation
- Better shadow filtering
- Rivers, lakes, and coastline generation
- Wetness and rainfall effects
- Vegetation and biome placement
- Terrain chunk streaming and LOD
v0.0.7🌄 Vulkan Terrain Renderer
🌊 Initial Ocean System Implementation | 2026-08-25
This update introduces the first prototype of the ocean system for the Vulkan terrain project.
✨ New Features
- 🌊 Added a basic ocean plane covering the current world area
- 📐 Set the initial sea level to
Z = 0 - 🔺 Created the water plane using 4 vertices and 6 indices
- 🗺️ Automatically calculates the ocean size using
BlockNum × BlockDistance - 🎨 Added color presets for shallow, medium, and deep water
- 🧱 Reused the existing depth buffer for basic terrain-water occlusion
- 🏔️ Terrain above sea level remains visible, while lower areas are covered by water
- 🧩 Prepared the project structure for a future independent water mesh and rendering pipeline
🎨 Current Water Colors
const vec3 deepOceanColor = vec3(0.0, 0.1, 0.35);
const vec3 middleOceanColor = vec3(0.0, 0.4, 0.7);
const vec3 shallowOceanColor = vec3(0.1, 0.6, 0.6);The current prototype uses a constant water color. A future update will calculate water depth from the terrain below and smoothly blend between shallow, coastal, and deep-water colors.
🛠️ Current Implementation Status
This version primarily verifies:
- Correct water vertices and indices
- Successful ocean rendering
- Correct depth testing between terrain and water
- Proper alignment between terrain height and sea level
- Sufficient ocean coverage across the current map
The ocean system is still in an early prototype stage and does not yet include:
- Vertex-displaced waves
- Depth-based water colors
- Transparency and refraction
- Fresnel reflections
- Shoreline foam
- A coastline distance field
- A dedicated water rendering pipeline
- FFT ocean simulation
⚠️ Known Limitations
- The ocean currently contains only 4 vertices and cannot support geometric waves
- Some rendering resources are still shared with the terrain system
- Water is temporarily detected using a fixed sea-level condition
- The fragment shader cannot currently access the terrain height below each water fragment
- Water color does not yet react to coastline distance or actual water depth
🚧 Planned Improvements
- Create an independent
LveWatermodule - Add a dedicated
WaterVertexstructure - Separate water vertex and index buffers from terrain buffers
- Create dedicated water vertex and fragment shaders
- Upgrade the ocean plane to a
128×128or256×256grid - Calculate water depth using the underlying terrain height
- Add smooth shallow, coastal, and deep-water color transitions
- Implement Gerstner waves
- Calculate dynamic normals from wave derivatives
- Add Fresnel reflections and transparent blending
- Implement shoreline foam and shallow-water effects
- Explore GPU-based FFT ocean simulation
📝 Summary
This update completes the first basic validation stage of the ocean system. The current goal is not final visual quality, but verifying that the water mesh, indices, depth testing, ocean coverage, and sea-level relationship work correctly.
Future updates will separate the ocean from the terrain system and gradually introduce dynamic waves, depth-based coloring, reflections, refraction, shoreline foam, and more advanced GPU ocean simulation. 🌊
v0.0.6🌄 Vulkan Terrain Renderer
🚀 Major Performance Update – Smooth Terrain, Fog Culling & Cleaner Code
Body:
What's New ✨
- 📖 Code readability overhaul – refactored for cleaner logic and easier maintenance
- 🏎️ Unmatched terrain performance – render terrains of any size without a single frame drop!
- 🎭 Smart fog culling – objects beyond the fog distance are automatically excluded from rendering
⚠️ NoteWhile performance stays buttery smooth across all terrain sizes, memory usage will scale up with world complexity. No lag, just more RAM – a fair trade-off! 💾
🎯 Summary
Bigger worlds, smoother rides. Enjoy! 🌍🔥
v0.0.5🌄 Vulkan Terrain Renderer
Performance Improvements 🚀
- Terrain Generation: 4.25s → 0.37s (11.4x faster) ⚡
- Normal Calculation: 1.18s → 0.08s (14.5x faster)
- GPU Erosion: 1.88s → 1.99s (slight variance, within tolerance)
Code Quality
- Refactored
main.cppfor improved readability and maintainability - Reorganized code structure for easier future development
Before
- Terrain generation: 4.24661s
- GPU erosion: 1.88284s
- Normal calculation: 1.17962s
After
- Terrain generation: 0.373596s
- GPU erosion: 1.98953s
- Normal calculation: 0.0811948s
v0.0.4🌄 Vulkan Terrain Renderer
First public release! 🎉
A real-time terrain rendering and hydraulic erosion simulation system built with Vulkan and SDL3.
✨ Features
- 🏔️ Procedural Terrain Generation — Multi-layer noise blending with FastNoiseLite for highly detailed terrain
- 💧 GPU Hydraulic Erosion — Compute shader parallel simulation with 1 million water droplets, creating natural gullies and sediment deposits
- 🎨 Smart Texture Blending — Auto-blends grass/dirt/rock/snow based on slope, height, normal direction, and water flow intensity
- 🌫️ Atmospheric Fog — Distance-based fog rendering for enhanced scene depth
- 🖱️ Free Camera Controls — WASD movement + mouse rotation for full 3D observation
📸 Screenshots
🔧 System Requirements
| Item | Requirement |
|---|---|
| OS | Windows 10/11 |
| GPU | Vulkan 1.3 compatible |
| Driver | Latest GPU driver |
| Runtime | Vulkan Runtime 1.3+ |
🎮 Controls
| Key | Action |
|---|---|
| WASD | Move forward/backward/left/right |
| Mouse | Look around |
| Space | Ascend |
| Shift | Descend |
| ESC | Exit |
🛠️ Build from Source
Dependencies
Build Steps
- Set up dependency paths
- Build with Visual Studio or your preferred compiler
- Run
compile.batto compile shaders
📜 Changelog
[0.0.3] - 2026-08-21
Added
- Optimized snow mountain generation, improved terrain generation function
- Added distance-based fog effect
Fixed
- Fixed boundary issues in terrain generation
🙏 Credits
- Vulkan Tutorial — Vulkan learning resource
- FastNoiseLite — Procedural noise library
📄 License
For educational and personal use only.
💡 This is an ongoing personal learning project. Star ⭐ to follow my progress!


