Troubleshooting
Quick checks
Before reading further, try these. They fix most problems:
| Check | How | |
|---|---|---|
| 1 | Phone and console on the same Wi-Fi network | Same router at home. No VPN, no mobile data, no guest network. 2.4 GHz and 5 GHz both work |
| 2 | BedrockConnect is up to date (4.0.88 or newer) | Update it in the App Store or on Google Play |
| 3 | Minecraft is up to date on your console | Check for game updates on your console |
| 4 | Connection helper is on | App Settings tab → Connection helper (it's on by default) — what it does |
| 5 | iPhone/iPad: Local Network is allowed | See the iOS tab below |
| 6 | Keep the app open until you're in the world | Don't switch apps or lock your phone while you join — leaving the app stops the server |
| 7 | Restart everything | Restart your phone and console (a full restart, not sleep mode). Then open BedrockConnect, tap Start (or Ad & Start) and keep the app open |
We know it sounds obvious. But a full restart of your phone and console, then starting the server again in the app, fixes a lot of problems. Do this before anything else.
Older Android versions had bugs with Xbox and PlayStation. They are fixed since 4.0.83 — update BedrockConnect to 4.0.88 on Google Play. There is no "Network Transport" setting anymore, so you don't need to change anything else.
Server doesn't show up in the world list
You tapped Start, but the BedrockConnect LAN world is not in Minecraft's Worlds tab? If the quick checks didn't help, work through these:
- iOS
- Android
- Network issues
- Switch
Local Network permission
BedrockConnect needs Local Network access to reach your console. The app asks for it during the welcome screens ("Allow Local Network"). If it's off, you'll see the error "Local network access needed".
If you accidentally denied it or never saw the popup:
iPhone Settings → scroll down to BedrockConnect → enable Local Network
You can also get there from the app: Settings tab → Community & Support → Local Network permission. Then restart the app.
Nothing to allow
Android doesn't need any extra permission. Make sure you're on 4.0.88 or newer, then check the quick checks and the Network issues tab.
Your network might be blocking it
Your phone and console have to talk to each other directly. Some networks stop that:
| Setting | Fix |
|---|---|
| Different networks | Phone and console must be on the same home network (same router). It doesn't matter if one uses 2.4 GHz and the other 5 GHz |
| Guest network | Guest networks keep devices apart — use your main Wi-Fi |
| AP isolation / Client isolation | Must be off in your router settings |
| Mesh systems / Wi-Fi extenders | Some keep devices apart — try connecting both devices to the main router |
| VPN on your phone | Turn it off |
| School / hotel / office Wi-Fi | These almost always block devices from talking to each other — use your home network |
Nintendo Switch
The Switch finds BedrockConnect as a LAN world, just like Xbox and PlayStation. It works with Android and iOS — you don't need to change any DNS settings.
If you changed your Switch's DNS settings for BedrockConnect in the past, set them back to Automatic: System Settings → Internet → Internet Settings → your Wi-Fi → Change Settings → DNS Settings → Automatic.
Server still not showing up? Try this:
- Close Minecraft completely on your console — not just the home menu, really quit the game
- Make sure BedrockConnect is up to date (4.0.88 or newer)
- Start the server in the app again and keep the app open
- Open Minecraft again and check the Worlds tab
Errors when joining a server
When you join, two things happen:
- Your console joins the BedrockConnect LAN world on your phone.
- BedrockConnect sends you on to the real server. From here, your console talks directly to the server — BedrockConnect is not a proxy.
Errors can happen in either step. The app keeps showing Stop either way — the error only shows up on your console.
First: is it your setup or the server?
Two quick tests tell you:
- Try another server. Join a Partner or Featured server through BedrockConnect. If that works, your setup is fine — the problem is the server you wanted to join.
- Check the WorldName. On the error screen, press Show Details and look at the WorldName:
| WorldName | What it means |
|---|---|
| BedrockConnect | It went wrong before or while you were sent to the server. Go through the steps below. If nothing helps, send us your connection log |
| Anything else | You were already on the server. The problem comes directly from the server — only the server's team can fix it. Contact the server's support |
"Unable to connect to world"
This means your console couldn't reach the world it tried to join. Do these steps in order:
- Same network: phone and console on the same home Wi-Fi (see Network issues)
- Keep the app open on your phone until you're in the world. Switching apps or locking the phone stops the server
- Connection helper is on: Settings tab → Connection helper
- iPhone/iPad: Local Network is allowed (see the iOS tab)
- Update BedrockConnect (4.0.88 or newer) and Minecraft
- Try another server — if other servers work, the problem is that one server
"Door" or "Terracotta"
These error codes mean your console was sent to the server, but the server's "front door" for joining didn't answer in a way consoles accept:
| Error | What usually happened |
|---|---|
| Terracotta | The server ignored your console's secure "Can I come in?" knock |
| Door | A website answered instead of the game server |
Both come from how the server is set up, not from your console. The Connection helper can fix many of these servers:
- Turn on Connection helper (Settings tab → Connection helper)
- Phone and console on the same Wi-Fi
- Start the server again and keep the app open until you're in the world
Still the same error? Then the server has a setup problem only its owner can fix. Tell the server's team, and point them to our server owners page.
Xbox stuck on "Locating server" or an "InitialConnection" error
These happened a lot with old app versions. Update BedrockConnect to 4.0.88 or newer, then start the server again. If it still happens, your network is probably keeping devices apart — check the Network issues tab above or try a different home network.
Other common causes
| Cause | Fix |
|---|---|
| "Unknown host" | The IP address or domain you entered is wrong or doesn't exist. Double-check the server's IP and make sure you typed it correctly |
| Server is offline | Check the server's Discord or website |
| Server is full | Wait and try again |
| Version mismatch / "Outdated" | See below |
| Banned on the server | Contact the server's support, not BedrockConnect |
| Server is broken or crashing | Nothing you can do — wait for the server owner to fix it |
Version mismatch
Your Minecraft and the server must be on matching versions. There are two cases:
- Your Minecraft is older than the server → update Minecraft on your console.
- The server is older than your Minecraft (for example, the server still runs an old version after a new Minecraft update came out) → only the server owner can fix this by updating the server. Wait until they do.
"Offline" or "Status unavailable" on a server
Every server in the list shows a small status pill:
| Pill | What it means |
|---|---|
| "Checking…" | The app is still asking the server |
| A people icon with a number, like 12 | The server answered — it's online, and this many players are on it |
| "Offline" | The server didn't answer. It may be down, or it only supports old connection types that consoles can't use anymore |
| "Status unavailable" | The app couldn't check — for example, the address doesn't exist or your phone's internet had a problem |
You can still tap Start on a server that shows "Offline" — the pill doesn't block you. But if a server stays "Offline", it probably won't work. Check the server's Discord or website. For "Status unavailable", check your phone's internet and the server address. All statuses are also explained on the app messages page.
Resource pack problems
| Problem | Solution |
|---|---|
| Pack doesn't load | Clear the server pack cache and rejoin |
| "Incompatible packs" error | Clear cache, 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 |
How to clear the server pack cache
Sometimes Minecraft holds on to an old server pack and your texture pack won't load properly. Clearing the cache forces Minecraft to re-download the pack from BedrockConnect.
- PlayStation
- Xbox & Switch
- Open Minecraft on your PlayStation
- Go to Settings → Storage → Cached Data
- Delete all the server packs listed there

On Xbox and Switch it's much simpler — just close Minecraft completely and reopen it. The server pack cache is cleared automatically when you restart the game.
"Something went wrong"
If you see this error in the app:

Something unexpected happened. 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 Minecraft helper apps — apps like Lunar Client or BedrockTogether can get in the way. Close them completely before using BedrockConnect.
Still there? Send us your connection log.
"Port already in use"
"Another app is using the connection port. Close apps like Lunar Client or BedrockTogether and try again. If it still doesn't work, restart your device."
Another app on your phone is using the port BedrockConnect needs. Close apps like Lunar Client or BedrockTogether completely, then try again. Still not working? Restart your phone.
BedrockConnect does not work while apps like Lunar Client or BedrockTogether are running. Make sure they are fully closed — not just in the background.
"Local network access needed" (iOS)
BedrockConnect isn't allowed to use your local network. Tap Open Settings and turn on Local Network — see the iOS tab above — and try again.
Ad errors
Free users watch a short ad when they tap "Ad & Start". If the ad can't be shown, you'll see one of these:
| Error | What to do |
|---|---|
| "Ad Blocked" | Something on your phone or network is blocking ads — usually an ad blocker or a private DNS. Turn it off (see below) and try again |
| "Ad Choices Needed" | You haven't made your ad choices yet. Tap Retry and make your choices |
| "Ad Load Failed" | The ad couldn't load — see below |
"Ad Load Failed"

This means the ad couldn't load. The most common causes:
| Cause | Fix |
|---|---|
| Ad blocker active | Disable any ad blocker app or browser-based blocker, then try again |
| VPN running | Turn off your VPN — some VPNs block ad networks |
| Custom DNS (e.g. AdGuard, Pi-hole, NextDNS) | Switch your DNS back to automatic or use 8.8.8.8 (Google) or 1.1.1.1 (Cloudflare) |
| Private DNS on Android | Go to Settings → Network → Private DNS → set to Off or Automatic |
| Firewall or parental controls | Check if something on your network blocks ad traffic |
Settings → Wi-Fi → tap the ⓘ next to your network → Configure DNS → set to Automatic.
Settings → Network & Internet → Private DNS → set to Off. Or: Settings → Wi-Fi → tap your network → Advanced → IP Settings → Static → set DNS to 8.8.8.8.
With Premium, you don't watch ads at all — this error won't happen. If you're seeing this frequently, consider upgrading.
Texture pack errors
| Error | What it means | What to do |
|---|---|---|
| "Too Many Packs" | You reached the maximum number of texture packs | Remove a pack you don't use, then try again |
| "Pack Too Large" | The pack is bigger than the maximum size | Use a smaller pack (lower resolution) |
| "Invalid Pack" | The file isn't a valid Minecraft Bedrock pack | Use a .zip or .mcpack made for Bedrock Edition — Java packs don't work |
| "Server Not Supported" | This server (or game mode) doesn't support texture packs | Tap "Continue without packs" to play without your packs |
"Server Already Listed"
You tried to add a custom server that's already in the Partner or Featured list. Just pick it from there instead.
App won't open or crashes
- Update to the latest version of the app
- Restart your phone
- Still broken? Reinstall the app — but read this first:
Your custom servers and imported texture packs are saved only on your phone. If you uninstall the app, they're gone. Write down your server addresses first.
Premium is not lost: after reinstalling, tap Restore Purchases in the Settings tab.
Other messages in the app
Seeing a message that's not on this page, like "Update Required", "Try Again Later" or "Too Many Devices"? The app messages page explains every message and what to do.
Still stuck? Send us your connection log
If nothing here helped, we can look at what happened:
- Try to join once more, so the problem is in the log
- In the app: Settings tab → Community & Support → Copy connection log — step-by-step guide
- Join the Discord, open a support ticket and paste the log into that ticket
Also tell us:
- What console you're using
- What phone you're using (Android/iOS) and your BedrockConnect version
- Which server you tried to join
- The exact error on your console (a photo of the Show Details screen helps a lot)
- What you've already tried
The connection log can contain IP addresses. Only paste it into your BedrockConnect support ticket — never into a public channel.
The team and community are active and can usually help quickly.