After installing

  1. macOS: after moving it to /Applications, open Terminal and run xattr -cr /Applications/Proxhy.app once.
  2. Open Proxhy and press Start in the top-left corner.
  3. In Minecraft 1.8.9, join the server localhost:41223.

That's it! You're playing through Proxhy. To update, click the Update Proxhy button.

Prefer the command line?

Proxhy also runs without the GUI, via uv:

uvx --index=https://kbidlack.github.io/proxhy/simple proxhy

Reruns fetch the latest release automatically. Or install it persistently:

uv tool install --index=https://kbidlack.github.io/proxhy/simple proxhy

Update later with uv upgrade proxhy. Full CLI options below ↓

CLI OPTIONS

Running without the GUI.

All flags available when running Proxhy directly from the command line.

-rh, --remote-host HOST    Remote server host (default: mc.hypixel.net)
-rp, --remote-port PORT    Remote server port (default: 25565)
-p,  --port PORT           Local proxy port (default: 41223)
--local                    Connect to localhost:25565 for development
--dev                      Bind to localhost:41224, disable compass client
-fh, --fake-host HOST      Host reported to the server (default: remote-host)
-fp, --fake-port PORT      Port reported to the server (default: remote-port)

UNINSTALLING

Not your thing?

We're sorry to see you go.

macOSremove /Applications/Proxhy.app
Windowsdelete Proxhy.exe
Linuxdelete Proxhy.AppImage

Settings, credentials, and logs live in platform-specific folders and aren't removed automatically: macOS uses ~/Library/Application Support/proxhy, Linux uses ~/.config/proxhy, Windows uses %LOCALAPPDATA%\proxhy. Delete those too for a clean slate.

CLI uninstall: uv tool uninstall proxhy