Skip to content
This repository was archived by the owner on Apr 16, 2022. It is now read-only.

Commit 5f7b036

Browse files
committed
Updated README
1 parent 3a25896 commit 5f7b036

File tree

2 files changed

+23
-3
lines changed

2 files changed

+23
-3
lines changed

README.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
# Node-BEWSS
2+
3+
## Minecraft Websockets
4+
Minecraft has websocket connection commands that may be used to connect to a websocket server. These commands are `/connect` and `/wsserver`.
5+
Both these commands have the same effect. Once connected to a websocket, the connection will last until the server closes it or until the
6+
player completely exits the game. The connection will last when a player merely leaves a world, and will thus last when joining a server.
7+
Websockets in Minecraft can be used for simple command communication between a player and a server. Additionally, the server can choose to
8+
listen for certain events sent by the client and act upon receiving them.
9+
10+
In order to be able to execute the `/connect` and `/wsserver` commands, cheats must be enabled. This means that connecting on third party
11+
servers is not possible, and only on the dedicated server when cheats are enabled. It is possible to connect on a singleplayer world and
12+
join a server after that, but commands executed by the websocket server will not work. Events will still be sent by the client however.
13+
14+
Node-BEWSS is based off of [mcwss](https://github.com/Sandertv/mcwss) but written in JavaScript.
15+
16+
## Getting started
17+
18+
- You need [Node.js](https://nodejs.org) v14.x and [npm](https://www.npmjs.com).
19+
- Download or clone the repository `git clone https://github.com/PMK744/node-mcwss.git`.
20+
- Install dependencies `npm install`
21+
- Before running production build you have to build it `npm run build`
22+
- You're done, you can run it using `npm run start` or `node .` (or `npm run dev` for development)
23+
- Check `src/index.ts` for basic usage examples.

README.txt

Lines changed: 0 additions & 3 deletions
This file was deleted.

0 commit comments

Comments
 (0)