Skip to main content

Troubleshooting

Quick checks​

Before reading further, try these. They fix most problems:

CheckHow
1Phone and console on the same Wi-Fi networkSame router at home. No VPN, no mobile data, no guest network. 2.4 GHz and 5 GHz both work
2BedrockConnect is up to date (4.0.88 or newer)Update it in the App Store or on Google Play
3Minecraft is up to date on your consoleCheck for game updates on your console
4Connection helper is onApp Settings tab → Connection helper (it's on by default) — what it does
5iPhone/iPad: Local Network is allowedSee the iOS tab below
6Keep the app open until you're in the worldDon't switch apps or lock your phone while you join — leaving the app stops the server
7Restart everythingRestart your phone and console (a full restart, not sleep mode). Then open BedrockConnect, tap Start (or Ad & Start) and keep the app open
Seriously — restart first

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.

Android users on 4.0.71 or 4.0.79

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:

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.

Server still not showing up? Try this:

  1. Close Minecraft completely on your console — not just the home menu, really quit the game
  2. Make sure BedrockConnect is up to date (4.0.88 or newer)
  3. Start the server in the app again and keep the app open
  4. Open Minecraft again and check the Worlds tab

Errors when joining a server​

When you join, two things happen:

  1. Your console joins the BedrockConnect LAN world on your phone.
  2. 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:
WorldNameWhat it means
BedrockConnectIt 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 elseYou 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:

  1. Same network: phone and console on the same home Wi-Fi (see Network issues)
  2. Keep the app open on your phone until you're in the world. Switching apps or locking the phone stops the server
  3. Connection helper is on: Settings tab → Connection helper
  4. iPhone/iPad: Local Network is allowed (see the iOS tab)
  5. Update BedrockConnect (4.0.88 or newer) and Minecraft
  6. 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:

ErrorWhat usually happened
TerracottaThe server ignored your console's secure "Can I come in?" knock
DoorA 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:

  1. Turn on Connection helper (Settings tab → Connection helper)
  2. Phone and console on the same Wi-Fi
  3. 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​

CauseFix
"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 offlineCheck the server's Discord or website
Server is fullWait and try again
Version mismatch / "Outdated"See below
Banned on the serverContact the server's support, not BedrockConnect
Server is broken or crashingNothing 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:

PillWhat it means
"Checking…"The app is still asking the server
A people icon with a number, like 12The 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​

ProblemSolution
Pack doesn't loadClear the server pack cache and rejoin
"Incompatible packs" errorClear cache, restart Minecraft, then rejoin
Wrong formatOnly .zip / .mcpack for Bedrock Edition. Java packs won't work
Lag or crashesPack 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.

  1. Open Minecraft on your PlayStation
  2. Go to Settings → Storage → Cached Data
  3. Delete all the server packs listed there
Clearing server pack cache in Minecraft settings
Settings → Storage → Cached Data → delete server packs

"Something went wrong"​

If you see this error in the app:

Something went wrong error in BedrockConnect
"Something went wrong" error

Something unexpected happened. Try these fixes in order:

  1. Close the app completely — swipe it away, don't just minimize it. Then reopen and try again.
  2. Restart your phone — a full restart fixes most cases.
  3. 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.

Important

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:

ErrorWhat 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"​

Ad Load Failed error
"Ad Load Failed" — ads can't load on your device

This means the ad couldn't load. The most common causes:

CauseFix
Ad blocker activeDisable any ad blocker app or browser-based blocker, then try again
VPN runningTurn 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 AndroidGo to Settings → Network → Private DNS → set to Off or Automatic
Firewall or parental controlsCheck if something on your network blocks ad traffic
How to change your DNS on iPhone

Settings → Wi-Fi → tap the ⓘ next to your network → Configure DNS → set to Automatic.

How to change your DNS on Android

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.

Premium users

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​

ErrorWhat it meansWhat to do
"Too Many Packs"You reached the maximum number of texture packsRemove a pack you don't use, then try again
"Pack Too Large"The pack is bigger than the maximum sizeUse a smaller pack (lower resolution)
"Invalid Pack"The file isn't a valid Minecraft Bedrock packUse 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 packsTap "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​

  1. Update to the latest version of the app
  2. Restart your phone
  3. Still broken? Reinstall the app — but read this first:
Reinstalling deletes your custom servers

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:

  1. Try to join once more, so the problem is in the log
  2. In the app: Settings tab → Community & Support → Copy connection log — step-by-step guide
  3. 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 log contains addresses

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.