Home

AquariusProxy

A headless Minecraft proxy/bot for 2b2t.org (works on any server), built as a fork of ZenithProxy by rfresh2.

It keeps everything ZenithProxy does — an always-online account you can also log into and control in-game, driven remotely from Discord, a terminal, or in-game chat — and adds a fix to the inventory engine plus a set of native built-in automation modules (no plugin jars to manage).

AquariusProxy implements only the Minecraft network protocol (no rendering / lighting / world-gen). It reads, modifies, cancels, and injects packets in either direction. See the original ZenithProxy project for the proxy fundamentals and the 2b2t.vc wiki for the full stock command reference.

⚠️ Java only. AquariusProxy is validated only on the Java release channel (the .jar, Java 21+) on Windows, Ubuntu/Linux, or macOS, and needs at least 1 GB of RAM (a 512 MB VPS is not enough). The native linux build and other platforms are not tested or validated. See Installation.

🧪 New on the 5.x beta channel: a permission system, a companion client mod, remote pearl pulls, and whisper commands — see What's New — 5.x Beta.

Getting started

• What's New — 5.x Beta 🧪 — everything added since the last stable release (4.1.0)
• Installation — build or download, run, and the control surfaces (terminal / Discord / in-game)
• Command Reference — every command, grouped by module
• Movement & Transport — pathfinder, bubble-column traversal, and boat autopilot
• The ShiftClick / inventory fix — why container automation works here
• Notifications (ntfy) — push alerts for visual range / connection state straight to your phone, no Discord required
• Plugin Development — write your own modules & commands as a drop-in plugin jar
• FAQ

Built-in modules

Module	Command	What it does
AquariusMiner	.aqm	AFK single-block quarry with ender-chest storage, auto-restock, anti-stall self-healing
AquariusSniffer	.aqm sniff	live / buffered packet capture with scenario templates + substring filters
PearlPlus	.pp	stasis-pearl loader (players whisper to teleport home)
VillagerTrader	.trader	fully automatic villager buy / sell / restock / store
PearlDrop	.pd	throws ender pearls into stasis chambers (the deposit side of PearlPlus)
KitMaker	.km	mass-produces filled kit shulkers from a template shulker
Regear	.rg	one-shot resupply: pulls a kit shulker from an ender chest and gears up
ElytraPilot	.fly	autopilot elytra flight — validated no-firework highway bounce, physics-solver nether flight, overworld trip planner
Enchanter	.enc	auto-builds max-template gear in an anvil station via the cheapest anvil order

Stash system (Postgres + Redis)

A stash-organisation bot + payment-gated order picker. See Order System for the full flow + setup.

Module	Command	What it does
StashScanner	.ss	read-only stash census — walks storage, reads each shulker's contents, classifies it as a kit, snapshots to Postgres
OrderFiller	.of	pops a paid order, withdraws the reserved kit shulkers and deposits them into the order's outgoing chest, posts a manifest
Order System	.order	native order intake (catalog / stock / order / status), soft-hold + payment gate + Discord manifest

Remote control & access 🧪 (5.x beta)

Let a group share one bot, safely. See What's New — 5.x Beta for the full preview.

Feature	Command	What it does
Access Control (RBAC)	.perms	role-based permissions + per-user API tokens that replace the owner/whitelist model
ProxyBridge	(client mod)	companion Fabric mod — live waypoints, pearl-pull-anywhere, in-game admin GUI, off-chat goto
WhisperControl	.wc	authorized players whisper the bot to protect / come / goto / patrol / mine

What's different from ZenithProxy

AquariusProxy is ZenithProxy with:

• Package / branding renamed com.zenith → com.aquarius; the product identifies as AquariusProxy (banner, jar, Discord).
• A fixed ShiftClick quick-move so shift-clicking actually moves items on 2b2t / Grim-protected servers. Every container-using module depends on it.
• The nine native built-in modules listed above — no plugin jars, no separate config files. Every setting lives in the main config.json under client.extra.<module> and is configured entirely through commands.

Everything from upstream ZenithProxy (AntiAFK, AutoEat, KillAura, AutoTotem, AutoArmor, VisualRange, Spammer, AutoFish, the Discord / terminal / in-game control surfaces, ViaVersion multi-version support, etc.) is still present and unchanged.

Credits & license

A fork of ZenithProxy by rfresh2 — AquariusProxy would not exist without it. The VillagerTrader and PearlPlus modules are ported from rfresh2's ZenithProxyVillagerTrader and duccss's PearlPlus. Licensed under AGPL-3.0, the same as ZenithProxy.