机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

棱柱石网页客户端

一个在网页中运行的Minecraft客户端。现场演示在 https://prismarinejs.github.io/prismarine-web-client/

工作原理

prismarine-web-client 在浏览器中运行 mineflayer 和 prismarine-viewer，它通过 WebSocket 连接到一个代理，该代理将 WebSocket 连接转换为 TCP 来连接普通的 Minecraft 服务器。Prismarine-web-client 基于：

• prismarine-viewer 用于世界渲染
• mineflayer 用于高级 Minecraft 客户端 API

如果你想更多地了解它的工作原理并进行贡献，请查看这些模块！

截图

实时演示

点击此链接即可在浏览器中打开，无需安装： https://prismarinejs.github.io/prismarine-web-client/

已在桌面平台的 Chrome 和 Firefox 上测试。

使用方法

要自己托管它，请在 bash 中运行以下命令：

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

最后，在你的浏览器中打开 http://localhost:8080。

功能

• 显示怪物和玩家
• 显示方块
• 移动（你可以移动，并且看到实体实时移动）
• 放置和破坏方块

路线图

• 容器（库存、箱子等）
• 声音
• 更多世界交互（攻击实体等）
• 美容渲染功能（昼夜循环、雾等）

开发

如果你正在贡献/进行更改，你需要使用不同的方式安装它。

首先，克隆仓库。

然后，将你的工作目录设置为该仓库的目录。例如：

$ cd ~/prismarine-web-client/

最后，跑

$ npm install
$ npm start

这将以开发模式启动 express 和 webpack；每当你保存文件时，构建将重新进行（需要5秒），你可以刷新页面以获取新结果。

在浏览器中连接到 http://localhost:8080。

你可能想在 IDE 中禁用自动保存以避免不断重新构建；参见 https://webpack.js.org/guides/development/#adjusting-your-text-editor。

要检查生产构建（构建需要一分钟），你可以运行 npm run build-start。

如果你有兴趣贡献，可以查看 https://github.com/PrismarineJS/prismarine-web-client/projects 上的项目。

一些变量被暴露在全局 window 对象中以便调试：

• bot
• viewer
• mcData
• worldView
• Vec3
• pathfinder
• debugMenu

向 debugMenu 添加内容

debugMenu.customEntries['myKey'] = 'myValue' 删除 debugMenu.customEntries['myKey']

一些调试示例

在 Chrome 开发者工具中：

• bot.chat('test') 允许你使用聊天
• bot.chat(JSON.stringify(Object.values(bot.players).map(({username, ping}) => ({username, ping})))) 显示每个人的 ping
• window.bot.entity.position.y += 5 jumps
• bot.chat(JSON.stringify(bot.findBlock({matching:(block) => block.name==='diamond_ore', maxDistance:256}).position)) 查找钻石方块的位置
• bot.physics.stepHeight = 2 允许你在方块上行走
• bot.physics.sprintSpeed = 5 walks faster
• 然后 bot.loadPlugin(pathfinder.pathfinder) bot.pathfinder.goto(new pathfinder.goals.GoalXZ(100, 100)) 前往位置 100, 100

更多调试想法，请阅读 mineflayer 文档。