Server Protocol Bridge

wss:// · Minecraft

Turn any Minecraft server into a local wss:// endpoint

A small relay for web clients such as MCJS: it runs on your own machine, answers the WebSocket side of the game protocol and keeps the certificate local.

Latest release

wssproxy

Reading version.json …

Get it running

1 Download and start it

Double-click the EXE. The first run issues a self-signed certificate and starts listening on 127.0.0.1.

2 Type the address into MCJS

On the web client page choose wss and fill in 127.0.0.1:8443.

3 Join as usual

The relay forwards everything to the real server configured in the program.

What it does

Everything happens between your browser and your own computer; the target server only ever sees a normal Minecraft client.

Local relay only

It listens on your own machine (127.0.0.1 by default) and moves the bytes untouched; nothing is opened to the internet.

Web client support

It recognises browser clients such as EaglercraftX and MCJS and answers the handshake for them; normal clients pass straight through.

Certificate handled

The first run creates a self-signed certificate and installs it into the system trust store, which is what makes wss:// work.

Vanilla resolving

When no port is given it resolves the SRV record first, exactly like the official client does, and falls back to 25565.

Questions

The browser says the certificate is not trusted.

Open the program settings and click "Install into Trust Store", then close the browser completely and reopen it. The page has to be reloaded after that.

The program says a new release is available.

Use "Check for Updates" in the program or the download button on this page; both point at the same file. A release marked as required has to be installed before the program keeps running.

Which clients can connect?

Any web client that accepts a wss:// address, such as MCJS. Classic Java clients can use the plaintext ws:// port the program opens as a fallback.