MineWave Tunnel

Fix high ping and packet loss with Hysteria2. Plus the MineWave mods pack, one click away.

What is this?

If your connection to MineWave suffers from high ping or packet loss (bad ISP routing, long distance), this tunnel routes your traffic through Hysteria2, a QUIC-based protocol that keeps pushing through lossy routes instead of slowing down.

It only helps when the problem is the route between you and the server. It won't fix server-side lag, and if your connection is already good you don't need it.

Setup

Download for Windows~8 MB

Extract the zip anywhere (Desktop is fine).
Double-click run-tunnel.bat. A console window opens; leave it open while you play. If Windows SmartScreen complains, click More info > Run anyway.
In Minecraft, add a server with the address localhost and join through it.

To stop the tunnel, just close the console window. To play without the tunnel, connect to mine.w4ve.xyz as usual.

Download for macOS~15 MB

Extract the zip anywhere.
Double-click run-tunnel.command. The first time, macOS will block it: right-click the file, choose Open, then Open again to bypass Gatekeeper. Leave the terminal window open while you play.
In Minecraft, add a server with the address localhost and join through it.

Works on both Apple Silicon and Intel Macs (the launcher picks the right binary). To stop the tunnel, close the terminal window.

Download for Linux~8 MB

Extract the zip anywhere.
Open a terminal in the extracted folder and run ./run-tunnel.sh. Leave it running while you play.
In Minecraft, add a server with the address localhost and join through it.

If the script isn't executable after extracting: chmod +x run-tunnel.sh hysteria. To stop the tunnel, Ctrl+C.

Troubleshooting

"localhost" won't connect: make sure the tunnel window is still open. The address only works while the tunnel is running.
The tunnel won't start: the tunnel uses Minecraft's default port (25565). If you have a local server or a LAN world open on your PC, close it first.
Still lagging: if the lag is server-side (low TPS), no tunnel can fix that. Ask in the help channel on Discord.

MineWave mods pack

The full client mods folder used on MineWave (Fabric, Minecraft 1.21): litematica, carpet, tweakeroo, minihud, sodium, xaero's map, and everything else, already updated and known to work together. Drop the jars into your instance's mods folder and you're set.

Download mods pack~117 MB

This folder also includes mods made by and for MineWave. If you only want those, grab them individually:

Mod	What it does
WaveMotes	Discord emotes rendered in the in-game chat	jar
RipDeepslate	Deepslate mines like stone with a netherite pickaxe	jar
MankeList	Shared material lists with HUD, claims and Discord board	jar

MineWave, by and for the monkeys.