Bedrock server guide: setup, add-ons and players
Run Vanilla Bedrock for the real Bedrock experience, or Nukkit/PocketMine-MP for plugins. Bedrock uses UDP, add-ons go in the world folder, and players join with address and port.
- Difficulty:
- Intermediate
- Time:
- 10 minutes
On this page
A Bedrock server is for players on Minecraft Bedrock Edition: Windows (the Microsoft Store / Xbox app version), Android, iPhone and consoles. On Endercloud you can run Vanilla Bedrock (Mojang's official server) or community software like Nukkit and PocketMine-MP. Bedrock software is chosen in Settings → Change Egg, not in the Versions tab (which is for Java software).
Switch your server to Bedrock
Make a backup in Backups (switching can remove your Java files).
Go to Settings, find Change Egg, choose Vanilla Bedrock, Nukkit or PocketmineMP and click Apply.
Keep Reinstall Server on. Turn on Wipe Server Files for a clean start (recommended when coming from Java). Confirm.
Wait for Running Installer to finish, then click Start and watch the Console.
To go back to Java, use Change Egg again and pick Paper (or another Java egg), then choose the version in the Versions tab. Full details: How to reinstall or change your server type.
Which Bedrock software?
Vanilla Bedrock (recommended): plays exactly like Bedrock single-player and Realms. Supports add-ons (behaviour and resource packs). No traditional plugins.
Nukkit (Java-based) and PocketMine-MP (PHP-based): support their own plugins and are popular for minigame servers. They can take time to support a new Bedrock version, and parts of vanilla gameplay (mob AI, redstone, world generation) are missing or different.
Have both Java and Bedrock players? Run a Java server (Paper) with Geyser instead. Bedrock players can join it, and Java players too. A Bedrock server cannot accept Java players. See Geyser and Floodgate crossplay.
Keep the version up to date
Bedrock clients update automatically, and a client can only join a server on the same version. If players see "Outdated server", the server needs updating. Make a backup and download it, then look in the Startup tab: if there is a version variable, set it to the version you need (or latest) and run Settings → Reinstall Server. Reinstalling can delete or change files, which is why the backup matters. If you are unsure, open a ticket and our team will update it with you.
Ports and joining
Bedrock uses UDP, not TCP. Your server's port is set by the panel; do not change
server-portinserver.properties.Players add the server in the Servers tab with the address and port in separate fields. SRV records do not work on Bedrock, so a free subdomain will not help Bedrock players.
Consoles cannot add custom servers directly. See How to join a Minecraft server for workarounds.
Important server.properties settings
Setting | What it does |
|---|---|
| The name shown in the server list. |
| Default game mode and difficulty. |
| Must be |
| Only players on the allow list can join. |
| Requires players to be signed in with a Microsoft (Xbox) account. Keep it on. |
|
|
| World folder name inside |
| Forces players to download the world's resource packs. |
| Lower these if the server lags. |
Edit them in Properties or in server.properties with Files, then restart.
Allow list and operators
Run these in the panel Console (Vanilla Bedrock):
allowlist on
allowlist add Steve
allowlist remove Steve
allowlist list
op Steve
deop Steve
kick Steve Please read the rulesNames are Xbox gamertags. The allow list is saved in allowlist.json and operator levels in permissions.json. There is no ban command on Vanilla Bedrock, so use the allow list to keep unwanted players out.
Installing add-ons (behaviour and resource packs)
Stop the server and make a backup.
Rename the
.mcaddonor.mcpackfile to.zipand extract it on your computer. An.mcaddonusually contains two packs: a behaviour pack and a resource pack. Each pack is a folder with amanifest.json.In Files, open
worlds/<your world>. Upload behaviour pack folders intobehavior_packsand resource pack folders intoresource_packs(create these folders if they are missing).Open each pack's
manifest.jsonand note theuuidandversionfrom theheadersection.In the world folder, create or edit
world_behavior_packs.json(andworld_resource_packs.jsonfor resource packs) so it lists each pack, as in the example below. Separate several packs with commas.Start the server and check the Console for pack errors.
[
{
"pack_id": "the-uuid-from-the-header",
"version": [1, 0, 0]
}
]Easiest method: create a world in single-player with the add-ons (and any experimental toggles they need) already applied, export it as .mcworld, and upload it. The packs and the JSON files come with it. See How to upload your own world.
Plugins on Nukkit and PocketMine-MP
Upload plugins to the plugins folder in Files and restart. Nukkit plugins are .jar files; PocketMine-MP plugins are .phar files. Plugins for one do not work on the other, or on Java servers.
Frequently asked questions
"Unable to connect to world" on Bedrock
Check that the server is online, the address and port are in separate fields, and your game version matches the server. See Connection timed out or refused.
Can I use my own domain for a Bedrock server?
Yes, with an A or CNAME record, but players still type the port separately. See Use a domain with a Bedrock server.
Commands don't work in game
Set allow-cheats=true, restart, and make sure you are an operator (op YourGamertag in the console).
Was this article helpful?
Related articles
Pick the right plan for your player count, plugins and modpacks — with a plan comparison table and chart.
Bedrock ignores SRV records, so point your domain at the server with an A or CNAME record and have players type the port. For no port at all, ask about a dedicated IP.
Databases → New Database → name it → Create Database. Then copy the endpoint, username and password into plugins like LuckPerms or CoreProtect, or into your bot.
Get a free short subdomain for Java players, connect your own domain, or ask for a dedicated IP so everyone can join without typing a port.
