TunnelMC

🆕 What's new in 1.1.0

Auto-Restart & Crash Loop Protection

Tunnels now restart automatically if the ngrok process exits unexpectedly. Crash loop protection kicks in if a tunnel fails too many times within a configurable time window, stopping the retry cycle to prevent runaway restarts. Both the restart delay and failure threshold are fully configurable.

Health Checks

TunnelMC now periodically verifies each tunnel is still alive by querying ngrok's local API. If a tunnel silently dies without crashing, the health check catches it and triggers an automatic restart. The check interval is configurable, or can be disabled entirely.

/tunnel download Command

You can now trigger the ngrok binary download manually at any time from in-game or console with /tunnel download. Useful if the initial download failed or you want to re-fetch the binary without restarting your server.

NodeRunner & PyRunner Integration

If NodeRunner or PyRunner is installed and one of your configured tunnel ports matches their dashboard port, TunnelMC will print a helpful suggestion in console. This is purely informational — these bot runners are never auto-started by TunnelMC.

---

Config changes

Four new options have been added to config.yml:

auto-restart: true
restart-delay-seconds: 10
max-restarts: 5
crash-window-seconds: 60
health-check-interval-seconds: 30

integrations:
  noderunner-suggestion: true
  pyrunner-suggestion: true

Existing configs remain fully compatible — all new keys will use their defaults if not present.