itzg / itzg/docker-minecraft-server

Container unhealthy due to ping failures - Paper 1.19.4 on image 2025.12.1

Open
#3,847 1 comment 0 reactions 0 assignees View on GitHub
bug status/needs triage
Dominant language
Shell
Stars
14.3k
Forks
1.9k
Avg merge
2d 10h
Merged PRs (30d)
31

Description

### Describe the problem

The latest image (2025.12.1) was throwing the following error for me and showing unhealthy status for the container. This is on Paper 1.19.4. Rolling back to image 2025.12.0 fixes it.

`failed to ping localhost:25565 : Received invalid packet. Expected #0, got #26`

### Container definition

```
docker run -d \
--name minecraft \
--cpus="2.0" \
-p 25565:25565 \
-p 8123:8123 \
-v /home/ubuntu/minecraft:/data \
-e EULA=TRUE \
-e SERVER_NAME=xxx \
-e ENABLE_RCON=true \
-e MOTD="xxx" \
-e DIFFICULTY=hard \
-e ENABLE_WHITELIST=true \
-e ENFORCE_WHITELIST=true \
-e WHITELIST=xxx \
-e OPS=xxx \
-e FORCE_GAMEMODE=true \
-e GENERATE_STRUCTURES=true \
-e ANNOUNCE_PLAYER_ACHIEVEMENTS=true \
-e ONLINE_MODE=true \
-e SEED="-6467775105471627794" \
-e SPAWN_PROTECTION=1 \
-e PVP=true \
-e TZ=America/New_York \
-e MEMORY=5G \
-e TYPE=PAPER \
-e USE_AIKAR_FLAGS=true \
-e VERSION=1.19.4 \
-e ENABLE_AUTOPAUSE=false \
-e UID=1001 \
-e GID=1001 \
--restart=always \
itzg/minecraft-server
```

### Container logs

```
failed to ping localhost:25565 : Received invalid packet. Expected #0, got #26
```

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by comparing image 2025.12.1 with the working 2025.12.0 and inspect the container health check that pings localhost:25565. Reproduce with Paper 1.19.4 using the provided docker run configuration, then verify that the container reports healthy without the invalid-packet error.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, java
Domain
devops, infrastructure
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
32/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.