A free mixin-based injection hacked-client for Minecraft using Minecraft Forge.
If you notice any bugs or missing features, you can let us know by opening an issue here.
This project is subject to the GNU General Public License v3.0. This does only apply for source code located directly in this clean repository. During the development and compilation process, additional source code may be used to which we have obtained no rights. Such code is not covered by the GPL license.
For those who are unfamiliar with the license, here is a summary of its main points. This is by no means legal advise nor legally binding.
You are allowed to
this project entirely or partially for free and even commercially. However, please consider the following:
- You must disclose the source code of your modified work and the source code you took from this project. This means you are not allowed to use code from this project (even partially) in a closed-source (or even obfuscated) application.
- Your modified application must also be licensed under the GPL
Do the above and share your source code with everyone; just like we do.
Setting up a Workspace
LiquidBounce is using Gradle, so make sure that it is installed properly. Instructions can be found on Gradle's website.
- Clone the repository using
git clone https://github.com/CCBlueX/LiquidBounce.
- CD into the local repository folder.
- Depending on which IDE you are using execute either of the following commands:
- For IntelliJ:
gradlew --debug setupDevWorkspace idea genIntellijRuns build
- For Eclipse:
gradlew --debug setupDevWorkspace eclipse build
- For IntelliJ:
- Open the folder as a Gradle project in your IDE.
- Open your IDE's run configuration window.
- Add the following to your projects VM options:
- Now simply launch LiquidBounce inside your IDE
Mixins can be used to modify classes at runtime before they are loaded. LiquidBounce is using it to inject its code into the Minecraft client. This way, we do not have to ship Mojangs copyrighted code. If you want to learn more about it, check out its Documentation.
We appreciate contributions. So if you want to support us, feel free to make changes to LiquidBounce's source code and submit a pull request. Currently our main goals are the following:
- Improve LiquidBounce's performance.
- Re-work most of the render code.
If you have experience in one or more of these fields, we would highly appreciate your support.