MSoris Mapper

MSoris Mapper is an Android app that allows users to play games using an external keyboard and mouse without requiring root access. It leverages Shizuku to grant necessary permissions and maps key events from external input devices to on-screen touch points.

Features

• Keyboard & Mouse Support - Play mobile games with a keyboard and mouse.
• No Root Required - Uses Shizuku for permission handling instead of rooting.
• Custom Key Mapping - Map keyboard/mouse events to specific touch points on the screen.
• Anti-Detection Mechanism - Introduces randomness in mapped touches to prevent detection by anti-cheat systems.
• Configurable Settings - Customize mappings for different games and control layouts.

Installation

1. Download and install the latest debug APK from Actions.
2. Install and set up Shizuku.
3. Open MSoris Mapper and follow the setup instructions.

How It Works

1. Install & Setup - Install MSoris Mapper and grant permission to Shizuku.
2. Connect Input Devices - Attach an external keyboard and mouse.
3. Add games - Add your favorite games to the launcher using the fab button.
4. Create Key Bindings - Launch the game from in-app launcher and map keys to specific screen areas.
5. Start Playing - Use the keyboard and mouse seamlessly in mobile games.

Usage

1. Open MSoris Mapper and ensure Shizuku is running.
2. Select or create a key mapping profile.
3. Launch your game and enjoy enhanced controls.

Toggle Shooting Mode

In FPS or other aim-based games, use "Shooting Mode" draggable item to switch between mouse pointer and in-game aim. By default, use MMB (Middle mouse button) to toggle.

Permissions

• Shizuku Access - Required to simulate touch events.
• Overlay Permission - Needed to display touch indicators.

Build It Yourself

Prerequisites

• Android Studio (latest stable)
• JDK 17
• An Android device (Android 11+)

Steps

git clone https://github.com/noteveno/MSoris-Mapper.git
cd MSoris-Mapper

Open the project in Android Studio, let Gradle sync, then run.

Shizuku Setup (Required)

• Install Shizuku from Play Store or GitHub
• Start Shizuku via ADB / Wireless Debugging
• Grant Shizuku permission when MSoris Mapper asks for it

Without Shizuku running, MSoris Mapper will not function.

Contributing

Contributions are welcome! Feel free to submit pull requests or report issues.

Disclaimer

Using artificial touch events in games may violate their terms of service. Use this app responsibly and at your own risk.