A Minecraft hacked client built in Rust, using JNI (Java Native Interface) for seamless integration with Minecraft's Java runtime. DarkClient provides a robust architecture for developing game modifications through dynamic library injection.

• 🔧 Dynamic Library Injection: Hot-swappable module system without requiring game restarts
• 🎨 Cross-Platform GUI: Beautiful injector interface built with egui
• ⌨️ Real-time Input Handling: Advanced keyboard event processing for module toggling
• 🗺️ Smart Mapping System: Automatic obfuscation handling through JSON-based mappings
• 🔄 Module Architecture: Extensible module system for easy feature development
• 📊 Comprehensive Logging: Detailed logging system for debugging and monitoring
• 🔒 Thread-Safe Design: Robust multi-threaded architecture with proper synchronization

The project is organized into three main components:

A user-friendly GUI application that handles:

• Process detection (finding Minecraft instances)
• Library injection into target processes
• Status monitoring and error reporting

A JVMTI agent that provides:

• Dynamic library loading capabilities
• TCP command server for hot-reloading
• Process lifecycle management
• Cross-platform injection support

The core modification framework featuring:

• JNI integration with Minecraft's runtime
• Module system for game modifications
• Mapping system for obfuscation handling
• Input processing and event management

• Rust 1.87.0+ with Cargo package manager
• Java Development Kit (JDK) 21+
• Minecraft Java Edition

If you prefer precompiled binaries instead of building from source:

1. Go to the Actions tab on GitHub.
2. Open the latest workflow run.
3. Scroll to the bottom of the page to find the Artifacts section.
4. Download the compiled binaries for your platform (Linux or Windows).

This allows you to get up and running without waiting for compilation.

bash git clone https://github.com/TheDarkSword/DarkClient cd darkclient

cargo build --release

The framework uses obfuscation mappings to interact with Minecraft:

python conversion.py

1. Launch the Injector:

   cd target/release ./injector

2. Start Minecraft and load into a world

3. In the Injector GUI:

• Click "Find" to detect the Minecraft process
• Click "Inject" to load the modification framework

4. Use Modules:

• Modules can be toggled using their assigned keybinds
• Check the log files for module status and debugging info

Create new modules by implementing the Module trait:

use crate::module::{Module, ModuleData}; pub struct CustomModule { data: ModuleData, // Your module-specific fields } impl Module for CustomModule { fn get_module_data(&self) -> &ModuleData { &self.data } fn get_module_data_mut(&mut self) -> &mut ModuleData { &mut self.data } fn on_start(&self) { // Called when module is enabled } fn on_stop(&self) { // Called when module is disabled } fn on_tick(&self) { // Called every game tick while enabled } }

DarkClient/ ├── 📁 client/ # Core modification library │ ├── 📁 src/ │ │ ├── 📄 lib.rs # Main library entry point │ │ ├── 📄 client.rs # DarkClient core & JVM integration │ │ ├── 📁 mapping/ # Minecraft mapping system │ │ └── 📁 module/ # Module framework ├── 📁 injector/ # GUI injection tool │ └── 📁 src/ │ └── 📄 main.rs # Injector application ├── 📁 agent_loader/ # JVMTI agent for dynamic loading ├── 📄 mappings.json # Minecraft obfuscation mappings ├── 📄 conversion.py # Mapping conversion utility └── 📄 Cargo.toml # Workspace configuration 

Logs are written to:

• • Injector application logs app.log is located where injector is executed
• • Client library logs dark_client.log is located in .minecraft

The agent loader uses TCP port 7878 for communication. This can be modified in : platform/mod.rs

pub const SOCKET_ADDRESS: SocketAddr = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 7878);

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-module)
3. Commit your changes (git commit -am 'Add amazing module')
4. Push to the branch (git push origin feature/amazing-module)
5. Create a Pull Request

• Follow Rust best practices and use cargo fmt
• Add comprehensive documentation for new modules
• Include proper error handling and logging

This project is intended for educational and research purposes. Users are responsible for complying with:

• Minecraft's Terms of Service
• Mojang's Commercial Usage Guidelines
• Local laws and regulations regarding game modifications

This project is licensed under the GNU GPL License - see the LICENSE file for details.