Skip to content

Latest commit

 

History

History
87 lines (65 loc) · 5.6 KB

README.md

File metadata and controls

87 lines (65 loc) · 5.6 KB

Website | Forum | Discord | YouTube | Twitter

A free mixin-based injection hacked-client for Minecraft using Minecraft Forge, supporting version 1.8.9

Discontinuation Notice

Legacy development was maintained by the community from 2020 to 2025. However, Legacy is now discontinued in favor of Nextgen. Since 2020, the project was officially discontinued by us, CCBlueX, which started the development in 2015.

b100 is the final release published by our community maintainers, and no further pull requests will be accepted. A huge thanks to everyone who contributed to the project over the years, with special recognition to our lead maintainers, @EclipsesDev and @mems01.

"I have started LiquidBounce in 2015, and since 2020 I have been working on a new code base, Nextgen, which left the Legacy code base to the community. A huge thank you for the community maintainers who have kept this branch of the client alive for so long, while our CCBlueX team was able to focus on our new branch. Looking at the current state, I'm not entirely happy with the direction this branch has taken, but I'm grateful for the work that has been done and the time that has been invested in it. I'm looking forward to the future of LiquidBounce and hope that we can merge our efforts in the future to create a better client for everyone."

— Izuna, Founder

"With this being the final release of Legacy, I’m grateful for how much this client has progressed. It has not only improved significantly over the previous version but also helped me grow as a developer, pushing me to learn and do better. I’d like to thank the CCBlueX team for their client support throughout this journey and @mems01 for his help during the development."

— EclipsesDev, Lead Community Maintainer

"This is the final Legacy version, meaning that the development continuation by the community (me and @EclipsesDev) is coming to a stop, permanently. I am proud to have reached this moment and this far with this client's development as it taught me new things everyday. I thank the CCBlueX team for allowing me in the first place to continue the development of this client, and @EclipsesDev for helping me do so. It was a good run."

— mems01, Lead Community Maintainer

We are grateful for the support we received from the community and hope that you will continue to support us in the future on our new code base, Nextgen that will continue to be maintained by us.

Issues

If you notice any bugs or missing features, you can let us know by opening an issue here.

License

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 advice nor legally binding.

You are allowed to

  • use
  • share
  • modify

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.

  1. Clone the repository using git clone https://github.com/CCBlueX/LiquidBounce/.
  2. CD into the local repository folder.
  3. Switch to the legacy branch using git checkout legacy
  4. 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
  5. Open the folder as a Gradle project in your IDE.
  6. Select either the Forge or Vanilla run configuration.

Additional libraries

Mixins

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 Mojang's copyrighted code. If you want to learn more about it, check out its Documentation.

Contributing

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:

  1. Improve LiquidBounce's performance.
  2. Re-work most of the render code.

If you have experience in one or more of these fields, we would highly appreciate your support.

Stats

Alt