{"id":17782193,"url":"https://github.com/caffeinemc/sodium","last_synced_at":"2026-05-14T01:03:23.789Z","repository":{"id":37028806,"uuid":"237553513","full_name":"CaffeineMC/sodium","owner":"CaffeineMC","description":"A Minecraft mod designed to improve frame rates and reduce micro-stutter","archived":false,"fork":false,"pushed_at":"2025-04-12T23:09:42.000Z","size":7234,"stargazers_count":5074,"open_issues_count":196,"forks_count":832,"subscribers_count":88,"default_branch":"dev","last_synced_at":"2025-04-13T21:20:50.613Z","etag":null,"topics":["azdo","fabric","minecraft","neoforge","opengl"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CaffeineMC.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"jellysquid3","patreon":"jellysquid"}},"created_at":"2020-02-01T03:04:09.000Z","updated_at":"2025-04-13T10:52:11.000Z","dependencies_parsed_at":"2024-01-07T12:19:03.584Z","dependency_job_id":"b2e67527-1267-418a-be8a-75eb668f3ba8","html_url":"https://github.com/CaffeineMC/sodium","commit_stats":{"total_commits":1155,"total_committers":82,"mean_commits":"14.085365853658537","dds":0.4337662337662338,"last_synced_commit":"0135b01a74193b8f438a1e4f915d8bbfd85e6435"},"previous_names":[],"tags_count":89,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CaffeineMC%2Fsodium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CaffeineMC%2Fsodium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CaffeineMC%2Fsodium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CaffeineMC%2Fsodium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CaffeineMC","download_url":"https://codeload.github.com/CaffeineMC/sodium/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250514756,"owners_count":21443208,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["azdo","fabric","minecraft","neoforge","opengl"],"created_at":"2024-10-27T05:04:13.625Z","updated_at":"2026-05-09T00:23:18.780Z","avatar_url":"https://github.com/CaffeineMC.png","language":"Java","funding_links":["https://github.com/sponsors/jellysquid3","https://patreon.com/jellysquid"],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"common/src/main/resources/sodium-icon.png\" width=\"128\"\u003e\n\n# Sodium\n\nSodium is a powerful rendering engine and optimization mod for the Minecraft client which improves frame rates and reduces\nmicro-stutter, while fixing many graphical issues in Minecraft.\n\n**This mod is the result of thousands of hours of development, and is made possible thanks to players like you.** If you\nwould like to show a token of your appreciation for my work, and help support the development of Sodium in the process,\nthen consider [buying me a coffee](https://caffeinemc.net/donate).\n\n\u003ca href=\"https://caffeinemc.net/donate\"\u003e\u003cimg src=\"https://storage.ko-fi.com/cdn/kofi2.png?v=3\" width=\"180\"/\u003e\u003c/a\u003e\n\n---\n\n### 📥 Downloads\n\n#### Stable builds\n\nThe latest stable release of Sodium can be downloaded from our official [Modrinth](https://modrinth.com/mod/sodium) and\n[CurseForge](https://www.curseforge.com/minecraft/mc-mods/sodium) pages.\n\n#### Nightly builds (for developers)\n\nWe also provide bleeding-edge builds (\"nightlies\") which are useful for testing the very latest changes before they're\npackaged into a release. These builds are primarily intended for other mod developers and users with expert skills, and do\nnot come with any support or warranty.\n\nFor a complete listing of available nightly builds, please see [the wiki page](https://github.com/CaffeineMC/sodium/wiki/Nightly-Builds). We also have a Maven repository for including Sodium in your development workspace or build process, for which you can also find [documentation on our wiki](https://github.com/CaffeineMC/sodium/wiki/CaffeineMC-Maven-\u0026-Config-API).\n\n### 🖥️ Installation\n\nSince the release of Sodium 0.6.0, both the _Fabric_ and _NeoForge_ mod loaders are supported. We generally recommend\nthat new users prefer to use the _Fabric_ mod loader, since it is more lightweight and stable (for the time being.)\n\nFor more information about downloading and installing the mod, please refer to our [Installation Guide](https://github.com/CaffeineMC/sodium/wiki/Installation).\n\n### 🙇 Getting Help\n\nFor technical support (including help with mod installation problems and game crashes), please use our\n[official Discord server](https://caffeinemc.net/discord).\n\n### 📬 Reporting Issues\n\nIf you do not need technical support and would like to report an issue (bug, crash, etc.) or otherwise request changes\n(for mod compatibility, new features, etc.), then we encourage you to open an issue on the\n[project issue tracker](https://github.com/CaffeineMC/sodium/issues).\n\nPlease note that while the issue tracker is open to feature requests, development is primarily focused on\nimproving compatibility, performance, and finishing any unimplemented features necessary for parity with\nthe vanilla renderer.\n\n### 💬 Join the Community\n\nWe have an [official Discord community](https://caffeinemc.net/discord) for all of our projects. By joining, you can:\n- Get installation help and technical support for all of our mods\n- Get the latest updates about development and community events\n- Talk with and collaborate with the rest of our team\n- ... and just hang out with the rest of our community.\n\n## ✅ Hardware Compatibility\n\nWe only provide official support for graphics cards which have up-to-date drivers that are compatible with OpenGL 4.5\nor newer. Most graphics cards released in the past 12 years will meet these requirements, including the following:\n\n- AMD Radeon HD 7000 Series (GCN 1) or newer\n- NVIDIA GeForce 400 Series (Fermi) or newer\n- Intel HD Graphics 500 Series (Skylake) or newer\n\nNearly all graphics cards that are already compatible with Minecraft (which requires OpenGL 3.3) should also work\nwith Sodium. But our team cannot ensure compatibility or provide support for older graphics cards, and they may\nnot work with future versions of Sodium.\n\n#### OpenGL Compatibility Layers\n\nDevices which need to use OpenGL translation layers (such as GL4ES, ANGLE, etc.) are not supported and will very likely\nnot work with Sodium. These translation layers do not implement required functionality, and they suffer from underlying\ndriver bugs which cannot be worked around.\n\n## 🛠️ Building from sources\n\nSodium uses the [Gradle build tool](https://gradle.org/) and can be built with the `gradle build` command. The build\nartifacts (production binaries and their source bundles) can be found in the `build/mods` directory.\n\nThe [Gradle wrapper](https://docs.gradle.org/current/userguide/gradle_wrapper.html#sec:using_wrapper) is provided for ease of use and will automatically download and install the\nappropriate version of Gradle for the project build. To use the Gradle wrapper, substitute `gradle` in build commands\nwith `./gradlew.bat` (Windows) or `./gradlew` (macOS and Linux).\n\n### Build Requirements\n\n- OpenJDK 21\n    - We recommend using the [Eclipse Temurin](https://adoptium.net/) distribution as it's regularly tested by our developers and known\n      to be of high quality.\n- Gradle 8.10.x\n    - Typically, newer versions of Gradle will work without issues, but the build script is only tested against the\n      version used by the [wrapper script](/gradle/wrapper/gradle-wrapper.properties).\n\n## 📜 License\n\nExcept where otherwise stated (see [third-party license notices](thirdparty/NOTICE.txt)), the content of this repository is provided\nunder the [Polyform Shield 1.0.0](LICENSE.md) license by [JellySquid](https://jellysquid.me).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaffeinemc%2Fsodium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcaffeinemc%2Fsodium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaffeinemc%2Fsodium/lists"}