https://github.com/kriation/docker-minecraft-bedrock
Minecraft Bedrock server on Ubuntu
https://github.com/kriation/docker-minecraft-bedrock
bedrock docker minecraft
Last synced: about 1 month ago
JSON representation
Minecraft Bedrock server on Ubuntu
- Host: GitHub
- URL: https://github.com/kriation/docker-minecraft-bedrock
- Owner: kriation
- Created: 2018-10-25T01:53:10.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2021-12-13T02:23:40.000Z (over 3 years ago)
- Last Synced: 2025-02-13T01:53:51.711Z (3 months ago)
- Topics: bedrock, docker, minecraft
- Language: Dockerfile
- Homepage:
- Size: 9.77 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Minecraft Bedrock on Ubuntu
This repository contains the required artifacts to build a Minecraft Bedrock
container image that is designed to run using container orchestration best
practices. By design, the entrypoint script tests for the existance of container
environment variables and applies them to the server.properties required for
server startup. This process ensures that the container can be customized at
instantiation versus requiring a rebuild of the image.
## Usage
The minimal requirements to run the container are:
```
[~] docker run -P -v [hostdir]:/opt/bedrock/worlds kriation/minecraft-bedrock:latest
```
This will instantiate a container exposing the service port (default 19132/udp)
to a random host port and creating a bind mount to a host directory (as
specified by replacing [hostdir]) against the worlds directory inside of the
running container. The bind mount of the worlds directory provides the ability
to backup the contents from the host (or through another container).
## Customization
At instantiation, the container can be customized by passing any of the
variables below:
| Environment Variable | Minecraft Server Property | Default Value |
| -------------------- | ------------------------- | ------------- |
| BEDROCK_SERVER_NAME | server-name | Dedicated Server |
| BEDROCK_GAMEMODE | gamemode | survival |
| BEDROCK_DIFFICULTY | difficulty | easy |
| BEDROCK_CHEATS | allow-cheats | false |
| BEDROCK_MAXPLAYERS | max-players | 10 |
| BEDROCK_ONLINE | online-mode | true |
| BEDROCK_WHITELIST | white-list | false |
| BEDROCK_IPV4_PORT | server-port | 19132 |
| BEDROCK_VIEWDIST | view-distance | 32 |
| BEDROCK_TICKDIST | tick_distance | 4 |
| BEDROCK_PLAYERTO | player-idle-timeout | 30 |
| BEDROCK_MAXTHREADS | max-threads | 8 |
| BEDROCK_LEVELNAME | level-name | Bedrock Level |
| BEDROCK_LEVELSEED | level-seed | |
| BEDROCK_DEFAULTPERM | default-player-permission-level | member |
| BEDROCK_TEXTUREPACK | texturepack-required | false |
## Caveats
If you modify the service port using BEDROCK_IPV4_PORT at container
instantiation time (versus at container build time), then you will have to
export the port manually. For example, if I change the service port to 19100,
then I will have to instantiate the container with the following:
```
[~] docker run -e BEDROCK_IPV4_PORT=19100 -p 19100:19100/udp -v [hostdir]:/opt/bedrock/worlds
kriation/minecraft-bedrock:latest
```