ZenithProxy

Minecraft proxy/bot intended for use on 2b2t.org.

Unlike a traditional MC bot, you can login to it like a normal MC server and control the account.

The primary purpose is to have accounts always online in-game and securely shared by multiple people.

This project is also used to support the 2b2t.vc API and Discord Bot.

What is a proxy?

This proxy itself consists of two components:
1. A Minecraft Server ("Proxy Server")
2. A Minecraft Client ("Proxy Client")

Players use a Minecraft client to connect to the Proxy Server as you would a normal MC server.
The Proxy Client connects to a destination MC server (i.e. 2b2t.org).
The Player's packets to the Proxy Server get forwarded to the Proxy Client which forwards them to the destination
MC server.

Player MC Client -> Proxy Server -> Proxy Client -> MC Server

When no Player Client is connected the Proxy Client can still act as a bot: moving around, chatting, etc.

How does it work?

The Proxy caches the client's world state including chunks, entities, other players, etc. to allow Player Clients to connect at any time.

The Proxy is also able to read/modify/cancel/send arbitrary packets in either direction at any time. This is used to simulate
player movements, spectator mode, discord chat relay, and more.

Features

• High performance and efficiency on minimal hardware, <300MB RAM per java instance or <150MB on linux.
• ViaVersion built in - can connect to any MC server version
• Secure Whitelist system - share MC accounts without sharing passwords
• Extensive Discord Bot integration
  • Chat relay
  • Player in visual range alerts
• Command System - Discord, In-game, and Terminal
  • 25+ commands and modules to configure every feature
• Spectator mode
  • Multiple players can connect to the proxy and spectate the player
• Advanced AntiAFK with full player movement simulation
• Modules including AutoEat, AutoDisconnect, AutoReconnect, AutoRespawn, AutoTotem, KillAura, Spammer, AutoReply
• Many, many, more features.

Getting Started

Setup and Download

1. Download ZenithProxyLauncher.zip here and unzip to a new folder:
   • Linux CLI:
     • Download: wget https://github.com/rfresh2/ZenithProxy/releases/download/launcher/ZenithProxyLauncher.zip
     • Unzip: unzip ZenithProxyLauncher.zip
2. Open a terminal to the launcher folder and run python3 setup.py (if python3 is not recognized, try python or py)

System Requirements

1. Linux or Windows computer. I recommend DigitalOcean:
   • $200 Free DigitalOcean Credits.
   • Guide and automatic setup script.
2. Python 3.10+
3. Java 21+ (Not required for linux release channel on supported CPU)
   • Linux Installation:
     • Install: https://sdkman.io/install
     • Run: sdk install java 21-zulu
   • Windows Installation: https://adoptium.net/

Run

• ./launch.sh (Linux) or .\launch.bat (Windows). Then use the connect command to log in
• Command Prefixes:
  • Discord: . (e.g. .help)
  • In-game: ! -> (e.g. !help)
  • Terminal: N/A -> (e.g. help)

Running on Linux Servers

See the Linux Guide

I highly recommend using a terminal multiplexer - a program that manages terminal sessions.

If you do not use one, ZenithProxy will be killed after you exit your SSH session.

• (Recommended) tmux
• screen
• pm2

Configuration

Release Channels

• (Default) java - Supports all operating systems
• (Recommended) linux - Linux native x86_64 executable. ~50% reduced memory usage and instant startup

DNS Setup

• To use a domain name you need the following DNS records:
  • an A record to the public IP address of your server Example
  • an SRV record for _minecraft._tcp with the port and the A record as its target. Example

Discord Bot Setup

• Create a discord bot here: discord.com/developers
• Enable Message Content Intent under the "Bot" tab. Example
• Invite the discord bot to a server.
• Create a role for users to manage the proxy, a channel to manage the proxy in, and a channel for the chat relay. The bot's role must have permissions to send and receive messages in both channels
• Run setup.py or configure with the discord command.

Running Multiple Instances

Create a new folder for each instance with its own copy of the launcher files. Example

Instances must be independently run and configured. i.e. separate terminal sessions, discord bots, ports, config files, etc.

See the Linux Guide for help copying files, creating folders, etc.

Special Thanks

• Pork2b2tBot Contributors
• MCProtocolLib Contributors