⛏️ Minecraft 浏览器联机版

🔌 连接服务器

服务器地址

端口

游戏版本

用户名（游戏内昵称）

WebSocket 代理地址

默认使用官方 demo 内置代理；自建代理请填 wss:// 地址。联机必须有可用的 WS 代理。

🌐 预设公共服务器

⚠️ 标「正版」的服务器需要 Java 版正版账号（online-mode）。离线/破解服则无需正版，可直接用任意用户名加入。

⭐ 我的服务器

⛏️

Minecraft 浏览器联机版

基于开源项目 prismarine-web-client，在浏览器中运行真实 Minecraft Java 客户端，通过 WebSocket 代理连接到真实的 Minecraft 服务器。

🛑 联机需要外部 WebSocket 代理 + Minecraft 服务器，两者都不能在 Cloudflare Workers 上运行。本页面仅提供前端入口，请在左侧填写信息后启动。

正在加载游戏资源…

未启动 — 点击「启动客户端」或左侧「连接服务器」官方 demo：prismarinejs.github.io

📖 工作原理

💡 浏览器客户端 → WebSocket 代理 → TCP 转换 → Minecraft Java 服务器。代理把浏览器的 WS 连接翻译成 MC 服务端能听懂的 TCP 协议。

本页通过 iframe 嵌入官方 demo（GitHub Pages 托管）。点击游戏区域可获得鼠标视角，按 Esc 释放鼠标。

🎮 操作说明

WASD移动

空格跳跃

鼠标转动视角

左键挖方块

右键放方块

Shift潜行/下蹲

Ctrl冲刺

T打开聊天

E背包/物品栏

Esc释放鼠标

1-9切换物品

F切换视角

先单击游戏画面锁定鼠标，才能用鼠标看四周。聊天时按 T 输入消息后回车发送。

🛠️ 自建 WebSocket 代理

npm 全局安装（最快）

在自己的服务器/VPS 上执行：

npm install -g prismarine-web-client
prismarine-web-client

然后浏览器打开 http://你的IP:8080，或在左侧代理栏填入对应的 wss:// 地址。

Docker 部署代理

docker run -d --name mc-web \
  -p 8080:8080 \
  ghcr.io/prismarinejs/prismarine-web-client

建议配合 Nginx + Let's Encrypt 反代到 wss://，浏览器才能直连。

⚡ Workers / Pages Functions 不能跑 WebSocket→TCP 代理，必须用 VPS 或支持 WS 的服务器。

🏠 连接自己的 MC 服务器

启动一台 Minecraft Java 版服务端（如 papermc / spigot）。
在同一台机器（或可达网络）部署上面的 WS 代理。
左侧填：服务器地址 = 127.0.0.1（或服务端 IP）、端口 25565。
代理地址填你的 wss:// 地址，点「连接服务器」。

提示：服务端 server.properties 设 online-mode=false 可允许离线登录；正版服需代理支持在线模式鉴权。

✅ 支持与性能

支持版本：Java Edition 1.8 - 1.20（推荐 1.16.5 / 1.20.4）。

推荐浏览器：桌面端 Chrome 或 Firefox 最新版。

移动端：体验有限，触屏操作不够流畅，官方推荐桌面端。

若游戏区长时间空白：可能代理被墙或服务器离线，请点右上「↗ 新窗口」直接用官方 demo 排查。

Minecraft 浏览器联机版

🚀 欢迎来到 DevHub