Mirage is a Manager App for hxo framework/tool for auto-injecting shared objects into target processes.
cptm59.mov
- Minimum of android 9 maximum is as long as google dosent disable side loading or pairip is implemented in every app (a work around to make the apps compaitiable with pairip to a certain extent is being planned for future)
Setting up Mirage Client is quick and straightforward. Follow these steps:
- Download the APK: Head to our Releases page and download the latest Mirrage 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.
If you encounter issues, visit our Discord for support.
For developers looking to contribute or customize Mirage, here’s how to set up your environment:
-
Clone the Repository:
git clone https://github.com/Kitsuri-Studios/Mirage.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
M1ragedirectory and open it.
-
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 Mirage.
- Test changes on a local Minecraft Bedrock server to verify functionality.
Refer to inline comments, For development tips, join our Discord.
- Do not distribute modified versions without sharing the source code, as required by the GPL.
- Do not claim Mirage as your own without crediting the Kitsuri team and its contributors.
- Selling Mirage or derivatives without adhering to the GPL is prohibited.
- Do not distribute Mirage as closed-source or under a non-GPL license.
- The authors are not responsible for bans, damages, or issues arising from Mirage’s use.
Join our community to connect with other Mirage users and developers:
- Discord: Our Discord server is the best place for real-time support, bug reports, and feature discussions.
We are deeply grateful to the open-source community and internal contributors whose tools and libraries make Mirage possible.
| Project | Description | Resources |
|---|---|---|
| Tabler Icons (Project Module) | Vector icon pack used throughout Mirage for consistent and clean UI icons. | Project module |
| Jetpack Compose | Declarative UI toolkit used to build Mirage’s interface. | Documentation |
| AndroidX Compose BOM | Ensures consistent and compatible Compose dependency versions. | Documentation |
| AndroidX Compose UI | Core UI primitives for Compose-based layouts. | Documentation |
| Compose UI Graphics | Graphics and rendering utilities for Compose. | Documentation |
| Compose UI Tooling & Preview | Preview and inspection tools for UI development. | Documentation |
| Material 3 | Material You components for modern, adaptive UI. | Documentation |
| Material Icons Extended | Extended Material icon set used across the UI. | Documentation |
| Compose Google Fonts | Google Fonts integration for Compose typography. | Documentation |
| Project | Description | Resources |
|---|---|---|
| AndroidX Core KTX | Kotlin extensions for Android core APIs. | Documentation |
| AndroidX Lifecycle Runtime KTX | Lifecycle-aware components for state management. | Documentation |
| Lifecycle ViewModel Compose | ViewModel integration for Jetpack Compose. | Documentation |
| AndroidX Activity Compose | Compose support for Android activities. | Documentation |
| AndroidX DocumentFile | SAF-compatible file access for modern Android storage. | Documentation |
| Project | Description | Resources |
|---|---|---|
| APK Signature (apksig) | APK signing and signature verification utilities. | AOSP |
| AXML Parser | Binary AndroidManifest.xml parsing and manipulation. | AOSP |
| APK Utils | APK inspection, extraction, and metadata handling utilities. | Internal |
| Zip4j | ZIP handling with encryption and advanced compression support. | GitHub |
| Baksmali | Disassembler for Android DEX bytecode. | GitHub |
| Smali | Assembler for Android DEX bytecode. | GitHub |
| Project | Description | Resources |
|---|---|---|
| Kotlinx Serialization JSON | JSON serialization for Kotlin-based data handling. | GitHub |
| UI Graphics Utilities | Shared graphics utilities used across Mirage UI layers. | Internal |
| Module | Description |
|---|---|
| Crash Reporter | Internal crash reporting and diagnostics utility. |
| Adapters | Shared adapter utilities used across UI and data layers. |
| Credits | Credits and attribution handling module. |
| File Utils | File system utilities for safe file operations. |
| Installer Utils | APK installation and package management helpers. |
| Package Utils | Android package inspection utilities. |
| Permission Utils | Runtime permission handling helpers. |
| Theme Utils | Theme and appearance customization utilities. |
| Translator Utils | Localization and translation helpers. |
| Project | Description | Resources |
|---|---|---|
| JUnit | Unit testing framework. | Documentation |
| AndroidX JUnit | Android-specific JUnit extensions. | Documentation |
| Espresso | UI testing framework for Android. | Documentation |
| Compose UI Test JUnit4 | Compose-specific UI testing utilities. | Documentation |
| Compose UI Test Manifest | Test manifest utilities for Compose UI tests. | Documentation |
Mirage 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 Mirage, 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.