d82a70a5ad
Bumps [webpack-dev-middleware](https://github.com/webpack/webpack-dev-middleware) from 5.3.3 to 6.0.0. - [Release notes](https://github.com/webpack/webpack-dev-middleware/releases) - [Changelog](https://github.com/webpack/webpack-dev-middleware/blob/master/CHANGELOG.md) - [Commits](https://github.com/webpack/webpack-dev-middleware/compare/v5.3.3...v6.0.0) --- updated-dependencies: - dependency-name: webpack-dev-middleware dependency-type: direct:development update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> |
||
---|---|---|
.github | ||
assets | ||
extra-textures | ||
lib | ||
test | ||
.dockerignore | ||
.gitignore | ||
.gitpod | ||
.npmignore | ||
.npmrc | ||
config.json | ||
Dockerfile | ||
HISTORY.md | ||
index.html | ||
index.js | ||
LICENSE | ||
package.json | ||
README.md | ||
README_PT.md | ||
README_RU.md | ||
screenshot.png | ||
server.js | ||
styles.css | ||
webpack.common.js | ||
webpack.dev.js | ||
webpack.prod.js |
prismarine-web-client
🇺🇸 English | 🇷🇺 Russian | 🇵🇹 Portuguese |
---|
A Minecraft client running in a web page. Live demo at https://webclient.prismarine.js.org/
How it Works
prismarine-web-client runs mineflayer and prismarine-viewer in the browser, which connects over WebSocket to a proxy which translates the WebSocket connection into TCP to connect to normal Minecraft servers. Prismarine-web-client is based on:
- prismarine-viewer for the world rendering
- mineflayer for the high-level Minecraft client API
Check these modules if you want to understand more how it works and contribute!
Screenshot
Live Demo
Click on this link to open it in your browser, no installation necessary: https://webclient.prismarine.js.org/
Tested on Chrome & Firefox for desktop platforms.
Usage
To host it yourself, run these commands in bash:
$ npm install -g prismarine-web-client
$ prismarine-web-client
Finally, open http://localhost:8080
in your browser.
Features
- Display mobs and players
- Display blocks
- Movement (you can move, and you see entities moving live)
- Place and break blocks
Roadmap
- Containers (inventory, chests, etc.)
- Sounds
- More world interactions (attacking entities, etc.)
- Cosmetic rendering features (day night cycle, fog, etc.)
Development
If you're contributing/making changes, you need to install it differently.
First, clone the repo.
Then, set your working directory to that of the repo. For example:
$ cd ~/prismarine-web-client/
Finally, run
$ npm install
$ npm start
This will start express and webpack in development mode; whenever you save a file, the build will be redone (it takes 5s), and you can refresh the page to get the new result.
Connect to http://localhost:8080 in your browser.
You may want to disable auto saving in your IDE to avoid constant rebuilding; see https://webpack.js.org/guides/development/#adjusting-your-text-editor.
To check the production build (will take a minute to build), you can run npm run build-start
.
If you're interested in contributing, you can check projects at https://github.com/PrismarineJS/prismarine-web-client/projects.
Some variables are exposed in the global window
object for debugging:
bot
viewer
mcData
worldView
Vec3
pathfinder
debugMenu
Adding stuff to the debugMenu
debugMenu.customEntries['myKey'] = 'myValue' delete debugMenu.customEntries['myKey']
Some debugging examples
In Chrome DevTools:
bot.chat('test')
allows you to use the chatbot.chat(JSON.stringify(Object.values(bot.players).map(({username, ping}) => ({username, ping}))))
display the ping of everyonewindow.bot.entity.position.y += 5
jumpsbot.chat(JSON.stringify(bot.findBlock({matching:(block) => block.name==='diamond_ore', maxDistance:256}).position))
finds the position of a diamond blockbot.physics.stepHeight = 2
allows you to walk about blocksbot.physics.sprintSpeed = 5
walks fasterbot.loadPlugin(pathfinder.pathfinder)
thenbot.pathfinder.goto(new pathfinder.goals.GoalXZ(100, 100))
goes to position 100, 100
For more debugging ideas, read the mineflayer doc.