You decide which services we may enable for analytics, personalization, and external content.
We use cookies and similar technologies on our website to personalize content, embed external media, and better understand how individual areas are used.
Necessary cookies
These entries support essential functions such as security, stability, and form processing.
Optional sections
AnalyticsMarketingPersonalizationExternal media
Your data may be processed with your consent or on the basis of legitimate interests. In the cookie settings, you can reject or explicitly allow each optional category.
Some services process personal data in third countries. By consenting, you also agree to this transfer. You can find more information in our Privacy Policy.
You can reopen and change your selection at any time. · 1.0.2
Learn how to fix common issues with your Minecraft Bedrock game server—from connection and version problems to add-ons and worlds → Find out more
10 November 20265 min read0 Views0 helpful
Introduction
Can't find your Minecraft Bedrock Edition game server, can't connect with friends on console, or an add-on won't load? Don't worry—most issues have a simple cause. Here we'll show you the most common problems and how to fix them yourself in no time.
FAQ
Frequently asked questions
The wrong port is often the cause. Use the exact port shown in the Overview, not the default port 19132, and check that the console displays Server started.
The connection to the server can't be established at the network level. The most common cause is the transport=raknet entry in server.properties: current Bedrock versions only connect via NetherNet. Leave transport and server-udp-ports unchanged, then restart the server.
The Allow List is enabled, and your Gamertag isn't on it. Add yourself in the console with allowlist add or turn off the Allow List.
Restart the server after installing the add-on, and check that it's compatible with your server version and listed for the currently loaded world. Many add-ons require both a Behavior Pack and a Resource Pack.
Your server loads the folder specified in the World folder startup parameter. If it doesn't exist in the worlds folder, the server creates a new world. Enter the exact name of your world folder.
You can't add your own servers by IP address on Xbox, PlayStation, or Switch. This is a limitation of the game, not an issue with your server.
Feedback
Was this article helpful?
Your feedback helps us prioritize and improve content.
0 of 0 Users found this article helpful.
Personal support
Need more help than the guide provides?
Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.
Navigation
Minecraft Bedrock Edition
Problems and solutions
The most helpful tool when troubleshooting is your game server's console. It shows you what your server does when it starts, which world it opens, which packs it loads, and whether it displays an error message. When your server is ready, you'll see Server started. there.
Connection
Connection fails or takes forever
Check the Overview to see whether your server is online and whether Server started. appears in the Console.
Enter the IP address and port exactly as shown in the Overview. Your server usually doesn't use the default port 19132.
Delete any old server entry from your list and add it again with the current details.
Minecraft Bedrock only connects when the game and server are running the same version. If your game is outdated, update it in your device's store. If your game is newer than your server, the server will be updated to the new version with the next server update. You can check whether automatic updates are enabled in the Overview under Update settings. If your server isn't keeping up, contact our support team.
“Terracotta,” “Door,” or “Kelp” error code
Minecraft Bedrock displays these codes when it can't establish a connection to your server at the network level. Since version 1.26.51, Bedrock players connect via NetherNet. In addition to the port shown in the Overview, your server uses other UDP ports, which ZapX sets up for you automatically. Here's what to do:
Enter the IP address and port from the Overview exactly as shown in the game. Delete any old server entry and add it again.
Leave the transport and server-udp-ports entries in server.properties unchanged. If it says transport=raknet, players using current versions can't join and will see the “Terracotta” code.
Check that your game and server are running the same version.
Restart your server and try again.
If the code still appears, contact our support team with the code and the time you tried to connect.
“You are not invited to play on this server”
The Allow List is enabled, and the player isn't on it. Add them in the Console with allowlist add Gamertag, or set the Allow List to false in the configuration and restart the server. Learn more in our Server configuration guide.
Player is denied entry because they aren't signed in
If Online Mode is set to true, all players must be signed in to the game with their Microsoft account. Ask the player to sign in to the game and try again.
Friends on Xbox, PlayStation, or Switch can't join
Minecraft on consoles doesn't let you add your own server using an IP address. Console players can only join the featured partner servers and Realms. This is a limitation of the game, not an issue with your server. Workarounds using third-party tools are possible, but neither Mojang nor we support them, and they often stop working for a while after game updates.
Add-ons and worlds
Add-on won't load
An add-on only works if its folder is in behavior_packs or resource_packsand it's listed in your world's world_behavior_packs.json or world_resource_packs.json file. If you install it from the Add-ons tab, ZapX takes care of both steps for you. Then check the following:
Did you restart your server after installing the add-on?
Is the add-on compatible with your server version? Older add-ons don't always work with newer versions.
Is your server still loading the same world? Add-ons are added to the world that was active during installation.
Does the add-on require another pack? Many add-ons consist of a Behavior Pack and a Resource Pack, and both need to be enabled.
If you installed it manually, check the pack_id and version entries using our Install addons guide.
An empty world appears after a restart
Your server loads the world from the folder specified in the World folder startup parameter. If that folder doesn't exist in the worlds folder, your server creates a new world. Check the exact name of your world folder in the Savegames tab, then enter that name under World folder. Capitalization and spaces must match.
Uploaded world won't load
The world folder must be directly inside the worlds folder and contain, among other things, the level.dat file and the db folder. If it's inside another folder, such as one created when extracting an archive, your server won't find the world. Stop your server before uploading. Find the step-by-step instructions in our Import your own world guide.
Changes to server.properties are gone after a restart
Your server writes values such as the server name, game mode, difficulty, or Allow List to server.properties from the Startup parameters every time it starts. So make these changes in the Startup parameters section of the Configuration tab.
Performance
Server lags or mobs move slowly
First lower the Tick Distance, then lower the View Distance. Large farms and lots of animals in a small area put additional strain on the server. Keep an eye on the usage under Statistics and upgrade your server if needed.
DDoS and other network threats
Game servers can be targeted by attacks that flood the server with traffic and cause lag or dropped connections. ZAP-Hosting offers built-in protection systems to protect your server against common attacks. If you suspect an attack, contact our support team.
Preventive measures
Regular backups can save you a lot of stress. We already back up your game server automatically every day. With the ZapX Pass, you can also create your own backups at any time and restore them with a click—with ZapX Pass Pro, you can even schedule them automatically. Before making major changes, such as adding new add-ons, download your world from the Savegames tab as well.
Conclusion
These steps should help you solve your issue. If they don't, don't hesitate to contact our support team—we're here every day and happy to help! 🙂
Server hosting from €2.49 / month, online instantly, DDoS protection included.
Preferred source on Google
