explaingit

caffeinemc/sodium

5,568JavaAudience · generalComplexity · 2/5LicenseSetup · moderate

TLDR

Sodium is a Minecraft mod that replaces the game's built-in graphics rendering with a faster version, significantly improving frame rates and reducing stuttering without changing how the game looks.

Mindmap

mindmap
  root((repo))
    What it does
      Replaces renderer
      Boosts frame rates
      Reduces stuttering
    Requirements
      OpenGL 4.5 GPU
      Fabric or NeoForge
      Java 21 for source
    Distribution
      Modrinth download
      CurseForge download
      GitHub source
    Audience
      Minecraft players
      Modpack creators
      Mod developers
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Install Sodium on your Minecraft client to improve frame rates and reduce stuttering on mid-range hardware.

USE CASE 2

Add Sodium to a Fabric or NeoForge modpack to boost performance for all players using the pack.

USE CASE 3

Study Sodium's source as a reference for how modern OpenGL rendering can optimize a voxel game.

USE CASE 4

Report compatibility issues between Sodium and other mods via the GitHub issue tracker.

Tech stack

JavaGradleFabricNeoForgeOpenGL

Getting it running

Difficulty · moderate Time to first run · 5min

Requires Fabric or NeoForge mod loader and a GPU with OpenGL 4.5 support, software rendering translation layers are explicitly unsupported.

Free to use and modify for personal and non-commercial purposes, competitors building similar rendering tools are not permitted.

In plain English

Sodium is a mod for the game Minecraft that replaces the game's built-in graphics rendering code with a faster, more efficient version. When Minecraft runs, it draws the world on screen using a process that can be slow on many computers, causing the game to stutter or run at low frame rates. Sodium rewrites that process to get more out of the same hardware, so the game runs more smoothly without changing how it looks to the player. The mod is not made by Mojang (the company behind Minecraft) and cannot be installed like a regular program. It requires a mod loader, either Fabric or NeoForge, to be installed first. Those are separate tools that allow players to add community-made modifications to Minecraft. Once a loader is in place, Sodium is added as an additional file that the loader picks up when the game starts. To use Sodium, a graphics card needs to support OpenGL 4.5, a standard that most cards released in the past decade already meet. Devices that use software-based translation layers to fake OpenGL support are explicitly not supported, as those layers tend to be incomplete and cause problems that cannot be fixed in the mod itself. Support is provided through a Discord server run by the developer. Bug reports and requests for mod compatibility improvements go through the project's issue tracker on GitHub. The README notes that development focuses mainly on performance, compatibility, and catching up to features already present in Minecraft's original renderer rather than adding new visual effects. The mod is available as pre-built downloads from Modrinth and CurseForge, the two main platforms for distributing Minecraft mods. Developers who want to build it from source need Java 21 and the Gradle build tool. The code is licensed under Polyform Shield 1.0.0, which differs from open-source licenses in that it restricts use by competitors building similar products.

Copy-paste prompts

Prompt 1
How do I install Sodium on Minecraft with the Fabric loader? Walk me through the exact steps.
Prompt 2
How do I check whether my graphics card supports OpenGL 4.5 before installing Sodium?
Prompt 3
I am getting a conflict between Sodium and another Minecraft mod. How do I report it on the GitHub issue tracker?
Prompt 4
How do I compile Sodium from source using Java 21 and Gradle?
Prompt 5
Why does Sodium not support Metal-to-OpenGL translation layers on Apple Silicon?
Open on GitHub → Explain another repo

← caffeinemc on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.