Minecraft:Bedrock Dedicated Server

File:Bedrock Dedicated Server Icon.png

The BDS logo

Bedrock Dedicated Server (or BDS for short) is the server software used to host a Template:BE Minecraft:server. It is distributed by Mojang and can be downloaded free of charge. It is available for Windows and Linux, and has both a release and a preview version.

Contents

The server software is distributed as a ZIP archive, which includes initial data, including the primary Minecraft:server.properties configuration file, and the executable. The software keeps data in the working directory, and expects the initial data to be present there.

Directory structure

• Template:File
  • Template:File: Default Minecraft Minecraft:behavior pack directory.
  • Template:File
    • Template:File
      • Template:File: A list of allowed Minecraft:scripting modules.
  • Template:File
    • Template:File
  • Template:File: Contains some resources for the server.
    • Template:File: JSON files containing resources (such as animations and render controllers) for attachables like Minecraft:armor and some Minecraft:weapons.
    • Template:File
      • Template:File: Server disconnection messages with codewords and URLs.
      • Template:File: Contains disconnection message when a player from Minecraft:Minecraft Education attempts to connect to the server.
    • Template:File: JSON files affecting Minecraft:feature placement during world generation, similar to the directory in Minecraft:behavior packs.
    • Template:File: JSON files affecting feature generation, similar to the directory in behavior packs.
    • Template:File: JSON files containg default settings and UUIDs for all nine default Minecraft:characters.
    • Template:File: JSON files containing layouts for the Minecraft:Dressing Room.
    • Template:File: JSON files containing spawn settings for all different Minecraft:raid waves.
  • Template:File: Custom Minecraft:behavior pack directory for worlds. Generated on the first run.
  • Template:File: Custom Minecraft:resource pack directory for worlds. Generated on the first run.
  • Template:File: Generated on the first run.
  • Template:File: Only Linux. Generated on the first run.
  • Template:File: Only Linux. Generated on the first run.
  • Template:File: Default Minecraft Minecraft:resource pack directory.
  • Template:File: Only Linux. Generated on the first run.
    • Template:File: Only Linux. Generated on the first run.
  • Template:File: Generated on the first run.
  • Template:File: Generated on the first run. May generate a world with the Template:Cd of Minecraft:server.properties simultaneously.
  • Template:File: Specifies players that are whitelisted.
  • Template:File (Linux) or Template:File (Windows): Server software executable.
  • Template:File: HTML manual describing how to use the server software.
  • Template:File: Only Linux, a log file. Generated on the first run.
  • Template:File: Generated on the first run. Requires to stop the server normally.
  • Template:File: Specifies the sending limit of packets.
  • Template:File: Specifies Minecraft:player permissions.
  • Template:File: Contains a list of words for filtering the profanity.
  • Template:File: Contains some notes and links to changelogs and the bug tracker.
  • Template:File: Primary configuration file.

Files are part of the distributed archive if not mentioned otherwise.

System requirements

Operating system

Windows: Windows 10 version 10.0.15063 or later, or Windows Server 2016 or later

Linux: Only Ubuntu 22.04 or later is officially supported, but the program will run on any Linux distribution for the x86-64 architecture that has correct libraries installed (including glibc 2.35 or later).

Processor

A minimum of a dual core CPU. Highly recommended to have a quad-core x86/64 bit processor that can run at least 3 GHz or higher, Intel i5 Ivy Bridge processor or newer, AMD FX-4100 or higher. Minimum requirements are Intel Core i3 3210, or AMD A8 7600 APU or equivalent.

Memory

4 GB of memory minimum. May require more memory with more than 10 players at the same time. Generally, Bedrock Edition does not seem to be as memory hungry as Java Edition. Unlike with Java Edition server software, there is no way to specify initial startup and maximum memory values.

Internet speed

A speed of 5 Mbps upload and 10 Mbps download per 10 players. A DSL connection will likely not have the bandwidth to run a server over the internet. An internet connection is not required to host a server on a LAN.

Network

An ethernet connection tends to be faster and more stable than a Wi-Fi connection. 100 Mbps Ethernet is acceptable. Gigabit LAN is not required.

The computer hosting the server should be assigned a static IP address on the network, rather than using DHCP.

To allow clients to connect to the server over the internet, the port used by the server needs to be forwarded.

Storage

180 MB free storage space is required, but 1 GB is recommended when using multiple or large worlds.

Connection

Template:Seealso BDS uses UDP, unlike Java Edition which uses TCP. The default port for IPv4 is 19132 and the default port for IPv6 is 19133; these can be changed in Template:Cd. Players on the Xbox, PlayStation, and Nintendo Switch versions can only connect through a custom DNS or a LAN connection.

Community resources

Plugin Support software

LeviLamina is an unofficial mod loader designed to provide essential API support for Minecraft Bedrock Edition. It features a comprehensive API, a range of utility interfaces, a powerful event system, and extensive support for basic interfaces. LeviLamina offers a solid foundation for augmenting Minecraft with additional gameplay features and functionalities, making the modding process effortless through its user-friendly development environment and flexible approach. It supports Windows client and server.

LiteLoaderBDS [Defunct as of 2024] was an unofficial plugin loader that provides basic API support for Bedrock Dedicated Server, with a massive API, a lot of packed utility interfaces, a rich event system and powerful basic interface support. With LiteLoaderBDS and plugins, it is easy to extend the functionality of BDS, the associated development is easy to learn, and the development approach is flexible.

BDSX [Defunct as of 2024] was a modification of Minecraft Bedrock Dedicated Server, supporting node.js. Because it is based on the official BDS software, it includes all the features of vanilla Minecraft, but includes other features as well, such as hooking functions and packets to change behavior.

Endstone is a modern plugin loader that provides a high-level plugin API for Bedrock Dedicated Servers, supporting both Python and C++. It allows developers to extend Bedrock Dedicated Servers without the hassle of dealing with low-level hooks. Endstone users will benefit from all vanilla features and native support for both Windows and Linux.

Startup and maintenance scripts

• BDSAddonInstaller A node.js tool used for automatically installing, updating, and uninstalling addons/packs.
• MCscripts systemd units and scripts for backups, automatic updates, and posting logs to chat bots
• MinecraftBedrockServer Sets up a Minecraft Bedrock dedicated server on Ubuntu / Debian / Raspbian / Armbian with options for automatic updates, backups and running automatically at startup
• MCBEPlay MCBEPlay is primarily a Windows 10 GUI for the official BDS System, that enables you to control and manage your Minecraft Bedrock Edition Server with little to no knowledge of server systems. It also has automatic backups, can save automatically, and has auto restarts.
• WinMSSScripts WinMSSScripts is a basic batch file to help create maintain backups of your worlds and log files as you run the official BDS System on Windows systems.
• MC-BDS-PWSH Updates Minecraft Bedrock Dedicated Server with PowerShell.

Download

Minecraft Education

Release versions

Download
1.21.132.1	Windows	Linux
1.21.133.2	Windows	Linux
1.26.32.0	Windows	Linux

Preview versions

Download
1.21.110.1	Windows	Linux
1.21.131.1	Windows	Linux
1.26.30.0	Windows	Linux

Limitations

This server software has some limitations compared to regular Bedrock Edition multiplayer or the Java Edition Minecraft:server.jar:<ref>https://feedback.minecraft.net/hc/en-us/community/posts/360059965732-Expand-Bedrock-Dedicated-Server-BDS-Configuration-Customization-Options</ref>

• The Template:Cmd command cannot reload the server like the Java server to prevent the server from crashing. As a result, the server needs to be restarted every time the server settings are readjusted, or plug-ins are added.
• Doesn't have a server invite system that allows in-game Minecraft:friends, including from consoles, to connect like Minecraft:Realms.
• Doesn't support Minecraft:remote console (RCON), which allows sending Minecraft:commands remotely from external sources.
• Doesn't support Minecraft:SRV record for a domain name, which allows connecting to a server using an Template:W without specifying a port manually.
• Doesn't support setting the server's Minecraft:message of the day (MOTD), even though the feature itself is supported by the Bedrock client, as seen in Bedrock Edition's server list.
• The server has poor support of community Minecraft:mods or plugins, unlike Java Edition, which has a larger community and matured over the years, e.g., Spigot and PaperMC. Additionally, players may resort to GeyserMC, which allows cross-compatibility for Bedrock Edition players to join a Java Edition server.
  • An alternative to plugins is the Minecraft:Scripting API provided by Minecraft:add-ons.
• The performance of BDS is poor on some multi-core server CPUs with low clock speed. On the contrary, some high clock speed desktop CPUs with stronger single core performance are more suitable for running BDS.
• In the case of high load (for example, a large number of entities accumulate / load complex chunks), sometimes the server suddenly has a very low CPU utilization, but the whole server is stuck.

History

Template:Main Template:Expand section The server follows the client's release cycle, though some hotfixes are brought exclusively to the server.

See also

• Minecraft:server.jar - the server software used to host a Template:JE server.
• Minecraft:Realms - the official server-hosting service which internally uses BDS.

External links

• Download page
• Bug tracker
• Tutorial