Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/caffeinemc/lithium
A Fabric mod designed to improve the general performance of Minecraft without breaking things
https://github.com/caffeinemc/lithium
fabric minecraft
Last synced: 5 days ago
JSON representation
A Fabric mod designed to improve the general performance of Minecraft without breaking things
- Host: GitHub
- URL: https://github.com/caffeinemc/lithium
- Owner: CaffeineMC
- License: lgpl-3.0
- Created: 2019-11-30T02:41:17.000Z (about 5 years ago)
- Default Branch: develop
- Last Pushed: 2024-12-16T19:52:09.000Z (14 days ago)
- Last Synced: 2024-12-18T23:05:20.436Z (12 days ago)
- Topics: fabric, minecraft
- Language: Java
- Homepage:
- Size: 3.54 MB
- Stars: 1,945
- Watchers: 46
- Forks: 191
- Open Issues: 32
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Lithium (for Fabric)
Lithium is a free and open-source Minecraft mod which works to optimize many areas of the game in order to provide
better overall performance. It works on both the **client and server**, and **doesn't require the mod to be installed
on both sides**.
### What makes Lithium different?
One of the most important design goals in Lithium is *correctness*. Unlike other mods which apply optimizations to the
game, Lithium does not sacrifice vanilla functionality or behavior in the name of raw speed. It's a no compromises
solution for those wanting to speed up their game, and as such, installing Lithium should be completely transparent
to the player.
If you do encounter an issue where Lithium deviates from the norm, please don't hesitate to
[open an issue.](https://github.com/CaffeineMC/lithium-fabric/issues) Each patch is carefully checked to ensure
vanilla parity, but after all, bugs are unavoidable. Before opening a new issue, please check using the search tool that your issue has not already been created, and that if
there is a suitable template for the issue you are opening, that it is filled out entirely. Issues which are duplicates
or do not contain the necessary information to triage and debug may be closed.
### Community
[](https://jellysquid.me/discord)
We have an [official Discord community](https://jellysquid.me/discord) for all of our projects. By joining, you can:
- Get installation help and technical support with all of our mods
- Be notified of the latest developments as they happen
- Get involved and collaborate with the rest of our team
- ... and just hang out with the rest of our community.
### Support the developers
Lithium is made possible by the following core contributors [and others](https://github.com/CaffeineMC/lithium-fabric/graphs/contributors).
You can help support members of the core team by making a pledge to our Patreon pages below.
| | Author | Role | Links |
|----|:---------|:-------|:--------|
|  | jellysquid3 | Project Lead | [Patreon](https://patreon.com/jellysquid) / [Contributions](https://github.com/CaffeineMC/lithium-fabric/commits?author=jellysquid3) |
|  | 2No2Name | Maintainer | [Patreon](https://patreon.com/2No2Name) / [Contributions](https://github.com/CaffeineMC/lithium-fabric/commits?author=2No2Name) |
---
## Installation
### Manual installation (recommended)
You will need Fabric Loader installed in your game in order to load Lithium. If you haven't installed Fabric mods
before, you can find a variety of community guides for doing so [here](https://fabricmc.net/wiki/install).
#### Stable releases
The latest releases of Lithium are published to our [Modrinth](https://modrinth.com/mod/lithium) and
[GitHub release](https://github.com/CaffeineMC/lithium-fabric/releases) pages. Releases are considered by our team to be
**suitable for general use**, but they are not guaranteed to be free of bugs and other issues.
Usually, releases will be made available on GitHub slightly sooner than other locations.
#### Bleeding-edge builds (unstable)
[](https://github.com/CaffeineMC/lithium-fabric/actions/workflows/gradle.yml)
If you are a player who is looking to get your hands on the latest **bleeding-edge changes for testing**, consider
taking a look at the automated builds produced through
our [GitHub Actions workflow](https://github.com/CaffeineMC/lithium-fabric/actions/workflows/gradle.yml?query=event%3Apush)
. This workflow automatically runs every time a change is pushed to the repository, and as such, the builds it produces
will generally reflect the latest snapshot of development.
Bleeding edge builds will often include unfinished code that hasn't been extensively tested. That code may introduce
incomplete features, bugs, crashes, and all other kinds of weird issues. You **should not use these bleeding edge builds**
unless you know what you are doing and are comfortable with software debugging. If you report issues using these builds,
we will expect that this is the case. Caveat emptor.
### CurseForge
[](https://www.curseforge.com/minecraft/mc-mods/lithium)
If you are using the CurseForge client, you can continue to find downloads through our
[CurseForge page](https://www.curseforge.com/minecraft/mc-mods/lithium). Unless you are using the CurseForge
client, you should prefer the downloads linked on our Modrinth or GitHub release pages above.
---
### Building from sources
Support is not provided for setting up build environments or compiling the mod. We ask that
users who are looking to get their hands dirty with the code have a basic understanding of compiling Java/Gradle
projects. The basic overview is provided here for those familiar.
#### Requirements
- JDK 17
- You can either install this through a package manager such as [Chocolatey](https://chocolatey.org/) on Windows
or [SDKMAN!](https://sdkman.io/) on other platforms. If you'd prefer to not use a package manager, you can always
grab the installers or packages directly from [Adoptium](https://adoptium.net/).
- Gradle 7 or newer (optional)
- The [Gradle wrapper](https://docs.gradle.org/current/userguide/gradle_wrapper.html#sec:using_wrapper) is provided
in this repository can be used instead of installing a suitable version of Gradle yourself. However, if you are
building many projects, you may prefer to install it yourself through a suitable package manager as to save disk
space and to avoid many Gradle daemons sitting around in memory.
#### Building with Gradle
Lithium uses a typical Gradle project structure and can be built by simply running the default `build` task. After Gradle
finishes building the project, you can find the build artifacts (typical mod binaries, and their sources) in
`build/libs`.
**Tip:** If this is a one-off build, and you would prefer the Gradle daemon does not stick around in memory afterwards,
try adding the [`--no-daemon` flag](https://docs.gradle.org/current/userguide/gradle_daemon.html#sec:disabling_the_daemon)
to ensure that the daemon is torn down after the build is complete. However, subsequent builds of the project will
[start more slowly](https://docs.gradle.org/current/userguide/gradle_daemon.html#sec:why_the_daemon) if the Gradle
daemon is not available to be re-used.
Build artifacts ending in `api` are for developers compiling against Lithium's API.
### Configuration
Out of the box, no additional configuration is necessary once the mod has been installed. Lithium makes use of a
configuration override system which allows you to either forcefully disable problematic patches or enable incubating
patches which are otherwise disabled by default. As such, an empty config file simply means you'd like to use the
default configuration, which includes all stable optimizations by default.
See [the Wiki page](https://github.com/CaffeineMC/lithium-fabric/wiki/Configuration-File) on the configuration file
format and all available options. The wiki may be outdated.
---
### License
Lithium is licensed under GNU LGPLv3, a free and open-source license. For more information, please see the
[license file](LICENSE.md).