You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+2-1Lines changed: 2 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,7 +21,7 @@ How different modules are used:
21
21
22
22
-`mineflayer` - provider `bot` variable and as mineflayer states it is a wrapper for the `node-minecraft-protocol` module and is used to connect and interact with real Java Minecraft servers. However not all events & properties are exposed and sometimes you have to use `bot._client.on('packet_name', data => ...)` to handle packets that are not handled via mineflayer API. Also you can use almost any mineflayer plugin.
23
23
24
-
## Making protocol changes
24
+
## Making protocol-related changes
25
25
26
26
You can get a description of packets for the latest protocol version from <https://wiki.vg/Protocol> and for previous protocol versions from <https://wiki.vg/Protocol_version_numbers> (look for *Page* links that have *Protocol* in URL).
27
27
@@ -37,6 +37,7 @@ Also there are [src/generatedClientPackets.ts](src/generatedClientPackets.ts) an
37
37
- Some data are cached between restarts. If you see something doesn't work after upgrading dependencies, try to clear the by simply removing the `dist` folder.
38
38
- The same folder `dist` is used for both development and production builds, so be careful when deploying the project.
39
39
- Use `start-prod` script to start the project in production mode after running the `build` script to build the project.
40
+
- If CI is failing on the next branch for some reason, feel free to use the latest commit for release branch. We will update the base branch asap. Please, always make sure to allow maintainers do changes when opening PRs.
Copy file name to clipboardExpand all lines: README.MD
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,14 +4,14 @@
4
4
5
5
A true Minecraft client running in your browser! A port of the original game to the web, written in JavaScript using modern web technologies.
6
6
7
-
If you encounter any bugs or usability issues, please report them!
7
+
If you encounter any bugs or usability issues, please report them! For development, see [development](#development--debugging).
8
8
9
9
You can try this out at [mcraft.fun](https://mcraft.fun/), [pcm.gg](https://pcm.gg) (short link) [mcon.vercel.app](https://mcon.vercel.app/) or the GitHub pages deploy. Every commit from the `develop` (default) branch is deployed to [s.mcraft.fun](https://s.mcraft.fun/) - so it's usually newer, but might be less stable.
10
10
11
11
### Big Features
12
12
13
13
- Open any zip world file or even folder in read-write mode!
14
-
- Connect to cracked servers* (it's possible because of proxy servers, see below)
14
+
- Connect to Java servers running in both offline (cracked) and online mode* (it's possible because of proxy servers, see below)
15
15
- Singleplayer mode with simple world generations!
16
16
- Works offline
17
17
- Play with friends over internet! (P2P is powered by Peer.js discovery servers)
@@ -39,9 +39,9 @@ Whatever offline mode you used (zip, folder, just single player), you can always
39
39
40
40
### Servers
41
41
42
-
You can play almost on any server, supporting offline connections.
42
+
You can play almost on any Java server, vanilla servers are fully supported.
43
43
See the [Mineflayer](https://github.com/PrismarineJS/mineflayer) repo for the list of supported versions (should support majority of versions).
44
-
There is a builtin proxy, but you can also host a your one! Just clone the repo, run `pnpm i` (following CONTRIBUTING.MD) and run `pnpm prod-start`, then you can specify `http://localhost:8080` in the proxy field.
44
+
There is a builtin proxy, but you can also host your one! Just clone the repo, run `pnpm i` (following CONTRIBUTING.MD) and run `pnpm prod-start`, then you can specify `http://localhost:8080` in the proxy field.
45
45
MS account authentication will be supported soon.
46
46
47
47
### Rendering
@@ -67,9 +67,9 @@ There are many many settings, that are not exposed in the UI yet. You can find o
67
67
68
68
To open the console, press `F12`, or if you are on mobile, you can type `#debug` in the URL (browser address bar), it wont't reload the page, but you will see a button to open the console. This way you can change advanced settings and see all errors or warnings. Also this way you can access global variables (described below).
69
69
70
-
### Debugging
70
+
### Development & Debugging
71
71
72
-
It should be easy to build/start the project locally. See [CONTRIBUTING.MD](./CONTRIBUTING.md) for more info.
72
+
It should be easy to build/start the project locally. See [CONTRIBUTING.MD](./CONTRIBUTING.md) for more info. Also you can look at Dockerfile for reference.
73
73
74
74
There is world renderer playground ([link](https://mcon.vercel.app/playground.html)).
75
75
@@ -113,10 +113,10 @@ Press `Y` to set query parameters to url of your current game state.
113
113
-`?version=<version>` - Set the version for server
114
114
-`?lockConnect=true` - Disable cancel / save buttons, useful for integrates iframes
115
115
-`?reconnect=true` - Reconnect to the server on page reloads. Available in **dev mode only** and very useful on server testing.
116
-
<!-- - `?password=<password>` - Set the password on load -->
117
116
-`?loadSave=<save_name>` - Load the save on load with the specified folder name (not title)
118
117
-`?singleplayer=1` - Create empty world on load. Nothing will be saved
119
118
-`?noSave=true` - Disable auto save on unload / disconnect / export. Only manual save with `/save` command will work
119
+
<!-- - `?requiresAuth=true` - Show the Microsoft login screen on server connect. Useful for servers that require authentication (running in online mode) -->
120
120
121
121
-`?map=<map_url>` - Load the map from ZIP. You can use any url, but it must be CORS enabled.
122
122
-`?setting=<setting_name>:<setting_value>` - Set the and lock the setting on load. You can set multiple settings by separating them with `&` e.g. `?setting=autoParkour:true&setting=renderDistance:4`
0 commit comments