/Minecraft-Client-Base

External client base for Minecraft using JNI

Primary LanguageC++BSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause


Minecraft Client Base

External client base for Minecraft using JNI.

Features • Building/Usage • Crashes • License

Features

  • External injector and loader
  • Currently supports vanilla and forge
  • Open source

Building/Usage

  1. Clone this project.
  2. Build the loader and injector using CMake.
mkdir build && cd build
cmake ..
cmake --build .
  1. Build the client using the batch file.
cd ../client
build.bat
  1. Download the mappings for your desired version.
cd ../mappings
py download.py
  1. Start Minecraft and run build/inject.exe to inject the loader. The loader will automatically load the client into the game.

Crashes

If Minecraft crashes when the loader is injected, try the following:

  • Injecting two or more times will cause the game to crash. This is not a bug, and is caused by the "client" not being detached properly, which redefines the classes.
  • Run Minecraft with logging enabled. If it crashes without any logging, then there is most likely a problem with your JNI version. Set the full JNI header and library paths in the CMakelists.txt file.
  • Make sure you are using the correct mappings for your version. For example, if you are using the latest version of 1.8.9, choose "1.8.9 stable 22" in the download script.
  • The "client" must be built using the same version of java as the version running the game. You can check your javac version by running javac -version. If the version is different, you can change the version by specifying the full path to the javac executable in the client/build.bat file.

License

This project is licensed under the BSD 3 license.