![Port Bridge | [1.21.11 - 26.3]](https://www.spigotmc.org/data/resource_icons/139/139616.jpg?1791888053){kind=icon}
ModsJava
Port Bridge | [1.21.11 - 26.3]
Java mod listed for Minecraft 1.21–26.x. Downloads from the MC Java Mods app on Android.
⬇ Download on SpigotPort Bridge
Host locally. Play together.
Managed tunnels · Copyable addresses · Automatic reconnection
Keep your Minecraft world on your computer. Give friends a way in.
Explore the documentation · Open the installation guide
Keep your world on your own computer and give friends an address they can use in ordinary Minecraft Java. Port Bridge connects your local server to a Bore relay, so you can share it without setting up router port forwarding.
Start a small survival world, test a build with friends or open a temporary development server. The Minecraft server, your computer and the tunnel must remain running while people play.
01 / A SIMPLE CONNECTION
From your local world to their server list.
From your local world to their server list.
Your Minecraft server stays where it is. Port Bridge detects its bind address and port, starts the Bore client and connects to your chosen relay. The relay allocates a public port that carries players' connections back to your local server.
Your server connects to the relay. Friends join using the public address.
- Run your server. Port Bridge detects the running server's bind address and Minecraft port.
- Open a tunnel. The managed Bore client connects to the relay and receives a public port.
- Share the address. Friends enter it in Minecraft Java's Multiplayer > Direct Connection screen. They need no tunnel client or additional software.
Port Bridge checks Minecraft's status response and matching ping through the local listener and, by default, the public route. A relay allocation alone does not mean the route is verified.
02 / MANAGED FOR YOU
A connection you can see and control.
A connection you can see and control.
Connect when you are ready. Open the tunnel shortly after Paper starts, or disable automatic startup and connect with /port start. The pinned Bore v0.6.0 client is downloaded automatically with SHA-256 archive and cached-executable verification. A custom executable path is also supported.
Keep the address close. Run /port address, copy it from the console or click Copy Address in chat. The panels include permission-aware command buttons, measured ping latency, retry timing and the latest diagnostic.
Recover from interruptions. Configure retry delays, route failure thresholds and attempt limits. Automatic reconnection helps restore the connection, while an explicit /port stop closes the tunnel and cancels retries.
Choose your public port. Request a port or let the relay allocate one. Optional fallback tries a random port when your requested port is occupied. Port availability depends on the relay, and an address can change after a restart or reconnection.
Make it fit your server. Use a private Bore relay with an optional shared secret and displayed hostname. Customize command replies, labels, buttons, hover text, connection details, timing values and ACF permission/error replies in messages.yml.
Downloads, process output and network checks run away from the server thread. The managed Bore process is closed when the plugin shuts down.
03 / YOUR FIRST TUNNEL
Install. Start. Share.
Install. Start. Share.
Requirements: Paper for Minecraft 1.21.11 or later, Java 25 or newer and an outbound connection to your chosen Bore relay. Keep enable-status=true in server.properties. Folia and Spigot are not supported.
- Download port-bridge-1.0.0.jar and place it in your server's plugins folder.
- Start the server. Default config.yml and messages.yml files are installed when they are missing.
- The default configuration starts a tunnel automatically. On the first connection, the supported Bore client is downloaded if needed.
- Run /port address, copy the address and send it to your friends.
/port help
Find your controls.
/port status
Check the connection.
/port address
Copy the address and invite your friends.
Find your controls.
/port status
Check the connection.
/port address
Copy the address and invite your friends.
If automatic startup is disabled, use /port start. The whitelist, account authentication and Minecraft client-version requirements still apply.
Follow the installation guide · Check compatibility
04 / COMMANDS THAT STAY CLOSE
Manage the tunnel from chat or console.
Manage the tunnel from chat or console.
/port, /pb and /portbridge share the same commands.
- /port status - View the state, local target, relay, latency, retries and latest error. The base command also shows status.
- /port help - View available commands with clickable suggestions.
- /port address - View and copy the public connection address. /port ip is an alias.
- /port start - Start a tunnel in the background.
- /port stop - Close the tunnel and cancel automatic retries.
- /port restart - Start a new tunnel session; the public address may change.
- /port reload - Validate settings and messages, then reconnect an active tunnel. An explicitly stopped tunnel stays stopped.
Spoiler: Permissions for administrators and trusted players
portbridge.admin grants every command permission. All permissions default to operators.
- portbridge.status - Status and help.
- portbridge.address - View/copy the address, receive connection announcements and optional join notifications.
- portbridge.manage - Start, stop and restart.
- portbridge.reload - Reload settings and messages.
Command reference · Permission reference
05 / MAKE IT YOURS
Choose your relay. Tune your connection.
Choose your relay. Tune your connection.
config.yml controls startup, local port detection, relay settings, Bore installation, reconnection, health checks and joining-player notifications.
messages.yml controls the chat design and every plugin command reply. Use literal text, {name} placeholders and quoted #RRGGBB theme colors. Missing keys fall back to bundled defaults; existing files are preserved. External diagnostic values keep their original text.
Edit either file and run /port reload. Invalid settings or messages reject the reload and retain the previous configuration.
Spoiler: Example: connect through your own Bore relay
Run a compatible Bore relay on a reachable server, then set your relay hostname and secret in config.yml:
The relay's control port is TCP 7835; allocated public ports must also be reachable. The shared secret authenticates tunnel creation and does not encrypt the forwarded traffic.
Code (Text):
relay:
host: relay.example.com
public-host: ''
port: 0
fallback-to-random: true
secret: 'your-private-secret'
host: relay.example.com
public-host: ''
port: 0
fallback-to-random: true
secret: 'your-private-secret'
Complete config.yml reference · Complete messages.yml reference
06 / BEFORE YOU CONNECT
Know what your address represents.
Know what your address represents.
Spoiler: Does it change my Minecraft port or router settings?
No. Automatic detection reads the existing Minecraft listener. The public port belongs to the relay; Port Bridge does not change your server's local port or router configuration.
Spoiler: Will the address stay the same?
It can change after a restart or reconnection. A requested public port remains subject to relay availability and policy. The default public bore.pub relay is operated independently and can be unavailable.
Spoiler: Does it forward Bedrock, UDP query or real player IP addresses?
Port Bridge forwards Minecraft Java TCP traffic. It does not expose Bedrock or UDP services, and forwarded connections do not preserve real player IP addresses. A relay can add latency.
Spoiler: Which operating systems support automatic downloads?
Windows x64/x86 and Linux/macOS x64/ARM64. Other platforms need a compatible executable configured in bore.executable.
Spoiler: What if the address is not reachable?
Check /port status, keep enable-status=true, confirm your local Minecraft listener is running and check the relay's availability. By default, public route failures trigger reconnection after the configured failure threshold. Disabling public health checks leaves the route unverified; local listener checks still run.
Open the troubleshooting guide
07 / BSTATS METRICS
bStats Metrics
bStats Metrics
Port Bridge collects anonymous usage statistics through bStats. These aggregate statistics show server counts and version adoption and help guide future development. Server owners can disable collection in plugins/bStats/config.yml.
Your next game starts with one address.
Free and open source under GPL-3.0-or-later. Created by Despical.
Installation guide
Documentation · Source code · Discord support
Javadocs
Free and open source under GPL-3.0-or-later. Created by Despical.
Installation guide
Documentation · Source code · Discord support
Javadocs
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 26.1, 26.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Port Bridge | [1.21.11 - 26.3] is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1, 26.2, 26.3. Downloaded 21 times (via Spigot). Download it and open it directly in the game.