19 lines
No EOL
1.8 KiB
Markdown
19 lines
No EOL
1.8 KiB
Markdown
# Client Module - IslaApocalypse
|
|
|
|
**Phase 2 Status:** Active (Mesh Rendering & Vertex Painting Online)
|
|
|
|
## Overview
|
|
The `Client` directory handles the visual representation of the 3D Voxel Engine. It is strictly responsible for receiving pre-calculated mathematical data from the `Server` and `Core` modules and translating it into Godot-native visual nodes (`MeshInstance3D`). It does not calculate collisions, densities, or terrain generation.
|
|
|
|
## Key Architecture & Components
|
|
|
|
### 1. The Visualizer (`ChunkRenderer.cs`)
|
|
A script attached to a `MeshInstance3D` node that physically draws a single 32x32 chunk of the world.
|
|
* **Mesh Generation:** Calls `MarchingCubes.GenerateMesh()` from the `Core` module, passing in the `Densities` and `BlockIDs` scalar fields.
|
|
* **Vertex Painting:** Dynamically creates a `StandardMaterial3D` and enables `VertexColorUseAsAlbedo = true`. This tells Godot to ignore standard texture maps and instead color the mesh using the exact RGB values we assigned to the vertices based on their `BlockID` (e.g., Green for Grass, Brown for Wasteland).
|
|
* **World Positioning:** Multiplies the `ChunkPosition` (e.g., [1, 0]) by `Constants.CHUNK_SIZE` and `Constants.VOXEL_SCALE` (1.0f) to perfectly align the chunk in the global 3D space.
|
|
* **Backface Rendering:** `CullMode` is explicitly disabled to ensure players don't see through the bottom of the map if they clip inside a mountain.
|
|
|
|
## Next Immediate Steps (Phase 2, Step 4)
|
|
* Currently, the renderer draws the exact topography. Once the `Server` implements **Road Carving**, the `Client` will automatically inherit those flattened vertices and paint them with the `ASPHALT` vertex color without needing any code changes here.
|
|
* Future implementations will include reading `BlockIDs` to paint different UV maps/textures instead of just raw RGB vertex colors. |