Lumina Client is a tool built for Minecraft Bedrock Edition players who want to step up their game in competitive PvP. It’s designed to work smoothly across different devices, offering a reliable and user-friendly experience. Our team has worked hard to create a client that supports players on popular servers while keeping performance steady and dependable. Whether you’re a player looking to improve your skills or a developer wanting to dive into our code, Lumina is here to help you succeed.
Lumina is all about giving Minecraft players the tools they need to shine in PvP. We’ve focused on making it easy to use, fast, and compatible with a range of platforms. The Project Lumina team is passionate about building a tool that’s both powerful and open for the community to explore and improve. We encourage everyone to use Lumina responsibly, contribute ideas, and join us in making it even better.
Lumina Client offers a set of tools to help you perform better in Minecraft Bedrock Edition PvP. We’ve built it to be fast, reliable, and easy to customize, so you can tweak it to fit your playstyle. The client works well on many servers, with features designed to keep your gameplay smooth and effective. Every part of Lumina has been tested to ensure it runs stably, making it a solid choice for players who want to take their skills to the next level.
The Project Lumina community is growing fast, and we love seeing all the energy and support from everyone! Our Discord server is full of people chatting, sharing ideas, and just hanging out every day.
Whether you're new or a regular, it's a great place to:
- Meet other Lumina players
- Share your creations
- Ask questions and get help
- Stay up to date with what’s new
Come say hello in the Discord — we’d love to have you around!
To run Lumina Client, your device must meet the following specifications:
- Android: Android 9.0 (Pie) or later, supporting both 64-bit and 32-bit architectures.
- Minecraft Version: Minecraft Bedrock Edition 1.21.80 or later is recommended for optimal performance and compatibility.
- Non-Android Platforms: For PC, Mac, or other devices, Lumina operates remotely through an Android device running the client.
- Storage: At least 200 MB of free storage for the APK and associated data.
- Internet: A stable internet connection is recommended, especially for multiplayer servers.
No additional hardware is required, but enabling developer options on Android may improve the installation process.
Setting up Lumina Client is quick and straightforward. Follow these steps:
- Download the APK: Head to our Releases page and download the latest Lumina Client APK.
- Allow Unknown Sources: On your Android device, go to Settings > Security (or Apps & Notifications on newer versions) and enable Install from Unknown Sources.
- Install the APK: Open the downloaded APK file using a file manager, tap to install, and follow the prompts.
- Launch Lumina: Find Lumina in your app drawer, open it, and log in with your Minecraft account.
- Configure Settings: Adjust keybinds, enable desired tools, and customize the UI to suit your preferences.
- Test on a Server: Join a test server to ensure everything works as expected. For best results, start with a non-protected server to familiarize yourself with the features.
If you encounter issues, visit our Discord for support or consult the NOTICE file.
For developers looking to contribute or customize Lumina, here’s how to set up your environment:
-
Clone the Repository:
git clone https://github.com/TheProjectLumina/LuminaClient.git
This downloads the full source code to your local machine.
-
Open in Android Studio:
- Launch Android Studio and select Open an existing project.
- Choose the
LuminaClientdirectory and open it.
-
Replace google-services.json:
- The repository includes a dummy
google-services.jsonfile, which must be replaced with your own for the app to build successfully. - Create a Firebase project at Firebase Console.
- Add an Android app to your Firebase project, following the prompts to download your
google-services.jsonfile. - Place the downloaded
google-services.jsonfile in theappdirectory of the LuminaClient project, overwriting the dummy file. - Ensure the package name in Firebase matches the one in
build.gradle(e.g.,com.projectlumina.luminaclient).
- The repository includes a dummy
-
Sync Gradle:
- Click Sync Project with Gradle Files to fetch dependencies.
- Ensure you have the Android SDK (API level 28 or higher) and Gradle installed.
-
Build and Test:
- Connect an Android device or configure an emulator.
- Select Run > Run 'app' to build and deploy Lumina.
- Test changes on a local Minecraft Bedrock server to verify functionality.
Refer to inline comments and the NOTICE file for guidance. For advanced development tips, join our Discord or check our YouTube for tutorials.
We welcome contributions to improve Lumina Client. To ensure a high-quality codebase, please adhere to these guidelines:
- Code Quality: Write clean, modular code with descriptive variable names and consistent formatting (follow Kotlin style guidelines).
- Commit Structure: Use small, focused commits with clear messages (e.g., "Fixed lag issue on Hive server").
- Documentation: Add comments for complex logic and update relevant documentation in the repository.
- Performance: Optimize additions to maintain low latency, especially for combat and networking modules.
- Testing: Test changes on multiple servers (e.g., CubeCraft, Hive) to ensure compatibility and stability.
- Pull Requests: Submit PRs with a detailed description of changes, including the problem solved or feature added.
- Community Standards: Follow our Code of Conduct to maintain a respectful environment.
Before submitting, run a full build and test cycle to minimize errors. We review all contributions promptly and appreciate your efforts to enhance Lumina.
Lumina is designed for personal use and experimentation, but there are rules to follow:
- Modify Lumina for personal gameplay or to test new features.
- Create educational content (e.g., YouTube videos, tutorials) showcasing Lumina’s capabilities.
- Fork the repository for learning or to create derivative projects, provided you comply with the GNU GPL v3.0.
- Do not distribute modified versions without sharing the source code, as required by the GPL.
- Do not claim Lumina as your own without crediting the Project Lumina team and its contributors.
- Selling Lumina or derivatives without adhering to the GPL is prohibited.
- Do not distribute Lumina as closed-source or under a non-GPL license.
- The authors are not responsible for bans, damages, or issues arising from Lumina’s use.
See the LICENSE and NOTICE files for full details.
Join our community to connect with other Lumina users and developers:
- Discord: Our Discord server is the best place for real-time support, bug reports, and feature discussions.
- YouTube: Visit our YouTube channel for tutorials, feature demos, and project updates.
- GitHub: Report issues or suggest enhancements on our GitHub Issues page.
We strive to maintain a welcoming and inclusive community. Please review our Code of Conduct before participating.
Lumina Client Version 4 is a fork of MuCuteClient by SuMuCheng and Protohax by Haxor, with extensive enhancements by the Project Lumina team. Copyright © 2025 Project Lumina, with portions © 2025 MuCuteClient/SuMuCheng and © 2023 Protohax/Haxor.
We are deeply grateful to the open-source community for providing the tools and libraries that make Lumina possible. Below are the key projects we rely on:
 Netty High-performance network framework for efficient packet handling. Documentation |
 Kotlin Modern language for concise, maintainable code. Documentation |
 OkHttp Robust HTTP client for reliable network requests. Documentation |
 Okio Streamlined I/O library for efficient data processing. Documentation |
 CloudBurst Minecraft Bedrock server software for seamless interoperability. Documentation |
 JetBrains Powerful IDEs for streamlined development. Documentation |
 Netlify Hosting platform for our documentation and web presence. Documentation |
 Android Mobile OS for native app deployment and features. Documentation |
 Material3 Libraries for modern Android UI development. Documentation |
Additional dependencies include:
- LevelDB: Fast key-value storage for efficient data management.
- AndroidX Compose Material: Material Design components for building modern, responsive UI with Jetpack Compose.
- AndroidX Foundation: Core utilities for Android app development, enhancing compatibility and functionality.
- AndroidX Window: Support for advanced window management, such as foldable device layouts.
- Log4j: Flexible logging framework for debugging and monitoring (used in debug builds).
- Netty: High-performance network framework for efficient packet handling in Minecraft Bedrock networking.
- ExpiringMap: Caching library with automatic expiration for optimized performance.
- Fastutil: High-performance collections for optimized data handling (long, int, and object maps).
- Jose4j: JWT support for secure authentication in network operations.
- CloudburstMC Math: Precise mathematical utilities for combat and movement calculations.
- CloudburstMC NBT: Handles Minecraft-specific NBT data formats for item and world data.
- Snappy: Data compression library for efficient storage and transfer.
- Google Guava: General-purpose utilities for robust development.
- Gson: JSON parsing and serialization for data exchange.
- Apache HttpClient: Advanced HTTP functionality for network operations.
- Bouncycastle: Cryptographic library for secure encryption and authentication.
- OkHttp: Robust HTTP client for reliable network requests.
- Amplitude Analytics: Analytics SDK for tracking user behavior and app performance.
- Compose Colorful Sliders: Custom UI components for interactive sliders in Jetpack Compose.
- Coil Compose: Image loading library for efficient image handling in Jetpack Compose.
- AnimatedUX: Custom animation library for dynamic UI transitions (project dependency).
- Pixie: ImGui setup for Android using native surface rendering for optimized graphics (project dependency).
- Lunaris: Custom utility library for Lumina’s core functionality (project dependency).
- SSC: Custom Utility Dependency (project dependency).
- Android Native Surface: Imgui And Native Rendering.
- Sign Verification: Signature Verification And integrity Check
- Kotlinx Serialization JSON: JSON serialization for Kotlin-based data handling.
- AndroidX Core KTX: Kotlin extensions for Android core APIs.
- AndroidX Lifecycle Runtime KTX: Lifecycle-aware components for reactive programming.
- AndroidX Activity Compose: Support for Jetpack Compose in Android activities.
- AndroidX Compose: Modern Android UI toolkit for building Lumina’s interface.
- AndroidX UI Graphics: Graphics utilities for Compose-based UI rendering.
- AndroidX UI Tooling Preview: Preview tools for Compose UI development.
- AndroidX Material3: Material You components for modern, adaptive UI design.
- AndroidX Navigation Compose: Navigation framework for Compose-based apps.
- AndroidX Material Icons Extended: Extended icon set for Material Design UI.
- Firebase BOM: Bill of Materials for Firebase dependencies, ensuring version compatibility.
- Jackson Databind: Advanced JSON data binding for complex data structures.
- Firebase Analytics: Analytics for tracking user engagement and app performance.
- Firebase Crashlytics: Crash reporting for identifying and resolving app issues.
- JUnit: Testing framework for unit tests.
- AndroidX JUnit: Android-specific testing extensions for JUnit.
- AndroidX Espresso Core: UI testing framework for Android apps.
- AndroidX UI Test JUnit4: Compose-specific UI testing framework.
- AndroidX UI Tooling: Debugging and inspection tools for Compose UI (debug builds).
- AndroidX UI Test Manifest: Manifest utilities for UI testing (debug builds).
We also acknowledge HavensGrace Studios by @aiko and @aoi for development and Technical Support Without them this project may not have been possible ❤️
Lumina Client Version 4 is licensed under the GNU General Public License v3.0. Earlier versions have separate freeware licenses; please review them if applicable. Key license terms:
- You may use, modify, and distribute Lumina, provided the source code is shared under the same GPL license.
- Derivative works must remain open-source and cannot impose additional restrictions.
- The software is provided "as is" without warranties, and the authors are not liable for any damages or misuse.
For complete details, see the LICENSE and NOTICE files.
Lumina Client is a form of love from the Project Lumina team, built for Minecraft Bedrock community. We’re excited to see how you use, customize, and contribute to Lumina. Join us on Discord or YouTube to stay connected, share your creations, and help shape the future of Lumina!
