whatisgithub

What is sodium?

caffeinemc/sodium — explained in plain English

Analysis updated 2026-06-26

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

In one sentence

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

What do people build with it?

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.

What is it built with?

JavaGradleFabricNeoForgeOpenGL

How does it compare?

caffeinemc/sodiumgeysermc/geysercinit/qauxiliary
Stars5,5685,5705,574
LanguageJavaJavaJava
Setup difficultymoderatemoderatehard
Complexity2/53/55/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get 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.

So what is it?

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?

Frequently asked questions

What is sodium?

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.

What language is sodium written in?

Mainly Java. The stack also includes Java, Gradle, Fabric.

What license does sodium use?

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

How hard is sodium to set up?

Setup difficulty is rated moderate, with roughly 5min to a first successful run.

Who is sodium for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.