User:ProudVirginGang/Drafts/Guide: Proxy Setup
More actions
This draft has been submitted for review. |
This is a minimal setup guide for Zenith Proxy that aims to be briefer than its respective website.
Zenith Proxy
Zenith Proxy is a Minecraft proxy commonly used by 2b2t players. It allows players to connect to a separate server that maintains its own connection to 2b2t. When no player is connected, the proxy can continue operating as a bot.
Zenith Proxy supports remote management through a terminal, Discord, or an in-game connection. Features include account sharing, a whitelist, AFK-related modules, and chat relay.
Requirements
A Minecraft account.
A Linux VPS or another computer capable of running Zenith Proxy.
Access to a terminal or server console.
A Discord account and server (optional).
Hosting
Zenith Proxy can run on a home computer or a VPS. A VPS is useful for keeping the proxy online without leaving a personal computer running.
Possible hosting providers include:
Vultr
DigitalOcean
Hostinger (add links)
A New York data center is recommended for connecting to 2b2t, although actual latency depends on network routing.
This article references low-cost shared CPU plans from Vultr and DigitalOcean. Prices and available plans may change.
Installation
Vultr
Log in to Vultr on the website.
Open Orchestration and select Scripts.
Create a startup script with the type set to Boot.
Copy the contents of the /rfresh2/ZenithProxy/blob/1.21.4/scripts/cloud-init.yaml startup script in the ZenithProxy github into the editor and save it.
Create a new VPS using a shared CPU plan.
Select a New York location and Debian 13.
Select the startup script you created.
Disable automatic backups if they are not needed.
Deploy the server and wait for initialization to finish.
The startup script installs required utilities, downloads the Zenith Proxy launcher, and reboots the server.
Open the VPS console and log in using the credentials provided by Vultr.
Allow incoming connections on the default Minecraft port:
sudo ufw allow 25565/tcp
This command configures UFW. If the hosting provider has a separate firewall, allow the required port there as well.
DigitalOcean
Log in to DigitalOcean (cloud website).
Create a new Droplet.
Select a New York region.
Choose Ubuntu 24.04.
Select a basic shared CPU plan.
Expand Advanced Options and enable Add Initialization Script.
Copy the contents of the /rfresh2/ZenithProxy/blob/1.21.4/scripts/cloud-init.yaml startup script in the ZenithProxy github into the field.
Name the Droplet and create it.
Wait for initialization to finish.
There should be a $4/month plan and a possible 60-day promotional trial. These offers are not guaranteed to remain available.
Launching Zenith Proxy
Open the VPS console and enter:
tmux cd ZenithProxy ./launch
The commands perform the following functions:
tmux creates a persistent terminal session.
cd ZenithProxy enters the installation directory.
./launch starts Zenith Proxy.
To detach from the tmux session without stopping the proxy, press Ctrl+B, then D.
To return to the session, enter:
tmux attach
First-time setup
When Zenith Proxy starts, follow the configuration prompts.
Select Linux by entering 2.
Select VPS by entering 2.
Enter 25565 as the listening port.
Enable Discord integration if desired and enter the bot token.
Enter the management channel ID and management role ID.
Enable chat relay if desired and enter its channel ID.
Complete the remaining prompts.
If Discord is not being used, disable the bot when prompted.
To connect the Minecraft account, enter:
connect
Follow the Microsoft authentication instructions displayed by Zenith Proxy. If authentication fails, try signing into the account using the official Minecraft launcher and joining a server before trying again.
Discord bot setup
Discord integration is optional. Steps:
Create a private Discord server.
Create a management channel and a chat-relay channel.
Create a role for users authorized to manage the proxy.
Open the Discord Developer Portal (see web) and create an application.
Open the Bot tab and copy the bot token.
Enable Message Content Intent and save the changes.
Open OAuth2, enable the bot scope, and grant the required permissions, including Send Messages.
Use the generated URL to invite the bot to the server.
Enable Developer Mode in Discord.
Right-click the management channel, management role, and chat-relay channel to copy their IDs.
Enter the token and IDs when prompted during the initial setup.
Keep the bot token private and grant management permissions only to trusted users.
Connecting to the proxy
Enter status in the Zenith Proxy terminal.
Find the Proxy IP in the output.
Open Minecraft and select Multiplayer.
Add a server using the Proxy IP.
Join the server.
Use the Proxy IP reported by Zenith Proxy rather than assuming that the VPS's public IP is always the correct connection address.
Configuration
Enable the following modules:
antiAFK on autoEat on
The commands enable AntiAFK and AutoEat, respectively. These modules can also be configured through the other command interfaces supported by Zenith Proxy.
For additional options, see the /rfresh2/ZenithProxy/blob/1.21.4/docs/wiki/Commands.md command reference on the ZenithProxy GitHub.
Commands
Commands can be entered through the terminal, Discord bot, or an in-game connection. The prefix depends on the interface: terminal commands have no prefix, Discord commands use a period, and in-game commands use a slash or exclamation mark.
Connection
connect disconnect reconnect status connectionTest
connect connects Zenith Proxy to its destination server.
disconnect disconnects it.
reconnect disconnects and reconnects to the destination server.
status displays the proxy's status, connected player, and module information.
connectionTest tests the connection to the proxy.
Whitelist
whitelist add PlayerName whitelist list whitelist del PlayerName whitelist clear
Replace PlayerName with the Minecraft username.
whitelist add adds a player to the whitelist.
whitelist list displays the whitelist.
whitelist del removes a player.
whitelist clear clears the whitelist.
Whitelisted players can connect to the proxy and control the associated account. Only whitelist trusted players.
Authentication
To switch Minecraft accounts, enter:
disconnect auth clear connect
Follow the authentication instructions to sign in to the other account. If Microsoft automatically selects the wrong account, open the authentication link in a private browsing window.
Troubleshooting
The proxy stops when the console closes
Run Zenith Proxy inside a tmux session. Detaching from the session with Ctrl+B followed by D leaves the process running.
The proxy disconnects from 2b2t
Check the terminal output for the disconnect reason. If the proxy is still running, try:
connect
If necessary, use reconnect to reconnect to the destination server.
Disconnects may be caused by network problems, server restarts, anti-cheat measures, AFK restrictions, or the eight-hour session limit for non-Priority accounts. A proxy does not guarantee uninterrupted connectivity.
Players cannot connect to the proxy
Run:
connectionTest
Check the reported errors and verify that:
The VPS is running.
Zenith Proxy is listening on the configured port.
The operating system firewall allows incoming connections.
Any provider-level firewall allows the required traffic.
Players are using the correct Proxy IP.
Authentication fails
Try logging into the account through the official Minecraft launcher and joining a server. Then retry authentication through Zenith Proxy.
Repeated login attempts may trigger Microsoft's rate limits. If this happens, wait before trying again.
The installation is broken
Check the console output and verify the installation directory and launcher files. If reinstalling is necessary, back up any configuration you want to keep and repeat the initial setup.
External links
External links will be added after admin approval lol