neoforge: handle new version ordering (#3703 )

build(deps): bump docker/login-action from 3.5.0 to 3.6.0 in the updates group (#3697 )
build(deps): bump mkdocs-material from 9.6.20 to 9.6.21 in /docs in the patches group (#3698 )
2026-02-17 07:03:57 +00:00 · 2025-10-09 18:54:56 -05:00 · 2025-10-06 07:13:20 -05:00 · 2025-10-06 06:27:14 -05:00 · 2025-10-05 15:17:40 -05:00 · 2025-10-05 09:00:04 -05:00
72 changed files with 969 additions and 683 deletions
--- a/.gitattributes
+++ b/.gitattributes
@@ -1,2 +1,2 @@
-# Auto detect text files and perform LF normalization
-* text=lf
+# Auto detect text files and perform LF normalization
+* text eol=lf
--- a/.github/workflows/build-multiarch.yml
+++ b/.github/workflows/build-multiarch.yml
@@ -21,8 +21,8 @@ jobs:
      matrix:
        # NOTE: the "latest" variant is identified in the Docker meta step's 'latest' config
        variant:
-          - java24
-          - java24-graalvm
+          - java25
+          - java25-graalvm
          - java21
          - java21-alpine
          - java21-graalvm
@@ -37,13 +37,13 @@ jobs:
          - java8-openj9
          - java8-jdk
        include:
-        # JAVA 24
-          - variant: java24
-            baseImage: eclipse-temurin:24-jre
+        # JAVA 25
+          - variant: java25
+            baseImage: eclipse-temurin:25-jre
            platforms: linux/amd64,linux/arm64
            mcVersion: latest
-          - variant: java24-graalvm
-            baseImage: container-registry.oracle.com/graalvm/jdk:24-ol8
+          - variant: java25-graalvm
+            baseImage: container-registry.oracle.com/graalvm/jdk:25-ol8
            platforms: linux/amd64,linux/arm64
            mcVersion: latest
        # JAVA 21:
@@ -186,14 +186,14 @@ jobs:
          tests/test.sh

      - name: Login to DockerHub
-        uses: docker/login-action@v3.5.0
+        uses: docker/login-action@v3.6.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.5.0
+        uses: docker/login-action@v3.6.0
        if: env.HAS_IMAGE_REPO_ACCESS
        with:
          registry: ghcr.io
--- a/.github/workflows/stale-check.yml
+++ b/.github/workflows/stale-check.yml
@@ -12,7 +12,7 @@ jobs:
      pull-requests: write
    steps:
      - name: Process Stale Issues
-        uses: actions/stale@v9
+        uses: actions/stale@v10
        with:
          stale-issue-label: status/stale
          stale-pr-label: status/stale
--- a/173
+++ b/173
@@ -1,82 +1,91 @@
-ARG BASE_IMAGE=eclipse-temurin:21-jre
-FROM ${BASE_IMAGE}
-
-# hook into docker BuildKit --platform support
-# see https://docs.docker.com/engine/reference/builder/#automatic-platform-args-in-the-global-scope
-ARG TARGETOS
-ARG TARGETARCH
-ARG TARGETVARIANT
-
-# The following three arg/env vars get used by the platform specific "install-packages" script
-ARG EXTRA_DEB_PACKAGES=""
-ARG EXTRA_DNF_PACKAGES=""
-ARG EXTRA_ALPINE_PACKAGES=""
-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
-
-EXPOSE 25565
-
-ARG APPS_REV=1
-ARG GITHUB_BASEURL=https://github.com
-
-ARG EASY_ADD_VERSION=0.8.11
-ADD ${GITHUB_BASEURL}/itzg/easy-add/releases/download/${EASY_ADD_VERSION}/easy-add_${TARGETOS}_${TARGETARCH}${TARGETVARIANT} /usr/bin/easy-add
-RUN chmod +x /usr/bin/easy-add
-
-ARG RESTIFY_VERSION=1.7.10
-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
-
-ARG RCON_CLI_VERSION=1.7.1
-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
-
-ARG MC_MONITOR_VERSION=0.15.6
-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
-
-ARG MC_SERVER_RUNNER_VERSION=1.13.3
-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
-
-ARG MC_HELPER_VERSION=1.48.11
-ARG MC_HELPER_BASE_URL=${GITHUB_BASEURL}/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 \
-  | tar -C /usr/share -zxf - \
-  && ln -s /usr/share/mc-image-helper-${MC_HELPER_VERSION}/bin/mc-image-helper /usr/bin
-
-VOLUME ["/data"]
-WORKDIR /data
-
-STOPSIGNAL SIGTERM
-
-# End user MUST set EULA and change RCON_PASSWORD
-ENV TYPE=VANILLA VERSION=LATEST EULA="" UID=1000 GID=1000 LC_ALL=en_US.UTF-8
-
-COPY --chmod=755 scripts/start* /
-COPY --chmod=755 files/shims/ /usr/local/bin/
-COPY --chmod=755 files/* /image/
-COPY --chmod=755 files/auto /auto
-
-RUN curl -fsSL -o /image/Log4jPatcher.jar https://github.com/CreeperHost/Log4jPatcher/releases/download/v1.0.1/Log4jPatcher-1.0.1.jar
-
-RUN dos2unix /start* /auto/*
-
-ENTRYPOINT [ "/start" ]
-HEALTHCHECK --start-period=2m --retries=2 --interval=30s CMD mc-health
-
-ARG BUILDTIME=local
-ARG VERSION=local
-ARG REVISION=local
-RUN echo "buildtime=${BUILDTIME}\nversion=${VERSION}\nrevision=${REVISION}" > /etc/image.properties
+ARG BASE_IMAGE=eclipse-temurin:21-jre
+FROM ${BASE_IMAGE}
+
+# hook into docker BuildKit --platform support
+# see https://docs.docker.com/engine/reference/builder/#automatic-platform-args-in-the-global-scope
+ARG TARGETOS
+ARG TARGETARCH
+ARG TARGETVARIANT
+
+# The following three arg/env vars get used by the platform specific "install-packages" script
+ARG EXTRA_DEB_PACKAGES=""
+ARG EXTRA_DNF_PACKAGES=""
+ARG EXTRA_ALPINE_PACKAGES=""
+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
+
+EXPOSE 25565
+
+ARG APPS_REV=1
+ARG GITHUB_BASEURL=https://github.com
+
+ARG EASY_ADD_VERSION=0.8.11
+ADD ${GITHUB_BASEURL}/itzg/easy-add/releases/download/${EASY_ADD_VERSION}/easy-add_${TARGETOS}_${TARGETARCH}${TARGETVARIANT} /usr/bin/easy-add
+RUN chmod +x /usr/bin/easy-add
+
+ARG RESTIFY_VERSION=1.7.10
+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
+
+ARG RCON_CLI_VERSION=1.7.1
+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
+
+ARG MC_MONITOR_VERSION=0.15.6
+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
+
+ARG MC_SERVER_RUNNER_VERSION=1.13.4
+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
+
+ARG MC_HELPER_VERSION=1.49.2
+ARG MC_HELPER_BASE_URL=${GITHUB_BASEURL}/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 \
+  | tar -C /usr/share -zxf - \
+    && ln -s /usr/share/mc-image-helper-${MC_HELPER_VERSION}/ /usr/share/mc-image-helper \
+    && ln -s /usr/share/mc-image-helper/bin/mc-image-helper /usr/bin
+
+VOLUME ["/data"]
+WORKDIR /data
+
+STOPSIGNAL SIGTERM
+
+# End user MUST set EULA and change RCON_PASSWORD
+ENV TYPE=VANILLA VERSION=LATEST EULA="" UID=1000 GID=1000 LC_ALL=en_US.UTF-8
+
+COPY --chmod=755 scripts/start* /image/scripts/
+
+# Backward compatible shim for those with legacy entrypoint
+COPY --chmod=755 <<EOF /start
+#!/bin/bash
+exec /image/scripts/start
+EOF
+
+COPY --chmod=755 scripts/auto/* /image/scripts/auto/
+COPY --chmod=755 scripts/shims/* /image/scripts/shims/
+RUN ln -s /image/scripts/shims/* /usr/local/bin/
+COPY --chmod=755 files/* /image/
+
+RUN curl -fsSL -o /image/Log4jPatcher.jar https://github.com/CreeperHost/Log4jPatcher/releases/download/v1.0.1/Log4jPatcher-1.0.1.jar
+
+RUN dos2unix /image/scripts/start* /image/scripts/auto/*
+
+ENTRYPOINT [ "/image/scripts/start" ]
+HEALTHCHECK --start-period=2m --retries=2 --interval=30s CMD mc-health
+
+ARG BUILDTIME=local
+ARG VERSION=local
+ARG REVISION=local
+RUN echo "buildtime=${BUILDTIME}\nversion=${VERSION}\nrevision=${REVISION}" > /etc/image.properties
--- a/docs/configuration/misc-options.md
+++ b/docs/configuration/misc-options.md
@@ -1,157 +1,189 @@
-
-## Running with a custom server JAR
-
-If you would like to run a custom server JAR, set `-e TYPE=CUSTOM` and pass the custom server
-JAR via `CUSTOM_SERVER`. It can either be a URL or a container path to an existing JAR file.
-
-If it is a URL, it will only be downloaded into the `/data` directory if it wasn't already. As
-such, if you need to upgrade or re-download the JAR, then you will need to stop the container,
-remove the file from the container's `/data` directory, and start again.
-
-## Force re-download of the server file
-
-For VANILLA, FORGE, BUKKIT, SPIGOT, PAPER, CURSEFORGE, SPONGEVANILLA server types, set
-`$FORCE_REDOWNLOAD` to some value (e.g. 'true) to force a re-download of the server file for
-the particular server type. by adding a `-e FORCE_REDOWNLOAD=true` to your command-line.
-
-For example, with PaperSpigot, it would look something like this:
-
-```
-docker run -d -v /path/on/host:/data \
-    -e TYPE=PAPER -e FORCE_REDOWNLOAD=true \
-    -p 25565:25565 -e EULA=TRUE --name mc itzg/minecraft-server
-```
-
-## Running as alternate user/group ID
-
-By default, the container will switch to and run the Minecraft server as user ID 1000 and group ID 1000; however, that can be changed by setting the environment variables `UID` and `GID`.
-
-The startup will also skip user switching if the `--user`/`-u` argument is passed to `docker run` or `user` is set on the compose service.
-
-## Extra Arguments
-
-Arguments that would usually be passed to the jar file (those which are written after the filename) can be passed via the `EXTRA_ARGS` environment variable.
-
-See [Custom worlds directory path](../misc/world-data.md#custom-worlds-directory-path) for an example.
-
-## 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 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.
-
-## Server Shutdown Options
-
-To allow time for players to finish what they're doing during a graceful server shutdown, set `STOP_SERVER_ANNOUNCE_DELAY` to a number of seconds to delay after an announcement is posted by the server.
-
-!!! warning "Increase stop grace period"
-
-    The Docker stop grace period must be increased to a value longer than the announce delay. The value to use that is longer than announce delay will vary based upon the amount of time it takes for final world data saving. If the container exits with exit code 137, then that indicates a longer grace period is needed. 
-    
-    The grace period can be increased using [the -t option on docker-compose down](https://docs.docker.com/compose/reference/down/) or set the [stop_grace_period](https://docs.docker.com/compose/compose-file/05-services/#stop_grace_period) in the compose file.
-
-The `STOP_SERVER_ANNOUNCE_DELAY` can be bypassed by sending a `SIGUSR1` signal to the `mc-server-runner` process.
-
-`docker`:
-
-        docker stop --signal SIGUSR1 mc
-
-`docker compose`:
-
-        docker compose kill --signal SIGUSR1
-
-## Configuration Options for Minecraft Server Health Monitoring
-
-The image tags include specific variables to simplify configuration for monitoring the health of a Minecraft server:
-
- `-e SERVER_HOST=localhost` : This variable sets the host address of the Minecraft server to be monitored. By default, it is set to `localhost`, but you can replace it with the actual hostname or IP address of your Minecraft server.
-
- `-e SERVER_PORT=25565` : This variable sets the port number on which the Minecraft server is running. By default, Minecraft servers run on port 25565, but if your server is configured to use a different port, you should replace `25565` with the correct port number. This helps the monitoring system to accurately check the health status of the Minecraft server on the specified port.
-
-## OpenJ9 Specific Options
-
-The openj9 image tags include specific variables to simplify configuration:
-
- `-e TUNE_VIRTUALIZED=TRUE` : enables the option to
-  [optimize for virtualized environments](https://www.eclipse.org/openj9/docs/xtunevirtualized/)
- `-e TUNE_NURSERY_SIZES=TRUE` : configures nursery sizes where the initial size is 50%
-  of the `MAX_MEMORY` and the max size is 80%.
-
-## Enabling rolling logs
-
-By default the vanilla log file will grow without limit. The logger can be reconfigured to use a rolling log files strategy by using:
-
-```
-  -e ENABLE_ROLLING_LOGS=true
-```
-
-> **NOTE** this will interfere with interactive/color consoles [as described in the section above](#interactive-and-color-console)
-
-## Timezone Configuration
-
-You can configure the timezone to match yours by setting the `TZ` environment variable:
-
-        -e TZ=Europe/London
-
-such as:
-
-        docker run -d -it -e TZ=Europe/London -p 25565:25565 --name mc itzg/minecraft-server
-
-Or mounting `/etc/timezone` as readonly (not supported on Windows):
-
-        -v /etc/timezone:/etc/timezone:ro
-
-such as:
-
-        docker run -d -it -v /etc/timezone:/etc/timezone:ro -p 25565:25565 --name mc itzg/minecraft-server
-
-## HTTP Proxy
-
-You may configure the use of an HTTP/HTTPS proxy by passing the proxy's "host:port" via the environment variable `PROXY`. In [the example compose file](https://github.com/itzg/docker-minecraft-server/blob/master/examples/docker-compose-proxied.yml) it references a Squid proxy. The host and port can be separately passed via the environment variables `PROXY_HOST` and `PROXY_PORT`. A `|` delimited list of hosts to exclude from proxying can be passed via `PROXY_NON_PROXY_HOSTS`.
-
-## Using "noconsole" option
-
-Some older versions (pre-1.14) of Spigot required `--noconsole` to be passed when detaching stdin, which can be done by setting `-e CONSOLE=FALSE`.
-
-## Explicitly disable GUI
-
-Some older servers get confused and think that the GUI interface is enabled. You can explicitly
-disable that by passing `-e GUI=FALSE`.
-
-## Stop Duration
-
-When the container is signalled to stop, the Minecraft process wrapper will attempt to send a "stop" command via RCON or console and waits for the process to gracefully finish. By default it waits 60 seconds, but that duration can be configured by setting the environment variable `STOP_DURATION` to the number of seconds.
-
-## Setup only
-
-If you are using a host-attached data directory, then you can have the image setup the Minecraft server files and stop prior to launching the server process by setting `SETUP_ONLY` to `true`. 
-    
-## Enable Flare Flags
-    
-To enable the JVM flags required to fully support the [Flare profiling suite](https://blog.airplane.gg/flare), set the following variable:
-    
-    -e USE_FLARE_FLAGS=true
-    
-Flare is built-in to Pufferfish/Purpur, and is available in [plugin form](https://github.com/TECHNOVE/FlarePlugin) for other server types.
-
-## Enable support for optimized SIMD operations
-
-To enable support for optimized SIMD operations, the JVM flag can be set with the following variable:
-
-    -e USE_SIMD_FLAGS=true
-
-SIMD optimized operations are supported by Pufferfish and Purpur.
-
-## Enable timestamps in init logs
-
-Before the container starts the Minecraft Server its output is prefixed with `[init]`, such as
-
-```
-[init] Starting the Minecraft server...
-```
-
-To also include the timestamp with each log, set `LOG_TIMESTAMP` to "true". The log output will then look like:
-
-```
-[init] 2022-02-05 16:58:33+00:00 Starting the Minecraft server...
-```
+## Running with a custom server JAR
+
+If you would like to run a custom server JAR, set `-e TYPE=CUSTOM` and pass the custom server
+JAR via `CUSTOM_SERVER`. It can either be a URL or a container path to an existing JAR file.
+
+If it is a URL, it will only be downloaded into the `/data` directory if it wasn't already. As
+such, if you need to upgrade or re-download the JAR, then you will need to stop the container,
+remove the file from the container's `/data` directory, and start again.
+
+## Force re-download of the server file
+
+For VANILLA, FORGE, BUKKIT, SPIGOT, PAPER, CURSEFORGE, SPONGEVANILLA server types, set
+`$FORCE_REDOWNLOAD` to some value (e.g. 'true) to force a re-download of the server file for
+the particular server type. by adding a `-e FORCE_REDOWNLOAD=true` to your command-line.
+
+For example, with PaperSpigot, it would look something like this:
+
+```
+docker run -d -v /path/on/host:/data \
+    -e TYPE=PAPER -e FORCE_REDOWNLOAD=true \
+    -p 25565:25565 -e EULA=TRUE --name mc itzg/minecraft-server
+```
+
+## Running as alternate user/group ID
+
+By default, the container will switch to and run the Minecraft server as user ID 1000 and group ID 1000; however, that can be changed by setting the environment variables `UID` and `GID`.
+
+The startup will also skip user switching if the `--user`/`-u` argument is passed to `docker run` or `user` is set on the compose service.
+
+## Extra Arguments
+
+Arguments that would usually be passed to the jar file (those which are written after the filename) can be passed via the `EXTRA_ARGS` environment variable.
+
+See [Custom worlds directory path](../misc/world-data.md#custom-worlds-directory-path) for an example.
+
+## 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 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.
+
+## Server Shutdown Options
+
+To allow time for players to finish what they're doing during a graceful server shutdown, set `STOP_SERVER_ANNOUNCE_DELAY` to a number of seconds to delay after an announcement is posted by the server.
+
+!!! warning "Increase stop grace period"
+
+    The Docker stop grace period must be increased to a value longer than the announce delay. The value to use that is longer than announce delay will vary based upon the amount of time it takes for final world data saving. If the container exits with exit code 137, then that indicates a longer grace period is needed. 
+    
+    The grace period can be increased using [the -t option on docker-compose down](https://docs.docker.com/compose/reference/down/) or set the [stop_grace_period](https://docs.docker.com/compose/compose-file/05-services/#stop_grace_period) in the compose file.
+
+The `STOP_SERVER_ANNOUNCE_DELAY` can be bypassed by sending a `SIGUSR1` signal to the `mc-server-runner` process.
+
+`docker`:
+
+        docker stop --signal SIGUSR1 mc
+
+`docker compose`:
+
+        docker compose kill --signal SIGUSR1
+
+## Configuration Options for Minecraft Server Health Monitoring
+
+The image tags include specific variables to simplify configuration for monitoring the health of a Minecraft server:
+
+- `-e SERVER_HOST=localhost` : This variable sets the host address of the Minecraft server to be monitored. By default, it is set to `localhost`, but you can replace it with the actual hostname or IP address of your Minecraft server.
+
+- `-e SERVER_PORT=25565` : This variable sets the port number on which the Minecraft server is running. By default, Minecraft servers run on port 25565, but if your server is configured to use a different port, you should replace `25565` with the correct port number. This helps the monitoring system to accurately check the health status of the Minecraft server on the specified port.
+
+## OpenJ9 Specific Options
+
+The openj9 image tags include specific variables to simplify configuration:
+
+- `-e TUNE_VIRTUALIZED=TRUE` : enables the option to
+  [optimize for virtualized environments](https://www.eclipse.org/openj9/docs/xtunevirtualized/)
+- `-e TUNE_NURSERY_SIZES=TRUE` : configures nursery sizes where the initial size is 50%
+  of the `MAX_MEMORY` and the max size is 80%.
+
+## Enabling rolling logs
+
+By default the vanilla log file will grow without limit. The logger can be reconfigured to use a rolling log files strategy by using:
+
+```
+  -e ENABLE_ROLLING_LOGS=true
+```
+
+> **NOTE** this will interfere with interactive/color consoles [as described in the section above](#interactive-and-color-console)
+
+## Timezone Configuration
+
+You can configure the timezone to match yours by setting the `TZ` environment variable:
+
+        -e TZ=Europe/London
+
+such as:
+
+        docker run -d -it -e TZ=Europe/London -p 25565:25565 --name mc itzg/minecraft-server
+
+Or mounting `/etc/timezone` as readonly (not supported on Windows):
+
+        -v /etc/timezone:/etc/timezone:ro
+
+such as:
+
+        docker run -d -it -v /etc/timezone:/etc/timezone:ro -p 25565:25565 --name mc itzg/minecraft-server
+
+## HTTP Proxy
+
+You may configure the use of an HTTP/HTTPS proxy by passing the proxy's "host:port" via the environment variable `PROXY`. In [the example compose file](https://github.com/itzg/docker-minecraft-server/blob/master/examples/docker-compose-proxied.yml) it references a Squid proxy. The host and port can be separately passed via the environment variables `PROXY_HOST` and `PROXY_PORT`. A `|` delimited list of hosts to exclude from proxying can be passed via `PROXY_NON_PROXY_HOSTS`.
+
+## Using "noconsole" option
+
+Some older versions (pre-1.14) of Spigot required `--noconsole` to be passed when detaching stdin, which can be done by setting `-e CONSOLE=FALSE`.
+
+## Explicitly disable GUI
+
+Some older servers get confused and think that the GUI interface is enabled. You can explicitly
+disable that by passing `-e GUI=FALSE`.
+
+## Stop Duration
+
+When the container is signaled to stop, the Minecraft process wrapper will attempt to send a "stop" command via RCON or console and waits for the process to gracefully finish. By default, it waits 60 seconds, but that duration can be configured by setting the environment variable `STOP_DURATION` to the number of seconds.
+
+Be sure to also increase the shutdown timeout described [here for docker compose down](https://docs.docker.com/reference/cli/docker/compose/down/#options) and [here for docker stop](https://docs.docker.com/reference/cli/docker/container/stop/#options).
+
+## Setup only
+
+If you are using a host-attached data directory, then you can have the image setup the Minecraft server files and stop prior to launching the server process by setting `SETUP_ONLY` to `true`. 
+    
+## Enable Flare Flags
+    
+To enable the JVM flags required to fully support the [Flare profiling suite](https://blog.airplane.gg/flare), set the following variable:
+    
+    -e USE_FLARE_FLAGS=true
+    
+Flare is built-in to Pufferfish/Purpur, and is available in [plugin form](https://github.com/TECHNOVE/FlarePlugin) for other server types.
+
+## Enable support for optimized SIMD operations
+
+To enable support for optimized SIMD operations, the JVM flag can be set with the following variable:
+
+    -e USE_SIMD_FLAGS=true
+
+SIMD optimized operations are supported by Pufferfish and Purpur.
+
+## Downloading extra configuration files
+
+You can download additional configuration files or other resources before the server starts by using the `DOWNLOAD_EXTRA_CONFIGS` environment variable. This is useful for downloading configs that you want to patch or modify during the startup process.
+
+The format uses a `<` separator between the destination path and the source URL:
+
+```
+DOWNLOAD_EXTRA_CONFIGS=destination<source_url[,destination2<source_url2,...]
+```
+
+For example, to download configuration files for plugins:
+
+```yaml
+environment:
+  DOWNLOAD_EXTRA_CONFIGS: |
+    plugins/WorldEdit<https://raw.githubusercontent.com/EngineHub/WorldEdit/refs/heads/version/7.3.x/worldedit-bukkit/src/main/resources/defaults/config.yml
+    plugins/EssentialsX<https://raw.githubusercontent.com/EssentialsX/Essentials/refs/heads/2.x/Essentials/src/main/resources/config.yml
+```
+
+Or as a single line:
+
+```yaml
+environment:
+  DOWNLOAD_EXTRA_CONFIGS: "plugins/WorldEdit<https://example.com/worldedit.yml,config<https://example.com/another.yml"
+```
+
+The files will be downloaded to `/data/` relative paths, so `plugins/WorldEdit` will be saved as `/data/plugins/WorldEdit/config.yml`.
+
+!!! note 
+    The downloaded files can be further processed using [environment variable replacement](interpolating.md) or [patch definitions](interpolating.md#patching-existing-files)
+
+## Enable timestamps in init logs
+
+Before the container starts the Minecraft Server its output is prefixed with `[init]`, such as
+
+```
+[init] Starting the Minecraft server...
+```
+
+To also include the timestamp with each log, set `LOG_TIMESTAMP` to "true". The log output will then look like:
+
+```
+[init] 2022-02-05 16:58:33+00:00 Starting the Minecraft server...
+```
--- a/docs/configuration/server-properties.md
+++ b/docs/configuration/server-properties.md
@@ -396,47 +396,51 @@ When using `docker run` from a bash shell, the entries must be quoted with the `

 ### Other server property mappings

-| Environment Variable              | Server Property                                                                                                   |
-|-----------------------------------|-------------------------------------------------------------------------------------------------------------------|
-| ACCEPTS_TRANSFERS                 | [accepts-transfers](https://minecraft.wiki/w/Server.properties#accepts-transfers)                                 |
-| ALLOW_FLIGHT                      | [allow-flight](https://minecraft.wiki/w/Server.properties#allow-flight)                                           |
-| ALLOW_NETHER                      | [allow-nether](https://minecraft.wiki/w/Server.properties#allow-nether)                                           |
-| BROADCAST_CONSOLE_TO_OPS          | [broadcast-console-to-ops](https://minecraft.wiki/w/Server.properties#broadcast-console-to-ops)                   |
-| BROADCAST_RCON_TO_OPS             | [broadcast-rcon-to-ops](https://minecraft.wiki/w/Server.properties#broadcast-rcon-to-ops)                         |
-| BUG_REPORT_LINK                   | [bug-report-link](https://minecraft.wiki/w/Server.properties#bug-report-link)                                     |
-| ENABLE_COMMAND_BLOCK              | [enable-command-block](https://minecraft.wiki/w/Server.properties#enable-command-block)                           |
-| ENABLE_STATUS                     | [enable-status](https://minecraft.wiki/w/Server.properties#enable-status)                                         |
-| ENFORCE_SECURE_PROFILE            | [enforce-secure-profile](https://minecraft.wiki/w/Server.properties#enforce-secure-profile)                       |
-| ENTITY_BROADCAST_RANGE_PERCENTAGE | [entity-broadcast-range-percentage](https://minecraft.wiki/w/Server.properties#entity-broadcast-range-percentage) |
-| FORCE_GAMEMODE                    | [force-gamemode](https://minecraft.wiki/w/Server.properties#force-gamemode)                                       |
-| FUNCTION_PERMISSION_LEVEL         | [function-permission-level](https://minecraft.wiki/w/Server.properties#function-permission-level)                 |
-| GENERATE_STRUCTURES               | [generate-structures](https://minecraft.wiki/w/Server.properties#generate-structures)                             |
-| HARDCORE                          | [hardcore](https://minecraft.wiki/w/Server.properties#hardcore)                                                   |
-| HIDE_ONLINE_PLAYERS               | [hide-online-players](https://minecraft.wiki/w/Server.properties#hide-online-players)                             |
-| LOG_IPS                           | [log-ips](https://minecraft.wiki/w/Server.properties#log-ips)                                                     |
-| MANAGEMENT_SERVER_ENABLED         | [management-server-enabled](https://minecraft.wiki/w/Server.properties#management-server-enabled)                 |
-| MANAGEMENT_SERVER_HOST            | [management-server-host](https://minecraft.wiki/w/Server.properties#management-server-host)                       |
-| MANAGEMENT_SERVER_PORT            | [management-server-port](https://minecraft.wiki/w/Server.properties#management-server-port)                       |
-| MAX_CHAINED_NEIGHBOR_UPDATES      | [max-chained-neighbor-updates](https://minecraft.wiki/w/Server.properties#max-chained-neighbor-updates)           |
-| MAX_PLAYERS                       | [max-players](https://minecraft.wiki/w/Server.properties#max-players)                                             |
-| MAX_TICK_TIME                     | [max-tick-time](https://minecraft.wiki/w/Server.properties#max-tick-time)                                         |
-| MAX_WORLD_SIZE                    | [max-world-size](https://minecraft.wiki/w/Server.properties#max-world-size)                                       |
-| NETWORK_COMPRESSION_THRESHOLD     | [network-compression-threshold](https://minecraft.wiki/w/Server.properties#network-compression-threshold)         |
-| ONLINE_MODE                       | [online-mode](https://minecraft.wiki/w/Server.properties#online-mode)                                             |
-| OP_PERMISSION_LEVEL               | [op-permission-level](https://minecraft.wiki/w/Server.properties#op-permission-level)                             |
-| PAUSE_WHEN_EMPTY_SECONDS          | [pause-when-empty-seconds](https://minecraft.wiki/w/Server.properties#pause-when-empty-seconds)                   |
-| PLAYER_IDLE_TIMEOUT               | [player-idle-timeout](https://minecraft.wiki/w/Server.properties#player-idle-timeout)                             |
-| PREVENT_PROXY_CONNECTIONS         | [prevent-proxy-connections](https://minecraft.wiki/w/Server.properties#prevent-proxy-connections)                 |
-| PVP                               | [pvp](https://minecraft.wiki/w/Server.properties#pvp)                                                             |
-| RATE_LIMIT                        | [rate-limit](https://minecraft.wiki/w/Server.properties#rate-limit)                                               |
-| REGION_FILE_COMPRESSION           | [region-file-compression](https://minecraft.wiki/w/Server.properties#region-file-compression)                     |   
-| RESOURCE_PACK_ID                  | [resource-pack-id](https://minecraft.wiki/w/Server.properties#resource-pack-id)                                   |
-| RESOURCE_PACK_PROMPT              | [resource-pack-prompt](https://minecraft.wiki/w/Server.properties#resource-pack-prompt)                           |
-| SERVER_NAME                       | [server-name](https://minecraft.wiki/w/Server.properties#server-name)                                             |
-| SIMULATION_DISTANCE               | [simulation-distance](https://minecraft.wiki/w/Server.properties#simulation-distance)                             |
-| SPAWN_MONSTERS                    | [spawn-monsters](https://minecraft.wiki/w/Server.properties#spawn-monsters)                                       |
-| SPAWN_PROTECTION                  | [spawn-protection](https://minecraft.wiki/w/Server.properties#spawn-protection)                                   |
-| STATUS_HEARTBEAT_INTERVAL         | [status-heartbeat-interval](https://minecraft.wiki/w/Server.properties#status-heartbeat-interval)                 |
-| SYNC_CHUNK_WRITES                 | [sync-chunk-writes](https://minecraft.wiki/w/Server.properties#sync-chunk-writes)                                 |
-| USE_NATIVE_TRANSPORT              | [use-native-transport](https://minecraft.wiki/w/Server.properties#use-native-transport)                           |
-| VIEW_DISTANCE                     | [view-distance](https://minecraft.wiki/w/Server.properties#view-distance)                                         |
+| Environment Variable                    | Server Property                                                                                                               |
+|-----------------------------------------|-------------------------------------------------------------------------------------------------------------------------------|
+| ACCEPTS_TRANSFERS                       | [accepts-transfers](https://minecraft.wiki/w/Server.properties#accepts-transfers)                                             |
+| ALLOW_FLIGHT                            | [allow-flight](https://minecraft.wiki/w/Server.properties#allow-flight)                                                       |
+| ALLOW_NETHER                            | [allow-nether](https://minecraft.wiki/w/Server.properties#allow-nether)                                                       |
+| BROADCAST_CONSOLE_TO_OPS                | [broadcast-console-to-ops](https://minecraft.wiki/w/Server.properties#broadcast-console-to-ops)                               |
+| BROADCAST_RCON_TO_OPS                   | [broadcast-rcon-to-ops](https://minecraft.wiki/w/Server.properties#broadcast-rcon-to-ops)                                     |
+| BUG_REPORT_LINK                         | [bug-report-link](https://minecraft.wiki/w/Server.properties#bug-report-link)                                                 |
+| ENABLE_COMMAND_BLOCK                    | [enable-command-block](https://minecraft.wiki/w/Server.properties#enable-command-block)                                       |
+| ENABLE_STATUS                           | [enable-status](https://minecraft.wiki/w/Server.properties#enable-status)                                                     |
+| ENFORCE_SECURE_PROFILE                  | [enforce-secure-profile](https://minecraft.wiki/w/Server.properties#enforce-secure-profile)                                   |
+| ENTITY_BROADCAST_RANGE_PERCENTAGE       | [entity-broadcast-range-percentage](https://minecraft.wiki/w/Server.properties#entity-broadcast-range-percentage)             |
+| FORCE_GAMEMODE                          | [force-gamemode](https://minecraft.wiki/w/Server.properties#force-gamemode)                                                   |
+| FUNCTION_PERMISSION_LEVEL               | [function-permission-level](https://minecraft.wiki/w/Server.properties#function-permission-level)                             |
+| GENERATE_STRUCTURES                     | [generate-structures](https://minecraft.wiki/w/Server.properties#generate-structures)                                         |
+| HARDCORE                                | [hardcore](https://minecraft.wiki/w/Server.properties#hardcore)                                                               |
+| HIDE_ONLINE_PLAYERS                     | [hide-online-players](https://minecraft.wiki/w/Server.properties#hide-online-players)                                         |
+| LOG_IPS                                 | [log-ips](https://minecraft.wiki/w/Server.properties#log-ips)                                                                 |
+| MANAGEMENT_SERVER_ENABLED               | [management-server-enabled](https://minecraft.wiki/w/Server.properties#management-server-enabled)                             |
+| MANAGEMENT_SERVER_HOST                  | [management-server-host](https://minecraft.wiki/w/Server.properties#management-server-host)                                   |
+| MANAGEMENT_SERVER_PORT                  | [management-server-port](https://minecraft.wiki/w/Server.properties#management-server-port)                                   |
+| MANAGEMENT_SERVER_SECRET                | [management-server-secret](https://minecraft.wiki/w/Server.properties#management-server-secret)                               |
+| MANAGEMENT_SERVER_TLS_ENABLED           | [management-server-tls-enabled](https://minecraft.wiki/w/Server.properties#management-server-tls-enabled)                     |
+| MANAGEMENT_SERVER_TLS_KEYSTORE          | [management-server-tls-keystore](https://minecraft.wiki/w/Server.properties#management-server-tls-keystore)                   |
+| MANAGEMENT_SERVER_TLS_KEYSTORE_PASSWORD | [management-server-tls-keystore-password](https://minecraft.wiki/w/Server.properties#management-server-tls-keystore-password) |
+| MAX_CHAINED_NEIGHBOR_UPDATES            | [max-chained-neighbor-updates](https://minecraft.wiki/w/Server.properties#max-chained-neighbor-updates)                       |
+| MAX_PLAYERS                             | [max-players](https://minecraft.wiki/w/Server.properties#max-players)                                                         |
+| MAX_TICK_TIME                           | [max-tick-time](https://minecraft.wiki/w/Server.properties#max-tick-time)                                                     |
+| MAX_WORLD_SIZE                          | [max-world-size](https://minecraft.wiki/w/Server.properties#max-world-size)                                                   |
+| NETWORK_COMPRESSION_THRESHOLD           | [network-compression-threshold](https://minecraft.wiki/w/Server.properties#network-compression-threshold)                     |
+| ONLINE_MODE                             | [online-mode](https://minecraft.wiki/w/Server.properties#online-mode)                                                         |
+| OP_PERMISSION_LEVEL                     | [op-permission-level](https://minecraft.wiki/w/Server.properties#op-permission-level)                                         |
+| PAUSE_WHEN_EMPTY_SECONDS                | [pause-when-empty-seconds](https://minecraft.wiki/w/Server.properties#pause-when-empty-seconds)                               |
+| PLAYER_IDLE_TIMEOUT                     | [player-idle-timeout](https://minecraft.wiki/w/Server.properties#player-idle-timeout)                                         |
+| PREVENT_PROXY_CONNECTIONS               | [prevent-proxy-connections](https://minecraft.wiki/w/Server.properties#prevent-proxy-connections)                             |
+| PVP                                     | [pvp](https://minecraft.wiki/w/Server.properties#pvp)                                                                         |
+| RATE_LIMIT                              | [rate-limit](https://minecraft.wiki/w/Server.properties#rate-limit)                                                           |
+| REGION_FILE_COMPRESSION                 | [region-file-compression](https://minecraft.wiki/w/Server.properties#region-file-compression)                                 |
+| RESOURCE_PACK_ID                        | [resource-pack-id](https://minecraft.wiki/w/Server.properties#resource-pack-id)                                               |
+| RESOURCE_PACK_PROMPT                    | [resource-pack-prompt](https://minecraft.wiki/w/Server.properties#resource-pack-prompt)                                       |
+| SERVER_NAME                             | [server-name](https://minecraft.wiki/w/Server.properties#server-name)                                                         |
+| SIMULATION_DISTANCE                     | [simulation-distance](https://minecraft.wiki/w/Server.properties#simulation-distance)                                         |
+| SPAWN_MONSTERS                          | [spawn-monsters](https://minecraft.wiki/w/Server.properties#spawn-monsters)                                                   |
+| SPAWN_PROTECTION                        | [spawn-protection](https://minecraft.wiki/w/Server.properties#spawn-protection)                                               |
+| STATUS_HEARTBEAT_INTERVAL               | [status-heartbeat-interval](https://minecraft.wiki/w/Server.properties#status-heartbeat-interval)                             |
+| SYNC_CHUNK_WRITES                       | [sync-chunk-writes](https://minecraft.wiki/w/Server.properties#sync-chunk-writes)                                             |
+| USE_NATIVE_TRANSPORT                    | [use-native-transport](https://minecraft.wiki/w/Server.properties#use-native-transport)                                       |
+| VIEW_DISTANCE                           | [view-distance](https://minecraft.wiki/w/Server.properties#view-distance)                                                     |
--- a/docs/img/modrinth-copy-project-id.png
+++ b/docs/img/modrinth-copy-project-id.png
--- a/docs/misc/contributing/development.md
+++ b/docs/misc/contributing/development.md
@@ -47,20 +47,20 @@ 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
-docker run -it --rm -v ${PWD}:/scripts -e SCRIPTS=/scripts/ --entrypoint bash mc-dev
+docker run -it --rm -v ${PWD}:/image/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:
+From within the container you can run individual scripts via the attached `/image/scripts/` path; however, be sure to set any environment variables expected by the scripts by either `export`ing them manually:

 ```shell
 export VERSION=1.12.2
-/scripts/start-magma
+/image/scripts/start-deployFabric
 ```

 ...or pre-pending script execution:

 ```shell
-VERSION=1.12.2 /scripts/start-magma
+VERSION=1.12.2 /image/scripts/start-deployFabric
 ```

 !!! note
@@ -69,15 +69,28 @@ VERSION=1.12.2 /scripts/start-magma

 ## 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 repo, such as [`mc-image-helper`](https://github.com/itzg/mc-image-helper), install the distribution locally by running:

 ```shell
-./gradlew distTar
+./gradlew installDist
 ```

-!!! note
+The distribution will be installed in the project's `build/install/mc-image-helper`. Obtain the absolute path to that directory use in the next step.

-    The distribution's version will be `0.0.0-<branch>-SNAPSHOT`
+Refer to the instructions above to mount any locally modified image scripts or build a local copy of the image using or with alternate `BASE_IMAGE`, as described above:
+
+```shell
+docker build -t itzg/minecraft-server .
+```
+
+Mount the local mc-image-helper distribution directory as a volume in the container at the path `/usr/share/mc-image-helper`, such as
+
+```shell
+docker run -it --rm \
+  -v /path/to/mc-image-helper/build/install/mc-image-helper:/usr/share/mc-image-helper \
+  -e EULA=true \
+  itzg/minecraft-server
+```

 For Go base tools, run

--- a/docs/mods-and-plugins/index.md
+++ b/docs/mods-and-plugins/index.md
@@ -133,6 +133,14 @@ The newline delimiting allows for compose file usage like:
        https://download.geysermc.org/v2/projects/floodgate/versions/latest/builds/latest/downloads/spigot
 ```

+!!! note "Auto-removal"
+
+    Entries that are removed from the `MODS` or `PLUGINS` list will be automatically removed from the `mods` or `plugins` directory. This is useful for removing mods/plugins that are no longer needed. An empty `MODS` or `PLUGINS` list will remove all mods/plugins.
+
+!!! note "Disable processing"
+
+    To temporarily disable processing of the `MODS` or `PLUGINS` list, then comment out the `MODS` or `PLUGINS` environment variable.
+
 ## Mod/Plugin URL Listing File 

 As an alternative to `MODS`/`PLUGINS`, the variable `MODS_FILE` or `PLUGINS_FILE` can be set with the container path or URL of a text file listing a mod/plugin URLs on each line. For example, the following
--- a/docs/mods-and-plugins/modrinth.md
+++ b/docs/mods-and-plugins/modrinth.md
@@ -2,28 +2,46 @@

 [Modrinth](https://modrinth.com/) is an open source modding platform with a clean, easy to use website for finding [Fabric, Forge, etc mods](https://modrinth.com/mods) and [Paper, etc plugins](https://modrinth.com/plugins), and [datapacks](https://modrinth.com/datapacks). At startup, the container will automatically locate and download the newest versions of mod/plugin files that correspond to the `TYPE` and `VERSION` in use. Older file versions downloaded previously will automatically be cleaned up.

- **MODRINTH_PROJECTS** : comma or newline separated list of project slugs (short name) or IDs. The project ID is located in the "Technical information" section. The project slug is the part of the URL that follows `/mod/`, `/plugin/`, or `/datapack/`. For example:
-  ```
+## Usage
+
+To use this feature, set the environment variable `MODRINTH_PROJECTS` to a comma or newline separated list of project slugs (short name) or IDs.  
+
+!!! tip "Project ID"
+
+    The project ID can be copied to the clipboard from the project page menu:
+
+    ![Modrinth copy project ID](../img/modrinth-copy-project-id.png)
+
+!!! tip "Project Slug"
+
+    The project slug is the part of the URL that follows `/mod/`, `/plugin/`, or `/datapack/`. For example:
+    
+    ```
    https://modrinth.com/mod/fabric-api
                             ----------
                              |
                              +-- project slug
-  ```
-  Also, a specific version (or release type) can be declared adding a colon and then the version id, version number/name, or release type after the project slug. The version ID or number can be found in the 'Metadata' section. Valid release types are `release`, `beta`, `alpha`.
-  
-  To select a datapack from a Modrinth project, prefix the entry with "datapack:". When running a vanilla server, this is optional since only datapacks will be available for vanilla servers to select.
-  
-  You can also reference a file containing project entries by prefixing the **container path** path with `@`.
-        
-  | Description                     | Example projects entry                                |
-  |---------------------------------|-------------------------------------------------------|
-  | Select latest version           | `fabric-api`                                          |
-  | Select specific version         | `fabric-api:bQZpGIz0`<br/>`fabric-api:0.119.2+1.21.4` |
-  | Select latest beta version      | `fabric-api:beta`                                     |
-  | Latest version using project ID | `P7dR8mSH`                                            |
-  | Latest version of datapack      | `datapack:terralith`                                  |
-  | Specific version of datapack    | `datapack:terralith:2.5.5`                            |
-  | Projects Listing File           | `@/path/to/modrinth-mods.txt`                         |
+    ```
+
+Also, a specific version (or release type) can be declared by adding a colon and then the version id, version number/name, or release type after the project slug. The version ID or number can be found in the 'Metadata' section. Valid release types are `release`, `beta`, `alpha`.
+
+To select a datapack from a Modrinth project, prefix the entry with "datapack:". When running a vanilla server, this is optional since only datapacks will be available for vanilla servers to select.
+
+You can also reference a file containing project entries by prefixing the **container path** path with `@`.
+
+### Examples
+            
+| Description                     | Example projects entry                                |
+|---------------------------------|-------------------------------------------------------|
+| Select latest version           | `fabric-api`                                          |
+| Select specific version         | `fabric-api:bQZpGIz0`<br/>`fabric-api:0.119.2+1.21.4` |
+| Select latest beta version      | `fabric-api:beta`                                     |
+| Latest version using project ID | `P7dR8mSH`                                            |
+| Latest version of datapack      | `datapack:terralith`                                  |
+| Specific version of datapack    | `datapack:terralith:2.5.5`                            |
+| Projects Listing File           | `@/path/to/modrinth-mods.txt`                         |
+
+### Notes

 !!! info "More about listing files"

@@ -42,6 +60,14 @@
    datapack:terralith
    ```

+!!! note "Auto-removal"
+
+    Entries that are removed from the `MODRINTH_PROJECTS` list will be automatically removed from the `mods` or `plugins` directory. This is useful for removing mods/plugins that are no longer needed. An empty `MODRINTH_PROJECTS` list will remove all mods/plugins.
+
+!!! note "Disable processing"
+
+    To temporarily disable processing of the `MODRINTH_PROJECTS` list, then comment out the `MODRINTH_PROJECTS` environment variable.
+
 ## Version from Projects

 When the environment variable `VERSION_FROM_MODRINTH_PROJECTS` is set to "true" the Minecraft [`VERSION`](../versions/minecraft.md) will be automatically determined by looking at the most recent version of Minecraft that is supported by all the projects provided in `MODRINTH_PROJECTS`.
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,6 +1,6 @@
-mkdocs-material == 9.6.18
+mkdocs-material == 9.6.21
 mkdocs-autorefs == 1.4.3
-mkdocstrings[python] == 0.30.0
+mkdocstrings[python] == 0.30.1
 mkdocs-literate-nav == 0.6.2
 mdx-gh-links == 0.4
 mkdocs-click == 0.9.0
--- a/docs/versions/java.md
+++ b/docs/versions/java.md
@@ -14,8 +14,8 @@ where `<tag>` refers to the first column of this table:
 |----------------|--------------|--------|--------------------|---------------------|------|
 | latest         | 21           | Ubuntu | Hotspot            | amd64, arm64        |      |
 | stable         | 21           | Ubuntu | Hotspot            | amd64, arm64        |      |
-| java24         | 24           | Ubuntu | Hotspot            | amd64, arm64        | (2)  |
-| java24-graalvm | 24           | Oracle | Oracle GraalVM (3) | amd64, arm64        | (2)  |   
+| java25         | 25           | Ubuntu | Hotspot            | amd64, arm64        |      |
+| java25-graalvm | 25           | Oracle | Oracle GraalVM (3) | amd64, arm64        |      |   
 | java21         | 21           | Ubuntu | Hotspot            | amd64, arm64        |      |
 | java21-jdk     | 21           | Ubuntu | Hotspot+JDK        | amd64, arm64        |      |
 | java21-alpine  | 21           | Alpine | Hotspot            | amd64, arm64        |      |
@@ -137,6 +137,7 @@ The following image tags have been deprecated and are no longer receiving update
 - java19
 - java20-graalvm, java20, java20-alpine
 - java23-*
+- java24, java24-graalvm 
 - java8-multiarch is still built and pushed, but please move to java8 instead
 - java8-alpine, java8-jdk, java8-openj9, java8-graalvm-ce

--- a/examples/gtnh/docker-compose.yaml
+++ b/examples/gtnh/docker-compose.yaml
@@ -9,15 +9,24 @@ services:
    environment:
      EULA: "TRUE"
      TYPE: CUSTOM
-      GENERIC_PACKS: GT_New_Horizons_2.7.2_Server_Java_17-21
+      GENERIC_PACKS: GT_New_Horizons_2.8.0_Server_Java_17-25
      GENERIC_PACKS_SUFFIX: .zip
      GENERIC_PACKS_PREFIX: https://downloads.gtnewhorizons.com/ServerPacks/
      # if this isn't true, then the container tries to download the modpack every run
      SKIP_GENERIC_PACK_UPDATE_CHECK: "true"
      MEMORY: 6G
      # Make sure that this matches what is in your pack's startserver bash file
-      JVM_OPTS: -Dfml.readTimeout=180 @java9args.txt
-      CUSTOM_JAR_EXEC: -jar lwjgl3ify-forgePatches.jar nogui
+      JVM_OPTS: "-Dfml.readTimeout=180 @java9args.txt"
+      CUSTOM_SERVER: "lwjgl3ify-forgePatches.jar"
+      # Set server.properties according to GTNH server defaults
+      MOTD: "GT:New Horizons 2.8.0"
+      DIFFICULTY: "hard"
+      ENABLE_COMMAND_BLOCK: "true"
+      SPAWN_PROTECTION: 1
+      VIEW_DISTANCE: 8
+      MODE: 0
+      LEVEL_TYPE: "rwg"
+      ALLOW_FLIGHT: "TRUE"
    volumes:
      # attach a managed volume, change to a relative or absolute host directory if needed
      - mc-data:/data
--- a/files/cf-exclude-include.json
+++ b/files/cf-exclude-include.json
@@ -1,195 +1,204 @@
-{
-  "globalExcludes": [
-    "advancement-plaques",
-    "ambience-music-mod",
-    "ambientsounds",
-    "appleskin",
-    "armor-chroma",
-    "armor-toughness-bar",
-    "audio-extension-for-fancymenu-forge",
-    "auudio-forge",
-    "beehivetooltips",
-    "better-advancements",
-    "better-foliage",
-    "better-modlist-neoforge",
-    "better-placement",
-    "better-sprinting",
-    "better-third-person",
-    "better-tips-nbt-tag",
-    "betterf3",
-    "betterfps",
-    "bettergrassify",
-    "biomeinfo",
-    "block-drops-jei-addon",
-    "blur-forge",
-    "cartography",
-    "chattoggle",
-    "cherished-worlds",
-    "chunk-animator",
-    "clickable-advancements",
-    "compass-coords",
-    "config-menus-forge",
-    "configured",
-    "controllable",
-    "controlling",
-    "craftpresence",
-    "ctm",
-    "custom-main-menu",
-    "dark-mode-everywhere",
-    "defensive-measures",
-    "ding",
-    "distraction-free-recipes",
-    "drippy-loading-screen",
-    "dynamic-surroundings",
-    "dynamic-view",
-    "dynamiclights-reforged",
-    "easiervillagertrading",
-    "effective-forge",
-    "embeddium",
-    "embeddium-extension",
-    "embeddium-extras",
-    "enchantment-descriptions",
-    "enhanced-boss-bars",
-    "enhancedvisuals",
-    "entity-collision-fps-fix",
-    "entity-model-features",
-    "entity-texture-features-fabric",
-    "entityculling",
-    "equipment-compare",
-    "essential-mod",
-    "euphoria-patches",
-    "extreme-sound-muffler",
-    "ezzoom",
-    "fading-night-vision",
-    "falling-leaves-forge",
-    "fancymenu",
-    "farsight",
-    "faster-ladder-climbing",
-    "fastquit",
-    "fastquit-forge",
-    "flerovium",
-    "foamfix-optimization-mod",
-    "forgeskyboxes",
-    "fps-reducer",
-    "free-cam",
-    "ftb-backups-2",
-    "fullscreen-windowed-borderless-for-minecraft",
-    "hwyla",
-    "iceberg",
-    "ignitioncoil",
-    "illager-raid-music",
-    "inmisaddon",
-    "iris-flywheel-compat",
-    "irisshaders",
-    "item-borders",
-    "item-highlighter",
-    "item-obliterator",
-    "itemphysic-lite",
-    "itemzoom",
-    "just-enough-harvestcraft",
-    "just-enough-mekanism-multiblocks",
-    "just-enough-resources-jer",
-    "just-zoom",
-    "legendary-tooltips",
-    "lighty",
-    "loot-capacitor-tooltips",
-    "loot-journal",
-    "lootbeams",
-    "magnesium-extras",
-    "make-bubbles-pop",
-    "menumobs",
-    "minecraft-rich-presence",
-    "model-gap-fix",
-    "more-overlays",
-    "mouse-tweaks",
-    "neat",
-    "nekos-enchanted-books",
-    "no-nv-flash",
-    "no-recipe-book",
-    "not-enough-animations",
-    "oculus",
-    "oldjavawarning",
-    "overloaded-armor-bar",
-    "packmenu",
-    "packmodemenu",
-    "particle-effects",
-    "particle-effects-reforged",
-    "particular",
-    "particular-reforged",
-    "reauth",
-    "rebind-narrator",
-    "reblured",
-    "reeses-sodium-options",
-    "reforgium",
-    "resource-reloader",
-    "rubidium",
-    "rubidium-extra",
-    "ryoamiclights",
-    "schematica",
-    "seamless-loading-screen",
-    "seamless-loading-screen-forge",
-    "searchables",
-    "seasonhud",
-    "shulkerboxviewer",
-    "skin-layers-3d",
-    "smart-hud",
-    "smithing-template-viewer",
-    "smooth-font",
-    "smoothwater",
-    "sodium",
-    "sodium-extra",
-    "sodium-options-api",
-    "sodium-rubidium-occlusion-culling-fix",
-    "sound",
-    "sound-filters",
-    "sound-physics-remastered",
-    "sound-reloader",
-    "stellar-sky",
-    "swingthroughgrass",
-    "textrues-embeddium-options",
-    "textrues-rubidium-options",
-    "thaumic-jei",
-    "tips",
-    "toast-control",
-    "torohealth-damage-indicators",
-    "true-darkness",
-    "ungrab-mouse-mod",
-    "vanillafix",
-    "visuality",
-    "waila-harvestability",
-    "waila-stages",
-    "wakes-reforged",
-    "wawla",
-    "welcome-screen",
-    "xaeroplus",
-    "yungs-menu-tweaks",
-    "zume"
-  ],
-  "modpacks": {
-    "all-of-fabric-6": {
-      "forceIncludes": ["revelationary"]
-    },
-    "beyond-depth": {
-      "forceIncludes": ["particular-reforged"]
-    },
-    "create-arcane-engineering": {
-      "forceIncludes": ["just-enough-resources-jer"]
-    },
-    "skyfactory-5": {
-      "forceIncludes": [
-        "colored-torches",
-        "dye-mob-dye",
-        "openstairs"
-      ]
-    },
-    "valhelsia-5": {
-      "excludes": ["modernfix"]
-    },
-    "mc-eternal-2": {
-      "forceIncludes": [
-        "particular-reforged",
-        "mob-player-animator"
-      ]
-    }
-  }
-}
+{
+  "globalExcludes": [
+    "advancement-plaques",
+    "ambience-music-mod",
+    "ambientsounds",
+    "appleskin",
+    "armor-chroma",
+    "armor-toughness-bar",
+    "audio-extension-for-fancymenu-forge",
+    "auudio-forge",
+    "beehivetooltips",
+    "better-advancements",
+    "better-foliage",
+    "better-modlist-neoforge",
+    "better-placement",
+    "better-sprinting",
+    "better-third-person",
+    "better-tips-nbt-tag",
+    "betterf3",
+    "betterfps",
+    "bettergrassify",
+    "biomeinfo",
+    "block-drops-jei-addon",
+    "blur-forge",
+    "cartography",
+    "chattoggle",
+    "cherished-worlds",
+    "chunk-animator",
+    "clickable-advancements",
+    "colorwheel",
+    "colorwheel-patcher",
+    "compass-coords",
+    "config-menus-forge",
+    "configured",
+    "controllable",
+    "controlling",
+    "craftpresence",
+    "ctm",
+    "custom-main-menu",
+    "dark-mode-everywhere",
+    "defensive-measures",
+    "ding",
+    "distraction-free-recipes",
+    "drippy-loading-screen",
+    "dynamic-surroundings",
+    "dynamic-view",
+    "dynamiclights-reforged",
+    "easiervillagertrading",
+    "effective-forge",
+    "embeddium",
+    "embeddium-extension",
+    "embeddium-extras",
+    "enchantment-descriptions",
+    "enhanced-boss-bars",
+    "enhancedvisuals",
+    "entity-collision-fps-fix",
+    "entity-model-features",
+    "entity-texture-features-fabric",
+    "entityculling",
+    "equipment-compare",
+    "essential-mod",
+    "euphoria-patches",
+    "extreme-sound-muffler",
+    "ezzoom",
+    "fading-night-vision",
+    "falling-leaves-forge",
+    "fancymenu",
+    "farsight",
+    "faster-ladder-climbing",
+    "fastquit",
+    "fastquit-forge",
+    "flerovium",
+    "foamfix-optimization-mod",
+    "forgeskyboxes",
+    "fps-reducer",
+    "free-cam",
+    "ftb-backups-2",
+    "fullscreen-windowed-borderless-for-minecraft",
+    "hwyla",
+    "iceberg",
+    "ignitioncoil",
+    "illager-raid-music",
+    "inmisaddon",
+    "iris-flywheel-compat",
+    "irisshaders",
+    "item-borders",
+    "item-highlighter",
+    "item-obliterator",
+    "itemphysic-lite",
+    "itemzoom",
+    "just-enough-harvestcraft",
+    "just-enough-mekanism-multiblocks",
+    "just-enough-resources-jer",
+    "just-zoom",
+    "legendary-tooltips",
+    "lighty",
+    "loot-capacitor-tooltips",
+    "loot-journal",
+    "lootbeams",
+    "magnesium-extras",
+    "make-bubbles-pop",
+    "menumobs",
+    "minecraft-rich-presence",
+    "model-gap-fix",
+    "more-overlays",
+    "mouse-tweaks",
+    "neat",
+    "nekos-enchanted-books",
+    "no-nv-flash",
+    "no-recipe-book",
+    "not-enough-animations",
+    "oculus",
+    "ok-zoomer",
+    "oldjavawarning",
+    "overloaded-armor-bar",
+    "packmenu",
+    "packmodemenu",
+    "particle-effects",
+    "particle-effects-reforged",
+    "particle-rain",
+    "particular",
+    "particular-reforged",
+    "reauth",
+    "rebind-narrator",
+    "reblured",
+    "reeses-sodium-options",
+    "reforgium",
+    "resource-reloader",
+    "rubidium",
+    "rubidium-extra",
+    "ryoamiclights",
+    "schematica",
+    "seamless-loading-screen",
+    "seamless-loading-screen-forge",
+    "searchables",
+    "seasonhud",
+    "shulkerboxviewer",
+    "skin-layers-3d",
+    "smart-hud",
+    "smithing-template-viewer",
+    "smooth-font",
+    "smoothwater",
+    "sodium",
+    "sodium-extra",
+    "sodium-options-api",
+    "sodium-rubidium-occlusion-culling-fix",
+    "sound",
+    "sound-filters",
+    "sound-physics-remastered",
+    "sound-reloader",
+    "stellar-sky",
+    "swingthroughgrass",
+    "textrues-embeddium-options",
+    "textrues-rubidium-options",
+    "thaumic-jei",
+    "tips",
+    "toast-control",
+    "torohealth-damage-indicators",
+    "true-darkness",
+    "ungrab-mouse-mod",
+    "vanillafix",
+    "visuality",
+    "waila-harvestability",
+    "waila-stages",
+    "wakes-reforged",
+    "wawla",
+    "welcome-screen",
+    "xaeroplus",
+    "yungs-menu-tweaks",
+    "zume"
+  ],
+  "modpacks": {
+    "all-of-fabric-6": {
+      "forceIncludes": ["revelationary"]
+    },
+    "beyond-depth": {
+      "forceIncludes": ["particular-reforged"]
+    },
+    "create-arcane-engineering": {
+      "forceIncludes": ["just-enough-resources-jer"]
+    },
+    "mc-eternal-2": {
+      "forceIncludes": [
+        "particular-reforged",
+        "mob-player-animator"
+      ]
+    },
+    "reclamation-reclaim-the-world": {
+      "forceIncludes": [
+        "more-overlays-updated"
+      ]
+    },
+    "skyfactory-5": {
+      "forceIncludes": [
+        "colored-torches",
+        "dye-mob-dye",
+        "openstairs"
+      ]
+    },
+    "valhelsia-5": {
+      "excludes": ["modernfix"]
+    }
+  }
+}
--- a/files/auto/knockd-config.cfg
+++ b/files/auto/knockd-config.cfg
@@ -3,14 +3,14 @@
 [unpauseMCServer-server]
 sequence = 25565
 seq_timeout = 1
- command = /auto/resume.sh %IP%
+ command = /image/scripts/auto/resume.sh %IP%
 tcpflags = syn
 [unpauseMCServer-rcon]
 sequence = 25575
 seq_timeout = 1
- command = /auto/resume.sh %IP%
+ command = /image/scripts/auto/resume.sh %IP%
 tcpflags = syn
 [unpauseMCServer-bedrock]
 sequence = 19132:udp
- command = /auto/resume.sh %IP%
+ command = /image/scripts/auto/resume.sh %IP%
 seq_cooldown = 60
--- a/files/modrinth-exclude-include.json
+++ b/files/modrinth-exclude-include.json
@@ -26,6 +26,7 @@
    "clickadv",
    "cobblemon-ui-tweaks",
    "compass-coords",
+    "colorwheel",
    "connectedness",
    "connector",
    "continuity",
@@ -74,7 +75,9 @@
    "nicer-skies",
    "notenoughanimations",
    "oculus",
+    "ok_zoomer",
    "OverflowingBars",
+    "particlerain",
    "PickUpNotifier",
    "PresenceFootsteps",
    "Prism",
--- a/files/property-definitions.json
+++ b/files/property-definitions.json
@@ -31,6 +31,10 @@
  "management-server-enabled": {"env": "MANAGEMENT_SERVER_ENABLED"},
  "management-server-host": {"env": "MANAGEMENT_SERVER_HOST"},
  "management-server-port": {"env": "MANAGEMENT_SERVER_PORT"},
+  "management-server-secret": {"env": "MANAGEMENT_SERVER_SECRET"},
+  "management-server-tls-enabled": {"env": "MANAGEMENT_SERVER_TLS_ENABLED"},
+  "management-server-tls-keystore": {"env": "MANAGEMENT_SERVER_TLS_KEYSTORE"},
+  "management-server-tls-keystore-password": {"env": "MANAGEMENT_SERVER_TLS_KEYSTORE_PASSWORD"},
  "max-build-height": {"env": "MAX_BUILD_HEIGHT"},
  "max-chained-neighbor-updates": {"env": "MAX_CHAINED_NEIGHBOR_UPDATES"},
  "max-players": {"env": "MAX_PLAYERS"},
--- a/images.json
+++ b/images.json
@@ -17,19 +17,35 @@
    "architectures": ["amd64", "arm64"],
    "lts": true
  },
+  {
+    "tag": "java25",
+    "java": "25",
+    "distribution": "ubuntu",
+    "jvm": "hotspot",
+    "architectures": ["amd64", "arm64"]
+  },
+  {
+    "tag": "java25-graalvm",
+    "java": "25",
+    "distribution": "oracle",
+    "jvm": "graalvm",
+    "architectures": ["amd64", "arm64"]
+  },
  {
    "tag": "java24",
    "java": "24",
    "distribution": "ubuntu",
    "jvm": "hotspot",
-    "architectures": ["amd64", "arm64"]
+    "architectures": ["amd64", "arm64"],
+    "deprecated": true
  },
  {
    "tag": "java24-graalvm",
    "java": "24",
    "distribution": "oracle",
    "jvm": "graalvm",
-    "architectures": ["amd64", "arm64"]
+    "architectures": ["amd64", "arm64"],
+    "deprecated": true
  },
  {
    "tag": "java21",
@@ -51,7 +67,7 @@
    "java": "21",
    "distribution": "oracle",
    "jvm": "graalvm",
-    "architectures": ["amd64", "arm64"],
+    "architectures": ["amd64", "arm64"]
  },
  {
    "tag": "java21-jdk",
@@ -66,7 +82,7 @@
    "java": "21",
    "distribution": "oracle",
    "jvm": "graalvm",
-    "architectures": ["amd64", "arm64"],
+    "architectures": ["amd64", "arm64"]
  },
  {
    "tag": "java17",
--- a/scripts/auto/autopause-daemon.sh
+++ b/scripts/auto/autopause-daemon.sh
@@ -1,9 +1,9 @@
 #!/bin/bash

-. /auto/autopause-fcns.sh
+. "$(dirname "$0")/autopause-fcns.sh"

-# shellcheck source=../../scripts/start-utils
-. "${SCRIPTS:-/}start-utils"
+# shellcheck source=../start-utils
+. "$(dirname "$0")/../start-utils"
 if isTrue "${DEBUG_AUTOPAUSE}"; then
  set -x
 fi
@@ -84,7 +84,7 @@ do
    else
      if [[ $(current_uptime) -ge $TIME_THRESH ]] ; then
        logAutopause "No client connected since startup / knocked - pausing"
-        /auto/pause.sh
+        "$(dirname "$0")/pause.sh"
        STATE=S
      fi
    fi
@@ -109,7 +109,7 @@ do
    else
      if [[ $(current_uptime) -ge $TIME_THRESH ]] ; then
        logAutopause "No client reconnected - pausing"
-        /auto/pause.sh
+        "$(dirname "$0")/pause.sh"
        STATE=S
      fi
    fi
@@ -117,7 +117,7 @@ do
  XS)
    # Stopped
    if rcon_client_exists ; then
-      /auto/resume.sh
+      "$(dirname "$0")/resume.sh"
    fi
    if java_running ; then
      if java_clients_connected ; then
--- a/scripts/auto/autopause-fcns.sh
+++ b/scripts/auto/autopause-fcns.sh
@@ -1,7 +1,7 @@
 #!/bin/bash

 # shellcheck source=../scripts/start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/../start-utils"
 current_uptime() {
  awk '{print $1}' /proc/uptime | cut -d . -f 1
 }
--- a/scripts/auto/autostop-daemon.sh
+++ b/scripts/auto/autostop-daemon.sh
@@ -1,10 +1,10 @@
 #!/bin/bash

 # needed for the clients connected function residing in autopause
-. /auto/autopause-fcns.sh
+. "$(dirname "$0")/autopause-fcns.sh"

 # shellcheck source=../../scripts/start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/../start-utils"
 if isTrue "${DEBUG_AUTOSTOP}"; then
  set -x
 fi
@@ -49,7 +49,7 @@ do
    else
      if [[ $(current_uptime) -ge $TIME_THRESH ]] ; then
        logAutostop "No client connected since startup - stopping server"
-        /auto/stop.sh
+        "$(dirname "$0")"/stop.sh
        exit 0
      fi
    fi
@@ -74,7 +74,7 @@ do
    else
      if [[ $(current_uptime) -ge $TIME_THRESH ]] ; then
        logAutostop "No client reconnected - stopping"
-        /auto/stop.sh
+        "$(dirname "$0")"/stop.sh
        exit 0
      fi
    fi
--- a/scripts/auto/pause.sh
+++ b/scripts/auto/pause.sh
@@ -1,6 +1,6 @@
 #!/bin/bash

-. /start-utils
+. "$(dirname "$0")/../start-utils"
 if isTrue "${DEBUG_AUTOPAUSE}"; then
  set -x
 fi
--- a/scripts/auto/rcon-cmds-daemon.sh
+++ b/scripts/auto/rcon-cmds-daemon.sh
@@ -9,10 +9,10 @@

 # needed for the clients connected function residing in autopause
 # shellcheck source=../auto/autopause-fcns.sh
-. /auto/autopause-fcns.sh
+. /image/scripts/auto/autopause-fcns.sh

 # shellcheck source=start-utils
-. ${SCRIPTS:-/}start-utils
+. /image/scripts/start-utils

 run_command(){
  rcon_cmd="$1"
--- a/scripts/auto/resume.sh
+++ b/scripts/auto/resume.sh
@@ -1,6 +1,6 @@
 #!/bin/bash

-. /start-utils
+. "$(dirname "$0")/../start-utils"
 if isTrue "${DEBUG_AUTOPAUSE}"; then
  set -x
 fi
--- a/scripts/auto/stop.sh
+++ b/scripts/auto/stop.sh
@@ -1,6 +1,6 @@
 #!/bin/bash

-. /start-utils
+. "$(dirname "$0")/../start-utils"
 if isTrue "${DEBUG_AUTOSTOP}"; then
  set -x
 fi
--- a/scripts/shims/mc-health
+++ b/scripts/shims/mc-health
@@ -1,7 +1,6 @@
 #!/bin/bash

-# shellcheck source=../scripts/start-utils
-. "${SCRIPTS:-/}start-utils"
+. "/image/scripts/start-utils"
 if [ -f /data/.mc-health.env ]; then
  . /data/.mc-health.env
 fi
--- a/scripts/shims/mc-send-to-console
+++ b/scripts/shims/mc-send-to-console
@@ -1,5 +1,5 @@
 #!/bin/bash
-. "/start-utils"
+. "/image/scripts/start-utils"
 : "${CONSOLE_IN_NAMED_PIPE:=/tmp/minecraft-console-in}"

 if isFalse "${CREATE_CONSOLE_IN_PIPE:-false}"; then
--- a/scripts/shims/mcstatus
+++ b/scripts/shims/mcstatus
--- a/scripts/start
+++ b/scripts/start
@@ -1,7 +1,7 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"

 # The Dockerfile ENVs take precedence here, but defaulting for testing consistency
 : "${UID:=1000}"
@@ -48,7 +48,7 @@ if ! isTrue "${SKIP_SUDO:-false}" && [ "$(id -u)" = 0 ]; then
    echo 'hosts: files dns' > /etc/nsswitch.conf
  fi

-  exec $(getSudoFromDistro) ${runAsUser}:${runAsGroup} "${SCRIPTS:-/}start-configuration" "$@"
+  exec $(getSudoFromDistro) ${runAsUser}:${runAsGroup} "$(dirname "$0")/start-configuration" "$@"
 else
-  exec "${SCRIPTS:-/}start-configuration" "$@"
+  exec "$(dirname "$0")/start-configuration" "$@"
 fi
--- a/scripts/start-autopause
+++ b/scripts/start-autopause
@@ -1,7 +1,7 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"

 : "${SERVER_PORT:=25565}"
 : "${ENABLE_AUTOPAUSE:=false}"
@@ -24,7 +24,7 @@ log "Autopause functionality enabled"

 isDebugging && set -x

-cp /auto/knockd-config.cfg /tmp/knockd-config.cfg
+cp /image/knockd-config.cfg /tmp/knockd-config.cfg

 function updatePort() {
  regseq="^\s*sequence\s*=\s*$1\s*$"
@@ -69,4 +69,4 @@ fi
 let COOLDOWN=$AUTOPAUSE_TIMEOUT_KN/2
 sed -i "s/\(seq_cooldown *= *\).*/\1$COOLDOWN/" /tmp/knockd-config.cfg

-/auto/autopause-daemon.sh &
+"$(dirname "$0")/auto/autopause-daemon.sh" &
--- a/scripts/start-autostop
+++ b/scripts/start-autostop
@@ -1,16 +1,14 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"

 : "${SERVER_PORT:=25565}"
-: "${ENABLE_AUTOSTOP:=false}"
 : "${AUTOSTOP_TIMEOUT_EST:=3600}"
 : "${AUTOSTOP_TIMEOUT_INIT:=1800}"
 : "${AUTOSTOP_PERIOD:=10}"
 : "${DEBUG_AUTOSTOP:=false}"
 export SERVER_PORT
-export ENABLE_AUTOSTOP
 export AUTOSTOP_TIMEOUT_EST
 export AUTOSTOP_TIMEOUT_INIT
 export AUTOSTOP_PERIOD
@@ -25,4 +23,4 @@ checkIfNotZeroElseSetToDefault "AUTOSTOP_PERIOD" 10
 isNumericElseSetToDefault "AUTOSTOP_TIMEOUT_EST" 3600
 isNumericElseSetToDefault "AUTOSTOP_TIMEOUT_INIT" 1800

-/auto/autostop-daemon.sh &
+"$(dirname "$0")/auto/autostop-daemon.sh" &
--- a/scripts/start-configuration
+++ b/scripts/start-configuration
@@ -3,7 +3,7 @@ set -euo pipefail
 IFS=$'\n\t'

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"

 : "${EULA:=}"
 : "${PROXY:=}"
@@ -166,11 +166,9 @@ if isTrue "${VERSION_FROM_MODRINTH_PROJECTS:-}" && [[ ${MODRINTH_PROJECTS:-} ]];
 fi

 if isTrue "${ENABLE_AUTOPAUSE}"; then
-  "${SCRIPTS:-/}start-autopause"
-fi
-
-if isTrue "${ENABLE_AUTOSTOP}"; then
-  "${SCRIPTS:-/}start-autostop"
+  "$(dirname "$0")/start-autopause"
+elif isTrue "${ENABLE_AUTOSTOP}"; then
+  "$(dirname "$0")/start-autostop"
 fi

 if
@@ -182,7 +180,7 @@ if
 then
  log "Starting RCON commands"
  # shellcheck source=start-rconcmds
-  "${SCRIPTS:-/}start-rconcmds"
+  "$(dirname "$0")/start-rconcmds"
 fi

 : "${MODPACK_PLATFORM:=${MOD_PLATFORM:-}}"
@@ -200,19 +198,19 @@ esac
 if [[ $MODPACK_PLATFORM ]]; then
  case "${MODPACK_PLATFORM^^}" in
    FTB|CURSEFORGE)
-      exec "${SCRIPTS:-/}start-deployCF" "$@"
+      exec "$(dirname "$0")/start-deployCF" "$@"
    ;;

    FTBA)
-      exec "${SCRIPTS:-/}start-deployFTBA" "$@"
+      exec "$(dirname "$0")/start-deployFTBA" "$@"
    ;;

    AUTO_CURSEFORGE)
-      exec "${SCRIPTS:-/}start-deployAutoCF" "$@"
+      exec "$(dirname "$0")/start-deployAutoCF" "$@"
      ;;

    MODRINTH)
-      exec "${SCRIPTS:-/}start-deployModrinth" "$@"
+      exec "$(dirname "$0")/start-deployModrinth" "$@"
      ;;

    *)
@@ -225,99 +223,99 @@ fi
 log "Resolving type given ${TYPE}"
 case "${TYPE^^}" in
  *BUKKIT|SPIGOT)
-    exec "${SCRIPTS:-/}start-deployBukkitSpigot" "$@"
+    exec "$(dirname "$0")/start-deployBukkitSpigot" "$@"
  ;;

  PAPER)
-    exec "${SCRIPTS:-/}start-deployPaper" "$@"
+    exec "$(dirname "$0")/start-deployPaper" "$@"
  ;;

  FOLIA)
-    exec "${SCRIPTS:-/}start-deployFolia" "$@"
+    exec "$(dirname "$0")/start-deployFolia" "$@"
  ;;

  FORGE)
-    exec "${SCRIPTS:-/}start-deployForge" "$@"
+    exec "$(dirname "$0")/start-deployForge" "$@"
  ;;

  NEOFORGE|NEOFORGED)
-    exec "${SCRIPTS:-/}start-deployNeoForge" "$@"
+    exec "$(dirname "$0")/start-deployNeoForge" "$@"
  ;;

  FABRIC)
-    exec "${SCRIPTS:-/}start-deployFabric" "$@"
+    exec "$(dirname "$0")/start-deployFabric" "$@"
  ;;

  QUILT)
-    exec "${SCRIPTS:-/}start-deployQuilt" "$@"
+    exec "$(dirname "$0")/start-deployQuilt" "$@"
  ;;

  VANILLA)
-    exec "${SCRIPTS:-/}start-deployVanilla" "$@"
+    exec "$(dirname "$0")/start-deployVanilla" "$@"
  ;;

  SPONGEVANILLA)
-    exec "${SCRIPTS:-/}start-deploySpongeVanilla" "$@"
+    exec "$(dirname "$0")/start-deploySpongeVanilla" "$@"
  ;;

  CUSTOM)
-    exec "${SCRIPTS:-/}start-deployCustom" "$@"
+    exec "$(dirname "$0")/start-deployCustom" "$@"
  ;;

  MAGMA)
-    exec "${SCRIPTS:-/}start-deployMagma" "$@"
+    exec "$(dirname "$0")/start-deployMagma" "$@"
  ;;

  MAGMA_MAINTAINED)
-    exec "${SCRIPTS:-/}start-deployMagmaMaintained" "$@"
+    exec "$(dirname "$0")/start-deployMagmaMaintained" "$@"
  ;;

  KETTING)
-    exec "${SCRIPTS:-/}start-deployKetting" "$@"
+    exec "$(dirname "$0")/start-deployKetting" "$@"
  ;;

  MOHIST|YOUER|BANNER)
-    exec "${SCRIPTS:-/}start-deployMohist" "$@"
+    exec "$(dirname "$0")/start-deployMohist" "$@"
  ;;

  CATSERVER)
-    exec "${SCRIPTS:-/}start-deployCatserver" "$@"
+    exec "$(dirname "$0")/start-deployCatserver" "$@"
  ;;

  PURPUR)
-    exec "${SCRIPTS:-/}start-deployPurpur" "$@"
+    exec "$(dirname "$0")/start-deployPurpur" "$@"
  ;;

  PUFFERFISH)
-    exec "${SCRIPTS:-/}start-deployPufferfish" "$@"
+    exec "$(dirname "$0")/start-deployPufferfish" "$@"
  ;;

  CANYON)
-    exec "${SCRIPTS:-/}start-deployCanyon" "$@"
+    exec "$(dirname "$0")/start-deployCanyon" "$@"
  ;;

  LIMBO)
-    exec "${SCRIPTS:-/}start-deployLimbo" "$@"
+    exec "$(dirname "$0")/start-deployLimbo" "$@"
  ;;

  NANOLIMBO)
-    exec "${SCRIPTS:-/}start-deployNanoLimbo" "$@"
+    exec "$(dirname "$0")/start-deployNanoLimbo" "$@"
  ;;

  CRUCIBLE)
-    exec "${SCRIPTS:-/}start-deployCrucible" "$@"
+    exec "$(dirname "$0")/start-deployCrucible" "$@"
  ;;

  LEAF)
-    exec "${SCRIPTS:-/}start-deployLeaf" "$@"
+    exec "$(dirname "$0")/start-deployLeaf" "$@"
  ;;

  ARCLIGHT)
-    exec "${SCRIPTS:-/}start-deployArcLight" "$@"
+    exec "$(dirname "$0")/start-deployArcLight" "$@"
  ;;

  POSEIDON)
-    exec "${SCRIPTS:-/}start-deployPoseidon" "$@"
+    exec "$(dirname "$0")/start-deployPoseidon" "$@"
  ;;

  *)
--- a/scripts/start-deployArcLight
+++ b/scripts/start-deployArcLight
@@ -38,4 +38,4 @@ export SERVER
 export FAMILY=HYBRID
 export HYBRIDTYPE="${ARCLIGHT_TYPE,,}"

-exec "${SCRIPTS:-/}start-spiget" "$@"
+exec "$(dirname "$0")/start-spiget" "$@"
--- a/scripts/start-deployAutoCF
+++ b/scripts/start-deployAutoCF
@@ -2,7 +2,7 @@
 set -eu

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"

 : "${CF_PAGE_URL:=}"
 : "${CF_SLUG:=}"
@@ -75,4 +75,4 @@ fi
 applyResultsFile ${resultsFile}
 resolveFamily

-exec "${SCRIPTS:-/}start-setupWorld" "$@"
+exec "$(dirname "$0")/start-setupWorld" "$@"
--- a/scripts/start-deployBukkitSpigot
+++ b/scripts/start-deployBukkitSpigot
@@ -1,7 +1,7 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 isDebugging && set -x

 set -eo pipefail
@@ -123,4 +123,4 @@ export JVM_OPTS
 # Normalize on Spigot for operations below
 export FAMILY=SPIGOT

-exec "${SCRIPTS:-/}start-spiget" "$@"
+exec "$(dirname "$0")/start-spiget" "$@"
--- a/scripts/start-deployCF
+++ b/scripts/start-deployCF
@@ -3,7 +3,7 @@
 set -e

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"

 loadForgeVars() {
  cfgFile=${1?}
@@ -138,7 +138,7 @@ if ! isTrue "${USE_MODPACK_START_SCRIPT:-true}"; then
  FTB_DIR=$(dirname "${SERVER}")
  export FTB_DIR

-  exec "${SCRIPTS:-/}start-setupWorld" "$@"
+  exec "$(dirname "$0")/start-setupWorld" "$@"
 fi


@@ -250,4 +250,4 @@ if isTrue "${FTB_LEGACYJAVAFIXER}" && [ ! -e "${legacyJavaFixerPath}" ]; then
 fi

 export FAMILY=FORGE
-exec "${SCRIPTS:-/}start-setupWorld" "$@"
+exec "$(dirname "$0")/start-setupWorld" "$@"
--- a/scripts/start-deployCanyon
+++ b/scripts/start-deployCanyon
@@ -3,7 +3,7 @@ set -euo pipefail
 IFS=$'\n\t'

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 isDebugging && set -x

 : "${CANYON_BUILD:=lastSuccessfulBuild}"
@@ -58,4 +58,4 @@ fi
 # Normalize on Spigot for later operations
 export FAMILY=SPIGOT

-exec ${SCRIPTS:-/}start-spiget "$@"
+exec "$(dirname "$0")/start-spiget" "$@"
--- a/scripts/start-deployCatserver
+++ b/scripts/start-deployCatserver
@@ -1,7 +1,7 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 set -o pipefail
 set -e

@@ -30,4 +30,4 @@ fi
 export FAMILY=HYBRID
 export HYBRIDTYPE=forge

-exec "${SCRIPTS:-/}start-spiget" "$@"
+exec "$(dirname "$0")/start-spiget" "$@"
--- a/scripts/start-deployCrucible
+++ b/scripts/start-deployCrucible
@@ -58,4 +58,4 @@ export SERVER
 export FAMILY=HYBRID
 export HYBRIDTYPE=forge

-exec "${SCRIPTS:-/}start-spiget" "$@"
+exec "$(dirname "$0")/start-spiget" "$@"
--- a/scripts/start-deployCustom
+++ b/scripts/start-deployCustom
@@ -5,7 +5,7 @@
 : "${CUSTOM_JAR_EXEC:=}"

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 isDebugging && set -x

 if isURL "${CUSTOM_SERVER}"; then
@@ -42,4 +42,4 @@ fi
 export FAMILY="${FAMILY:-HYBRID}"
 export HYBRIDTYPE="${HYBRIDTYPE:-any}"

-exec "${SCRIPTS:-/}start-spiget" "$@"
+exec "$(dirname "$0")/start-spiget" "$@"
--- a/scripts/start-deployFTBA
+++ b/scripts/start-deployFTBA
@@ -7,7 +7,7 @@
 ftbInstallMarker=".ftb-installed"

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 isDebugging && set -x
 set -e

@@ -160,4 +160,4 @@ else
  exit 1
 fi

-exec "${SCRIPTS:-/}start-setupWorld" "$@"
+exec "$(dirname "$0")/start-setupWorld" "$@"
--- a/scripts/start-deployFabric
+++ b/scripts/start-deployFabric
@@ -2,7 +2,7 @@
 set -eu

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"

 export TYPE=FABRIC
 : "${FABRIC_LAUNCHER_VERSION:=${FABRIC_INSTALLER_VERSION:-LATEST}}"
@@ -56,4 +56,4 @@ fi
 applyResultsFile ${resultsFile}

 export FAMILY=FABRIC
-exec "${SCRIPTS:-/}start-setupWorld" "$@"
+exec "$(dirname "$0")/start-setupWorld" "$@"
--- a/scripts/start-deployFolia
+++ b/scripts/start-deployFolia
@@ -3,7 +3,7 @@
 : "${FOLIA_CHANNEL:=experimental}"

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 set -o pipefail
 handleDebugMode

@@ -18,4 +18,4 @@ fi
 PAPER_PROJECT="folia" \
 PAPER_NAME="FoliaMC" \
 PAPER_CHANNEL="${FOLIA_CHANNEL}" \
-  exec "${SCRIPTS:-/}start-deployPaper" "$@"
+  exec "$(dirname "$0")/start-deployPaper" "$@"
--- a/scripts/start-deployForge
+++ b/scripts/start-deployForge
@@ -46,4 +46,4 @@ applyResultsFile ${resultsFile}

 export FAMILY=FORGE

-exec "${SCRIPTS:-/}start-setupWorld" "$@"
+exec "$(dirname "$0")/start-setupWorld" "$@"
--- a/scripts/start-deployKetting
+++ b/scripts/start-deployKetting
@@ -1,7 +1,7 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 isDebugging && set -x

 if ! SERVER=$(mc-image-helper github download-latest-asset \
@@ -30,4 +30,4 @@ export SERVER
 export FAMILY=HYBRID
 export HYBRIDTYPE=forge

-exec "${SCRIPTS:-/}start-spiget" "$@"
+exec "$(dirname "$0")/start-spiget" "$@"
--- a/scripts/start-deployLeaf
+++ b/scripts/start-deployLeaf
@@ -48,4 +48,4 @@ fi
 export FAMILY=SPIGOT
 export SERVER

-exec "${SCRIPTS:-/}start-spiget" "$@"
+exec "$(dirname "$0")/start-spiget" "$@"
--- a/scripts/start-deployLimbo
+++ b/scripts/start-deployLimbo
@@ -2,15 +2,15 @@
 set -euo pipefail
 IFS=$'\n\t'

-. ${SCRIPTS:-/}start-utils
+. "$(dirname "$0")/start-utils"
 isDebugging && set -x

-: ${LIMBO_BUILD:=LATEST}
-: ${FORCE_REDOWNLOAD:=false}
-: ${LIMBO_SCHEMA_FILENAME:=default.schem}
-: ${LEVEL:=default;${LIMBO_SCHEMA_FILENAME}}
+: "${LIMBO_BUILD:=LATEST}"
+: "${FORCE_REDOWNLOAD:=false}"
+: "${LIMBO_SCHEMA_FILENAME:=default.schem}"
+: "${LEVEL:=default;${LIMBO_SCHEMA_FILENAME}}"
 # defaults to localhost, if this is not set
-: ${SERVER_IP:=0.0.0.0}
+: "${SERVER_IP:=0.0.0.0}"

 export LEVEL SERVER_IP

@@ -65,4 +65,4 @@ fi
 export LEVEL

 export FAMILY=LIMBO
-exec ${SCRIPTS:-/}start-setupWorld "$@"
+exec "$(dirname "$0")/start-setupWorld" "$@"
--- a/scripts/start-deployMagma
+++ b/scripts/start-deployMagma
@@ -1,7 +1,7 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 isDebugging && set -x

 : "${MAGMA_VERSION:=}"
@@ -27,4 +27,4 @@ export SERVER
 export FAMILY=HYBRID
 export HYBRIDTYPE=forge

-exec "${SCRIPTS:-/}start-spiget" "$@"
+exec "$(dirname "$0")/start-spiget" "$@"
--- a/scripts/start-deployMagmaMaintained
+++ b/scripts/start-deployMagmaMaintained
@@ -1,7 +1,7 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 isDebugging && set -x

 : "${FORGE_VERSION:=}"
@@ -36,4 +36,4 @@ export SERVER
 export FAMILY=HYBRID
 export HYBRIDTYPE=forge

-exec "${SCRIPTS:-/}start-spiget" "$@"
+exec "$(dirname "$0")/start-spiget" "$@"
--- a/scripts/start-deployModrinth
+++ b/scripts/start-deployModrinth
@@ -2,7 +2,7 @@
 set -eu

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"

 resultsFile=/data/.install-modrinth.env

@@ -75,4 +75,4 @@ fi
 applyResultsFile ${resultsFile}
 resolveFamily

-exec "${SCRIPTS:-/}start-setupWorld" "$@"
+exec "$(dirname "$0")/start-setupWorld" "$@"
--- a/scripts/start-deployMohist
+++ b/scripts/start-deployMohist
@@ -62,4 +62,4 @@ fi
 export SERVER
 export FAMILY=HYBRID

-exec "${SCRIPTS:-/}start-spiget" "$@"
+exec "$(dirname "$0")/start-spiget" "$@"
--- a/scripts/start-deployNanoLimbo
+++ b/scripts/start-deployNanoLimbo
@@ -1,19 +1,164 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 isDebugging && set -x

 if ! SERVER=$(mc-image-helper github download-latest-asset \
  --output-directory=/data \
-  --name-pattern="NanoLimbo-.+?(?<!-sources)\.jar" \
+  --name-pattern="NanoLimbo(-.+?(?<!-sources))?\.jar" \
  BoomEaro/NanoLimbo
  ); then
    logError "Failed to download NanoLimbo"
    exit 1
 fi

+: "${SERVER_PORT:=25565}"
+cat <<EOF > /data/settings.yml
+#
+# NanoLimbo configuration
+#
+
+# Server's host address and port. Set ip empty to use public address
+bind:
+  ip: '0.0.0.0'
+  port: ${SERVER_PORT}
+
+# Max number of players can join to server
+# Set -1 to make it infinite
+maxPlayers: 100
+
+# Server's data in servers list
+ping:
+  description: '{"text": "&9NanoLimbo"}'
+  version: 'NanoLimbo'
+  # Return static protocol version number in ping result
+  # By default, its -1 to return the client version if it supported
+  # https://wiki.vg/Protocol_version_numbers
+  protocol: -1
+
+# Available dimensions: OVERWORLD, NETHER, THE_END
+dimension: THE_END
+
+# Whether to display the player in the player list
+# For 1.16.5 clients, the player list will be sent even if disabled, to avoid crash
+playerList:
+  enable: false
+  username: 'NanoLimbo'
+
+# Whether to display header and footer in player list
+# For 1.8+ clients
+headerAndFooter:
+  enable: false
+  header: '{"text": "&eWelcome!"}'
+  footer: '{"text": "&9NanoLimbo"}'
+
+# Setup player's game mode
+# 0 - Survival
+# 1 - Creative (hide HP and food bar)
+# 2 - Adventure
+# 3 - Spectator (hide all UI bars)
+# Spectator works on 1.8+ clients
+gameMode: 3
+
+# Remove secure-chat toast
+# For 1.20.5+ clients
+secureProfile: false
+
+# Server name which is shown under F3
+# For 1.13+ clients
+brandName:
+  enable: true
+  content: 'NanoLimbo'
+
+# Message sends when player joins to the server
+joinMessage:
+  enable: true
+  text: '{"text": "&eWelcome to the Limbo!"}'
+
+# BossBar displays when player joins to the server
+# For 1.9+ clients
+bossBar:
+  enable: true
+  text: '{"text": "Welcome to the Limbo!"}'
+  health: 1.0
+  # Available colors: PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
+  color: PINK
+  # Available divisions: SOLID, DASHES_6, DASHES_10, DASHES_12, DASHES_20
+  division: SOLID
+
+# Display title and subtitle
+# For 1.8+ clients
+title:
+  enable: true
+  # Set title text value empty, if you need only subtitle
+  title: '{"text": "&9&lWelcome!"}'
+  # Set subtitle text value empty, if you need only title
+  subtitle: '{"text": "&6NanoLimbo"}'
+  # Fade in time in ticks (1 sec = 20 ticks)
+  fadeIn: 10
+  # Stay time in ticks
+  stay: 100
+  # Fade out time in ticks
+  fadeOut: 10
+
+# Player info forwarding support.
+# Available types:
+#  - NONE
+#  - LEGACY
+#  - MODERN
+#  - BUNGEE_GUARD
+# Don't use secret if you do not use MODERN type
+infoForwarding:
+  type: NONE
+  secret: '<YOUR_SECRET_HERE>'
+  tokens:
+    - '<BUNGEE_GUARD_TOKEN>'
+
+# Read timeout for connections in milliseconds
+readTimeout: 30000
+
+# Define log level. For production, I'd recommend to use level 2
+# Log levels:
+# 0 - Display only errors
+# 1 - Display errors, warnings
+# 2 - Display errors, warnings, info
+# 3 - Display errors, warnings, info, debug
+debugLevel: 2
+
+# Warning! Do not touch params of this block if you are not completely sure what is this!
+netty:
+  # Use a Linux native transport type, if it possible
+  useEpoll: true
+  # EventLoopGroup threads count
+  threads:
+    bossGroup: 1
+    workerGroup: 4
+
+# Options to check incoming traffic and kick potentially malicious connections.
+# Take into account that player can send many small packets, for example, just moving mouse.
+traffic:
+  # If true, then additional handler will be added to the channel pipeline
+  enable: true
+  # Max packet size in bytes
+  # Unlimited if -1
+  maxPacketSize: 8192
+  # The interval to measure packets over
+  # Lowering this value will limit peak packets from players which would target people with bad connections
+  # Raising this value will allow higher peak packet rates, which will help with people who have poor connections
+  # Ignored if -1.0
+  interval: 7.0
+  # The maximum packets per second for players
+  # It is measured over the configured interval
+  # Ignored if -1.0
+  maxPacketRate: 500.0
+  # The maximum packet bytes per second for players
+  # It is measured over the configured interval as an average bytes/sec
+  # Ignored if -1.0
+  maxPacketBytesRate: 2048.0
+EOF
+
 export SERVER
 export FAMILY=LIMBO

-exec ${SCRIPTS:-/}start-setupMounts "$@"
+exec "$(dirname "$0")/start-setupMounts" "$@"
--- a/scripts/start-deployNeoForge
+++ b/scripts/start-deployNeoForge
@@ -23,4 +23,4 @@ applyResultsFile ${resultsFile}

 export FAMILY=FORGE

-exec "${SCRIPTS:-/}start-setupWorld" "$@"
+exec "$(dirname "$0")/start-setupWorld" "$@"
--- a/scripts/start-deployPaper
+++ b/scripts/start-deployPaper
@@ -1,7 +1,7 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 set -o pipefail
 handleDebugMode

@@ -58,4 +58,4 @@ export DOWNLOAD_DEFAULTS
 # Normalize on Spigot for downstream operations
 export FAMILY=SPIGOT

-exec "${SCRIPTS:-/}start-spiget" "$@"
+exec "$(dirname "$0")/start-spiget" "$@"
--- a/scripts/start-deployPoseidon
+++ b/scripts/start-deployPoseidon
@@ -34,4 +34,4 @@ fi
 export SERVER
 export FAMILY=SPIGOT

-exec "${SCRIPTS:-/}start-spiget" "$@"
+exec "$(dirname "$0")/start-spiget" "$@"
--- a/scripts/start-deployPufferfish
+++ b/scripts/start-deployPufferfish
@@ -1,7 +1,7 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"

 set -euo pipefail
 isDebugging && set -x
@@ -45,4 +45,4 @@ fi
 # Normalize on Spigot for later operations
 export FAMILY=SPIGOT

-exec "${SCRIPTS:-/}start-spiget" "$@"
+exec "$(dirname "$0")/start-spiget" "$@"
--- a/scripts/start-deployPurpur
+++ b/scripts/start-deployPurpur
@@ -6,7 +6,7 @@ IFS=$'\n\t'
 : "${PURPUR_DOWNLOAD_URL:=}"

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 isDebugging && set -x

 resultsFile=/data/.purpur.env
@@ -39,4 +39,4 @@ applyResultsFile ${resultsFile}
 # Normalize on Spigot for later operations
 export FAMILY=SPIGOT

-exec "${SCRIPTS:-/}start-spiget" "$@"
+exec "$(dirname "$0")/start-spiget" "$@"
--- a/scripts/start-deployQuilt
+++ b/scripts/start-deployQuilt
@@ -2,7 +2,7 @@
 set -eu

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"

 : "${QUILT_LAUNCHER:=}"
 : "${QUILT_LAUNCHER_URL:=}"
@@ -29,7 +29,7 @@ if [[ $QUILT_LAUNCHER ]]; then
  resolveVersion

  export FAMILY=FABRIC
-  exec "${SCRIPTS:-/}start-setupWorld" "$@"
+  exec "$(dirname "$0")/start-setupWorld" "$@"

 elif [[ $QUILT_LAUNCHER_URL ]]; then
  logError "QUILT_LAUNCHER_URL is not longer supported. Pre-download and use QUILT_LAUNCHER."
@@ -52,4 +52,4 @@ fi
 applyResultsFile ${resultsFile}

 export FAMILY=FABRIC
-exec "${SCRIPTS:-/}start-setupWorld" "$@"
+exec "$(dirname "$0")/start-setupWorld" "$@"
--- a/scripts/start-deploySpongeVanilla
+++ b/scripts/start-deploySpongeVanilla
@@ -1,7 +1,7 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. ${SCRIPTS:-/}start-utils
+. "$(dirname "$0")/start-utils"

 export TYPE=spongevanilla
 : ${SPONGEBRANCH:=STABLE}
@@ -37,4 +37,4 @@ if [ ! -e "$SERVER" ] || [ -n "$FORCE_REDOWNLOAD" ]; then
 fi

 export FAMILY=SPONGE
-exec "${SCRIPTS:-/}start-setupWorld" "$@"
+exec "$(dirname "$0")/start-setupWorld" "$@"
--- a/scripts/start-deployVanilla
+++ b/scripts/start-deployVanilla
@@ -1,7 +1,7 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 isDebugging && set -x
 set -o pipefail

@@ -53,4 +53,4 @@ fi

 isDebugging && ls -l
 export FAMILY=VANILLA
-exec "${SCRIPTS:-/}start-setupWorld" "$@"
+exec "$(dirname "$0")/start-setupWorld" "$@"
--- a/scripts/start-finalExec
+++ b/scripts/start-finalExec
@@ -5,7 +5,7 @@
 : "${CUSTOM_JAR_EXEC:=}"

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 isDebugging && set -x
 baseDataDir=/data
 tmpServerIconPath=/tmp/icon.img
@@ -166,7 +166,7 @@ if isTrue "${USE_MEOWICE_FLAGS}"; then
  fi
 fi

-if isTrue "${USE_AIKAR_FLAGS}"; then
+if isTrue "${USE_AIKAR_FLAGS}" || isTrue "${USE_MEOWICE_FLAGS}"; then
  # From https://mcflags.emc.gs/
  if isTrue "${USE_MEOWICE_FLAGS}"; then
    log "Using MeowIce's flags"
@@ -216,9 +216,13 @@ if isTrue "${USE_AIKAR_FLAGS}"; then
  -XX:SurvivorRatio=32
  -XX:+PerfDisableSharedMem
  -XX:MaxTenuringThreshold=1
-  -Dusing.aikars.flags=https://mcflags.emc.gs
-  -Daikars.new.flags=true
  "
+  if isTrue "${USE_AIKAR_FLAGS}"; then
+    JVM_XX_OPTS="${JVM_XX_OPTS}
+    -Dusing.aikars.flags=https://mcflags.emc.gs
+    -Daikars.new.flags=true
+    "
+  fi
 fi

 if isTrue "${USE_MEOWICE_FLAGS}"; then
--- a/scripts/start-rconcmds
+++ b/scripts/start-rconcmds
@@ -1,7 +1,7 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"

 : "${RCON_CMDS_STARTUP:=}"
 : "${RCON_CMDS_ON_CONNECT:=}"
@@ -25,4 +25,4 @@ isDebugging && set -x
 isNumericElseSetToDefault RCON_CMDS_PERIOD 10
 checkIfNotZeroElseSetToDefault RCON_CMDS_PERIOD 10

-/usr/local/bin/rcon-cmds-daemon.sh &
+"$(dirname "$0")/auto/rcon-cmds-daemon.sh" &
--- a/scripts/start-setupDatapack
+++ b/scripts/start-setupDatapack
@@ -10,7 +10,7 @@ set -e -o pipefail
 : "${REMOVE_OLD_DATAPACKS_INCLUDE:=*.zip}"

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 isDebugging && set -x

 out_dir=/data/${LEVEL:-world}/datapacks
@@ -89,4 +89,4 @@ if [[ ${VANILLATWEAKS_FILE} || ${VANILLATWEAKS_SHARECODE} ]]; then
    --pack-files="$VANILLATWEAKS_FILE"
 fi

-exec "${SCRIPTS:-/}start-setupModpack" "$@"
+exec "$(dirname "$0")/start-setupModpack" "$@"
--- a/scripts/start-setupEnvVariables
+++ b/scripts/start-setupEnvVariables
@@ -1,7 +1,7 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"

 set -e
 handleDebugMode
@@ -17,6 +17,7 @@ handleDebugMode
 : "${DOWNLOAD_DEFAULTS:=}"
 : "${DOWNLOAD_DEFAULT_CONFIGS:=}"
 : "${SKIP_DOWNLOAD_DEFAULTS:=false}"
+: "${DOWNLOAD_EXTRA_CONFIGS:=}"

 if isTrue "${REPLACE_ENV_IN_PLACE}"; then
  log "Replacing env variables in ${REPLACE_ENV_PATHS} that match the prefix '$REPLACE_ENV_VARIABLE_PREFIX' ..."
@@ -54,6 +55,15 @@ if isFalse "$SKIP_DOWNLOAD_DEFAULTS"; then
  fi
 fi

+if [[ $DOWNLOAD_EXTRA_CONFIGS ]]; then
+  mc-image-helper mcopy \
+    --to /data \
+    --skip-existing \
+    --skip-up-to-date=false \
+    --quiet-when-skipped \
+    "$DOWNLOAD_EXTRA_CONFIGS"
+fi
+
 if [[ ${PATCH_DEFINITIONS} ]]; then
  log "Applying patch definitions from ${PATCH_DEFINITIONS}"
  mc-image-helper patch \
@@ -61,4 +71,4 @@ if [[ ${PATCH_DEFINITIONS} ]]; then
    "${PATCH_DEFINITIONS}"
 fi

-exec "${SCRIPTS:-/}start-setupRbac" "$@"
+exec "$(dirname "$0")/start-setupRbac" "$@"
--- a/scripts/start-setupModpack
+++ b/scripts/start-setupModpack
@@ -3,10 +3,8 @@
 set -e -o pipefail

 : "${REMOVE_OLD_MODS:=false}"
-: "${MODS:=}"
 : "${MODS_OUT_DIR:=/data/mods}"
 : "${MODS_FILE:=}"
-: "${PLUGINS:=}"
 : "${PLUGINS_OUT_DIR:=/data/plugins}"
 : "${PLUGINS_FILE:=}"
 : "${REMOVE_OLD_MODS_DEPTH:=1} "
@@ -26,7 +24,7 @@ if [[ -n ${CF_API_KEY_FILE} ]]; then
 fi

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 isDebugging && set -x

 #  CURSE_URL_BASE used in manifest downloads below
@@ -94,7 +92,7 @@ fi

 function handleListings() {
  if usesMods && usesPlugins; then
-      if [[ "$MODS" ]]; then
+      if [[ -v MODS ]]; then

        ensureRemoveAllModsOff "MODS is set"

@@ -105,7 +103,7 @@ function handleListings() {
          --to="$MODS_OUT_DIR" \
          "$MODS"
      fi
-      if [[ "$PLUGINS" ]]; then
+      if [[ -v PLUGINS ]]; then
        ensureRemoveAllModsOff "PLUGINS is set"
        mkdir -p "$PLUGINS_OUT_DIR"
        mc-image-helper mcopy \
@@ -140,14 +138,14 @@ function handleListings() {
      outDir="$PLUGINS_OUT_DIR"
    fi

-    if [[ "$MODS" || "$PLUGINS" ]]; then
+    if [[ -v MODS || -v PLUGINS ]]; then
      ensureRemoveAllModsOff "MODS or PLUGINS is set"
      mkdir -p "$outDir"
      mc-image-helper mcopy \
        --glob=*.jar \
        --scope=var-list \
        --to="$outDir" \
-        "$MODS" "$PLUGINS"
+        "${MODS:-}" "${PLUGINS:-}"
    fi

    if [[ "$MODS_FILE" || "$PLUGINS_FILE" ]]; then
@@ -255,7 +253,6 @@ function handleGenericPacks() {
 }

 function handleModrinthProjects() {
-  : "${MODRINTH_PROJECTS:=}"
  : "${MODRINTH_ALLOWED_VERSION_TYPE:=release}"
  : "${MODRINTH_DOWNLOAD_DEPENDENCIES:=none}"
  if [[ -v MODRINTH_DOWNLOAD_OPTIONAL_DEPENDENCIES ]]; then
@@ -263,7 +260,7 @@ function handleModrinthProjects() {
    logWarning "        Use MODRINTH_DOWNLOAD_DEPENDENCIES=optional instead"
  fi

-  if [[ $MODRINTH_PROJECTS ]]; then
+  if [[ -v MODRINTH_PROJECTS ]]; then

    if isType CUSTOM; then
      if ! [[ $MODRINTH_LOADER ]]; then
@@ -366,4 +363,4 @@ case "X$MODCONFIG" in
 esac
 fi

-exec "${SCRIPTS:-/}start-setupMounts" "$@"
+exec "$(dirname "$0")/start-setupMounts" "$@"
--- a/scripts/start-setupMounts
+++ b/scripts/start-setupMounts
@@ -1,7 +1,7 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"

 : "${SYNC_SKIP_NEWER_IN_DESTINATION:=${PLUGINS_SYNC_UPDATE:-true}}"
 : "${REPLACE_ENV_DURING_SYNC:=true}"
@@ -58,4 +58,4 @@ fi
 log "Copying any configs from ${COPY_CONFIG_SRC} to ${COPY_CONFIG_DEST}"
 mc-image-helper-mounts "${COPY_CONFIG_SRC}" "${COPY_CONFIG_DEST}"

-exec "${SCRIPTS:-/}start-setupServerProperties" "$@"
+exec "$(dirname "$0")/start-setupServerProperties" "$@"
--- a/scripts/start-setupRbac
+++ b/scripts/start-setupRbac
@@ -6,7 +6,7 @@ IFS=$'\n\t'
 : "${EXISTING_WHITELIST_FILE:=SYNC_FILE_MERGE_LIST}"

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 isDebugging && set -x

 if [[ -v APPEND_OPS ]] && isTrue "${APPEND_OPS}"; then
@@ -97,4 +97,4 @@ if [[ -v WHITELIST ]]; then
    $WHITELIST
 fi

-exec "${SCRIPTS:-/}start-finalExec" "$@"
+exec "$(dirname "$0")/start-finalExec" "$@"
--- a/scripts/start-setupServerProperties
+++ b/scripts/start-setupServerProperties
@@ -1,7 +1,7 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"

 : "${SERVER_PROPERTIES:=/data/server.properties}"
 : "${OVERRIDE_SERVER_PROPERTIES:=true}"
@@ -179,4 +179,4 @@ if isTrue "${DUMP_SERVER_PROPERTIES:-false}"; then
  cat "${SERVER_PROPERTIES}"
 fi

-exec "${SCRIPTS:-/}start-setupEnvVariables" "$@"
+exec "$(dirname "$0")/start-setupEnvVariables" "$@"
--- a/scripts/start-setupWorld
+++ b/scripts/start-setupWorld
@@ -1,7 +1,7 @@
 #!/bin/bash

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 set -e
 isDebugging && set -x

@@ -135,4 +135,4 @@ fi
 [[ -f ${worldDownload} ]] && rm ${worldDownload}
 [[ -d ${tmpWorldData} ]] && rm -rf ${tmpWorldData}

-exec "${SCRIPTS:-/}start-setupDatapack" "$@"
+exec "$(dirname "$0")/start-setupDatapack" "$@"
--- a/scripts/start-spiget
+++ b/scripts/start-spiget
@@ -3,7 +3,7 @@ set -euo pipefail
 IFS=$'\n\t'

 # shellcheck source=start-utils
-. "${SCRIPTS:-/}start-utils"
+. "$(dirname "$0")/start-utils"
 handleDebugMode

 : "${SPIGET_RESOURCES:=}"
@@ -142,4 +142,4 @@ if [[ ${SPIGET_RESOURCES} ]]; then
  done
 fi

-exec "${SCRIPTS:-/}start-setupWorld" "$@"
+exec "$(dirname "$0")/start-setupWorld" "$@"
--- a/tests/setuponlytests/nanolimbo/verify.sh
+++ b/tests/setuponlytests/nanolimbo/verify.sh
@@ -1 +1,2 @@
-mc-image-helper assert fileExists "/data/NanoLimbo-*.jar"
+mc-image-helper assert fileExists "/data/NanoLimbo*.jar"
+mc-image-helper assert fileExists "/data/settings.yml"
--- a/tests/setuponlytests/test.sh
+++ b/tests/setuponlytests/test.sh
@@ -71,7 +71,7 @@ image=""

 # Go through each folder in setuponly and test setups
 if (( $# == 0 )); then
-  readarray -t folders < <(find . -maxdepth 2 -mindepth 2 -name docker-compose.yml -printf '%h\n')
+  readarray -t folders < <(find . -maxdepth 2 -mindepth 2 -name docker-compose.yml -exec dirname "{}" \;)
  foldersList=("${folders[@]}")
  image=" using $IMAGE_TO_TEST"
 fi
Author	SHA1	Message	Date
Geoff Bourne	f88cb8eee9	neoforge: handle new version ordering (#3703 )	2025-10-09 18:54:56 -05:00
dependabot[bot]	18f69b7680	build(deps): bump docker/login-action from 3.5.0 to 3.6.0 in the updates group (#3697 )	2025-10-06 07:13:20 -05:00
dependabot[bot]	1dbe0f9621	build(deps): bump mkdocs-material from 9.6.20 to 9.6.21 in /docs in the patches group (#3698 )	2025-10-06 06:27:14 -05:00
Geoff Bourne	79518f124a	Add colorwheel and colorwheel-patcher to default excludes (#3696 )	2025-10-05 15:17:40 -05:00
Geoff Bourne	c6cf0857fc	Fix script import path for RCON_CMDS_* (#3695 )	2025-10-05 09:00:04 -05:00
Geoff Bourne	3eb8f85cd4	paper: now applies channel and resolves stable by default (#3692 )	2025-10-04 16:37:18 -05:00
Geoff Bourne	cbffecfd3a	Added related info about stop/down timeout (#3691 )	2025-10-04 13:39:53 -05:00
Geoff Bourne	a19eadec80	Correct formatting of /start shim for alpine variants (#3690 )	2025-10-04 12:38:42 -05:00
Crafter_Y	b7859d7496	Added DOWNLOAD_EXTRA_CONFIGS (#3679 )	2025-10-01 07:30:30 -05:00
Geoff Bourne	c6cec6390a	deps: upgrade mc-server-runner 1.13.4 for CVE fixes (#3678 )	2025-09-28 17:07:22 -05:00
Leon Kampwerth	6c81a0fd49	Update Greg Tech New Horizons compose file example (#3677 )	2025-09-28 15:25:56 -05:00
Geoff Bourne	b008a33a8f	Added java25 images, deprecated java24 (#3675 )	2025-09-27 10:52:23 -05:00
Geoff Bourne	31a39bc46b	Add "ok menu" and "particle rain" to default excludes (#3674 )	2025-09-27 10:20:34 -05:00
dependabot[bot]	593c94ad94	build(deps): bump the patches group in /docs with 2 updates (#3671 )	2025-09-22 07:08:53 -05:00
kingcavespider1	d1da61d0de	Fix USE_MEOWICE_FLAGS and appearance of Aikars enablement (#3660 )	2025-09-21 09:10:51 -05:00
Geoff Bourne	ac805a4da6	Fix autostop-daemon.sh path in start-autostop (#3670 )	2025-09-20 15:01:00 -05:00
iofq	0517a0a2b1	fix: update autopause-fcns.sh path (#3666 )	2025-09-19 22:53:43 -05:00
Geoff Bourne	bdac28a323	Support selecting Paper "pre" versions (#3664 )	2025-09-19 19:51:36 -05:00
Geoff Bourne	9a6b858b83	Add /start shim for containers using old entrypoint (#3663 )	2025-09-19 17:17:59 -05:00
Geoff Bourne	cabeb9c695	Corrected retrieval of NanoLimbo release file (#3662 )	2025-09-19 16:49:24 -05:00
Geoff Bourne	81cbc72ae9	Improve local development (#3661 )	2025-09-19 15:07:35 -05:00
EmilyxFox	9cbe5c2228	More management server properties docs (#3657 )	2025-09-12 14:41:06 -05:00
Geoff Bourne	d58dfeaaf4	fetch: download specific file to adjacent temp (#3653 )	2025-09-11 19:08:08 -05:00
EmilyxFox	82ecda599e	add new server properties added in 25w37a (#3651 )	2025-09-10 07:12:11 -05:00
dependabot[bot]	d1e6f738f3	build(deps): bump mkdocs-material from 9.6.18 to 9.6.19 in /docs in the patches group (#3650 )	2025-09-08 16:10:30 -05:00
dependabot[bot]	ffd6e7fc60	build(deps): bump actions/stale from 9 to 10 (#3649 )	2025-09-08 07:26:12 -05:00