q13x-eaglerproxy/README.md

52 lines
1.9 KiB
Markdown
Raw Normal View History

2022-12-18 05:39:38 -08:00
# EaglercraftX (1.8.9) WebSocket Proxy
## What is this?
2022-12-18 05:46:54 -08:00
A very poorly written and small Node.js-based proxy that allows EaglerX/Eaglercraft 1.8.9 clients to connect to (offline) Vanilla 1.8.9 servers.
2022-12-18 05:39:38 -08:00
## Issues
* Generic and vague "End of stream" error when disconnected by the proxy, not the server
* Inability to set a server icon
* Skins don't work
## Setup Guide
### Prerequisites
* Node.js v12 and up
* A 1.8.9-compatible Minecraft server or proxy
### Setup Guide
1. Download and extract this repository to a folder on your computer.
2. Open a terminal and go to the folder of the repository. Run `npm i`.
3. Edit `config.js` to configure your proxy. Below is a small breakdown of the configuration file.
```js
export const config = {
// The name of the proxy. Does nothing.
name: "BasedProxy",
// The port you want to run the proxy on.
port: 80,
// The amount of players that can join and use this proxy simultaneously.
maxPlayers: 20,
motd: {
// Does nothing. (icons do not work)
iconURL: null,
// The first line of the MOTD.
l1: "hi",
// The second line of the MOTD.
l2: "lol"
},
server: {
// The IP/domain of the server you want the proxy to point to.
// Remember, the server HAS to be offline, or you can't connect.
host: "127.0.0.1",
// The port the server is running on.
port: 25565
},
security: {
// Whether or not encryption should be enabled.
// If you are using Repl.it, this should be left off.
enabled: false,
// The key issued to you by your certificate authority (CA).
key: null,
// The certificate issued to you by your certificate authority (CA).
cert: null
}
};
```
2022-12-18 05:44:15 -08:00
3. Start your proxy by running `node index.js`.
4. Connect to your server. For the server address, use the folllowing format: `ws://<IP>:<port>`. If you are using encryption, replace `ws://` with `wss://`.