$ show TheProjectLumina/LuminaClient
This repository is a multi-module Android application that functions as a cheat client for Minecraft Bedrock Edition. It intercepts and modifies network packets between the client and server using a custom relay/proxy (Lunaris) and a comprehensive implementation of the Bedrock protocol (CloudburstMC-derived). The app provides a graphical overlay (Pixie with ImGui) for toggling cheat modules such as flight, speed, killaura, ESP, and more. It also includes Microsoft/Xbox authentication, Discord Rich Presence, and an update check mechanism with native signature verification. Architecture: The project is organized into several Gradle modules: `app` (main Android app with Compose UI and cheat modules), `Protocol/bedrock-codec` (versioned Bedrock packet serializers), `Protocol/bedrock-connection` (Netty-based session management), `Network/transport-raknet` (custom RakNet UDP transport), `Lunaris` (relay/proxy for packet interception), `Pixie` (native C++ overlay with ImGui and Dobby hooking), `minecraft-msftauth` (Microsoft authentication), `lunarisrpc` (Discord RPC), and `animatedux` (Compose UI components). The app uses a packet interception pattern where cheat modules (subclasses of `Element`) override `beforePacketBound` to modify or cancel packets before they are sent to the server. Key entry points: `app` module's `MainActivity` or `LaunchActivity` (Android entry), `Pixie`'s `MuffinService` (overlay service), `Lunaris`'s `LuminaRelaySession` (relay logic), and the protocol codec builders (e.g., `Bedrock_v898`). Data flows: The app connects to a Bedrock server via RakNet, the relay intercepts packets, cheat modules modify them, and the modified packets are forwarded. The protocol library handles serialization/deserialization for dozens of protocol versions. External dependencies: Netty (network), OkHttp (HTTP), Firebase (analytics/crashlytics), Gson (JSON), fastutil (collections), Lombok (Java boilerplate), AndroidX Compose (UI), ImGui (native overlay), Dobby (native hooking), and various Android SDK components.
The LLM identified 4 files worth highlighting for reuse:
Core codec framework for Minecraft Bedrock protocol. Defines how packet serializers are registered per protocol version, with helper factories and type maps. This is the central orchestrator for all version-specific serialization and can be extracted as a standalone library for any Bedrock protocol implementation.
Implements a custom sliding window congestion control algorithm for RakNet over UDP. Manages RTT, congestion window, slow start threshold, and duplicate ACK detection. This is a self-contained, reusable component for any UDP-based reliable transport protocol.
Provides read/write helpers for common Bedrock protocol data types (VarInts, strings, NBT, block positions, vectors, optional fields). Version-specific subclasses extend this to handle protocol changes. This pattern is reusable for any binary protocol with versioned serialization.
An efficient bit queue implementation for handling variable-length bit sequences, used in RakNet packet encoding. Supports enqueue/dequeue of bits with minimal overhead. This is a standalone utility that could be reused in any project requiring bit-level data manipulation.