mcproxy

Turn your
Minecraft server
into a proxy.

McProxy runs a private SOCKS5 and HTTP/HTTPS proxy on your Minecraft server’s connection. Install the Paper or Purpur plugin, or run the standalone JAR on Java 21+.

Download plugin 80 KB Download standalone 83 KB

Two ways to run it

It is the same proxy either way. The only difference is whether Minecraft runs next to it.

Paper plugin

Add it as a plugin on your mc server.

  • Needs an additional allocated port
  • Paper or Purpur 1.21.11+
  • Run /mcproxy in game or in the console
Download plugin 80 KB

Plugin setup

What’s in the JAR

Both downloads do the same things.

  • One port for everything

    SOCKS5, HTTP and HTTPS all answer on the same port. UDP goes through SOCKS5 on the same number.

  • Locked from the first start

    A random 43-character password is generated for you. There is no way to run it without a login.

  • No restarts

    Change the port, the password or UDP from the console and it applies right away.

  • Made for panels

    On Pterodactyl and Pelican the standalone JAR picks up your allocated port by itself.

  • Stays out of your network

    Clients cannot reach localhost or LAN addresses behind your server unless you allow it.

  • Limits built in

    64 connections at once and 8 per IP by default, and you can lock it to your own IP addresses.

Set up in three steps

Paper plugin

  1. Drop it into plugins/

    Add the JAR to your Paper or Purpur server’s plugins folder.

  2. Start and set your port

    Start Minecraft, then run mcproxy setport with an extra allocated port.

  3. Connect your apps

    Use the server IP, the proxy port and the generated login in your proxy client.

Standalone JAR

  1. Upload the server JAR

    Put the JAR in your server root and select it as your egg’s server JAR.

  2. Start on your allocation

    Use Java 21+. On Pterodactyl, McProxy picks up SERVER_PORT by itself.

  3. Grab your login and connect

    Open mcproxy.properties, then enter the server address and login in your proxy client.

Want the long version with every command? Read the setup guide.

FAQ

What does McProxy do?

It routes traffic from proxy-capable apps through your server’s outbound internet connection. You get a password-protected SOCKS5, HTTP and HTTPS proxy on your own server.

Which download should I choose?

The plugin if you want a proxy while Minecraft keeps running. It needs an extra allocated port. The standalone JAR if you want to turn a whole Java server slot into McProxy, using its main port.

Does it work on Pterodactyl?

Yes. For standalone, upload the JAR, choose Java 21+ and set SERVER_JARFILE to its file name. McProxy reads the allocated SERVER_PORT by itself. Your host has to allow proxy traffic, and UDP if you use it.

Where do I find my login?

McProxy generates a password on first start. For the plugin, open plugins/MCProxy/config.yml. For standalone, open mcproxy.properties. It is saved there and never printed in the console.

What about HTTPS and UDP?

Use http://IP:PORT as the proxy for both HTTP and HTTPS sites. HTTPS stays encrypted through a CONNECT tunnel. UDP needs a client with SOCKS5 UDP support and a host that allows it.

Is this a Minecraft lobby or a VPN?

Neither. It is an application proxy: only apps you point at it use it, and it does not move players between servers like Velocity does. The standalone JAR does not host a world.

Can other people use my proxy?

Only with your login. There is no open mode, the generated password is long and random, and you can limit the proxy to your own IP addresses in the config.

I lost the password.

It is still in the config file. To get a new one, run mcproxy newpassword and read it from the same file. All commands are on the commands page.