A proxy to wait out 2b2t.org's way too long queue. Includes a small webserver a REST-like API for external control
Table of Contents
A proxy to wait out 2b2t.org's way too long queue.
Please Note that because of security reasons this tool doesn't auto-update! Also 2b2w does not show ETA from 2b2t.
The ETA is calculated based on position in the queue. This results in better ETA most of the time.
- node.js
- npm
- HTML
To get a local copy up and running follow these simple steps.
Please optain all required items
- A discord bot (optional) (detailed instructions)
- Read the code to ensure I'm not stealing your credentials. I'm not, but you shouldn't take my word for it. If you don't know how to read it, downloading stuff off the internet and giving it your password is probably a bad idea anyway.
- Download the executable here
- (Optional) Take a look at
config/default.json
, edit your values and place the config under${USER}/.2bored2wait/config/local.json
- Download and install node.js version 14 or above and git. You need git even if you download the repository as zip because it is to install the dependencies via npm.
- Open a terminal then clone this repo then cd into folder:
git clone https://github.com/themoonisacheese/2bored2wait
cd 2bored2wait
- Run
npm install
to install the required libraries - Start the program with
npm start
.
- Read the code to ensure I'm not stealing your credentials. I'm not, but you shouldn't take my word for it. If you don't know how to read it, downloading stuff off the internet and giving it your password is probably a bad idea anyway.
docker run -d -p 80:8080 -p 25565:25565 -e NODE_CONFIG='{"username":"[email protected]","mcPassword":"password","updatemessage":"n","BotToken":""}' 2bored2wait/2bored2wait:latest
. The docker image is automatically up to date after each push to this repo. Docker images are available foramd64
andarm64
among other platforms.- Open a browser and navigate to https://localhost
- Press the "Start queuing" button. The queue position indicator auto-updates, but sometimes it takes a while to start counting (like 1 min).
- Once the queue reaches a low number, connect to the Minecraft server at address
localhost
. - After you log off, click the "stop queuing" button. This is really important, as you will not actually disconnect from 2b2t until you do that.
If you want to change the configuration or you don't want your credentials in the bash history you will have to mount config/local.json manually.
- You can change all credentials and whether you want update messages by simply editing the values in local.js or deleting that file.
- Read the code to ensure I'm not stealing your credentials. I'm not, but you shouldn't take my word for it. If you don't know how to read it, downloading stuff off the internet and giving it your password is probably a bad idea anyway.
- Run
npm start
- It will now ask for your Minecraft email and password (or permission to use saved launcher data instead). If you want update messages then you need to type Y otherwise N. If you are using the discord bot you need to add your token. Then answer Y or N if you want to save your Minecraft credentials. If you answer N you will need to re-enter your Minecraft login information into the console each time you start the program.
- Refer to Commands on how to use 2b2w from the console. Otherwise keep on reading for the web interface.
- Now open a browser and navigate to https://localhost: your web port here (default 80).
- Press the "Start queuing" button. The queue position indicator auto-updates, but sometimes it takes a while to start counting (like 1 min).
- Once the queue reaches a low number, connect to the Minecraft server at address
localhost
. - After you log off, click the "stop queuing" button. This is really important, as you will not actually disconnect from 2b2t until you do that.
All commands can be used through discord or simply typed in the console window.
start
will start the queue. It takes between 15-30 seconds for the bot to update with the queue position.start 14:00
will start at 2pm.play 8:00
will try to calculate the right time to join so you can play at 8:00update
will send an update to the current channel with your position and ETA.stop
will stop the queue.
See the open issues for a list of proposed features (and known issues).
- Starting the queue will revoke your Minecraft token. this means that you will not be able to join normal Minecraft servers until you restart the game
- If you connect after the queue is finished or reconnect the proxy will send cached data. Otherwise you would fly in an empty world. However not all data will be resend. You can move out of render distance (I find going through a nether portal works best) and return to fix this issue. Sometimes the client renders a cached chunk with a blank texture.
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b themoonisacheese/2bored2wait
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin themoonisacheese/2bored2wait
) - Open a Pull Request
Distributed under the GPL-3.0 License. See this for more information.
- Run
npm test
to run test.js