🐒 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

1. Install Fabric — Download from fabricmc.net
2. Download MonkeyCraft — Get the mod JAR for your Minecraft version
3. Install Mod — Place in your mods folder
4. Get the App — Download on your phone
5. 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