Skip to content

README_EN.md

Latest commit

 

History

History
84 lines (54 loc) · 3.04 KB

README_EN.md

File metadata and controls

84 lines (54 loc) · 3.04 KB
Raw

OrangeX Client

Note: This project is undergoing refactoring. For the original code, please refer to the legacy branch: legacy

Welcome to join our QQ / Discord groups for more information and support:

- Discord: JuiceDev

- QQ Group: 1103504356

Banner1 Banner2

Language: 中文 | English

Supported Injectable Clients

Currently, only non-obfuscated clients are supported. The following clients have been tested:

Client Description
MCP 1.8.8 Local development environment based on MCP
Lunar Client 1.8.9 Adapted third-party client

How to Build

Method 1: Direct Build

The project already includes prebuilt dependencies and can be built directly.

  • Run ./gradlew buildInjector to build the project
  • After the build completes, Injector.jar will be generated in the out/ directory
  • Launch the injector using java -jar Injector.jar

Method 2: Rebuild Dependencies

Suitable for cases where you need to compile the underlying dependencies yourself.

Step 1: Download or Build JuiceAgent

  • In the JuiceAgent project, build it according to the documentation or download a precompiled version

  • Obtain the following files:

    • libagent.dll
    • libinject.dll
    • libjuiceloader.dll

  • Replace the corresponding DLL files in the natives directory

Step 2: Download or Build JuiceLoader

  • In the JuiceLoader project, build it according to the documentation or download a precompiled version
  • Obtain JuiceLoader.jar
  • Replace JuiceLoader.jar in the libraries directory

Step 3: Build OrangeX

  • Run ./gradlew buildInjector to build the project
  • After the build completes, Injector.jar will be generated in the out/ directory
  • Launch the injector using java -jar Injector.jar

Development

  • Install IntelliJ IDEA
  • Open the project with IntelliJ IDEA
  • Write code
  • Launch the development client using the button in the top-right corner

devlaunch

Acknowledgements

  • FontRenderer - Font rendering
  • YMixin - Bytecode instrumentation tool for dynamically generating replaceable bytecode
  • OpenVape - Vape Crack??? (Part of font rendering code comes from this project)
  • OpenYolbi - Hot injection client (Mixin approach and some ideas from this project)
  • JuiceAgent - JVMTI-based injection framework - Underlying implementation for client hot injection
  • JuiceRemapper - Runtime automatic remapping tool