🐒 MonkeyCraft
Play Minecraft from anywhere. Really anywhere.
Stream and control your Minecraft game from your phone
iOS client is available in TestFlight and has passed Beta Review by Apple App Store Connect. Android client is clear for closed testing. Please refer to the wiki for the latest client release information.
✨ What Can You Do?
MonkeyCraft lets you play Minecraft remotely from your iOS or Android phone.
🎮 Imagine these scenarios:
- 🛋️ Couch Gaming — Keep playing while someone else uses the computer
- 🚇 On the Go — Continue your world from your phone during commute
- 🏠 Around the House — Check on your farm or AFK fishing from anywhere
- 👥 Share Your Game — Let a friend play on your world from their phone
🎯 Features
📹 Live Video Streaming
Watch your Minecraft game in real-time on your phone with:
| Setting | Options |
|---|---|
| 📐 Resolution | Low, Medium, High |
| 🎨 Color Mode | Normal, High Perf (12-bit), Retro (6-bit), Grayscale |
| ⚡ FPS | 1–20 frames per second |
🗺️ 2D Map Mode
Switch to a top-down view of the world around you, streamed as H.264 video just like the first-person feed. Handy for navigation, base layout, or following someone else on the server.
🕹️ Touch Controls
Full gameplay control with intuitive touch interface:
| Control | Action |
|---|---|
| 🕹️ Virtual Joystick | Move around (WASD) |
| 👆 Look Pad | Look around by dragging + tap to click |
| 🦘 Jump Button | Jump (Space) |
| 🦆 Sneak Button | Sneak/crouch (Shift) |
| 🔢 Hotbar | Select items in your hotbar |
| 🧭 Auto-Face Movement | Optional: Automatically face movement direction |
💬 Chat System
- 📨 Send Messages — Chat with other players on the server
- 📥 Receive Messages — See all incoming chat with rich formatting
- 🔗 Click Links — Tap on links and commands in chat
🔔 Smart Notifications
Stay informed even when not actively playing:
| Type | Description |
|---|---|
| ⏰ Timed Notification | Get reminded at a specific time with countdown |
| 📳 Instant Nudge | Receive immediate alerts from in-game events |
🎵 Spatial Audio
When the server you're on runs OpenAudioMc or the MCParks v1 audio system, MonkeyCraft can route the audio session to your phone:
- 🎧 Server-side spatial audio — voice, ambience, music played by the server reaches your phone
- 🔊 Volume slider — adjust MCParks playback volume independently in Settings
- 🔁 Soft-refresh on resume — when the app returns from background, the audio session reconnects without a full re-pair
😴 Hibernation Mode
Need to step away but stay connected?
- ⏸️ Pause Streaming — Stops video to save bandwidth
- 🔗 Keep Connection — Stays logged in to the server
- 💬 Chat Available — Still send and receive messages
- 📱 Live Activity (iOS) — See countdown on your lock screen
🔐 Secure Connection
- 🛡️ Password Protected — Only those with your password can connect
- 🔒 HMAC Authentication — Cryptographic challenge-response
- 🌐 Network Control — Restrict to localhost, local network, or anywhere
- 📱 QR Code Setup — Quick scan to enter password
🎮 How It Works
1️⃣ Install the Mod
Install the MonkeyCraft mod on your Fabric Minecraft client (1.19, 1.21.11, or 26.1+).
2️⃣ Start the Server
In Minecraft, type /monkey start to launch the WebSocket server.
3️⃣ Connect Your Phone
Open the MonkeyCraft app on your phone and:
- Enter your computer's IP address and port (default: 9600)
- Scan the QR code displayed in-game, or
- Enter the password manually
4️⃣ Play!
Your Minecraft view appears on your phone. Use the touch controls to move, look, jump, and interact with the world.
⚙️ Configuration Options
Access settings via /monkey config or through ModMenu:
| Option | Default | What It Does |
|---|---|---|
| 🚪 Port | 9600 | The port number for connections |
| 🔑 Password | Random | Your connection password |
| 🌍 Allow Connections From | Local Network | Who can connect |
| ✅ Command Allowlist | All allowed | Which commands can be run remotely |
| ❌ Command Denylist | op, deop | Blocked commands |
| 🚀 Auto-Launch | Off | Start server automatically when joining a world |
📋 In-Game Commands
| Command | Description |
|---|---|
/monkey |
Show help (also prints your IPs while the server is running) |
/monkey start |
Start the WebSocket server |
/monkey stop |
Stop the server |
/monkey config |
Open settings screen |
📱 App Screens
| Screen | Purpose |
|---|---|
| 🔐 Login | Enter server details and password |
| 📹 Stream | Main gameplay with video and controls |
| 💬 Chat | Dedicated chat interface |
| ⚙️ Settings | Adjust video quality and preferences |
🚀 Getting Started
Supported Versions
| Minecraft Version | Java | Mod Location |
|---|---|---|
| 26.1+ | 25+ | mods/26.1/ |
| 1.21.11 | 21+ | mods/1.21.11/ |
| 1.19 | 17+ | mods/1.19/ |
Install Steps
- Install Fabric — Download from fabricmc.net
- Download MonkeyCraft — Get the mod JAR for your Minecraft version
- Install Mod — Place in your
modsfolder - Get the App — Download on your phone
- Connect & Play!
Building from Source
# Build for Minecraft 26.1 (needs Java 25)
cd mods/26.1 && ./gradlew build
# Build for Minecraft 1.21.11 (needs Java 21)
cd mods/1.21.11 && ./gradlew build
# Build for Minecraft 1.19 (needs Java 17)
cd mods/1.19 && ./gradlew build
# Build Flutter app
cd flutter/monkeycraft && flutter build apk
❓ FAQ
Can I play on a server?
Yes! MonkeyCraft streams your Minecraft client, so you can play on any server or singleplayer world.
Is there lag?
Video is encoded and streamed in real-time. For best results:
- Use a strong WiFi connection
- Lower resolution/FPS if needed
- Keep your computer close to your router
Can multiple phones connect?
Only one phone can connect at a time.
Does it work over the internet?
By default, connections are restricted to your local network. You can enable internet access in settings, but proceed with caution.
What commands can I run remotely?
By default, all commands are allowed except op and deop. Configure allowlist/denylist in settings.
Made with ❤️ by weikengchen
