Troubleshooting
Why did the local Minecraft server not respond?
Section titled “Why did the local Minecraft server not respond?”Keep enable-status=true in server.properties and restart Minecraft after changing it. Check /port status for the resolved target. With automatic detection disabled, local.host and local.port must identify an existing Minecraft Java listener. A successful plain TCP connection alone does not satisfy the Minecraft status probe.
Why did the Bore download or executable fail?
Section titled “Why did the Bore download or executable fail?”The server needs HTTPS access to the pinned GitHub release. Check the operating system and CPU architecture against Compatibility. Managed archives and cache receipts are verified; modified or invalid caches are replaced when downloads are allowed. A custom path must identify a readable executable; relative paths start inside plugins/PortBridge/.
Why does the tunnel keep reconnecting?
Section titled “Why does the tunnel keep reconnecting?”Check relay reachability, TCP 7835 and the assigned public port. A private relay’s secret must match. If relay.public-host is configured, it must reach the forwarded Minecraft port from the server machine as well as from friends. Public relay outages can require waiting or selecting another relay.
What if the requested port is occupied?
Section titled “What if the requested port is occupied?”Enable relay.fallback-to-random or request port 0. Assigned addresses can change; share the new address after reconnecting.
Why can friends not join the displayed address?
Section titled “Why can friends not join the displayed address?”Check the public-route result. With public checks disabled, the relay may allocate a port without proving Minecraft is reachable. Friends still need a compatible Minecraft Java version, a valid authenticated account when required and whitelist access. Port Bridge does not expose Bedrock or UDP services.
Why is a command denied?
Section titled “Why is a command denied?”Give the player the specific permission or portbridge.admin. Status permission alone does not reveal the public address or grant tunnel management.
Why was the reload rejected?
Section titled “Why was the reload rejected?”Values must match the documented types and ranges. Message values require non-empty single-line strings, and theme colors require quoted #RRGGBB. The previous settings remain active after validation fails. Correct the file and retry /port reload.
Report an Issue
Section titled “Report an Issue”Include plugin version, exact Paper/Minecraft and Java versions, OS/architecture, reproduction steps and relevant logs. Remove relay secrets and private information. Report vulnerabilities privately following SECURITY.md.