Installing Nvidium on Minecraft 1.21 is mainly a version-matching task. You need a supported NVIDIA GPU, a compatible Fabric or Quilt loader, the exact Sodium version required by the chosen Nvidium build, and the compiled Nvidium .jar file. A development ZIP package is useful for reviewing or building the project, but it is not the file ordinary players place in the mods folder.
1. Check hardware and create a backup
Confirm that the computer uses an NVIDIA GTX 16-series/Turing-or-newer GPU with mesh-shader support. Update the NVIDIA driver through an official NVIDIA method, then back up important worlds before changing a modded profile. Nvidium is client-side, but any changing mod setup can crash or expose an unrelated world problem.
2. Choose one exact Minecraft version
“Minecraft 1.21” includes several point releases that are not automatically interchangeable. Pick the exact game version you intend to launch, then select a Nvidium file whose compatibility list includes that version. Confirm the supported Minecraft version and dependency details before choosing a file.
3. Install Fabric or Quilt
Install the loader supported by the selected Nvidium build. Launch that profile once and close the game. This creates the normal game directories. On a default installation, place client mods in the profile's mods folder. Third-party launchers may use a separate instance folder, so open the instance directory from the launcher instead of assuming the global Minecraft folder is active.
4. Install the matching Sodium build
Nvidium requires Sodium. Read the dependency information attached to the Nvidium version and download the exact compatible Sodium release. Do not combine a newer Sodium JAR with an older Nvidium file unless the release notes explicitly allow it. Fabric API is not always required by Nvidium itself; add it only when another installed mod or the chosen release requires it.
5. Download the compiled Nvidium JAR
For a normal installation, obtain a compiled Nvidium .jar that explicitly supports your Minecraft version and required Sodium build. The ZIP package on this website contains project files for review or local builds and must not be placed in the mods folder as though it were a compiled mod.
6. Place files and launch
Put the Sodium JAR and Nvidium JAR in the same instance mods folder. Remove older duplicates of either mod. Launch the selected Fabric or Quilt profile. If you use Mod Menu, check that both projects appear; otherwise, review the latest log for loading errors and confirm the game reaches the main menu.
7. Verify the renderer correctly
Test with shaders disabled because Nvidium disables its accelerated path while Iris is actively using shaders. Use a known world, allow terrain to load, and compare against a Sodium-only profile at the same resolution and render distance. A small difference at low render distance does not prove installation failed; Nvidium's advantage is often clearer when terrain rendering is CPU-limited.
Common installation mistakes
- Putting the development ZIP package in the
modsfolder instead of a compiled JAR. - Mixing Minecraft point versions or using an incompatible Sodium build.
- Leaving old duplicate Sodium or Nvidium files in the same folder.
- Launching a different launcher instance from the folder you edited.
- Testing with active Iris shaders and expecting the Nvidium renderer to remain enabled.
- Using an unsupported NVIDIA, AMD or Intel GPU.
