MonkeyCraft · 我的世界Mod

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

🐒 MonkeyCraft

随时随地玩 Minecraft。真的随时随地。

从手机或浏览器串流并操控你的 Minecraft 游戏

MonkeyCraft Mod 1.4.3 已发布，适用于 Minecraft 26.2、26.1、1.21.11 和 1.19。每个安装包约 27 MB，包含 Flutter Web 客户端，以及适用于 Windows x64 和 Apple Silicon Mac 的可选内置 Tailscale。本版本更新的是 Mod；App Store 客户端仍为 iOS 1.4.1。

支持的版本

Minecraft	Java	Fabric Loader	Mod 1.4.3 下载
26.2	25+	0.19.3+	26.2 JAR
26.1	25+	0.18.4+	26.1 JAR
1.21.11	21+	0.18.4+	1.21.11 JAR
1.19	17+	0.14.0+	1.19 JAR

同时请安装匹配的 Fabric API。为你的 Minecraft 版本选择一个 JAR；-sources.jar 文件仅面向开发者。

内置 Tailscale 支持 Windows x64 以及运行 ARM64 Java 的 Apple Silicon Mac。Linux 和 Intel Mac 仍可通过局域网或系统 Tailscale 使用本 Mod。辅助组件已打包在 JAR 中，无需下载组件。

📱 客户端可用性

iOS 1.4.1 — 可在 Apple App Store 获取。
Web — 打开在线 Web 客户端。支持桌面版 Chrome/Edge 和 iPhone Safari。使用 Connect with Tailscale 登录，选择你的游戏电脑，并在 Minecraft 中完成配对。直接地址浏览器视频需要 HTTPS 以及可访问的安全 WebSocket（wss://）端点；开发环境也支持 localhost。
Android — 尚未公开发布。Google Play 封闭测试和生产发布准备工作正在进行中；Android 公开发布将另行公告。

✨ 你可以做什么？

MonkeyCraft 让你可以从 iOS App 或受支持的浏览器远程畅玩 Minecraft。Android 公开发布准备工作正在进行中。

🎮 想象以下场景：

🛋️ 沙发游戏 — 别人使用电脑时你也能继续玩
🚇 出行途中 — 通勤时用手机继续你的世界
🏠 在家中各处 — 随时查看你的农场或挂机钓鱼
👥 分享游戏 — 让朋友用他们的手机在你的世界中游玩

🎯 功能

📹 实时视频串流

在手机上实时观看你的 Minecraft 游戏，支持：

设置	选项
📐 分辨率	低、中、高
🎨 色彩模式	普通、高性能（12 位）、复古（6 位）、灰度
⚡ FPS	每秒 1–20 帧

🗺️ 2D 地图模式

切换为周围世界的俯视图，与第一人称画面一样以 H.264 视频串流。适合导航、基地布局规划或跟随服务器上的其他玩家。

🕹️ 触控操作

通过直观的触控界面实现完整游戏操控：

控件	操作
🕹️ 虚拟摇杆	移动（WASD）
👆 视角面板	拖动环顾四周 + 轻点点击
🦘 跳跃按钮	跳跃（空格）
🦆 潜行按钮	潜行/蹲下（Shift）
🔢 快捷栏	选择快捷栏中的物品
🧭 自动朝向移动方向	可选：自动朝向移动方向

💬 聊天系统

📨 发送消息 — 与服务器上的其他玩家聊天
📥 接收消息 — 以丰富格式查看所有收到的聊天
🔗 点击链接 — 点击聊天中的链接和命令

🔔 智能通知

即使未主动游玩也能及时获知信息：

类型	说明
⏰ 定时通知	在指定时间收到提醒，并显示倒计时
📳 即时提醒	由游戏内事件触发的即时提醒

🎵 空间音频

当你所在的服务器运行 OpenAudioMc 或 MCParks v1 音频系统时，MonkeyCraft 可以将音频会话路由到你的手机：

🎧 服务器端空间音频 — 服务器播放的语音、环境音、音乐传到你的手机
🔊 音量滑块 — 可在设置中单独调节 MCParks 播放音量
🔁 恢复时软刷新 — App 从后台返回时，音频会话无需完整重新配对即可重新连接

😴 休眠模式

需要离开但仍保持连接？

⏸️ 暂停串流 — 停止视频以节省带宽
🔗 保持连接 — 保持登录服务器
💬 聊天可用 — 仍可发送和接收消息
📱 实时活动（iOS） — 在锁屏上查看倒计时

🧭 远程加入服务器

当 Minecraft 仍停留在标题界面时，从手机连接：

📋 已保存的服务器列表 — 浏览客户端上保存的多人服务器
⌨️ 直接连接 — 输入任意服务器地址加入
🚪 免手动操作 — 启用 启动时启动服务器 后，可完全在 App 中选择并加入服务器

🔐 安全连接

🛡️ 配对与密码 — 在 Minecraft 中批准配对请求，或使用 Mod 密码连接；iOS 1.4.1 使用密码或密码二维码
🔒 HMAC 认证 — 加密质询-响应
🌐 网络控制 — 限制为仅 localhost、本地网络或任意位置
📱 二维码设置 — 快速扫描以输入密码

🎮 工作原理

1️⃣ 安装 Mod

在你的 Fabric Minecraft 客户端（1.19、1.21.11、26.1 或 26.2）上安装 MonkeyCraft Mod。

2️⃣ 启动服务器

在 Minecraft 中输入 /monkey start 启动 WebSocket 服务器。

3️⃣ 连接手机或浏览器

对于在线 Web 客户端，选择 Connect with Tailscale，登录，选择你的电脑，并在 Minecraft 中批准配对请求。在受支持的电脑上，/monkey tailscale login 可启用内置 Tailscale 连接；否则使用系统 Tailscale。

对于 iOS 1.4.1，输入可访问的电脑地址和端口（默认：9600），然后输入 Mod 密码或扫描其密码二维码。局域网和系统 Tailscale 连接仍然可用。更新 Mod 不会为旧版 App 添加较新的配对界面。

Mod 还会提供其内置的 Flutter Web 客户端。浏览器视频需要安全上下文：直接地址连接需使用 HTTPS 和可访问的 wss:// 端点，例如现有的 Tailscale Serve HTTPS 地址。纯局域网 HTTP 不是跨设备浏览器视频的可行方式。托管客户端的内置 Tailscale 连接是另一个独立选项。

4️⃣ 开始玩！

你的 Minecraft 画面会显示在手机上。使用触控操作移动、观察、跳跃并与世界互动。

⚙️ 配置选项

通过 /monkey config 或 ModMenu 访问设置：

选项	默认值	作用
🚪 端口	9600	连接使用的端口号
🔑 密码	随机	你的连接密码
🌍 谁可以连接	我的本地网络	基础范围：仅本机 / 我的本地网络 / 任何人
🔐 Tailscale 访问	检测到时	接受 Tailscale（`100.64.0.0/10`）：检测到时 / 始终 / 从不
✅ 命令允许列表	全部允许	哪些命令可远程运行
❌ 命令拒绝列表	op、deop	被阻止的命令
🚀 自动启动	关	加入世界时自动启动服务器
🟢 启动时启动服务器	关	Minecraft 加载完成时启动服务器，以便 App 可从标题界面连接
🔗 允许远程加入服务器	开	允许已连接的 App 让此客户端加入多人服务器

📋 游戏内命令

命令	说明
`/monkey`	显示帮助（服务器运行时还会打印你的 IP）
`/monkey start`	启动 WebSocket 服务器
`/monkey stop`	停止服务器
`/monkey config`	打开设置界面
`/monkey tailscale login`	在受支持的电脑上启用并登录内置 Tailscale
`/monkey tailscale status`	显示内置 Tailscale 状态
`/monkey tailscale stop`	停止内置 Tailscale 连接
`/monkey tailscale logout`	退出内置 Tailscale

📱 App 界面

界面	用途
🔐 登录	输入服务器详情和密码
🧭 服务器选择	当客户端处于标题界面时，选择要加入的多人服务器
📹 串流	主游戏画面，含视频和控件
💬 聊天	专用聊天界面
⚙️ 设置	调整视频质量和偏好

🚀 快速开始

安装步骤

安装 Fabric — 从 fabricmc.net 下载
下载 MonkeyCraft — 从上方支持版本中选择匹配的 Mod 1.4.3 JAR
安装 Mod — 放入你的 mods 文件夹
选择客户端
- Web：在浏览器中打开 MonkeyCraft
- iOS：从 Apple App Store 下载 MonkeyCraft
- Android：Google Play 发布准备和封闭测试即将推出；Android 尚未公开发布
连接并开始玩！

从源码构建

在仓库根目录运行每条命令。请先安装目标 JDK、Flutter 和 Go 工具链。每次 Mod 构建都需要共享的 Flutter 浏览器包以及 Windows x64 / Apple Silicon macOS 辅助程序构件：

# Set FLUTTER_BIN to your Flutter executable when it is not on PATH.
# This is the production web bundle embedded by every Mod, rooted at /.
(cd flutter/monkeycraft && \
  FLUTTER_BIN=/absolute/path/to/flutter \
  MONKEYCRAFT_PAGES_PROVENANCE=0 \
  bash tool/build_web_release.sh / build/web)

(cd native/tailscale-helper && ./scripts/build-all.sh)
(cd mods/26.2 && ./gradlew build)

# Other Mod targets: Java 25, 21, and 17 bytecode respectively
(cd mods/26.1 && ./gradlew build)
(cd mods/1.21.11 && ./gradlew build)
(cd mods/1.19 && ./gradlew build)

如果 Flutter 已在你的 PATH 中，请省略 FLUTTER_BIN=/absolute/path/to/flutter。历史 web/ TypeScript 客户端仅作为参考和测试夹具保留；pnpm --dir web build 不是生产 Mod 浏览器构建。要在本地构建单独的 GitHub Pages 构件，请使用相同命令，基路径设为 /monkeycraft/ 并使用不同的输出目录：

(cd flutter/monkeycraft && \
  FLUTTER_BIN=/absolute/path/to/flutter \
  MONKEYCRAFT_PAGES_PROVENANCE=0 \
  bash tool/build_web_release.sh /monkeycraft/ build/pages)

该命令仅创建本地文件；不会部署或更改线上 Pages 站点。1.19 的 Gradle 启动器在编译 Java 17 目标时需要 Java 21 或更高版本。关于 Go 工具链选择，请参阅辅助程序构建说明。

对于 Android，请在构建 App 前安装 NDK 并构建固定版本的原生库。详细信息与 APK 验证请参阅 Android 原生依赖说明。

flutter/monkeycraft/android/third_party/libtailscale/build.sh
(cd flutter/monkeycraft && flutter pub get && flutter build apk)

对于 iOS，请使用 macOS 搭配 Xcode 以及原生依赖说明中所述固定版本的 Go 工具链，然后使用你的签名配置构建：

flutter/monkeycraft/ios/third_party/libtailscale/build.sh
(cd flutter/monkeycraft && bash tool/build_ios_device_release.sh)

此设备构建入口会在安装前清除共享原生资源缓存，并验证每个内嵌框架的平台和签名团队。请在其清理步骤前保留所需的任何 Android 或 Web 构建输出。

❓ 常见问题

我可以在服务器上玩吗？

可以！MonkeyCraft 串流你的 Minecraft 客户端，因此你可以在任何服务器或单人世界中游玩。

会有延迟吗？

视频会实时编码和串流。为获得最佳效果：

使用强 WiFi 连接
必要时降低分辨率/FPS
让电脑靠近路由器

可以连接多个客户端吗？

同一时间只能连接一个控制用的手机或浏览器。

可以通过互联网使用吗？

可以。在 Windows x64 或 Apple Silicon Mac 上使用内置 Tailscale，或在你的游戏电脑上使用系统 Tailscale。托管 Web 客户端可直接登录 Tailscale。默认直接地址访问仍限于你的本地网络。

我可以远程运行哪些命令？

默认情况下，除 op 和 deop 外所有命令均被允许。可在设置中配置允许列表/拒绝列表。

由 weikengchen 用 ❤️ 制作