Get Help & Join the Community

Connect with other Sodium users, report issues, get support, and contribute to the ongoing development of Sodium and the CaffeineMC ecosystem.

Join Our Community

Discord Community

Join our active Discord server to connect with other Sodium users, get real-time support, discuss ideas, and stay updated on the latest developments.

Direct access to developers and knowledgeable community members

Dedicated support channels for troubleshooting issues

Announcements about new releases and features

Join the Discord Server

GitHub Repository

Sodium is an open-source project hosted on GitHub. Visit our repository to access source code, report issues, contribute, and track development progress.

Submit bug reports and feature requests via Issues

Contribute to development through pull requests

Browse the codebase and view ongoing development

Modrinth

Modrinth is our primary mod distribution platform. Visit our Modrinth page for downloads, project information, and version history.

View on Modrinth

Reddit

Join discussions about Sodium on Reddit. Share your experiences, setups, and configurations on r/fabricmc and r/Minecraft.

How to Report a Bug

Found an issue with Sodium? We appreciate your help in making Sodium better! Here's how to report bugs effectively:

Before Reporting

1

Check If It's Already Reported

Search the existing issues to see if someone has already reported the same problem.

2

Test Without Other Mods

Try to reproduce the issue with only Sodium installed to determine if it's a compatibility issue with another mod.

3

Update to the Latest Version

Make sure you're using the latest version of Sodium, as the issue may have already been fixed.

Creating a Bug Report

1

Use the Issue Template

When creating a new issue on GitHub, use the provided bug report template to include all necessary information.

2

Include Essential Information

Your report should include:

  • Minecraft version
  • Sodium version
  • Mod loader version (Fabric/Quilt/etc.)
  • Complete list of installed mods
  • System specifications (CPU, GPU, RAM, OS)
  • Steps to reproduce the issue
  • Screenshots or videos if applicable
  • Crash reports or logs if available
3

Be Clear and Specific

Describe the issue clearly, including what you expected to happen and what actually happened. The more detailed your report is, the easier it will be for developers to identify and fix the issue.

Contributing to Sodium

Sodium is an open-source project that welcomes contributions from the community. There are many ways to contribute, even if you're not a programmer:

Code Contributions

Help improve Sodium by contributing code changes, bug fixes, or new features.

  • Fix existing issues on GitHub
  • Implement new features
  • Optimize existing code
  • Add documentation
Read the contribution guidelines →

Non-Code Contributions

There are many ways to help without programming:

  • Create tutorials and documentation
  • Test pre-release versions and report bugs
  • Help other users on Discord or Reddit
  • Translate resources
  • Share Sodium with others
Get started with Sodium →

Note: All contributors to Sodium are expected to follow our Code of Conduct. We're committed to providing a welcoming and inclusive environment for everyone.

Getting Support

Discord Help

For the fastest support, join our Discord server and post in the #support channel. Community members and developers are often available to help.

Join Discord Support Channel →

GitHub Issues

For confirmed bugs or feature requests, open an issue on GitHub. Please follow the reporting guidelines to ensure your issue can be addressed efficiently.

Browse GitHub Issues →

Documentation

Check our configuration guides and FAQs for solutions to common issues. Our website contains detailed information about most aspects of Sodium.

Common Support Topics

Compatibility Issues

If you're experiencing issues with another mod, check the compatibility chart or ask in Discord's #compatibility channel.

Performance Optimization

For help optimizing Sodium for your specific hardware, see our recommended presets or ask for personalized advice in Discord.

Installation Problems

For help with installation issues, refer to our installation troubleshooting guide.

Crash Reports

If Minecraft is crashing, share your crash report on Discord or GitHub for analysis. Be sure to include your full mod list and system specifications.

Join the Sodium Community Today

Connect with thousands of players and developers who are using Sodium to enhance their Minecraft experience.