itzg/docker-minecraft-bedrock-server
Docker Minecraft Bedrock Server
This project provides a containerized environment for hosting and managing dedicated Minecraft Bedrock multiplayer servers. It functions as a portable image that automates the deployment lifecycle, including the automatic retrieval and installation of the latest server binaries upon container startup.
The system distinguishes itself through its reliance on environment variables to dynamically generate server configurations and manage game parameters. It includes built-in support for automated asset injection, allowing for the seamless deployment of behavior and resource packs, alongside integrated tools for scheduling remote backups of game world data to ensure persistence.
The platform covers a broad range of administrative and operational capabilities, including granular player access control through whitelisting and permission management. It supports flexible deployment patterns, ranging from single-instance hosting to orchestrated clusters within containerized infrastructure, while providing mechanisms for secure network connectivity and direct console access for administrative commands.
Features
- Containerized Server Deployments - Provides a containerized environment for hosting multiplayer game servers with automated version updates.
- Minecraft Server Orchestrators - Provides a specialized containerized environment for deploying and managing Minecraft Bedrock servers with automated updates.
- Game World Backups - Scheduling and executing the transfer of game world data to remote storage to ensure persistence and disaster recovery.
- Persistent Volume Mapping - Ensures game world and configuration persistence by mapping host-mounted volumes to the container filesystem.
- Dedicated Server Deployments - Deploys a dedicated game server that automatically updates to the latest software version upon startup.
- Containerized Server Orchestrators - Automates the deployment and configuration of containerized game server instances using environment variables.
- Container Lifecycle Management - Automates the retrieval, verification, and deployment of server binaries upon every container startup.
- Game Server Images - Provides a portable container image that simplifies game server deployment through automated file management and environment variables.
- System Data Backup Schedules - Schedules and executes automated transfers of game world data to remote cloud storage for disaster recovery.
- Game Server Settings - Adjusts game parameters like difficulty and world generation settings through environment-variable-driven configuration.
- Server Lifecycle Commands - Provides utility scripts and console attachment methods to send administrative commands to the running server.
- Networking and Connectivity - Exposes dedicated UDP ports for network traffic with patches to resolve common dual-stack connectivity issues.
- Custom Addon Deployments - Merges custom behavior and resource packs into the server environment automatically on every container start.
- Addon Installers - Automatically deploys behavior and resource packs by unpacking archives into the server directory during startup.
- Permission Managers - Assigns operator, member, or visitor status to players to maintain granular access control over server features.
- Username Whitelist Access Control - Limits player connections to an approved list of users by matching identifiers against a whitelist.
- Game - Manages player whitelists and operator status to restrict server access and maintain a secure environment.
- Environment Variable-Based Configuration - Dynamically generates server configuration files at runtime by mapping environment variables to native property formats.
- Environment Asset Injection - Automatically unpacks and injects behavior and resource packs into the server directory during container initialization.
