itzg/docker-minecraft-bedrock-server

Add support for importing local mcworld files

Open

#585 opened on Dec 21, 2025

View on GitHub
 (6 comments) (0 reactions) (0 assignees)Shell (295 forks)github user discovery
enhancementhelp wanted

Repository metrics

Stars
 (1,793 stars)
PR merge metrics
 (PR metrics pending)

Description

  • Specified by user by an environment variable such as IMPORT_MCWORLD
  • Would be a container path to the file
  • Docs could suggest mounting a host directory to a container path such as /worlds
  • Contents of mcworld would be unzipped. If the resulting level directory already exists, skip the rest with a logged warning.
  • Identifies level name
  • Sets level name environment variable to be provided to properties file management

Contributor guide

Research direction
Inspect the Dockerfile and entrypoint script to understand how environment variables like IMPORT MCWORLD are currently processed. Look for existing import logic and add a block that unzips the mcworld file, checks if the resulting level directory exists, and sets the level name environment variable.
Tech stack
shelldocker
Domain
backenddevops
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
DockerShell
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
65