Troubleshooting
Quick checklist
Before reading further — try these three things. They fix 90% of all issues:
| Check | How | |
|---|---|---|
| 1 | Phone and console on the same Wi-Fi | No VPN, no mobile data, no guest network |
| 2 | Restart both your phone and console | Full restart — not just sleep mode |
| 3 | Restart the server in the BedrockConnect app | Stop → Start again |
We know it sounds obvious. But a full restart of your phone + console + the server in the app fixes the vast majority of problems. Do this before anything else.
Server doesn't show up in the world list
If the quick checklist didn't help, work through these:
- iOS
- Network issues
- Switch
Local Network permission
When you first use BedrockConnect, iOS may show a popup asking to connect to devices on your local network. You must tap OK. This popup doesn't always appear — but the permission must be enabled either way.
If you accidentally denied it or never saw the popup:
iPhone Settings → scroll down to BedrockConnect → enable Local Network
Then restart the app.
Your router might be blocking it
Some routers prevent devices from talking to each other. Check for:
| Setting | Fix |
|---|---|
| AP isolation / Client isolation | Must be off |
| Guest network | These isolate devices — use your main Wi-Fi |
| 2.4 GHz vs. 5 GHz | Some routers treat these as separate networks — put both devices on the same band |
| Corporate / school / hotel Wi-Fi | Almost always blocks local connections — use a personal hotspot or home network |
DNS settings
Your Switch's Primary DNS must be set to your iPhone's current IP address. This IP can change — always double-check it in the BedrockConnect app before setting the DNS.
After changing DNS: full restart of the Switch (hold power → Restart, not sleep).
Featured Server doesn't redirect
Make sure BedrockConnect is running on your iPhone (app open, server started), that Switch Support is enabled in the app settings, and try a different Featured Server (e.g. Lifeboat instead of Hive).
"Unable to connect to world"
This means BedrockConnect worked — but the target server has a problem.
| Cause | Fix |
|---|---|
| Server is offline | Check the server's Discord or website |
| Server is full | Wait and try again |
| Version mismatch | Update Minecraft to the latest version |
| Banned on the server | Contact the server's support — not a BedrockConnect issue |
Quick test: try connecting to a different server. If that works, the problem is with the specific server, not with BedrockConnect.
Resource pack problems
| Problem | Solution |
|---|---|
| Pack doesn't load | Clear cache: Minecraft → Settings → Storage → Cached Data → delete server packs |
| "Incompatible packs" error | Clear cache (Settings → Storage → Cached Data), restart Minecraft, then rejoin |
| Wrong format | Only .zip / .mcpack for Bedrock Edition. Java packs won't work |
| Lag or crashes | Pack resolution too high for your console — use a lighter pack or subpack |
"Something went wrong"
If you see this error when starting a server:
This usually means something is blocking the app from working properly. Try these fixes in order:
- Close the app completely — swipe it away, don't just minimize it. Then reopen and try again.
- Restart your phone — a full restart fixes most cases.
- Close other networking apps — apps like Lunar Proxy, BedrockTogether, or similar tools interfere with BedrockConnect. They cannot run at the same time. Close them completely before using BedrockConnect.
BedrockConnect does not work while apps like Lunar Proxy or BedrockTogether are running. Make sure they are fully closed — not just in the background.
App won't open or crashes
- Update to the latest version of the app
- Restart your phone
- Reinstall the app — your server list is tied to your account, nothing gets lost
None of this helped?
Join the Discord and describe your issue. Include:
- What console you're using
- What phone you're using (Android/iOS)
- What you've already tried
- Any error messages you see
The team and community are active and can usually help quickly.