Web Craft - The Game

这是由 AI 完全重写的 Minecraft 1.21.11 纯 Web 前端客户端还原项目。致力于在 Web 游玩 Minecraft Java Edition 服务器。

Important

这个项目正在早期开发阶段，将会频繁作出破坏性变更。

欢迎来 为我投喂Tokens！🥰🥰🥰

Minecraft 1.21.11 是在北京时间 2025年12月9日 发布的官方正式游戏版本，是群骑纷争主题更新的第一个版本，具体内容详见 Minecraft Wiki。

游戏中的物品模型、纹理等在 Minecraft 核心 Jar 中资源，会在用户的浏览器中通过 Mojang 官方服务器下载并使用，不包含在本项目的源码以及构建产物中。

部分资源如语言文件、主菜单全景图等，则包含在前端静态资源中。因为 mojang 的资源下载服务器没给跨域支持。

对于多人游戏连接，因浏览器不支持 TCP 协议长连接，使用 proxy 目录中的 WebSocket 开放反向代理来帮助连接服务器。

建议的 Agent 开发路径

1. 让 Agent 拉取 VineFlower 和版本 JSON 中的客户端 Jar 放到 cache 目录中
2. 让 Agent 反编译客户端 Jar，放到 decompiled 目录中便于后续参考
3. 让 Agent 大概通读整个项目，整理一个 SKILL 出来便于后续开发

cache
│  1.21.11_client.jar
│  
├─assets
│  └─indexes
│          29.json
│          aaf4be9d6e197c384a09b1d9c631c6900d1f077c.json
│          
└─tools
        vineflower.jar
decompiled
│  flightrecorder-config.jfc
│  pack.png
│  version.json
│ 
├─assets
├─com
├─data
├─META-INF
└─net

frontend

这是 Minecraft 客户端前端，主要在这里完成网络包解析、游戏引擎、画面渲染等工作。

初次拉取仓库，需要先下载资源到前端资源目录

# 在仓库根目录执行
npm install
node scripts/download-assets.ts

# 构建
cd frontend
npm run build

构建产物会出现在 frontend/dist/ 目录中，使用任意静态网站软件即可运行。

# 运行测试
cd frontend
npm run dev

proxy

这是 WS <---> TCP 反向代理，用于让客户端能够连接到 Minecraft 服务器。

# 构建
cd proxy
npm run build

构建产物会出现在 proxy/dist/ 目录中，通过 node dist/index.cjs 命令运行。

# 运行测试
cd proxy
npm run dev

鸣谢

• Minecraft - 原版游戏
• vineflower - 模组开发常用反编译工具
• FabricMC/mcsrc - 1.21.11 无混淆版本来源与参考
• lax1dude's eaglercraft - 多人游戏实现方案原型参考
• DeepSeek v4 Flash/Pro - 前期项目结构搭建与设计
• GPT 5.5 - 漏洞修复与精细结构处理