Rendering System Overview

​

Architecture Overview

• GameRenderer - Main rendering coordinator and camera management
• LevelRenderer - Terrain chunk rendering and world visualization
• EntityRenderer - Entity and mob rendering with model system
• ParticleEngine - Particle effects management and rendering
• TileRenderer - Block/tile rendering
• TileEntityRenderer - Special block entity rendering (chests, signs, etc.)

​

Rendering Pipeline

1. Camera Setup (GameRenderer::setupCamera)
   • Position and orientation calculation
   • FOV and projection matrix setup
   • Third-person camera handling
   • Smooth camera movement interpolation
2. Sky Rendering (LevelRenderer::renderSky)
   • Skybox with sun, moon, and stars
   • Dimension-specific sky (Overworld, Nether, End)
   • Time-of-day based coloring
   • Rain brightness adjustment
3. Terrain Rendering (LevelRenderer::render)
   • Chunk frustum culling
   • Opaque geometry (layer 0)
   • Transparent geometry (layer 1)
   • Platform-specific optimizations
4. Entity Rendering (LevelRenderer::renderEntities)
   • Entity frustum culling
   • Model-based rendering
   • Shadow rendering
   • Name tag rendering
5. Particle Rendering (ParticleEngine::render)
   • Sorted by texture type
   • Billboarded quads
   • Lighting integration
6. Weather Effects (GameRenderer::renderSnowAndRain)
   • Rain and snow particles
   • Weather-based audio
7. Cloud Rendering (LevelRenderer::renderClouds)
   • Simple and advanced cloud modes
   • Dynamic movement
   • Lighting integration
8. Hand Rendering (GameRenderer::renderItemInHand)
   • First-person hand and item
   • Animation and bobbing
9. UI Rendering (GameRenderer::setupGuiScreen)
   • HUD elements
   • Menus and screens

​

Texture Management

• Terrain Atlas - Block textures compiled into a single atlas
• Item Atlas - Item textures
• Entity Textures - Mob skins and entity textures
• Particle Textures - Particle effects
• UI Textures - GUI elements

​

Dynamic Textures

textures->bindTexture(TN_TERRAIN);        // Terrain atlas
textures->bindTexture(TN_GUI_ITEMS);      // Item textures
textures->bindTexture(TN_PARTICLES);      // Particle effects

​

Lighting System

​

Light Texture

• Per-level light textures (up to 4 for split-screen)
• Night vision effects
• Dimension-specific lighting (Nether has different lighting)
• Smooth transitions between light levels

​

Texture Lighting

• Vertices receive light color via GL_TEXTURE1
• Per-chunk lighting calculations
• Smooth lighting across block boundaries

​

Performance Optimizations

​

Chunk Management

• Frustum Culling - Only render visible chunks
• Occlusion Culling - Skip chunks behind other chunks
• Empty Chunk Flags - Skip rendering empty chunks
• Dirty Chunk System - Only rebuild modified chunks
• Command Buffers - Pre-compiled rendering commands

​

Split-Screen Support

• Shared chunk pool across players
• Per-player frustum culling
• Dynamic render distance based on player count
• Reference counting for shared resources

​

Platform-Specific Optimizations

​

PS3 SPU Acceleration

• LevelRenderer_cull - Chunk frustum culling on SPU
• LevelRenderer_zSort - Depth sorting on SPU
• LevelRenderer_FindNearestChunk - Nearest chunk finding on SPU

​

PS Vita Optimizations

• Reduced render distance in split-screen
• Alpha cutout optimization (separate pass)
• Forced LOD control for cutout geometry
• Camera position-based fog calculations

​

Xbox One/PS4

• Larger command buffer allocations (512MB Xbox One, 448MB PS4)
• Enhanced memory management

​

Anaglyph 3D Support

if (mc->options->anaglyph3d) {
    // Red-cyan color conversion
    float r = (original_r * 30 + original_g * 59 + original_b * 11) / 100;
    float g = (original_r * 30 + original_g * 70) / 100;
    float b = (original_r * 30 + original_b * 70) / 100;
}

​

Render Distance

int dist = (int)sqrtf((float)PLAYER_RENDER_AREA / (float)activePlayers());

• Single player: Maximum render distance
• Split-screen: Reduced per-player to maintain performance
• Configurable via Options::viewDistance

​

Multi-Threading

• GameRenderer::m_updateThread - Background chunk rebuilding
• Critical sections for dirty chunk management
• Thread-safe renderable tile entity tracking
• Deferred deletion of rendering resources

​

Debug Information

​

Rendering Stats

• LevelRenderer::gatherStats1() - Chunk statistics
  • Rendered chunks / Total chunks
  • Frustum culled (F), Occluded (O), Empty (E)
• LevelRenderer::gatherStats2() - Entity statistics
  • Rendered entities / Total entities
  • Culled (B), Invisible (I)

​

Command Buffer System

• Pre-compiled geometry for each chunk
• Two render lists per chunk (opaque and transparent)
• Global chunk indexing system
• Memory-limited allocation (platform-specific)

​

Next Steps

• Level Renderer - Detailed chunk rendering
• Entity Renderer - Entity and mob rendering
• Particle Engine - Particle effects system