How caffeinemc/sodium works
Sodium is a Minecraft client rendering engine and optimization mod. The principal workflow is: Minecraft launches Sodium; compatibility checks validate the graphics environment; world changes become render-section updates; visible sections are culled and asynchronously rebuilt; lighting and model data are uploaded through GPU arenas; the renderer submits batches to the graphics device for faster frames. The repository also exposes configuration APIs and GUI controls, resource-pack checks, block-entity rendering, and platform-specific compatibility workarounds. Some orchestration is inferred from sampled files and directory structure.
Main entry points: RenderSectionManager.java Section Manager · SodiumClientMod.java Sodium Entry · VideoSettingsScreen.java Video Settings UI · ChunkRenderer.java Chunk Renderer
Components 20
Entry & Compatibility
- Sodium Entry
common/src/main/java/net/caffeinemc/mods/sodium/client/SodiumClientMod.java - Compatibility Checks
common/src/boot/java/net/caffeinemc/mods/sodium/client/compatibility/checks - Driver Workarounds
common/src/boot/java/net/caffeinemc/mods/sodium/client/compatibility/workarounds - Resource Checks
common/src/main/java/net/caffeinemc/mods/sodium/client/checks/ResourcePackScanner.java
Configuration UI
- Config API
common/src/api/java/net/caffeinemc/mods/sodium/api/config - Config Manager
common/src/main/java/net/caffeinemc/mods/sodium/client/config/ConfigManager.java - Video Settings UI
common/src/main/java/net/caffeinemc/mods/sodium/client/gui/VideoSettingsScreen.java - Option Search
common/src/main/java/net/caffeinemc/mods/sodium/client/config/search
World Geometry
- World Renderer
common/src/main/java/net/caffeinemc/mods/sodium/client/render/SodiumWorldRenderer.java - Section Manager
common/src/main/java/net/caffeinemc/mods/sodium/client/render/chunk/RenderSectionManager.java - Section Storage
common/src/main/java/net/caffeinemc/mods/sodium/client/render/chunk/storage/QueuedSectionStorage.java - Chunk Renderer
common/src/main/java/net/caffeinemc/mods/sodium/client/render/chunk/ChunkRenderer.java - Lighting Pipelines
common/src/main/java/net/caffeinemc/mods/sodium/client/model/light - Block Entity API
common/src/api/java/net/caffeinemc/mods/sodium/api/blockentity
GPU Rendering
- Section Mesh Data
common/src/main/java/net/caffeinemc/mods/sodium/client/render/chunk/data/SectionRenderDataStorage.java - GPU Buffer Arenas
common/src/main/java/net/caffeinemc/mods/sodium/client/gpu/arena - Draw Backend
common/src/main/java/net/caffeinemc/mods/sodium/client/gpu/device/backend/DrawBackend.java - Draw Batches
common/src/main/java/net/caffeinemc/mods/sodium/client/gpu/device/batch
Other components
- Minecraft Client
- Graphics Device
Connections 19
- Minecraft Client → Sodium Entry: launches
- Sodium Entry → Compatibility Checks: runs checks
- Compatibility Checks → Driver Workarounds: selects workarounds
- Sodium Entry → Resource Checks: checks resources
- Minecraft Client → Video Settings UI: opens settings
- Video Settings UI → Config Manager: saves options
- Config API → Config Manager: binds options
- Video Settings UI → Option Search: searches options
- Minecraft Client → World Renderer: renders world
- World Renderer → Section Manager: updates sections
- Section Manager → Section Storage: queues sections
- Section Manager → Chunk Renderer: submits builds
- Chunk Renderer → Lighting Pipelines: calculates lighting
- Chunk Renderer → Section Mesh Data: stores meshes
- Section Mesh Data → GPU Buffer Arenas: allocates buffers
- Section Manager → Draw Backend: renders visible sections
- Draw Backend → Draw Batches: dispatches batches
- Draw Batches → Graphics Device: submits draws
- Block Entity API → World Renderer: extends rendering