chown knockd to minecraft user

.github/ISSUE_TEMPLATE/bug.yml

@@ -11,9 +11,9 @@ body:
         
         Please double check some things first:
         1. Do you just have a question about something? If so, asking in the [Q&A Discussions](https://github.com/itzg/docker-minecraft-server/discussions/categories/q-a) or asking on [the Discord server](https://discord.gg/DXfKpjB) would be best.
-        2. Did you **re-pull the newest image** and confirmed the issue after that? Run `docker pull <image>` or if using a compose file, it's as easy as running `docker compose pull`. If using Kubernetes, add `imagePullPolicy: Always` to the container. 
-        4. Is this bug happening after the `[init]` prefixed logs and after the log that says "Starting the Minecraft server"? If so, please report the bug with Mojang or the respective server provider.
-        5. Are you seeing a performance problem? If so, that is typically outside the scope of this image. Ask a question as above or contact the respective server provider.
+        2. Did you re-pull the newest image using `docker pull`? 
+        3. Is this bug happening after the `[init]` prefixed logs and after the log that says "Starting the Minecraft server"? If so, please report the bug with Mojang or the respective server provider.
+        4. Are you seeing a performance problem? If so, that is typically outside the scope of the image setup mechanims. Ask a question as above or contact the respective server provider.
   - type: textarea
     id: problem
     attributes:

.github/dependabot.yml

@@ -21,4 +21,3 @@ updates:
           - "*"
         update-types:
           - patch
-          - minor

.github/workflows/build-multiarch.yml

@@ -10,7 +10,6 @@ on:
       - "*.md"
       - "docs/**"
       - "examples/**"
-      - "notes/**"
 
 jobs:
   build:
@@ -20,61 +19,73 @@ jobs:
         # NOTE: the "latest" variant is identified in the Docker meta step's 'latest' config
         variant:
           - java21-graalvm
-          - java21
-          - java21-alpine
+          - java20
+          - java20-alpine
           - java17
           - java17-graalvm
           - java17-jdk
+          - java17-openj9
           - java17-alpine
           - java8
           - java8-graalvm-ce
+          - java8-multiarch
           - java8-openj9
           - java8-jdk
-          - java8-alpine
           - java11
+          - java11-openj9
+          - java11-jdk
         include:
         # JAVA 21:
           - variant: java21-graalvm
             baseImage: container-registry.oracle.com/graalvm/jdk:21-ol8
             platforms: linux/amd64,linux/arm64
-            mcVersion: latest
-          - variant: java21
-            baseImage: eclipse-temurin:21-jre
+            mcVersion: 1.20.2
+        # JAVA 20:
+          - variant: java20
+            baseImage: eclipse-temurin:20-jre
             platforms: linux/amd64,linux/arm64
-            mcVersion: latest
-          - variant: java21-alpine
-            baseImage: eclipse-temurin:21-jre-alpine
-            platforms: linux/amd64,linux/arm64
-            mcVersion: latest
+            mcVersion: 1.19.3
+          - variant: java20-alpine
+            baseImage: eclipse-temurin:20-jre-alpine
+            platforms: linux/amd64
+            mcVersion: 1.19.3
         # JAVA 17:
           - variant: java17
             # jammy doesn't work until minecraft updates to https://github.com/netty/netty/issues/12343
             baseImage: eclipse-temurin:17-jre-focal
             platforms: linux/amd64,linux/arm/v7,linux/arm64
-            mcVersion: 1.20.4
+            mcVersion: 1.18.2
           - variant: java17-graalvm
             baseImage: container-registry.oracle.com/graalvm/jdk:17-ol8
             platforms: linux/amd64,linux/arm64
-            mcVersion: 1.20.4
+            mcVersion: 1.18.2
           - variant: java17-jdk
             baseImage: eclipse-temurin:17-focal
             platforms: linux/amd64,linux/arm/v7,linux/arm64
-            mcVersion: 1.20.4
+            mcVersion: 1.18.2
+          - variant: java17-openj9
+            baseImage: ibm-semeru-runtimes:open-17-jre
+            platforms: linux/amd64,linux/arm64
+            mcVersion: 1.18.2
           - variant: java17-alpine
             baseImage: eclipse-temurin:17-jre-alpine
             platforms: linux/amd64
-            mcVersion: 1.20.4
+            mcVersion: 1.18.2
         # JAVA 11:
           - variant: java11
             baseImage: adoptopenjdk:11-jre-hotspot
             platforms: linux/amd64,linux/arm/v7,linux/arm64
             mcVersion: 1.16.5
+          - variant: java11-jdk
+            baseImage: adoptopenjdk:11-jdk-hotspot
+            platforms: linux/amd64,linux/arm/v7,linux/arm64
+            mcVersion: 1.16.5
+          - variant: java11-openj9
+            baseImage: ibm-semeru-runtimes:open-11-jre
+            platforms: linux/amd64,linux/arm64
+            mcVersion: 1.16.5
         # JAVA 8: NOTE: Unable to go past 8u312 because of Forge dependencies
           - variant: java8
-            baseImage: eclipse-temurin:8u312-b07-jre-focal
-            platforms: linux/amd64,linux/arm/v7,linux/arm64
-            mcVersion: 1.12.2
-          - variant: java8-alpine
             baseImage: openjdk:8-jre-alpine3.9
             platforms: linux/amd64
             mcVersion: 1.12.2
@@ -82,6 +93,10 @@ jobs:
             baseImage: ghcr.io/graalvm/graalvm-ce:java8
             platforms: linux/amd64
             mcVersion: 1.12.2
+          - variant: java8-multiarch
+            baseImage: eclipse-temurin:8u312-b07-jre-focal
+            platforms: linux/amd64,linux/arm/v7,linux/arm64
+            mcVersion: 1.12.2
           - variant: java8-jdk
             baseImage: eclipse-temurin:8u312-b07-jdk-focal
             platforms: linux/amd64,linux/arm64
@@ -91,20 +106,20 @@ jobs:
             platforms: linux/amd64,linux/arm64
             mcVersion: 1.12.2
     env:
-      IMAGE_TO_TEST: "${{ github.repository_owner }}/minecraft-server:test-${{ matrix.variant }}-${{ github.run_id }}"
+      IMAGE_TO_TEST: ${{ github.repository_owner }}/minecraft-server:test-${{ matrix.variant }}-${{ github.run_id }}
       HAS_IMAGE_REPO_ACCESS: ${{ secrets.DOCKER_USER != '' && secrets.DOCKER_PASSWORD != '' }}
-      MAIN_VARIANT: java21
-    runs-on: ubuntu-22.04
+      MAIN_VARIANT: java17
+    runs-on: ubuntu-20.04
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.1.6
+        uses: actions/checkout@v4.1.0
         with:
           # for build-files step
           fetch-depth: 0
 
       - name: Docker meta
         id: meta
-        uses: docker/metadata-action@v5.5.1
+        uses: docker/metadata-action@v5.0.0
         with:
           # NOTE for forks: if your Docker Hub organization doesn't match your Github repo's,
           # then the use of ${{ github.repository_owner }} will need to be replaced.
@@ -122,8 +137,6 @@ jobs:
             type=raw,value=stable,enable=${{ github.ref_type == 'tag' && matrix.variant == env.MAIN_VARIANT }}            
             # apply the variant as a moving tag for most recent commit per variant
             type=raw,value=${{ matrix.variant }},enable=${{ github.ref_name == github.event.repository.default_branch }}
-            # for backward compatibility with users referencing java8-multiarch, this will set an extra label on java8
-            type=raw,value=java8-multiarch,enable=${{ matrix.variant == 'java8' && github.ref_name == github.event.repository.default_branch }}
           # NOTE this identifies which variant will be published as "latest", which isn't
           # necessarily the newest version of Java
           flavor: |
@@ -132,13 +145,13 @@ jobs:
             org.opencontainers.image.authors=Geoff Bourne <itzgeoff@gmail.com>
 
       - name: Setup Docker Buildx
-        uses: docker/setup-buildx-action@v3.3.0
+        uses: docker/setup-buildx-action@v3.0.0
 
       - name: Set up QEMU
         uses: docker/setup-qemu-action@v3.0.0
 
       - name: Build for test
-        uses: docker/build-push-action@v5.3.0
+        uses: docker/build-push-action@v5.0.0
         with:
           platforms: linux/amd64
           tags: ${{ env.IMAGE_TO_TEST }}
@@ -161,14 +174,14 @@ jobs:
           tests/test.sh
 
       - name: Login to DockerHub
-        uses: docker/login-action@v3.1.0
+        uses: docker/login-action@v3.0.0
         if: env.HAS_IMAGE_REPO_ACCESS
         with:
           username: ${{ secrets.DOCKER_USER }}
           password: ${{ secrets.DOCKER_PASSWORD }}
 
       - name: Login to GHCR
-        uses: docker/login-action@v3.1.0
+        uses: docker/login-action@v3.0.0
         if: env.HAS_IMAGE_REPO_ACCESS
         with:
           registry: ghcr.io
@@ -176,7 +189,7 @@ jobs:
           password: ${{ github.token }}
 
       - name: Build and push
-        uses: docker/build-push-action@v5.3.0
+        uses: docker/build-push-action@v5.0.0
         if: github.actor == github.repository_owner
         with:
           platforms: ${{ matrix.platforms }}

.github/workflows/discord.yml

@@ -1,11 +1,8 @@
 name: Discord notifications
 
 on:
-  release:
-    types:
-      - published
   workflow_run:
-    workflows: ["Build and Publish"]
+    workflows: ["ContinuousIntegration", "Build and Publish", "Build and publish multiarch" ]
     types:
       - completed
 
@@ -17,26 +14,13 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 5
     steps:
-      - name: on-publish
-        if: github.event_name == 'release' && github.event.action == 'published'
-        uses: SethCohen/github-releases-to-discord@v1.15.0
-        with:
-          webhook_url: ${{ secrets.DISCORD_WEBHOOK }}
       - name: on-success
-        if: github.event.workflow_run.conclusion == 'success'
+        if: ${{ github.event.workflow_run.conclusion == 'success' }}
         uses: Ilshidur/action-discord@master
         with:
-          args: |
-            Github repo: ${{ github.repository }}
-            - Branch: ${{ github.event.workflow_run.head_branch }}
-            - [Link: to Actions](<${{ github.event.workflow_run.html_url }}>)
-            - Status: 🎉  ${{ github.event.workflow_run.conclusion }}  🍏
+          args: "Github repo: ${{ github.repository }}\n- Branch: ${{ github.event.workflow_run.head_branch }}\n- [Link: to Actions](<${{ github.event.workflow_run.html_url }}>)\n- Status: 🎉  ${{ github.event.workflow_run.conclusion }}  🍏"
       - name: on-failure
-        if: github.event.workflow_run.conclusion == 'failure'
+        if: ${{ github.event.workflow_run.conclusion == 'failure' }}
         uses: Ilshidur/action-discord@master
         with:
-          args: |
-            Github repo: ${{ github.repository }}
-            - Branch: ${{ github.event.workflow_run.head_branch }}
-            - [Link: to Actions](<${{ github.event.workflow_run.html_url }}>)
-            - Status: 🤔  ${{ github.event.workflow_run.conclusion }}  💣💥
+          args: "Github repo: ${{ github.repository }}\n- Branch: ${{ github.event.workflow_run.head_branch }}\n- [Link: to Actions](<${{ github.event.workflow_run.html_url }}>)\n- Status: 🤔  ${{ github.event.workflow_run.conclusion }}  💣💥"

.github/workflows/stale-check.yml

@@ -6,13 +6,13 @@ on:
 
 jobs:
   check:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-20.04
     permissions:
       issues: write
       pull-requests: write
     steps:
       - name: Process Stale Issues
-        uses: actions/stale@v9
+        uses: actions/stale@v8
         with:
           stale-issue-label: status/stale
           stale-pr-label: status/stale

.github/workflows/verify-pr.yml

@@ -7,7 +7,6 @@ on:
       - "*.md"
       - "docs/**"
       - "examples/**"
-      - "notes/**"
       - "docker-compose*.yml"
       - "mkdocs.yml"
 
@@ -17,45 +16,45 @@ jobs:
       fail-fast: false
       matrix:
         variant:
-          - java21
-          - java21-alpine
+          - java20
           - java17
-          - java8
+          - java17-alpine
+          - java8-multiarch
         include:
-        # JAVA 21:
-          - variant: java21
-            baseImage: eclipse-temurin:21-jre
+        # JAVA 20:
+          - variant: java20
+            baseImage: eclipse-temurin:20-jre
             platforms: linux/amd64,linux/arm64
-            mcVersion: latest
-          - variant: java21-alpine
-            baseImage: eclipse-temurin:21-jre-alpine
-            platforms: linux/amd64,linux/arm64
-            mcVersion: latest
+            mcVersion: 1.19.4
         # JAVA 17:
           - variant: java17
             # jammy doesn't work until minecraft updates to https://github.com/netty/netty/issues/12343
             baseImage: eclipse-temurin:17-jre-focal
             platforms: linux/amd64
-            mcVersion: 1.20.4
-          - variant: java8
+            mcVersion: 1.19.4
+          - variant: java17-alpine
+            baseImage: eclipse-temurin:17-jre-alpine
+            platforms: linux/amd64
+            mcVersion: 1.19.4
+          - variant: java8-multiarch
             baseImage: eclipse-temurin:8u312-b07-jre-focal
             platforms: linux/amd64
             mcVersion: 1.12.2
     env:
       IMAGE_TO_TEST: ${{ github.repository_owner }}/minecraft-server:test-${{ matrix.variant }}-${{ github.run_id }}
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-20.04
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.1.6
+        uses: actions/checkout@v4.1.0
         with:
           # for build-files step
           fetch-depth: 0
 
       - name: Setup Docker Buildx
-        uses: docker/setup-buildx-action@v3.3.0
+        uses: docker/setup-buildx-action@v3.0.0
 
       - name: Confirm multi-arch build
-        uses: docker/build-push-action@v5.3.0
+        uses: docker/build-push-action@v5.0.0
         with:
           platforms: ${{ matrix.platforms }}
           # ensure latest base image is used
@@ -65,7 +64,7 @@ jobs:
           cache-from: type=gha,scope=${{ matrix.variant }}
 
       - name: Build for test
-        uses: docker/build-push-action@v5.3.0
+        uses: docker/build-push-action@v5.0.0
         with:
           # Only build single platform since loading multi-arch image into daemon fails with
           # "docker exporter does not currently support exporting manifest lists"

.readthedocs.yaml

@@ -1,4 +1,5 @@
 # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
 version: 2
 
 build:

Dockerfile

@@ -1,6 +1,6 @@
 # syntax = docker/dockerfile:1.3
 
-ARG BASE_IMAGE=eclipse-temurin:21-jre
+ARG BASE_IMAGE=eclipse-temurin:17-jre-focal
 FROM ${BASE_IMAGE}
 
 # hook into docker BuildKit --platform support
@@ -9,46 +9,38 @@ ARG TARGETOS
 ARG TARGETARCH
 ARG TARGETVARIANT
 
-ARG FORCE_INSTALL_PACKAGES=1
-RUN --mount=target=/build,source=build \
-    TARGET=${TARGETARCH}${TARGETVARIANT} /build/run.sh install-packages
-
 RUN --mount=target=/build,source=build \
     /build/run.sh setup-user
 
+RUN --mount=target=/build,source=build \
+    TARGET=${TARGETARCH}${TARGETVARIANT} /build/run.sh install-packages
+
 COPY --chmod=644 files/sudoers* /etc/sudoers.d
 
 EXPOSE 25565
 
-ARG APPS_REV=1
-ARG GITHUB_BASEURL=https://github.com
-
-ARG EASY_ADD_VERSION=0.8.5
-ADD ${GITHUB_BASEURL}/itzg/easy-add/releases/download/${EASY_ADD_VERSION}/easy-add_${TARGETOS}_${TARGETARCH}${TARGETVARIANT} /usr/bin/easy-add
+ARG EASY_ADD_VER=0.8.0
+ADD https://github.com/itzg/easy-add/releases/download/${EASY_ADD_VER}/easy-add_${TARGETOS}_${TARGETARCH}${TARGETVARIANT} /usr/bin/easy-add
 RUN chmod +x /usr/bin/easy-add
 
-ARG RESTIFY_VERSION=1.7.2
 RUN easy-add --var os=${TARGETOS} --var arch=${TARGETARCH}${TARGETVARIANT} \
-  --var version=${RESTIFY_VERSION} --var app=restify --file {{.app}} \
-  --from ${GITHUB_BASEURL}/itzg/{{.app}}/releases/download/{{.version}}/{{.app}}_{{.version}}_{{.os}}_{{.arch}}.tar.gz
+  --var version=1.7.0 --var app=restify --file {{.app}} \
+  --from https://github.com/itzg/{{.app}}/releases/download/{{.version}}/{{.app}}_{{.version}}_{{.os}}_{{.arch}}.tar.gz
 
-ARG RCON_CLI_VERSION=1.6.6
 RUN easy-add --var os=${TARGETOS} --var arch=${TARGETARCH}${TARGETVARIANT} \
-  --var version=${RCON_CLI_VERSION} --var app=rcon-cli --file {{.app}} \
-  --from ${GITHUB_BASEURL}/itzg/{{.app}}/releases/download/{{.version}}/{{.app}}_{{.version}}_{{.os}}_{{.arch}}.tar.gz
+  --var version=1.6.2 --var app=rcon-cli --file {{.app}} \
+  --from https://github.com/itzg/{{.app}}/releases/download/{{.version}}/{{.app}}_{{.version}}_{{.os}}_{{.arch}}.tar.gz
 
-ARG MC_MONITOR_VERSION=0.12.11
 RUN easy-add --var os=${TARGETOS} --var arch=${TARGETARCH}${TARGETVARIANT} \
-  --var version=${MC_MONITOR_VERSION} --var app=mc-monitor --file {{.app}} \
-  --from ${GITHUB_BASEURL}/itzg/{{.app}}/releases/download/{{.version}}/{{.app}}_{{.version}}_{{.os}}_{{.arch}}.tar.gz
+  --var version=0.12.3 --var app=mc-monitor --file {{.app}} \
+  --from https://github.com/itzg/{{.app}}/releases/download/{{.version}}/{{.app}}_{{.version}}_{{.os}}_{{.arch}}.tar.gz
 
-ARG MC_SERVER_RUNNER_VERSION=1.12.1
 RUN easy-add --var os=${TARGETOS} --var arch=${TARGETARCH}${TARGETVARIANT} \
-  --var version=${MC_SERVER_RUNNER_VERSION} --var app=mc-server-runner --file {{.app}} \
-  --from ${GITHUB_BASEURL}/itzg/{{.app}}/releases/download/{{.version}}/{{.app}}_{{.version}}_{{.os}}_{{.arch}}.tar.gz
+  --var version=1.9.0 --var app=mc-server-runner --file {{.app}} \
+  --from https://github.com/itzg/{{.app}}/releases/download/{{.version}}/{{.app}}_{{.version}}_{{.os}}_{{.arch}}.tar.gz
 
-ARG MC_HELPER_VERSION=1.38.15
-ARG MC_HELPER_BASE_URL=${GITHUB_BASEURL}/itzg/mc-image-helper/releases/download/${MC_HELPER_VERSION}
+ARG MC_HELPER_VERSION=1.36.1
+ARG MC_HELPER_BASE_URL=https://github.com/itzg/mc-image-helper/releases/download/${MC_HELPER_VERSION}
 # used for cache busting local copy of mc-image-helper
 ARG MC_HELPER_REV=1
 RUN curl -fsSL ${MC_HELPER_BASE_URL}/mc-image-helper-${MC_HELPER_VERSION}.tgz \

bin/mc-send-to-console

@@ -2,11 +2,6 @@
 . "/start-utils"
 : "${CONSOLE_IN_NAMED_PIPE:=/tmp/minecraft-console-in}"
 
-if isFalse "${CREATE_CONSOLE_IN_PIPE:-false}"; then
-  echo "ERROR: console pipe needs to be enabled by setting CREATE_CONSOLE_IN_PIPE to true"
-fi
-
-
 if [ $# = 0 ]; then
   echo "ERROR: pass console commands as arguments"
   exit 1

build/alpine/install-packages.sh

@@ -34,6 +34,4 @@ curl -fsSL -o /tmp/knock.tar.gz https://github.com/Metalcape/knock/releases/down
 tar -xf /tmp/knock.tar.gz -C /usr/local/ && rm /tmp/knock.tar.gz
 ln -s /usr/local/sbin/knockd /usr/sbin/knockd
 setcap cap_net_raw=ep /usr/local/sbin/knockd
-
-# Set git credentials
-echo -e "[user]\n       name = Minecraft Server on Docker\n     email = server@example.com" >> /etc/gitconfig
+chown minecraft /usr/local/sbin/knockd

build/ol/install-packages.sh

@@ -18,15 +18,13 @@ enabled=1
 EOF
 dnf update -y
 
-dnf install -y \
-  ImageMagick \
+dnf install -y ImageMagick \
   file \
   sudo \
   net-tools \
   iputils \
   curl \
   git \
-  git-lfs \
   jq \
   dos2unix \
   mysql \
@@ -42,11 +40,6 @@ dnf install -y \
   findutils \
   which
 
-curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.rpm.sh | sudo bash
-dnf update -y
-dnf install -y \
-  git-lfs
-
 bash /build/ol/install-gosu.sh
 
 # Patched knockd
@@ -54,6 +47,4 @@ curl -fsSL -o /tmp/knock.tar.gz https://github.com/Metalcape/knock/releases/down
 tar -xf /tmp/knock.tar.gz -C /usr/local/ && rm /tmp/knock.tar.gz
 ln -s /usr/local/sbin/knockd /usr/sbin/knockd
 setcap cap_net_raw=ep /usr/local/sbin/knockd
-
-# Set git credentials
-echo -e "[user]\n       name = Minecraft Server on Docker\n     email = server@example.com" >> /etc/gitconfig
+chown minecraft /usr/local/sbin/knockd

build/ubuntu/install-packages.sh

@@ -29,11 +29,6 @@ apt-get install -y \
   libpcap0.8 \
   webp
 
-curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash
-apt-get update
-apt-get install -y \
-  git-lfs
-
 apt-get clean
 
 # Patched knockd
@@ -41,7 +36,5 @@ curl -fsSL -o /tmp/knock.tar.gz https://github.com/Metalcape/knock/releases/down
 tar -xf /tmp/knock.tar.gz -C /usr/local/ && rm /tmp/knock.tar.gz
 ln -s /usr/local/sbin/knockd /usr/sbin/knockd
 setcap cap_net_raw=ep /usr/local/sbin/knockd
+chown minecraft /usr/local/sbin/knockd
 find /usr/lib -name 'libpcap.so.0.8' -execdir cp '{}' libpcap.so.1 \;
-
-# Set git credentials
-echo -e "[user]\n	name = Minecraft Server on Docker\n	email = server@example.com" >> /etc/gitconfig

docker-compose-mkdocs.yml

@@ -4,6 +4,8 @@
 #
 # and then access http://localhost:8000
 
+version: "3.8"
+
 services:
   mkdocs:
     build:

docker-compose.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server

docs/commands.md

@@ -19,9 +19,7 @@ docker exec mc rcon-cli stop
 
 _The `-i` is not needed in this case._
 
-## When RCON is disabled
-
-If rcon is disabled you can send commands by passing them as arguments to the packaged `mc-send-to-console` script after setting the env var `CREATE_CONSOLE_IN_PIPE` to "true". For example, a player can be op'ed in the container `mc` with: 
+If rcon is disabled you can send commands by passing them as arguments to the packaged `mc-send-to-console` script. For example, a player can be op'ed in the container `mc` with: 
 
 ```shell
 docker exec mc mc-send-to-console op player
@@ -29,26 +27,9 @@ docker exec mc mc-send-to-console op player
             +- container name     +- Minecraft commands start here
 ```
 
-## Enabling interactive console
+In order to attach and interact with the Minecraft server, add `-it` when starting the container, such as
 
-In order to attach and interact with the Minecraft server make sure to enable TTY and keep stdin open.
-
-!!! example
-
-    With `docker run` use the `-it` arguments:
-
-    ```shell
     docker run -d -it -p 25565:25565 --name mc itzg/minecraft-server
-    ```
-
-    or with a compose file:
-
-    ```yaml
-    services:
-      minecraft:
-        stdin_open: true
-        tty: true
-    ```
 
 With that you can attach and interact at any time using
 
@@ -56,6 +37,9 @@ With that you can attach and interact at any time using
 
 and then Control-p Control-q to **detach**.
 
-!!! info "RCON is required for fully interactive, color console"
+For remote access, configure your Docker daemon to use a `tcp` socket (such as `-H tcp://0.0.0.0:2375`)
+and attach from another machine:
 
-    RCON must be enabled, which is the default, in order to use a fully interactive console with auto-completion and colorized log output. 
+    docker -H $HOST:2375 attach mc
+
+Unless you're on a home/private LAN, you should [enable TLS access](https://docs.docker.com/articles/https/).

docs/configuration/interpolating.md

@@ -66,6 +66,7 @@ database:
 This is how your `docker-compose.yml` file could look like:
 
 ```yml
+version: "3.8"
 # Other docker-compose examples in /examples
 
 services:
@@ -100,11 +101,11 @@ secrets:
 
 ## Patching existing files
 
-JSON path based patches can be applied to one or more existing files by setting the variable `PATCH_DEFINITIONS` to the path of a directory that contains one or more [patch definition json files](https://github.com/itzg/mc-image-helper#patchdefinition) or a [patch set json file](https://github.com/itzg/mc-image-helper#patchset). 
+JSON path based patches can be applied to one or more existing files by setting the variable `PATCH_DEFINITIONS` to the path of a directory that contains one or more [patch definition json files](https://github.com/itzg/mc-image-helper#patchdefinition) or a [patch set json file](https://github.com/itzg/mc-image-helper#patchset).
 
-The `file` and `value` fields of the patch definitions may contain `${...}` variable placeholders. The allowed environment variables in placeholders can be restricted by setting `REPLACE_ENV_VARIABLE_PREFIX`, which defaults to "CFG_".
+Variable placeholders in the patch values can be restricted by setting `REPLACE_ENV_VARIABLE_PREFIX`, which defaults to "CFG_".
 
-The following example shows a patch-set file where various fields in the `paper.yaml` configuration file can be modified and added:
+The following example shows a patch-set file were various fields in the `paper.yaml` configuration file can be modified and added:
 
 ```json
 {
@@ -138,8 +139,4 @@ The following example shows a patch-set file where various fields in the `paper.
 }
 ```
 
-Supports the file formats:
-- JSON
-- JSON5
-- Yaml
-- TOML, but processed output is not pretty
+> **NOTES:** Only JSON and Yaml files can be patched at this time. TOML support is planned to be added next. Removal of comments and other cosmetic changes will occur when patched files are processed.

docs/configuration/jvm-options.md

@@ -8,47 +8,13 @@ By default, the image declares an initial and maximum Java memory-heap limit of
 - `INIT_MEMORY`: independently sets the initial heap size
 - `MAX_MEMORY`: independently sets the max heap size
 
-The values of all three are passed directly to the JVM and support format/units as `<size>[g|G|m|M|k|K]`. 
+The values of all three are passed directly to the JVM and support format/units as `<size>[g|G|m|M|k|K]`. For example:
 
-!!! example "Using docker run"
- 
-    ```
-        -e MEMORY=2G
-    ```
+    -e MEMORY=2G
 
-    or to use init and max memory:
+To let the JVM calculate the heap size from the container declared memory limit, unset `MEMORY` with an empty value, such as `-e MEMORY=""`. By default, the JVM will use 25% of the container memory limit as the heap limit; however, as an example the following would tell the JVM to use 75% of the container limit of 2GB of memory:
 
-    ```
-        -e INIT_MEMORY=1G -e MAX_MEMORY=4G
-    ```
-
-!!! example "Using compose file"
-     
-    ```
-        environment:
-          MEMORY: 2G
-    ```
-
-    or to use init and max memory:
-
-    ```
-        environment:
-          INIT_MEMORY: 1G
-          MAX_MEMORY: 4G
-    ```
-
-To let the JVM calculate the heap size from the container declared memory limit, unset `MEMORY` with an empty value, such as `-e MEMORY=""`. By default, the JVM will use 25% of the container memory limit as the heap limit; however, as an example the following would tell the JVM to use 75% of the container limit of 4GB of memory:
-
-!!! example "MaxRAMPercentage using compose file"
-
-    ```
-        environment:
-          MEMORY: ""
-          JVM_XX_OPTS: "-XX:MaxRAMPercentage=75"
-        deploy:
-          limits:
-            memory: 4G  
-    ```
+     -e MEMORY="" -e JVM_XX_OPTS="-XX:MaxRAMPercentage=75" -m 2000M
 
 !!! important
     The settings above only set the Java **heap** limits. Memory resource requests and limits on the overall container should also account for non-heap memory usage. An extra 25% is [a general best practice](https://dzone.com/articles/best-practices-java-memory-arguments-for-container).
@@ -96,30 +62,11 @@ you can use
 
 ## Enable Remote JMX for Profiling
 
-To enable remote JMX, such as for profiling with VisualVM or JMC, set the environment variable `ENABLE_JMX` to "true", set `JMX_HOST` to the IP/host running the Docker container, and add a port forwarding of TCP port 7091, such as:
+To enable remote JMX, such as for profiling with VisualVM or JMC, add the environment variable `ENABLE_JMX=true`, set `JMX_HOST` to the IP/host running the Docker container, and add a port forwarding of TCP port 7091, such as:
 
-!!! example
-
-    With `docker run`
-
-    ```
-    -e ENABLE_JMX=true -e JMX_HOST=$HOSTNAME -p 7091:7091
-    ```
-
-If needing to map to a different port, then also set the environment variable `JMX_PORT` to the desired host port.
-
-!!! example
-
-    With a compose file:
-    
-    ```yaml
-    environment:
-      ENABLE_JMX: true
-      JMX_HOST: ${HOSTNAME}
-      JMX_PORT: "7092"
-    ports:
-      - "7092:7092"
-    ```
+```
+-e ENABLE_JMX=true -e JMX_HOST=$HOSTNAME -p 7091:7091
+```
 
 ## Enable Aikar's Flags
 

docs/configuration/misc-options.md

@@ -41,9 +41,21 @@ See [Custom worlds directory path](../misc/world-data.md#custom-worlds-directory
 
 ## Interactive and Color Console
 
-When RCON is enabled, which is the default, and [TTY](https://docs.docker.com/compose/compose-file/05-services/#tty) is enabled on the container, then some server types will output colorized logs and provide a fully interactive console. To access the interactive console, use [`docker attach`](https://docs.docker.com/engine/reference/commandline/container_attach/) (not `exec`). When finished, make sure to use the sequence Control-P, Control-Q to detach without stopping the container.
+If you would like to `docker attach` to the Minecraft server console with color and interactive capabilities, then add
 
-If this behavior interferes with the log content, then disable TTY or remove the setting entirely since the default is disabled. In a compose file, set the service's `tty` parameter to `false`. On the `docker run` command-line remove the `-t` argument.
+```
+  -e EXEC_DIRECTLY=true
+```
+
+> **NOTES**
+>
+> This feature doesn't work via rcon, so you will need to `docker attach` to the container. Use the sequence Ctrl-P, Ctrl-Q to detach. 
+> 
+> This will bypass graceful server shutdown handling when using `docker stop`, so be sure the server console's `stop` command.
+> 
+> Make to enable stdin and tty with `-it` when using `docker run` or `stdin_open: true` and `tty: true` when using docker compose.
+>
+> This feature is incompatible with Autopause and cannot be set when `ENABLE_AUTOPAUSE=true`.
 
 ## Server Shutdown Options
 

docs/configuration/server-properties.md

@@ -1,92 +1,32 @@
-In order to unify management of the Minecraft server container, all of the [`server.properties`](https://minecraft.wiki/w/Server.properties) entries can be managed by the environment variables described in the sections below. Some of the mappings provide additional functionality above and beyond the properties file.
+By default, the server configuration will be created and set based on the following environment variables, but only the first time the server is started. If the `server.properties` file already exists, the values in them will not be changed.
 
 If you prefer to manually manage the `server.properties` file, set `OVERRIDE_SERVER_PROPERTIES` to "false". Similarly, you can entirely skip the startup script's creation of `server.properties` by setting `SKIP_SERVER_PROPERTIES` to "true".
 
-!!! note
-  
-    To clear a server property, set the variable to an empty string, such as `-e RESOURCE_PACK=""`. An unset variable is ignored and the existing server property is left unchanged.
-
-To see what `server.properties` will get used by the server, set the environment variable `DUMP_SERVER_PROPERTIES` to "true" and the contents of `server.properties` will get output before the server starts.
-
-## Placeholders
-
-When declaring a server properties via container environment variables, those values may contain placeholders that are processed when the `server.properties` file is updated. 
-
-The syntax of placeholders is DOS-style, `%VAR%`, to avoid being processed by Docker or the shell and the following options are available:
-
-`%VAR%` or `%env:VAR%`
-
-: Replaced with the resolved value or the environment variable `VAR`
-
-`%date:FMT%`
-
-: Formats the current date/time with the given `FMT` string processed by [Java's DateTimeFormatter](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/format/DateTimeFormatter.html).
-
-Any declared or resolved environment variable may be referenced, such as `VERSION` and `TYPE`. Additionally, [Modrinth](../types-and-platforms/mod-platforms/modrinth-modpacks.md) and [Auto CurseForge](../types-and-platforms/mod-platforms/auto-curseforge.md) modpacks will expose the environment variables `MODPACK_NAME` and `MODPACK_VERSION`. The originally declared version, such as "LATEST" or "SNAPSHOT", is available in the variable `DECLARED_VERSION` 
-
-!!! example
-
-    As a compose file environment entry:
-
-    ```yaml
-        MOTD: Running %MODPACK_NAME% version %env:MODPACK_VERSION%
-        LEVEL: world-%date:yyyy-MM-dd%
-    ```
-
-!!! warning
-
-    Placeholders are not supported when manually managing `server.properties`
-
-## Properties
+> NOTE: to clear a server property, set the variable to an empty string, such as `-e RESOURCE_PACK=""`. A variables that maps to a server property that is unset, is ignored and the existing `server.property` is left unchanged. 
 
 ### Message of the Day
 
-The message of the day, shown below each server entry in the client UI, can be changed with the `MOTD` environment variable or a default is computed from the server type and version, such as
+The message of the day, shown below each server entry in the client UI, can be changed with the `MOTD` environment variable, such as
+
+    -e MOTD="My Server"
+
+If you leave it off, a default is computed from the server type and version, such as
 
     A Paper Minecraft Server powered by Docker
 
-That way you can easily differentiate between several server types you may have started.
+That way you can easily differentiate between several servers you may have started.
 
-The section symbol (§) and other unicode characters are automatically converted to allow [formatting codes](https://minecraft.wiki/w/Formatting_codes) to be used consistently with all server versions. For Minecraft versions less than 1.20, unicode characters in `server.properties` will be escaped as `\uXXXX`, by default. That behavior can be altered by setting `SERVER_PROPERTIES_ESCAPE_UNICODE` to "true" or "false".
+The section symbol (§) and other unicode characters are automatically converted to allow [formatting codes](https://minecraft.wiki/w/Formatting_codes) to be used consistently with all server versions. For example,
 
-!!! example
+     -e MOTD="A §l§cMinecraft§r §nserver"
 
-    With `docker run`
-    
-         -e MOTD="A §l§cMinecraft§r §nserver"
-    
-    or within a compose file
-    
-        environment:
-          MOTD: "A §l§cMinecraft§r §nserver"
+renders
 
-    renders
-    
-    ![](../img/motd-example.png)
+![](../img/motd-example.png)
 
-To produce a multi-line MOTD, embed a newline character as `\n` in the string, such as the following example.
+To produce a multi-line MOTD, you will need to double escape the newline such as
 
-!!! example "Multi-line MOTD"
-
-    With `docker run`
-    
-    ```
-    -e MOTD="Line one\nLine two"
-    ```
-    
-    or within a compose file
-    
-    ```yaml
-          MOTD: |
-            line one
-            line two
-    # or
-    #      MOTD: "line one\nline two"
-    ```
-
-!!! tip
-
-    You can also embed configured and resolved environment variables using [placeholders](#placeholders).
+    -e MOTD="Line one\\nLine two"
 
 ### Difficulty
 
@@ -100,8 +40,6 @@ Valid values are: `peaceful`, `easy`, `normal`, and `hard`, and an
 error message will be output in the logs if it's not one of these
 values.
 
-Refer to [the Minecraft wiki](https://minecraft.wiki/w/Difficulty)
-
 ### Whitelist Players
 
 !!! warning "For public servers" 
@@ -146,11 +84,6 @@ To change the behavior when the whitelist file already exists, set the variable
 
 To [enforce the whitelist changes immediately](https://minecraft.wiki/w/Server.properties#enforce-whitelist) when whitelist commands are used , set `ENFORCE_WHITELIST` to "true". If managing the whitelist file manually, `ENABLE_WHITELIST` can be set to "true" to set the `white-list` property.
 
-!!! tip "Changing user API provider"
-
-    The usernames provided for whitelist and ops processing are resolved using either [PlayerDB](https://playerdb.co/) or [Mojang's API](https://wiki.vg/Mojang_API#Username_to_UUID). The default uses PlayerDB, but can be changed by setting the environment variable `USER_API_PROVIDER` to "mojang". Sometimes one or the other service can become overloaded, which is why there is the ability to switch providers.
-
-
 ### Op/Administrator Players
 
 Similar to the whitelist, users can be provisioned as operators (aka administrators) to your Minecraft server by
@@ -210,13 +143,9 @@ The server icon which has been set doesn't get overridden by default. It can be
 
 RCON is **enabled by default** to allow for graceful shut down the server and coordination of save state during backups. RCON can be disabled by setting `ENABLE_RCON` to "false".
 
-!!! warning
+The default password is randomly generated if `RCON_PASSWORD` has not been set.
 
-    Disabling RCON will remove and limit some features, such as interactive and color console support.
-
-The default password is randomly generated on each startup; however, a specific one can be set with `RCON_PASSWORD`.
-
-**DO NOT MAP THE RCON PORT EXTERNALLY** unless you are aware of all the consequences and have set a **secure password** with `RCON_PASSWORD`. 
+**DO NOT MAP THE RCON PORT EXTERNALLY** unless you aware of all the consequences and have set a **secure password** with `RCON_PASSWORD`. 
 
 !!! info 
 
@@ -374,43 +303,7 @@ environment variable set to `false`, such as
 By default, a standard world is generated with hills, valleys, water, etc. A different level type can
 be configured by setting `LEVEL_TYPE` to [an expected type listed here](https://minecraft.wiki/w/Server.properties#level-type).
 
-For some of the level types, `GENERATOR_SETTINGS` can be used to further customize the world generation.
-
-To configure the `GENERATOR_SEETINGS` you need to add the appropriate `GeneratorOptions` JSON configuration. In the case of a superflat world, you may omit the `flat_world_options`.
-
-The layers are applied from -64 and up and are added in the order of the list
-
-Example for a superflat world:
-
-- 1x bedrock
-- 2x stone
-- 15x sandstone
-- Desert biome
-
-```yaml
-LEVEL_TYPE: FLAT
-GENERATOR_SETTINGS: >-4
-    {
-        "layers": [
-            {
-                "block": "minecraft:bedrock",
-                "height": 1
-            },
-            {
-                "block": "minecraft:stone",
-                "height": 2
-            },
-            {
-                "block": "minecraft:sandstone",
-                "height": 15
-            }
-        ],
-        "biome": "minecraft:desert"
-    }
-
-
-```
-For more details, check the [official wiki](https://minecraft.wiki/w/Java_Edition_level_format#generatorOptions_tag_format).
+For some of the level types, `GENERATOR_SETTINGS` can be used to further customize the world generation [as described here](https://minecraft.wiki/w/Server.properties#generator-settings).
 
 ### Custom Server Resource Pack
 

docs/data-directory.md

@@ -31,6 +31,7 @@ When attached in this way you can stop the server, edit the configuration under
 With Docker Compose, setting up a host attached directory is even easier since relative paths can be configured. For example, with the following `docker-compose.yml` Docker will automatically create/attach the relative directory `minecraft-data` to the container.
 
 ``` yaml title="docker-compose.yml"
+version: "3"
 
 services:
   mc:

docs/index.md

@@ -39,6 +39,7 @@ By default, the container will download the latest version of the "vanilla" [Min
 4. Done! Point your client at your host's name/IP address and port 25565.
 
 ```yaml
+version: "3.8"
 
 services:
   mc:

docs/misc/autopause-autostop/autopause.md

@@ -38,6 +38,8 @@ The following environment variables define the behaviour of auto-pausing:
   describes period of the daemonized state machine, that handles the pausing of the process (resuming is done independently)
 - `AUTOPAUSE_KNOCK_INTERFACE`, default `eth0`
   <br>Describes the interface passed to the `knockd` daemon. If the default interface does not work, run the `ifconfig` command inside the container and derive the interface receiving the incoming connection from its output. The passed interface must exist inside the container. Using the loopback interface (`lo`) does likely not yield the desired results.
+- `AUTOPAUSE_SUDO`, default "true"
+  specifies if the knockd service should be run via sudo in order to elevate its privileges
 
 !!! tip
 
@@ -45,9 +47,7 @@ The following environment variables define the behaviour of auto-pausing:
 
 ## Rootless Auto-Pause
 
-If you're running the container as rootless, then it is necessary to add the `CAP_NET_RAW` capability to the container, such as using [the `cap_add` service field](https://docs.docker.com/compose/compose-file/05-services/#cap_add) in a compose file or [`--cap-add` docker run argument](https://docs.docker.com/engine/reference/run/#runtime-privilege-and-linux-capabilities). It may also be necessary to set the environment variable `SKIP_SUDO` to "true". 
-
-You might need to set change the default port forwarder from RootlessKit to slirp4netns.
+If you're running the container as rootless, you might need to set change the default port forwarder from RootlessKit to slirp4netns.
 
 For Docker, see the following for setup:
 
@@ -56,9 +56,8 @@ For Docker, see the following for setup:
 
 For Podman, see the following for setup:
 - https://rootlesscontaine.rs/getting-started/podman/#changing-the-port-forwarder
+- Run with
 
-
-!!! example "Using docker run"
-
-    -e AUTOPAUSE_KNOCK_INTERFACE=tap0 --cap-add=CAP_NET_RAW --network slirp4netns:port_handler=slirp4netns
-
+  ```
+  -e AUTOPAUSE_KNOCK_INTERFACE=tap0 --cap-add=CAP_NET_RAW --network slirp4netns:port_handler=slirp4netns
+  ```

docs/misc/contributing/development.md

@@ -46,59 +46,51 @@ popd
 
 Using the baseline image, an interactive container can be started to iteratively run the scripts to be developed. By attaching the current workspace directory, you can use the local editor of your choice to iteratively modify scripts while using the container to run them.
 
-```shell
+```shell script
 docker run -it --rm -v ${PWD}:/scripts -e SCRIPTS=/scripts/ --entrypoint bash mc-dev
 ```
 
 From within the container you can run individual scripts via the attached `/scripts/` path; however, be sure to set any environment variables expected by the scripts by either `export`ing them manually:
 
-```shell
+```shell script
 export VERSION=1.12.2
 /scripts/start-magma
 ```
 
 ...or pre-pending script execution:
 
-```shell
+```shell script
 VERSION=1.12.2 /scripts/start-magma
 ```
 
-!!! note
+> NOTE: You may want to temporarily add an `exit` statement near the end of your script to isolate execution to just the script you're developing.
 
-    You may want to temporarily add an `exit` statement near the end of your script to isolate execution to just the script you're developing.
+## Using development copy of mc-image-helper
 
-## Using development copy of tools
-
-In the cloned repo, such as [`mc-image-helper`](https://github.com/itzg/mc-image-helper), create an up-to-date snapshot build of the tgz distribution using:
+In the cloned copy of [`mc-image-helper`](https://github.com/itzg/mc-image-helper), create an up-to-date snapshot build of the tgz distribution using:
 
 ```shell
 ./gradlew distTar
 ```
 
 !!! note
-
     The distribution's version will be `0.0.0-<branch>-SNAPSHOT`
 
-For Go base tools, run
+Assuming Java 18 or newer:
 
 ```shell
-goreleaser release --snapshot --clean
+cd build/distributions
+jwebserver -b 0.0.0.0 -p 8008
 ```
 
-Clone [itzg/github-releases-proxy](https://github.com/itzg/github-releases-proxy) and run it according to the instructions shown there.
-
-In the Docker build, configure the following 
+If `jwebserver` is not available, try `java -m jdk.httpserver`
 
 ```shell
---build-arg GITHUB_BASEURL=http://host.docker.internal:8080 \
---build-arg APPS_REV=1
+--build-arg MC_HELPER_VERSION=1.8.1-SNAPSHOT \
+--build-arg MC_HELPER_BASE_URL=http://host.docker.internal:8008
 ```
 
-and declare one or more version overrides, such as
-
-```
---build-arg MC_HELPER_VERSION=1.8.1-SNAPSHOT
-```
+Now the image can be built like normal, and it will install mc-image-helper from the locally built copy.
 
 ## Generating release notes
 

docs/misc/deployment/index.md

@@ -1,22 +1,12 @@
 # More Deployment Info 
 
-## On Kubernetes
-
-### Using Helm
+## Using Helm
 
 - itzg Helm Chart:
     - [GitHub repo](https://github.com/itzg/minecraft-server-charts)
       - [Helm Chart repo](https://itzg.github.io/minecraft-server-charts/)
 - [mcsh/server-deployment](https://github.com/mcserverhosting-net/charts)
 
-### Using Shulker
-
-[Shulker](https://github.com/jeremylvln/Shulker) is a Kubernetes operator for managing complex and dynamic Minecraft infrastructures, including game servers and proxies. It uses the docker-minecraft-server and docker-bungeecord images under-the-hood.
-
-## On CloudFormation (AWS)
-
-If you're looking for a simple way to deploy this to the Amazon Web Services Cloud, check out the [Minecraft Server Deployment (CloudFormation) repository](https://github.com/vatertime/minecraft-spot-pricing). This repository contains a CloudFormation template that will get you up and running in AWS in a matter of minutes. Optionally it uses Spot Pricing so the server is very cheap, and you can easily turn it off when not in use.
-
 ## Supporting Articles
 
 Below are supporting articles for server deployment.
@@ -26,3 +16,7 @@ Below are supporting articles for server deployment.
     https://dev.to/rela-v/zero-to-minecraft-server-with-docker-desktop-and-compose-500a
 
     - This is a reference guide/tutorial on how to set up a vanilla Minecraft server using this project, including step-by-step instructions, and information on topics such as port-forwarding.
+
+## Deploying onto AWS
+
+If you're looking for a simple way to deploy this to the Amazon Web Services Cloud, check out the [Minecraft Server Deployment (CloudFormation) repository](https://github.com/vatertime/minecraft-spot-pricing). This repository contains a CloudFormation template that will get you up and running in AWS in a matter of minutes. Optionally it uses Spot Pricing so the server is very cheap, and you can easily turn it off when not in use.

docs/misc/examples.md

@@ -7,6 +7,7 @@ Various examples are [maintained in the repository](https://github.com/itzg/dock
 Using the [GeyserMC plugin](https://geysermc.org/) with a Paper server (or similar) "enables clients from Minecraft Bedrock Edition to join your Minecraft Java server". The example also includes [Floodgate](https://wiki.geysermc.org/floodgate/) which "allows Xbox Live authenticated Bedrock users to join without a Java Edition account". 
 
 ```yaml
+version: "3.8"
 
 services:
   mc:
@@ -24,45 +25,4 @@ services:
       - ./data:/data
 ```
 
-[Source](https://github.com/itzg/docker-minecraft-server/blob/master/examples/geyser/docker-compose.yml)
-
-## Lazytainer - Stop Minecraft container based on traffic
-Monitors network traffic to the Minecraft containers. If there is traffic, the container runs, otherwise the container is stopped/paused.
-
-By using [Lazytainer](https://github.com/vmorganp/Lazytainer) with the [docker-minecraft-server](https://github.com/itzg/docker-minecraft-server) a somehow similar behaviour to [Lazymc](https://github.com/timvisee/lazymc) can be archived.
-
-```yaml
-services:
-  lazytainer:
-    image: ghcr.io/vmorganp/lazytainer:master
-    environment:
-      VERBOSE: false
-    ports:
-      - 25565:25565
-    volumes:
-      - /var/run/docker.sock:/var/run/docker.sock:ro
-    labels:
-      - lazytainer.group.minecraft.sleepMethod=stop
-      - lazytainer.group.minecraft.ports=25565
-      - lazytainer.group.minecraft.minPacketThreshold=2 # Start after two incomming packets
-      - lazytainer.group.minecraft.inactiveTimeout=600 # 10 minutes, to allow the server to bootstrap. You can probably make this lower later if you want.
-    restart: unless-stopped
-    network_mode: bridge
-  mc:
-    image: itzg/minecraft-server
-    environment:
-      EULA: TRUE
-      TYPE: PAPER
-      MEMORY: 4G
-    volumes:
-      - ./data:/data
-    labels:
-      - lazytainer.group=minecraft
-    depends_on:
-      - lazytainer
-    network_mode: service:lazytainer
-    tty: true
-    stdin_open: true
-    restart: unless-stopped
-```
-[Source](https://github.com/itzg/docker-minecraft-server/blob/master/examples/lazytainer/docker-compose.yml)
+[Source](https://github.com/itzg/docker-minecraft-server/blob/master/examples/geyser/docker-compose.yml)

docs/mods-and-plugins/curseforge-files.md

@@ -10,10 +10,6 @@ A specific file can be omitted from each reference to allow for auto-selecting t
 
 ## Project-file references
 
-!!! tip
-
-    Individual project files typically represent a version of the mod/plugin, but CurseForge refers to these items broadly as "files" rather than "versions". 
-
 The following formats are supported in the list of project-file references:
 
 - A project page URL, such as `https://www.curseforge.com/minecraft/mc-mods/jei`. _The newest applicable file will be automatically selected._
@@ -21,7 +17,7 @@ The following formats are supported in the list of project-file references:
 - Project slug, such as `jei`. _The newest applicable file will be automatically selected._
 - Project ID, such as `238222`. _The newest applicable file will be automatically selected._
 - Project slug or ID, `:`, and a file ID, such as `jei:4593548` or `238222:4593548`
-- Project slug or ID, `@`, and a partial filename, such as `jei@10.2.1.1005`. This option is useful to refer to a version of the mod/plugin rather than looking up the file ID.
+- Project slug or ID, `@`, and a partial filename, such as `jei@10.2.1.1005`
 
 An `@` followed by the container path to a listing file can also be provided as a project-file reference. Each line is processed as a reference where blank lines and comments that start with `#` are ignored.
 

docs/mods-and-plugins/index.md

@@ -76,7 +76,7 @@ would expand to `https://cdn.example.org/configs-v9.0.1.zip,https://cdn.example.
 
 If applying large generic packs, the update can be time-consuming. To skip the update set `SKIP_GENERIC_PACK_UPDATE_CHECK` to "true". Conversely, the generic pack(s) can be forced to be applied by setting `FORCE_GENERIC_PACK_UPDATE` to "true".
 
-The most time-consuming portion of the generic pack update is generating and comparing the SHA1 checksum. To skip the checksum generation, set `SKIP_GENERIC_PACK_CHECKSUM` to "true".
+The most time-consuming portion of the generic pack update is generating and comparing the SHA1 checksum. To skip the checksum generation, set `SKIP_GENERIC_PACK_CHECKSUM` to "true.
 
 ## Mods/plugins list
 

docs/requirements.txt

@@ -1,7 +1,9 @@
-mkdocs-material == 9.5.24
-mkdocs-autorefs == 1.0.1
-mkdocstrings == 0.25.1
+mkdocs == 1.5.3
+mkdocs-material-extensions == 1.2
+mkdocs-material == 9.4.3
+mkdocs-autorefs == 0.5.0
+mkdocstrings == 0.23.0
 mkdocs-literate-nav == 0.6.1
-mdx-gh-links == 0.4
+mdx-gh-links == 0.3.1
 mkdocs-click == 0.8.1
-mkdocs-static-i18n == 1.2.3
+mkdocs-static-i18n == 1.0.6

docs/types-and-platforms/mod-platforms/auto-curseforge.md

@@ -8,7 +8,7 @@ To manage a CurseForge modpack automatically with upgrade support, pinned or lat
 
     A CurseForge API key is **required** to use this feature. Go to their [developer console](https://console.curseforge.com/), generate an API key, and set the environment variable `CF_API_KEY`.
     
-    When entering your API Key in a docker compose file you will need to escape any `$` character with a second `$`. Refer to [this compose file reference section](https://docs.docker.com/compose/compose-file/compose-file-v3/#variable-substitution) for more information.
+    When entering your API Key in a docker compose file you will need to escape any `$` character with a second `$`.
     
     Example if your key is `$11$22$33aaaaaaaaaaaaaaaaaaaaaaaaaa`:
     ```yaml
@@ -56,6 +56,13 @@ For example:
 -e TYPE=AUTO_CURSEFORGE -e CF_SLUG=all-the-mods-8
 ```
 
+For mod, modpacks, and world files that are not allowed for automated download, the container path `/downloads` can be attached and matching files will be retrieved from there. The subdirectories `mods`, `modpacks`, and `worlds` will also be checked accordingly. To change the source location of downloaded files, set `CF_DOWNLOADS_REPO` to an existing container path. To disable this feature, set `CF_DOWNLOADS_REPO` to an empty string.
+
+!!! note "Mods need download report"
+    A file called `MODS_NEED_DOWNLOAD.txt` will be created in the `/data` directory that lists the mods that need to be manually downloaded and where to get them.
+
+If you wish to use a unpublished modpack zip, set the container path to the file in `CF_MODPACK_ZIP`. Similarly, the container path to a modpack manifest JSON can be passed to `CF_MODPACK_MANIFEST`.  In either case, **the modpack slug or page URL must still be provided**.
+
 The latest file will be located and used by default, but if a specific version is desired you can use one of the following options. With any of these options **do not select a server file** -- they lack the required manifest and defeat the ability to consistently automate startup.
 
 - Use `CF_PAGE_URL`, but include the full URL to a specific file
@@ -68,95 +75,17 @@ The following shows where to get the URL to the specific file and also shows whe
 
 The following examples all refer to version 1.0.7 of ATM8:
 
-```yaml
-  CF_PAGE_URL: https://www.curseforge.com/minecraft/modpacks/all-the-mods-8/files/4248390
+```
+-e CF_PAGE_URL=https://www.curseforge.com/minecraft/modpacks/all-the-mods-8/files/4248390
 ```
 
-```yaml
-  CF_SLUG: all-the-mods-8
-  CF_FILE_ID: "4248390"
+```
+-e CF_SLUG=all-the-mods-8 -e CF_FILE_ID=4248390
 ```
 
-```yaml
-  CF_SLUG: all-the-mods-8
-  CF_FILENAME_MATCHER: 1.0.7
 ```
-
-## Manual Downloads
-
-For mod, modpacks, and world files that are not allowed for automated download, the container path `/downloads` can be attached and matching files will be retrieved from there. The subdirectories `mods`, `modpacks`, and `worlds` will also be checked accordingly. To change the source location of downloaded files, set `CF_DOWNLOADS_REPO` to an existing container path. To disable this feature, set `CF_DOWNLOADS_REPO` to an empty string.
-
-!!! warning "Download using a browser"
-
-    It's important to use a browser to download the files listed for manual download. If your Docker host is running without a graphical interface, then you can use `scp` or similar to transfer the files to it.
-
-!!! example
-
-    Assuming Docker compose is being used:
-    
-    1. Create a directory next to the `docker-compose.yml` file. The name doesn't matter, but "downloads" is the common convention
-    2. From the "Mods Need Download" output, visit the download page of each, click on the file download and save that file into the directory created in the previous step
-    3. Add a host directory mount to the volumes section where the container path **must be** `/downloads`. The snippet below shows how that will look
-    4. Re-run `docker compose up -d` to apply the changes
-    
-    ```yaml
-        volumes:
-          ./downloads:/downloads
-    ```
-
-## Unpublished Modpacks
-
-If you wish to use an unpublished modpack zip, set the container path to the file in `CF_MODPACK_ZIP`. Similarly, the container path to a modpack manifest JSON can be passed to `CF_MODPACK_MANIFEST`.  In either case, **the modpack slug or page URL must still be provided**.
-
-!!! example
-
-    ```yaml
-    services:
-      mc:
-        image: itzg/minecraft-server
-        environment:
-          EULA: true
-          MOD_PLATFORM: AUTO_CURSEFORGE
-          # allocate from https://console.curseforge.com/ and set in .env file
-          CF_API_KEY: ${CF_API_KEY}
-          CF_MODPACK_MANIFEST: /manifests/manifest.json
-          CF_SLUG: "custom"
-        volumes:
-          - ./manifests:/manifests:ro
-    ```
-
-    where an exported manifest file should look like:
-    
-    ```json
-    {
-      "minecraft": {
-        "version": "1.20.4",
-        "modLoaders": [
-          {
-            "id": "fabric-0.15.3",
-            "primary": true
-          }
-        ]
-      },
-      "manifestType": "minecraftModpack",
-      "manifestVersion": 1,
-      "name": "Custom",
-      "author": "",
-      "files": [
-        {
-          "projectID": 351725,
-          "fileID": 4973035,
-          "required": true
-        },
-        {
-          "projectID": 306612,
-          "fileID": 5010374,
-          "required": true
-        }
-      ],
-      "overrides": "overrides"
-    }
-    ```
+-e CF_SLUG=all-the-mods-8 -e CF_FILENAME_MATCHER=1.0.7
+```
 
 ## Exclude client mods
 
@@ -174,69 +103,12 @@ If needing to iterate on the options above, set `CF_FORCE_SYNCHRONIZE` to "true"
 !!! important
     These options are provided to empower you to get your server up and running quickly. Please help out by reporting an issue with the respective mod project. Ideally mod developers should [use correct registrations for one-sided client mods](https://docs.minecraftforge.net/en/latest/concepts/sides/#writing-one-sided-mods). Understandably, those code changes may be non-trivial, so mod authors can also add "Client" to the game versions when publishing.
 
-## Excluding Overrides Files
-
-Modpack zip files typically include an `overrides` subdirectory that may contain config files, world data, and extra mod files. All of those files will be extracted into the `/data` path of the container. If any of those files, such as incompatible mods, need to be excluded from extraction, then the `CF_OVERRIDES_EXCLUSIONS` variable can be set with a comma or newline delimited list of ant-style paths ([see below](#ant-style-paths)) to exclude, relative to the overrides (or `/data`) directory. 
-
-### Ant-style paths
-
-Ant-style paths can include the following globbing/wildcard symbols:
-
-| Symbol | Behavior                                                |
-|--------|---------------------------------------------------------|
-| `*`    | Matches zero, one, or many characters except a slash    |
-| `**`   | Matches zero, one, or many characters including slashes |
-| `?`    | Matches one character                                   |
-
-!!! example
-    
-    The following compose `environment` entries show how to exclude Iris and Sodium mods from the overrides
-    
-    ```yaml
-      CF_OVERRIDES_EXCLUSIONS: mods/iris*.jar,mods/sodium*.jar
-    ```
-    
-    or using newline delimiter, which improves maintainability
-    
-    ```yaml
-      CF_OVERRIDES_EXCLUSIONS: |
-        mods/iris*.jar
-        mods/sodium*.jar
-    ```
-
-## World/Level Data
+## Extra options
 
 Some modpacks come with world/save data via a worlds file and/or the overrides provided with the modpack. Either approach can be selected to set the `LEVEL` to the resulting saves directory by setting `CF_SET_LEVEL_FROM` to either:
-
 - `WORLD_FILE`
 - `OVERRIDES`
 
-## Ignore missing files
-
-Some mods use temporary files from the modpack and delete them when finished. Others will patch themselves and "disable" the original mod jar, such as gregtech. In order to avoid the installer from detecting the absent file(s) and re-installing, those files can be ignored by passing a comma or newline delimited list to `CF_IGNORE_MISSING_FILES`.
-
-!!! hint
-
-    A warning log will indicate what files were found to be missing from the previous installation run, such as
-
-    ```
-    Re-installing due to missing files from modpack: [mods/gregtech-2.6.2-beta.jar]
-    ```
-
-!!! example
-
-    In a Compose file
-    ```yaml
-      environment:
-        CF_IGNORE_MISSING_FILES: |
-          mods/gregtech-2.6.2-beta.jar
-    ```
-
-
-## Extra options
-
 Other configuration available:
-
 - `CF_PARALLEL_DOWNLOADS` (default is 4): specify how many parallel mod downloads to perform
 - `CF_OVERRIDES_SKIP_EXISTING` (default is false): if set, files in the overrides that already exist in the data directory are skipped. **NOTE** world data is always skipped, if present.
-- `CF_FORCE_REINSTALL_MODLOADER` (default is false): this can be set to `true` to force the modpack's declared modloader, such as Forge, to be reinstalled. This is useful if some of the modloader's files become corrupted.

docs/types-and-platforms/mod-platforms/curseforge.md

@@ -1,9 +1,5 @@
 # Manual CurseForge server packs
 
-!!! warning "Deprecated"
-
-    This mod platform type is deprecated. Please use [AUTO_CURSEFORGE](auto-curseforge.md) for new deployments.
-
 Enable this server mode by setting `MOD_PLATFORM` or `TYPE` to "CURSEFORGE" along with the following specific variables.
 
 You need to specify a modpack to run, using the `CF_SERVER_MOD` environment

docs/types-and-platforms/mod-platforms/modrinth-modpacks.md

@@ -9,17 +9,11 @@ The desired modpack project is specified with the `MODRINTH_MODPACK` environment
 - The project "slug", which is located in the URL shown here:
 
   ![](../../img/modrinth-project-slug.drawio.png)
-
 - The project ID, which is located in the bottom of the left panel, shown here
 
   ![](../../img/modrinth-project-id.drawio.png)
-
 - The project page URL, such as <https://modrinth.com/modpack/cobblemon-fabric>. As described below, this can further be the page URL of a modpack's version page.
 
-- A custom URL of a hosted [mrpack file](https://support.modrinth.com/en/articles/8802351-modrinth-modpack-format-mrpack)
-
-- The container path to a local [mrpack file](https://support.modrinth.com/en/articles/8802351-modrinth-modpack-format-mrpack)
-
 ## Modpack version
 
 The automatic modpack version resolving can be narrowed in a few ways:
@@ -47,59 +41,3 @@ Some mods, such as [MCInstance Loader](https://modrinth.com/mod/mcinstance-loade
           config/mcinstanceloader/pack.mcinstance
     ```
 
-## Excluding files
-
-To exclude client mods that are incorrectly declared by the modpack as server-compatible, set `MODRINTH_EXCLUDE_FILES` to a comma or newline delimited list of partial file names to exclude. You may need to set `MODRINTH_FORCE_SYNCHRONIZE` to "true" while iterating on a compatible set of mods to use.
-
-!!! example
-
-    In a Compose file:
-    ```yaml
-      MODRINTH_EXCLUDE_FILES: |
-        notenoughanimations
-        lambdynamiclights
-        euphoriapatcher
-    ```
-
-## Force-include files
-
-To force include client mods, set `MODRINTH_FORCE_INCLUDE_FILES` to a comma or newline delimited list of partial file names. You may need to set `MODRINTH_FORCE_SYNCHRONIZE` to "true" while iterating on a compatible set of mods to use.
-
-!!! example
-
-    In a Compose file:
-    ```yaml
-      MODRINTH_FORCE_INCLUDE_FILES: |
-        yet-another-config-lib
-    ```
-
-## Excluding Overrides Files
-
-Modrinth mrpack/zip files may include an `overrides` subdirectory that contains config files, world data, and extra mod files. All of those files will be extracted into the `/data` path of the container. If any of those files, such as incompatible mods, need to be excluded from extraction, then the `MODRINTH_OVERRIDES_EXCLUSIONS` variable can be set with a comma or newline delimited list of ant-style paths ([see below](#ant-style-paths)) to exclude, relative to the overrides (or `/data`) directory.
-
-### Ant-style paths
-
-Ant-style paths can include the following globbing/wildcard symbols:
-
-| Symbol | Behavior                                                |
-|--------|---------------------------------------------------------|
-| `*`    | Matches zero, one, or many characters except a slash    |
-| `**`   | Matches zero, one, or many characters including slashes |
-| `?`    | Matches one character                                   |
-
-!!! example
-
-    The following compose `environment` entries show how to exclude Iris and Sodium mods from the overrides
-    
-    ```yaml
-      MODRINTH_OVERRIDES_EXCLUSIONS: mods/NekosEnchantedBooks-*.jar,mods/citresewn-*.jar
-    ```
-    
-    or using newline delimiter, which improves maintainability
-    
-    ```yaml
-      MODRINTH_OVERRIDES_EXCLUSIONS: |
-        mods/NekosEnchantedBooks-*.jar
-        mods/citresewn-*.jar
-    ```
-

docs/types-and-platforms/server-types/forge.md

@@ -40,7 +40,7 @@ In both of the cases above, there is no need for the `VERSION` or `FORGE_VERSION
 
 ### NeoForge
 
-Support for [NeoForge](https://neoforged.net/) is also provided. A NeoForge server can be automatically managed by setting `TYPE` to "NEOFORGE". `VERSION` specifies the Minecraft version and `NEOFORGE_VERSION` can be set to select a specific version, "latest", or "beta". By default, the latest, non-beta NeoForge version available for the requested Minecraft version will be used.
+Support for [NeoForge](https://neoforged.net/) is also provided. A NeoForge server can be automatically managed by setting `TYPE` to "NEOFORGE". `VERSION` specifies the Minecraft version and `NEOFORGE_VERSION` can be set to select a specific sub-version. By default, the latest NeoForge version available for the requested Minecraft version will be used.
 
 !!! example
 
@@ -52,6 +52,6 @@ Support for [NeoForge](https://neoforged.net/) is also provided. A NeoForge serv
     ```yaml
         environment:
           TYPE: NEOFORGE
-          VERSION: "1.20.4"
-          NEOFORGE_VERSION: "beta"
+          VERSION: "1.20.1"
+          NEOFORGE_VERSION: "47.1.79"
     ```

docs/types-and-platforms/server-types/hybrids.md

@@ -8,32 +8,8 @@ A [Magma](https://magmafoundation.org/) server, which is a combination of Forge
 
 !!! note
 
-    The Magma project has been terminated ([original link died](https://git.magmafoundation.org/magmafoundation/magma-1-20-x/-/commit/4e7abe37403c47d09b74b77bcfc26a19b18f5891), [alternate statement on their discord](https://discord.com/channels/612695539729039411/647287352833605662/1174412642962649198) ). Please use Magma Maintained for 1.12.2, 1.18.2 and 1.19.3, or Ketting for 1.20.1+.
+There are limited base versions supported, so you will also need to  set `VERSION`, such as "1.12.2", "1.16.5", etc.
 
-    There are limited base versions supported, so you will also need to  set `VERSION`, such as "1.12.2", "1.16.5", etc.
-
-### Magma Maintained
-A [Magma Maintained](https://github.com/magmamaintained/) server, which is a alternative project of Magma, can be used with
-
-    -e TYPE=MAGMA_MAINTAINED
-
-!!! note
-
-    There are limited base versions supported, so you will also need to set `VERSION`, such as "1.12.2", "1.18.2", "1.19.3", or "1.20.1".
-
-    In addition, `FORGE_VERSION` and `MAGMA_MAINTAINED_TAG` must be specified. You can find the supported `FORGE_VERSION` and `MAGMA_MAINTAINED_TAG` in a releases page for each repositories.
-
-### Ketting
-
-A [Ketting](https://github.com/kettingpowered/Ketting-1-20-x) server, which is an alternative project of Magma 1.20.1+, can be used with
-
-    -e TYPE=KETTING
-
-There are limited base versions supported, so you will also need to  set `VERSION`, such as "1.20.1" or later.
-
-`FORGE_VERSION` and `KETTING_VERSION` may be specified; however, they will be defaulted by the [Ketting launcher](https://github.com/kettingpowered/kettinglauncher) otherwise.
-Available Ketting Versions may be found at [https://github.com/kettingpowered/Ketting-1-20-x/packages/2041866/versions](https://github.com/kettingpowered/Ketting-1-20-x/packages/2041866/versions).
-The Version structure is `MinecraftVersion-ForgeVersion-KettingVersion` (e.g. `1.20.1-47.2.20-0.1.4` is for Minecraft `1.20.1`, Forge `47.2.20` and Ketting `0.1.4`).
 
 ### Mohist
 
@@ -43,7 +19,7 @@ A [Mohist](https://github.com/MohistMC/Mohist) server can be used with
 
 !!! note
 
-    There are limited base versions supported, so you will also need to  set `VERSION`, such as "1.12.2"
+There are limited base versions supported, so you will also need to  set `VERSION`, such as "1.12.2"
 
 By default the latest build will be used; however, a specific build number can be selected by setting `MOHIST_BUILD`, such as
 

docs/variables/index.md

@@ -1,11 +1,5 @@
 
-!!! warning
-
-    The variables listed on this page are manually documented and may be out-of-date or inaccurate. 
-
-    All other documentation pages are actively maintained, so please use the search box above to find the desired topic.
-
-### General options
+### **OS OPTIONS**
 <table>
     <thead>
         <tr>
@@ -114,7 +108,7 @@ alternatively, you can mount: <code>/etc/localtime:/etc/localtime:ro
     </tbody>
 </table>
 
-### Server
+### **SERVER**
 
 <table>
     <thead>
@@ -454,7 +448,7 @@ alternatively, you can mount: <code>/etc/localtime:/etc/localtime:ro
     </tbody>
 </table>
 
-### Custom resource pack
+### **CUSTOM RESOURCE PACK**
 
 <table>
     <thead>
@@ -487,7 +481,7 @@ alternatively, you can mount: <code>/etc/localtime:/etc/localtime:ro
     </tbody>
 </table>
 
-### Whitelist
+### **WHITELIST**
 
 <table>
     <thead>
@@ -526,7 +520,7 @@ alternatively, you can mount: <code>/etc/localtime:/etc/localtime:ro
     </tbody>
 </table>
 
-### RCON
+### **RCON**
 
 <table>
     <thead>
@@ -540,7 +534,7 @@ alternatively, you can mount: <code>/etc/localtime:/etc/localtime:ro
     <tbody>
         <tr>
             <td><code>ENABLE_RCON</code></td>
-            <td>Enable/disable RCON support; however, be aware that disabling RCON will remove and limit some features, such as interactive and color console support.</td>
+            <td>Should RCON be enabled</td>
             <td><code>true</code></td>
             <td>⬜️</td>
         </tr>
@@ -595,7 +589,7 @@ alternatively, you can mount: <code>/etc/localtime:/etc/localtime:ro
     </tbody>
 </table>
 
-### Auto-Pause
+### **AUTOPAUSE**
 
 !!! note
 
@@ -658,7 +652,7 @@ alternatively, you can mount: <code>/etc/localtime:/etc/localtime:ro
 
 
 
-### Auto-Stop
+### **AUTOSTOP**
 
 !!! note
 
@@ -708,11 +702,11 @@ alternatively, you can mount: <code>/etc/localtime:/etc/localtime:ro
 </table>
 
 
-### CurseForge
+### **CURSEFORGE**
 
-!!! tip
-    
-    Refer to the [main documentation page](types-and-platforms/mod-platforms/auto-curseforge.md) for more details and up-to-date information.
+!!! note
+
+     A CurseForge API key is required to use a CurseForge type server. Go to their [developer console](https://console.curseforge.com/), generate an API key, and set the environment variable CF_API_KEY
 
 <table>
     <thead>

docs/versions/java.md

@@ -1,115 +1,52 @@
-## Image tags
+## Running Minecraft server on different Java version
 
-Image references can either omit the tag, which implies the tag `latest`, such as
+!!! note
 
-    itzg/minecraft-server
+    For Forge versions less than 1.18, you _must_ use the `java8-multiarch` (or other java8) image tag.
 
-or explicitly include the tag, such as
+    In general, if you see the following line in a server startup failure, then it means you need to be using Java 8 instead of the latest image Java version:
 
-    itzg/minecraft-server:<tag>
+    ```
+    Caused by: java.lang.ClassCastException: class jdk.internal.loader.ClassLoaders$AppClassLoader 
+       cannot be cast to class java.net.URLClassLoader
+    ```
 
-where `<tag>` refers to the first column of this table:
+When using the image `itzg/minecraft-server` without a tag, the `latest` image tag is implied from the table below. To use a different version of Java, please use an alternate tag to run your Minecraft server container. The `stable` tag is similar to `latest`; however, it tracks [the most recent repository release/tag](https://github.com/itzg/docker-minecraft-server/releases/latest).
 
-| Tag              | Java version | Linux  | JVM Type           | Architecture        |
-|------------------|--------------|--------|--------------------|---------------------|
-| latest           | 21           | Ubuntu | Hotspot            | amd64, arm64        |
-| stable           | 21           | Ubuntu | Hotspot            | amd64, arm64        |
-| java21           | 21           | Ubuntu | Hotspot            | amd64, arm64        |
-| java21-alpine    | 21           | Alpine | Hotspot            | amd64, arm64        |
-| java21-graalvm   | 21           | Oracle | Oracle GraalVM[^1] | amd64, arm64        |   
-| java17           | 17           | Ubuntu | Hotspot            | amd64, arm64, armv7 |
-| java17-jdk       | 17           | Ubuntu | Hotspot+JDK        | amd64, arm64, armv7 |
-| java17-graalvm   | 17           | Oracle | Oracle GraalVM[^1] | amd64, arm64        |   
-| java17-alpine    | 17           | Alpine | Hotspot            | amd64  (1)          |
-| java11           | 11           | Ubuntu | Hotspot            | amd64, arm64, armv7 |
-| java8            | 8            | Ubuntu | Hotspot            | amd64, arm64, armv7 |
-| java8-alpine     | 8            | Alpine | Hotspot            | amd64  (1)          |
-| java8-jdk        | 8            | Ubuntu | Hotspot+JDK        | amd64               |
-| java8-openj9     | 8            | Debian | OpenJ9             | amd64               |
-| java8-graalvm-ce | 8            | Oracle | GraalVM CE         | amd64               |
+| Tag name         | Java version | Linux  | JVM Type       | Architecture      |
+|------------------|--------------|--------|----------------|-------------------|
+| latest           | 17           | Ubuntu | Hotspot        | amd64,arm64,armv7 |
+| stable           | 17           | Ubuntu | Hotspot        | amd64,arm64,armv7 |
+| java8            | 8            | Alpine | Hotspot        | amd64             |
+| java8-jdk        | 8            | Ubuntu | Hotspot+JDK    | amd64             |
+| java8-multiarch  | 8            | Ubuntu | Hotspot        | amd64,arm64,armv7 |
+| java8-openj9     | 8            | Debian | OpenJ9         | amd64             |
+| java8-graalvm-ce | 8            | Oracle | GraalVM CE     | amd64             |
+| java11           | 11           | Ubuntu | Hotspot        | amd64,arm64,armv7 |
+| java11-jdk       | 11           | Ubuntu | Hotspot+JDK    | amd64,arm64,armv7 |
+| java11-openj9    | 11           | Debian | OpenJ9         | amd64             |
+| java17           | 17           | Ubuntu | Hotspot        | amd64,arm64,armv7 |
+| java17-jdk       | 17           | Ubuntu | Hotspot+JDK    | amd64,arm64,armv7 |
+| java17-openj9    | 17           | Debian | OpenJ9         | amd64             |
+| java17-graalvm   | 17           | Oracle | Oracle GraalVM | amd64,arm64       |   
+| java17-alpine    | 17           | Alpine | Hotspot        | amd64             |
+| java20-alpine    | 20           | Alpine | Hotspot        | amd64             |
+| java20           | 20           | Ubuntu | Hotspot        | amd64,arm64       |
+| java21-graalvm   | 21           | Oracle | Oracle GraalVM | amd64,arm64       |   
 
-1. Why no arm64 for Java 17 Alpine? That is because the base images, such as [elipse-temurin](https://hub.docker.com/_/eclipse-temurin/tags?page=&page_size=&ordering=&name=17-jre-alpine) do not provide support for that. Use the Ubuntu based images instead.
+For example, to use Java version 8 on any supported architecture:
 
-!!! example "Example using java8"
+    docker run --name mc itzg/minecraft-server:java8-multiarch
 
-    With docker run command-line
+!!! note
+
+    Keep in mind that some versions of Minecraft server, such as Forge before 1.17, can't work on the newest versions of Java. Instead, one of the Java 8 images should be used. Also, FORGE doesn't support openj9 JVM implementation.
     
-    ```
-    docker run -it -e EULA=true itzg/minecraft-server:java8
-    ```
-    
-    or in a compose file
-    
-    ```yaml
-    services:
-      mc:
-        image: itzg/minecraft-server:java8
-    ```
+    Some versions of vanilla Minecraft, such as 1.10, also do not run correctly with Java 17. If in doubt, use `java8-multiarch` for any version less than 1.17.
 
-!!! note "Latest"
-
-    The "latest" tag shifts to include not only the latest features and bug fixes, but also the latest Java version that Mojang requires for the latest Minecraft version.
-
-!!! tip "Class File Version"
-
-    If the Minecraft startup is logging an error about a "class file version", then refer [to this table](https://javaalmanac.io/bytecode/versions/) to identify the JDK/Java version corresponding to each class file version.
-
-### Release versions
-
-Since the tags referenced above will shift as the newest image build brings in new features and bug fixes, released variants of those can also be used to pin a specific build of the image.
-
-The syntax of released image tags is:
-
-    itzg/minecraft-server:<release>-<java tag>
-
-where `java tag` still refers to the first column of the table above and `release` refers to [one of the image releases](https://github.com/itzg/docker-minecraft-server/releases).
-
-!!! example
-
-    For example, the 2024.4.0 release of the Java 17 image would be
-    
-    ```
-    itzg/minecraft-server:2024.4.0-java17
-    ```
-
-### Stable image tag
-
-The `stable` image tag combines the benefits of `latest` and [release versions](#release-versions) since it shifts to refer to the most recently released version.
-
-## Version compatibilities
-
-[This section in the Minecraft wiki](https://minecraft.wiki/w/Tutorials/Update_Java#Why_update?) lists out versions of **vanilla** Minecraft versions and the corresponding Java version that is required.
-
-### Forge versions
-
-Forge and its mods sometimes utilize non-public APIs of the JVM and as such are suspceptible to becoming broken with newer Java versions.
-
-#### Java 21
-
-Some mods even up to Minecraft 1.21 require Java 17 and will not run on the latest Java version. If you see an error like the following then be sure to explicitly use a Java 17 tagged image:
-
-```
-Caused by: org.spongepowered.asm.mixin.throwables.ClassMetadataNotFoundException: java.util.List
-	at MC-BOOTSTRAP/org.spongepowered.mixin/org.spongepowered.asm.mixin.transformer.MixinPreProcessorStandard.transformMethod(MixinPreProcessorStandard.java:754)
-```
-
-#### Java 8
-
-For Forge versions less than 1.18, you _must_ use the `java8-multiarch` (or other java8) image tag.
-
-In general, if you see the following line in a server startup failure, then it means you need to be using Java 8 instead of the latest image Java version:
-
-```
-Caused by: java.lang.ClassCastException: class jdk.internal.loader.ClassLoaders$AppClassLoader 
-   cannot be cast to class java.net.URLClassLoader
-```
-
-Forge also doesn't support openj9 JVM implementation.
-
-## Deprecated Image Tags
+### Deprecated Image Tags
 
 The following image tags have been deprecated and are no longer receiving updates:
-
 - java19
 - adopt13
 - adopt14
@@ -118,8 +55,4 @@ The following image tags have been deprecated and are no longer receiving update
 - multiarch-latest
 - java16/java16-openj9
 - java17-graalvm-ce
-- java17-openj9
-- java20-graalvm, java20, java20-alpine
-- java8-multiarch is still built and pushed, but please move to java8 instead
-
-[^1]: Based on the [Oracle GraalMV images](https://blogs.oracle.com/java/post/new-oracle-graalvm-container-images), which as of JDK 17, are now under the [GraalVM Free License](https://blogs.oracle.com/java/post/graalvm-free-license) incorporating what used to be known as the GraalVM Enterprise. 
+- java20-graalvm

examples/.gitignore

@@ -1,4 +1,3 @@
 data/
 modpacks/
-.env
-downloads/
+.env

examples/aof7/docker-compose.yml

@@ -1,37 +0,0 @@
-services:
-  mc:
-    image: itzg/minecraft-server
-    environment:
-      EULA: true
-      MOD_PLATFORM: AUTO_CURSEFORGE
-      # from .env
-      CF_API_KEY: ${CF_API_KEY}
-      CF_PAGE_URL: https://www.curseforge.com/minecraft/modpacks/all-of-fabric-7
-#      CF_FILENAME_MATCHER: 1.2.2
-      CF_OVERRIDES_EXCLUSIONS: |
-        mods/iris*.jar
-        mods/sodium*.jar
-      MEMORY: 4G
-    ports:
-      - "25565:25565"
-    volumes:
-      - mc-data:/data
-      - ./downloads:/downloads
-      # Manually download the following and put into the 'downloads' directory next to this compose file
-      #
-      #  Mod                          Filename                                   Download page
-      #  ===========================  =========================================  ====================================================================================
-      #  Fish of Thieves              [Fabric 1.20.1] Fish of Thieves v3.0.3     https://www.curseforge.com/minecraft/mc-mods/fish-of-thieves/files/4958329
-      #  Only Hammers [FORGE/FABRIC]  OnlyHammers-1.20.1-0.6-Fabric              https://www.curseforge.com/minecraft/mc-mods/only-hammers-forge-fabric/files/4832068
-      #  Sprinklerz                   sprinklerz-0.5_fabric.jar                  https://www.curseforge.com/minecraft/mc-mods/sprinklerz/files/4835664
-      #  Frog Legs (Fabric/Forge)     FrogLegs-v2.0.0-1.20.1-Fabric.jar          https://www.curseforge.com/minecraft/mc-mods/froglegs/files/4917818
-      #  TrimsEffects                 [FABRIC] TrimsEffects - MC 1.20.X - 1.1.0  https://www.curseforge.com/minecraft/mc-mods/trimseffects/files/4954156
-      #  Display Case                 Display Case-fabric-1.20-1.0.8.jar         https://www.curseforge.com/minecraft/mc-mods/displaycase/files/4921333
-      #  Structory: Towers            Structory Towers 1.20.4 v1.0.6             https://www.curseforge.com/minecraft/mc-mods/structory-towers/files/4937875
-      #  Packet Fixer                 Packet Fixer Fabric 1.2.1                  https://www.curseforge.com/minecraft/mc-mods/packet-fixer/files/4884316
-      #  Perfect Plushies             Perfect Plushies 1.9.0 [Fabric]            https://www.curseforge.com/minecraft/mc-mods/perfect-plushies/files/4985767
-      #  Structory                    Structory 1.20.2 v1.3.4                    https://www.curseforge.com/minecraft/mc-mods/structory/files/4937872
-
-volumes:
-  mc-data: {}
-

examples/atm8/docker-compose.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server

examples/atm9/docker-compose.yml

@@ -1,20 +0,0 @@
-services:
-  mc:
-    image: itzg/minecraft-server
-    ports:
-      - "25565:25565"
-    environment:
-      EULA: "true"
-      MOD_PLATFORM: AUTO_CURSEFORGE
-      # allocate from https://console.curseforge.com/ and set in .env file
-      CF_API_KEY: ${CF_API_KEY}
-      CF_PAGE_URL: https://www.curseforge.com/minecraft/modpacks/all-the-mods-9
-      # Optional: select a specific version/file
-      #CF_FILENAME_MATCHER: "0.2.34"
-      MEMORY: 4G
-    volumes:
-      - mc-data:/data
-      - ./downloads:/downloads
-
-volumes:
-  mc-data: {}

examples/auto-cf/modpack-manifest/docker-compose.yml

@@ -1,19 +0,0 @@
-services:
-  mc:
-    image: itzg/minecraft-server
-    environment:
-      EULA: true
-      MOD_PLATFORM: AUTO_CURSEFORGE
-      # allocate from https://console.curseforge.com/ and set in .env file
-      CF_API_KEY: ${CF_API_KEY}
-      CF_MODPACK_MANIFEST: /manifests/manifest.json
-      CF_SLUG: "custom"
-      MEMORY: 2G
-    volumes:
-      - mc-data:/data
-      - ./manifests:/manifests:ro
-    ports:
-      - "25565:25565"
-
-volumes:
-  mc-data: {}

examples/auto-cf/modpack-manifest/manifests/manifest.json

@@ -1,28 +0,0 @@
-{
-  "minecraft": {
-    "version": "1.20.4",
-    "modLoaders": [
-      {
-        "id": "fabric-0.15.3",
-        "primary": true
-      }
-    ]
-  },
-  "manifestType": "minecraftModpack",
-  "manifestVersion": 1,
-  "name": "Custom",
-  "author": "",
-  "files": [
-    {
-      "projectID": 351725,
-      "fileID": 4973035,
-      "required": true
-    },
-    {
-      "projectID": 306612,
-      "fileID": 5010374,
-      "required": true
-    }
-  ],
-  "overrides": "overrides"
-}

examples/auto-cf/using-excludes/docker-compose.yml

@@ -1,49 +0,0 @@
-services:
-  mc:
-    image: itzg/minecraft-server:java8-multiarch
-    ports:
-      - "25565:25565"
-    environment:
-      EULA: "true"
-      MOD_PLATFORM: AUTO_CURSEFORGE
-      # allocate from https://console.curseforge.com/ and set in .env file
-      CF_API_KEY: ${CF_API_KEY}
-      CF_PAGE_URL: https://www.curseforge.com/minecraft/modpacks/minecraft-eternal/files/4102634
-      CF_EXCLUDE_MODS: |
-        cherished-worlds
-        controlling
-        ctm
-        custom-main-menu
-        ding
-        minecraft-rich-presence
-        enchantment-descriptions
-        just-enough-harvestcraft
-        just-enough-resources-jer
-        menumobs
-        more-overlays
-        mouse-tweaks
-        oldjavawarning
-        overloaded-armor-bar
-        reauth
-        thaumic-jei
-        tips
-        armor-toughness-bar
-        waila-harvestability
-        ambientsounds
-        biomeinfo
-        block-drops-jei-addon
-        loot-capacitor-tooltips
-        no-recipe-book
-        packmodemenu
-        resource-reloader
-
-#        blockdrops
-
-      CF_FORCE_SYNCHRONIZE: "true"
-      MEMORY: 4G
-    volumes:
-      - mc-data:/data
-      - ./downloads:/downloads
-
-volumes:
-  mc-data: {}

examples/bettermc/docker-compose.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server

examples/bmc4/docker-compose.yml

@@ -1,30 +0,0 @@
-services:
-  mc:
-    image: itzg/minecraft-server:java17
-    environment:
-      EULA: true
-      TYPE: MODRINTH
-      MEMORY: 4G
-      MODRINTH_MODPACK: better-mc-forge-bmc4
-      MODRINTH_VERSION: v26
-      MODRINTH_EXCLUDE_FILES: |
-        citresewn
-        oculus
-        yungsmenutweaks
-        notenoughanimations
-        ryoamiclights
-        euphoriapatcher
-        entity_model_features
-        entity_texture_features
-        3dskinlayers
-        connector
-      MODRINTH_OVERRIDES_EXCLUSIONS: |
-        mods/NekosEnchantedBooks-*.jar
-        mods/citresewn-*.jar
-    volumes:
-      - data:/data
-    ports:
-      - "25565:25565"
-
-volumes:
-  data: {}

examples/curseforge-files/docker-compose.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server

examples/docker-compose-autopause.yml

@@ -1,3 +1,5 @@
+version: '3.8'
+
 services:
   minecraft:
     image: itzg/minecraft-server

examples/docker-compose-autostop.yml

@@ -1,3 +1,5 @@
+version: '3.8'
+
 services:
   minecraft:
     image: itzg/minecraft-server

examples/docker-compose-big.yml

@@ -1,3 +1,5 @@
+version: '3.8'
+
 services:
   minecraft:
     ports:

examples/docker-compose-curseforge-atm7.yaml

@@ -1,3 +1,5 @@
+version: '3.8'
+
 ####################################################################
 #                         CURSEFORGE                               #
 #                                                                  #

examples/docker-compose-curseforge.yml

@@ -1,3 +1,5 @@
+version: '3.8'
+
 services:
   mc:
     image: itzg/minecraft-server:${IMAGE_TAG:-java8}

examples/docker-compose-fabric.yml

@@ -1,3 +1,5 @@
+version: "3"
+
 services:
   mc:
     image: itzg/minecraft-server

examples/docker-compose-forge-bettermcplus

@@ -1,3 +1,5 @@
+version: '3.8'
+
 ####################################################################
 #                       FORGE_GENERIC_PACK                         #
 #                                                                  #

examples/docker-compose-forge.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server

examples/docker-compose-ftba.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     # FTBA support is only available in non-Alpine images

examples/docker-compose-generic-pack-tnp5.yml

@@ -1,3 +1,5 @@
+version: '3.8'
+
 ####################################################################
 #                         FORGE GENERIC_PACK                       #
 #                                                                  #

examples/docker-compose-generic-pack.yml

@@ -1,3 +1,5 @@
+version: '3.8'
+
 services:
   mc:
     image: itzg/minecraft-server:${IMAGE_TAG:-latest}

examples/docker-compose-magma.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server:java8

examples/docker-compose-modrinth.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server

examples/docker-compose-mods-mount.yml

@@ -1,8 +1,10 @@
+version: '3.8'
+
 services:
   minecraft:
     image: itzg/minecraft-server
     volumes:
-      - ./data:/data
+      - data:/data
       - ./mods:/mods
     ports:
       - "25565:25565"
@@ -10,5 +12,10 @@ services:
       EULA: "true"
       TYPE: "FORGE"
       VERSION: "1.19.2"
-    tty: true
-    stdin_open: true
+      DEBUG: "true"
+      SETUP_ONLY: "true"
+    tty: True
+    stdin_open: True
+
+volumes:
+  data: {}

examples/docker-compose-mohist.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server

examples/docker-compose-ngrok.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server

examples/docker-compose-paper.yml

@@ -1,3 +1,4 @@
+version: '3.8'
 services:
   mc:
     image: itzg/minecraft-server

examples/docker-compose-proxied.yml

@@ -1,3 +1,5 @@
+version: '3.8'
+
 services:
   mc:
 #    build: .

examples/docker-compose-rconcmd.yml

@@ -1,3 +1,5 @@
+version: '3'
+
 services:
   minecraft:
     image: ${IMAGE_TO_TEST:-itzg/minecraft-server}

examples/docker-compose-rlcraft.yml

@@ -1,3 +1,5 @@
+version: '3.8'
+
 services:
   mc:
     image: itzg/minecraft-server:java8

examples/docker-compose-simple.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server

examples/docker-compose-spiget.yml

@@ -1,18 +1,18 @@
-# NOTE
-# This file is named spiget with an "e"
-# since it provides an example of the 
-# feature https://docker-minecraft-server.readthedocs.io/en/latest/mods-and-plugins/spiget/
-# which uses the Spiget API at https://spiget.org/
+version: "3"
 
 services:
   mc:
+    # Only using IMAGE variable to allow for local testing
     image: itzg/minecraft-server
+#    image: ${IMAGE:-itzg/minecraft-server}
     ports:
       - "25565:25565"
     environment:
       EULA: "TRUE"
-      TYPE: PAPER
-      SPIGET_RESOURCES: 34315,3836
+      TYPE: SPIGOT
+#      SPIGET_RESOURCES: 34315,3836
+      SPIGET_RESOURCES: ""
+      REMOVE_OLD_MODS: "true"
     volumes:
       - data:/data
 

examples/docker-compose-spongeforge.yml

@@ -1,3 +1,4 @@
+version: '3.8'
 # Forge with Sponge API support. THIS REQUIRES DOWNLOADING SPONGEFORGE.
 # Place the SpongeForge jar file in /data/mods. Other Forge mods go here as well.
 # Place Sponge mods in /data/mods/plugins. Yes, this is a directory inside the Forge mod directory. Do NOT use /data/plugins.

examples/docker-compose-tailscale.yml

@@ -1,35 +0,0 @@
-services:
-  tailscale-client:
-    image: tailscale/tailscale:latest
-    container_name: tailscale
-    hostname: tailscale-minecraft # This name will be the one on the tailscale network
-    environment:
-      TS_AUTHKEY: "tskey-auth-PLACE-YOUR-KEY-HERE"
-      TS_STATE_DIR: "/var/lib/tailscale"
-      TS_USERSPACE: "FALSE" # If not using Auto-pause it can be set as true
-    volumes:
-      - ./ts-minecraft/state:/var/lib/tailscale
-      - /dev/net/tun:/dev/net/tun
-    cap_add:
-      - net_admin
-      - sys_module
-    restart: unless-stopped
-    # ports: # Not needed, tailscale is directly linking to the container.
-      # - "25565:25565"
-  minecraft-server:
-    image: itzg/minecraft-server
-    network_mode: container:tailscale
-    stdin_open: true
-    tty: true
-    environment:
-      EULA: "TRUE"
-      # ENABLE_AUTOPAUSE: "TRUE"
-      # AUTOPAUSE_KNOCK_INTERFACE: "tailscale0"
-      # MAX_TICK_TIME: "-1"
-    volumes:
-      - minecraftserver:/data
-    restart: unless-stopped
-
-    
-volumes:
-  minecraftserver:

examples/docker-compose-world-download.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server

examples/docker-compose.yml

@@ -1,12 +1,16 @@
+version: '3'
+# Other docker-compose examples in /examples
+
 services:
   minecraft:
     image: itzg/minecraft-server
-    stdin_open: true
-    tty: true
     ports:
       - "25565:25565"
     volumes:
-      - ./data:/data
+      - "mc:/data"
     environment:
       EULA: "TRUE"
-    restart: unless-stopped
+    restart: always
+
+volumes:
+  mc: {}

examples/geyser/docker-compose.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server

examples/jline/docker-compose.yml

@@ -1,14 +0,0 @@
-services:
-  mc:
-    image: itzg/minecraft-server
-    tty: true
-    stdin_open: true
-    environment:
-      EULA: true
-      TYPE: FABRIC
-      MODRINTH_PROJECTS: |
-        jline4mcdsrv
-    volumes:
-      - mc-data:/data
-volumes:
-  mc-data: {}

examples/k8s/using-statefulset.yml

@@ -19,7 +19,6 @@ spec:
       containers:
         - name: mc
           image: itzg/minecraft-server
-          imagePullPolicy: Always
           env:
             - name: EULA
               value: "TRUE"

examples/ketting/docker-compose.yml

@@ -1,11 +0,0 @@
-services:
-  mc:
-    image: itzg/minecraft-server
-    environment:
-      EULA: true
-      TYPE: KETTING
-      VERSION: 1.20.1
-      CF_API_KEY: "${CF_API_KEY}"
-      CURSEFORGE_FILES: https://www.curseforge.com/minecraft/mc-mods/aquaculture
-    ports:
-      - "25565:25565"

examples/lazytainer/docker_compose.yml

@@ -1,32 +0,0 @@
-services:
-  lazytainer:
-    image: ghcr.io/vmorganp/lazytainer:master
-    environment:
-      VERBOSE: false
-    ports:
-      - 25565:25565
-    volumes:
-      - /var/run/docker.sock:/var/run/docker.sock:ro
-    labels:
-      - lazytainer.group.minecraft.sleepMethod=stop
-      - lazytainer.group.minecraft.ports=25565
-      - lazytainer.group.minecraft.minPacketThreshold=2 # Start after two incomming packets
-      - lazytainer.group.minecraft.inactiveTimeout=600 # 10 minutes, to allow the server to bootstrap. You can probably make this lower later if you want.
-    restart: unless-stopped
-    network_mode: bridge
-  mc:
-    image: itzg/minecraft-server
-    environment:
-      EULA: TRUE
-      TYPE: PAPER
-      MEMORY: 4G
-    volumes:
-      - ./data:/data
-    labels:
-      - lazytainer.group=minecraft
-    depends_on:
-      - lazytainer
-    network_mode: service:lazytainer
-    tty: true
-    stdin_open: true
-    restart: unless-stopped

examples/modrinth-modpack/docker-compose.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server

examples/modrinth-paper/docker-compose.yml

@@ -1,3 +1,5 @@
+version: "3"
+
 services:
   mc:
     image: itzg/minecraft-server

examples/modrinth/local-modpack/docker-compose.yml

@@ -1,15 +0,0 @@
-services:
-  mc:
-    image: itzg/minecraft-server
-    environment:
-      EULA: true
-      MOD_PLATFORM: MODRINTH
-      # Download the mrpack file from https://modrinth.com/modpack/cobblemon-fabric/version/1.4.1 and place in
-      # modpacks directory next to this compose file.
-      MODRINTH_MODPACK: /modpacks/Cobblemon Modpack [Fabric] 1.4.1.mrpack
-    volumes:
-      - mc-data:/data
-      - ./modpacks:/modpacks:ro
-
-volumes:
-  mc-data: {}

examples/mods-file/docker-compose.yml

@@ -1,3 +1,5 @@
+version: '3.8'
+
 services:
   mc:
     image: itzg/minecraft-server

examples/multi-project/dbs/docker-compose.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mariadb:
     image: mariadb:10

examples/multi-project/servers/docker-compose.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   proxy:
     image: itzg/bungeecord
@@ -8,16 +10,7 @@ services:
     volumes:
       - waterfall:/server
       - ./waterfall-config:/config
-# If you want to use Velocity here is a premade version that supports Velocity
-#  velocity-proxy:
-#    image: itzg/bungeecord
-#    environment:
-#      TYPE: VELOCITY
-#    ports:
-#      - "25565:25577"
-#    volumes:
-#      - velocity:/server
-#      - ./velocity-config:/config
+
   mc:
     image: itzg/minecraft-server
     environment:
@@ -45,4 +38,4 @@ networks:
   dbs:
     # declared in ../dbs
     external: true
-    name: dbs_default
+    name: dbs_default

examples/multi-project/servers/velocity-config/velocity.toml

@@ -1,155 +0,0 @@
-# Config version. Do not change this
-config-version = "2.6"
-
-# What port should the proxy be bound to? By default, we'll bind to all addresses on port 25565.
-bind = "0.0.0.0:25565"
-
-# What should be the MOTD? This gets displayed when the player adds your server to
-# their server list. Only MiniMessage format is accepted.
-motd = "<#09add3>A Velocity Server"
-
-# What should we display for the maximum number of players? (Velocity does not support a cap
-# on the number of players online.)
-show-max-players = 500
-
-# Should we authenticate players with Mojang? By default, this is on.
-online-mode = true
-
-# Should the proxy enforce the new public key security standard? By default, this is on.
-force-key-authentication = true
-
-# If client's ISP/AS sent from this proxy is different from the one from Mojang's
-# authentication server, the player is kicked. This disallows some VPN and proxy
-# connections but is a weak form of protection.
-prevent-client-proxy-connections = false
-
-# Should we forward IP addresses and other data to backend servers?
-# Available options:
-# - "none":        No forwarding will be done. All players will appear to be connecting
-#                  from the proxy and will have offline-mode UUIDs.
-# - "legacy":      Forward player IPs and UUIDs in a BungeeCord-compatible format. Use this
-#                  if you run servers using Minecraft 1.12 or lower.
-# - "bungeeguard": Forward player IPs and UUIDs in a format supported by the BungeeGuard
-#                  plugin. Use this if you run servers using Minecraft 1.12 or lower, and are
-#                  unable to implement network level firewalling (on a shared host).
-# - "modern":      Forward player IPs and UUIDs as part of the login process using
-#                  Velocity's native forwarding. Only applicable for Minecraft 1.13 or higher.
-player-info-forwarding-mode = "NONE"
-
-# If you are using modern or BungeeGuard IP forwarding, configure a file that contains a unique secret here.
-# The file is expected to be UTF-8 encoded and not empty.
-forwarding-secret-file = "forwarding.secret"
-
-# Announce whether or not your server supports Forge. If you run a modded server, we
-# suggest turning this on.
-# 
-# If your network runs one modpack consistently, consider using ping-passthrough = "mods"
-# instead for a nicer display in the server list.
-announce-forge = false
-
-# If enabled (default is false) and the proxy is in online mode, Velocity will kick
-# any existing player who is online if a duplicate connection attempt is made.
-kick-existing-players = false
-
-# Should Velocity pass server list ping requests to a backend server?
-# Available options:
-# - "disabled":    No pass-through will be done. The velocity.toml and server-icon.png
-#                  will determine the initial server list ping response.
-# - "mods":        Passes only the mod list from your backend server into the response.
-#                  The first server in your try list (or forced host) with a mod list will be
-#                  used. If no backend servers can be contacted, Velocity won't display any
-#                  mod information.
-# - "description": Uses the description and mod list from the backend server. The first
-#                  server in the try (or forced host) list that responds is used for the
-#                  description and mod list.
-# - "all":         Uses the backend server's response as the proxy response. The Velocity
-#                  configuration is used if no servers could be contacted.
-ping-passthrough = "DISABLED"
-
-# If not enabled (default is true) player IP addresses will be replaced by <ip address withheld> in logs
-enable-player-address-logging = true
-
-[servers]
-# Configure your servers here. Each key represents the server's name, and the value
-# represents the IP address of the server to connect to.
-lobby = "127.0.0.1:30066"
-factions = "127.0.0.1:30067"
-minigames = "127.0.0.1:30068"
-
-# In what order we should try servers when a player logs in or is kicked from a server.
-try = [
-    "lobby"
-]
-
-[forced-hosts]
-# Configure your forced hosts here.
-"lobby.example.com" = [
-    "lobby"
-]
-"factions.example.com" = [
-    "factions"
-]
-"minigames.example.com" = [
-    "minigames"
-]
-
-[advanced]
-# How large a Minecraft packet has to be before we compress it. Setting this to zero will
-# compress all packets, and setting it to -1 will disable compression entirely.
-compression-threshold = 256
-
-# How much compression should be done (from 0-9). The default is -1, which uses the
-# default level of 6.
-compression-level = -1
-
-# How fast (in milliseconds) are clients allowed to connect after the last connection? By
-# default, this is three seconds. Disable this by setting this to 0.
-login-ratelimit = 3000
-
-# Specify a custom timeout for connection timeouts here. The default is five seconds.
-connection-timeout = 5000
-
-# Specify a read timeout for connections here. The default is 30 seconds.
-read-timeout = 30000
-
-# Enables compatibility with HAProxy's PROXY protocol. If you don't know what this is for, then
-# don't enable it.
-haproxy-protocol = false
-
-# Enables TCP fast open support on the proxy. Requires the proxy to run on Linux.
-tcp-fast-open = false
-
-# Enables BungeeCord plugin messaging channel support on Velocity.
-bungee-plugin-message-channel = true
-
-# Shows ping requests to the proxy from clients.
-show-ping-requests = false
-
-# By default, Velocity will attempt to gracefully handle situations where the user unexpectedly
-# loses connection to the server without an explicit disconnect message by attempting to fall the
-# user back, except in the case of read timeouts. BungeeCord will disconnect the user instead. You
-# can disable this setting to use the BungeeCord behavior.
-failover-on-unexpected-server-disconnect = true
-
-# Declares the proxy commands to 1.13+ clients.
-announce-proxy-commands = true
-
-# Enables the logging of commands
-log-command-executions = false
-
-# Enables logging of player connections when connecting to the proxy, switching servers
-# and disconnecting from the proxy.
-log-player-connections = true
-
-[query]
-# Whether to enable responding to GameSpy 4 query responses or not.
-enabled = false
-
-# If query is enabled, on what port should the query protocol listen on?
-port = 25565
-
-# This is the map name that is reported to the query services.
-map = "Velocity"
-
-# Whether plugins should be shown in query response by default or not
-show-plugins = false

examples/multiline-motd/docker-compose.yml

@@ -1,12 +0,0 @@
-services:
-  mc:
-    image: itzg/minecraft-server
-    environment:
-      EULA: true
-      MOTD: |
-        line one
-        line two
-# or
-#      MOTD: "line one\nline two"
-    ports:
-      - "25565:25565"

examples/neoforge/docker-compose.yml

@@ -1,14 +0,0 @@
-services:
-  mc:
-    image: itzg/minecraft-server
-    environment:
-      EULA: true
-      TYPE: NEOFORGE
-      VERSION: latest
-      NEOFORGE_VERSION: beta
-    ports:
-      - "25565:25565"
-    volumes:
-      - mc:/data
-volumes:
-  mc: {}

examples/one-block-modded/docker-compose.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server

examples/paper-build-plugins/docker-compose.yml

@@ -1,3 +1,5 @@
+version: '3.7'
+
 services:
   mc:
     build: .

examples/paper-proxy-protocol/config/paper-global.yml

@@ -1,2 +0,0 @@
-proxies:
-  proxy-protocol: true

examples/paper-proxy-protocol/docker-compose.yml

@@ -1,15 +0,0 @@
-services:
-  mc:
-    image: itzg/minecraft-server
-    environment:
-      EULA: true
-      TYPE: PAPER
-    ports:
-      # Use host port 25566 assuming mc-router or similar is bound to 25565
-      - "25566:25565"
-    volumes:
-      - mc-data:/data
-      - ./config:/config:ro
-
-volumes:
-  mc-data: {}

examples/pixelmon/docker-compose.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server:java8-multiarch

examples/quilt/docker-compose.yml

@@ -1,3 +1,5 @@
+version: "3"
+
 services:
   mc:
     image: itzg/minecraft-server

examples/rad2/compose.yaml

@@ -1,50 +0,0 @@
-# This runs the most recent version of Roguelike Adventures and Dungeons 2. Version 1.11 as of writing.
-services:
-  mc:
-    image: itzg/minecraft-server:java8
-    ports:
-      - "25565:25565"
-    environment:
-      EULA: "true"
-      MOD_PLATFORM: AUTO_CURSEFORGE
-      # allocate from https://console.curseforge.com/ and set in .env file
-      CF_API_KEY: ${CF_API_KEY}
-      CF_PAGE_URL: https://www.curseforge.com/minecraft/modpacks/roguelike-adventures-and-dungeons-2
-      # Optional: select a specific version/file
-      #CF_FILENAME_MATCHER: "0.2.34"
-      CF_EXCLUDE_MODS: |
-        auudio-forge
-        betterf3
-        better-third-person
-        clickable-advancements
-        controlling
-        craftpresence
-        creative-core
-        default-options
-        drippy-loading-screen
-        embeddium
-        embeddium-extension
-        embeddium-extras
-        equipment-compare
-        ezzoom
-        fading-night-vision
-        fancymenu
-        item-borders
-        itemphysic-lite
-        just-enough-resources-jer
-        konkrete
-        legendary-tooltips
-        mouse-tweaks
-        oauth
-        oculus
-        sound-filters
-        textrues-embeddium-options
-        toast-control
-      CF_FORCE_SYNCHRONIZE: "true"
-      MEMORY: 4G
-    volumes:
-      - mc-data:/data
-      - ./downloads:/downloads
-
-volumes:
-  mc-data: {}

examples/rlcraft/docker-compose.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server:java8-multiarch

examples/skript/docker-compose.yml

@@ -1,10 +0,0 @@
-services:
-  mc:
-    image: itzg/minecraft-server
-    environment:
-      EULA: true
-      TYPE: PAPER
-      PLUGINS: https://github.com/SkriptLang/Skript/releases/download/2.8.4/Skript.jar
-      SPIGET_RESOURCES: 103749
-    ports:
-      - "25565:25565"

examples/spigot/docker-compose.yml

@@ -1,13 +0,0 @@
-services:
-  mc:
-    image: itzg/minecraft-server
-    environment:
-      EULA: true
-      TYPE: SPIGOT
-      VERSION: 1.20.4
-    ports:
-      - "25565:25565"
-    volumes:
-      - data:/data
-volumes:
-  data: {}

examples/valhelsia2/docker-compose.yml

@@ -1,3 +1,5 @@
+version: '3.8'
+
 services:
   mc:
     image: itzg/minecraft-server:java8-multiarch

examples/valhesia5/docker-compose.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server

examples/vanilla-tweaks/docker-compose.yml

@@ -1,3 +1,5 @@
+version: "3.3"
+
 services:
   vanillatweaks_file:
     restart: "no"

examples/vault-hunters-1-18-2/docker-compose.yml

@@ -1,3 +1,5 @@
+version: "3.8"
+
 services:
   mc:
     image: itzg/minecraft-server