AquariusSniffer

AquariusSniffer — packet sniffer

A live / buffered packet inspector for debugging behaviour against the destination server. It's a separate toggle from the miner so you can capture packets any time. Enabling it registers an observe-only codec at the head of the client (bot ⇄ server) pipeline — it never alters packets — and disabling it fully unregisters the codec, so there is zero per-packet overhead when off. Captured lines go into a rolling buffer (most-recent-N) that survives enable/disable cycles, so dump still works after you turn it off.

All sniffer commands live under .aqm sniff ….

Capture controls

Command	What it does
.aqm sniff on / off	Start / stop capturing into the rolling buffer.
.aqm sniff dump	Print the buffered packet lines to the console / terminal log.
.aqm sniff clear	Empty the buffer.
.aqm sniff 1s / 3s / 5s / 10s	One-shot verbose capture (forces live + body on) for N seconds, then auto-dumps and turns the sniffer off. The fastest way to grab a short trace.

Output controls

Command	What it does
.aqm sniff live on / off	Mirror each matching packet to the log in real time (in addition to buffering).
.aqm sniff body on / off	on = log the full packet toString() (all fields); off = log just the packet class name.
.aqm sniff dir in / out / both	Restrict to inbound (from server), outbound (bot → server), or both.

Filtering

Two independent filters are AND-ed together; a packet is captured only if it passes both:

1. Template — a named scenario that matches a curated set of packet-name substrings.

Command	What it does
.aqm sniff template list	List the available templates.
.aqm sniff template <name>	Apply a template (forgiving match: block → blocks, chunk → chunks, entit → entities).
.aqm sniff template off	Clear the template (capture all packet types).

Template	Matches packet names containing
movement	playerposition, moveplayer, moveentity, teleport, rotate, velocity, vehiclemove, setentitymotion
combat	damage, hurt, interact, sethealth, entityevent, removeentities, attack
inventory	container, setslot, setcontent, openscreen, carrieditem, creativemodeslot, setheldslot
blocks	blockupdate, blockdestruction, playeraction, useitem, blockchangedack, blockevent, sectionblocks
chunks	levelchunk, forgetlevelchunk, chunkcachecenter, chunkcacheradius, lightupdate
chat	chat, systemchat, disguised, playerinfo
entities	addentity, removeentities, setentitydata, moveentity, teleportentity, entityevent
keepalive	keepalive, ping, pong

2. Substring filter — a free-text substring matched against the packet class name.

Command	What it does
.aqm sniff filter <text>	Only capture packets whose class name contains <text> (e.g. filter merchant).
.aqm sniff filter off	Clear the substring filter.

Examples

.aqm sniff template inventory      # only inventory/container packets
.aqm sniff dir in                  # ...inbound only
.aqm sniff filter merchant         # ...and only those whose name contains "merchant"
.aqm sniff 5s                      # capture 5s verbose, auto-dump, auto-off

.aqm sniff template movement       # debug pathing/teleport behaviour
.aqm sniff body on                 # see full packet fields
.aqm sniff on                      # ...then dump/clear as needed

Buffer size, live, body, dir, filter, and template all persist in config.json under client.extra.aquariusMiner (sniff* fields).