docs: avoid overly describing server properties

.github/workflows/build-multiarch.yml

@@ -29,8 +29,6 @@ jobs:
           - java17
           - java17-graalvm
           - java17-alpine
-          - java16
-          - java11
           - java8
           - java8-graalvm-ce
           - java8-openj9
@@ -76,41 +74,31 @@ jobs:
             baseImage: eclipse-temurin:17-jre-alpine
             platforms: linux/amd64
             mcVersion: 1.20.4
-        # JAVA 16
-          - variant: java16
-            baseImage: adoptopenjdk:16-jre-hotspot
-            platforms: linux/amd64,linux/arm/v7,linux/arm64
-            mcVersion: 1.16.5
-        # JAVA 11
-          - variant: java11
-            baseImage: adoptopenjdk:11-jre-hotspot
-            platforms: linux/amd64,linux/arm/v7,linux/arm64
-            mcVersion: 1.16.4
         # JAVA 8: NOTE: Unable to go past 8u312 because of Forge dependencies
           - variant: java8
             baseImage: eclipse-temurin:8u312-b07-jre-focal
             platforms: linux/amd64,linux/arm/v7,linux/arm64
             mcVersion: 1.12.2
             # Pin version for Java 8
-#            mcHelperVersion: 1.46.0
+            mcHelperVersion: 1.42.1
           - variant: java8-graalvm-ce
             baseImage: ghcr.io/graalvm/graalvm-ce:java8
             platforms: linux/amd64
             mcVersion: 1.12.2
             # Pin version for Java 8
-#            mcHelperVersion: 1.46.0
+            mcHelperVersion: 1.42.1
           - variant: java8-jdk
             baseImage: eclipse-temurin:8u312-b07-jdk-focal
             platforms: linux/amd64,linux/arm64
             mcVersion: 1.12.2
             # Pin version for Java 8
-#            mcHelperVersion: 1.46.0
+            mcHelperVersion: 1.42.1
           - variant: java8-openj9
             baseImage: ibm-semeru-runtimes:open-8u312-b07-jre
             platforms: linux/amd64,linux/arm64
             mcVersion: 1.12.2
             # Pin version for Java 8
-#            mcHelperVersion: 1.46.0
+            mcHelperVersion: 1.42.1
     env:
       IMAGE_TO_TEST: "${{ github.repository_owner }}/minecraft-server:test-${{ matrix.variant }}-${{ github.run_id }}"
       HAS_IMAGE_REPO_ACCESS: ${{ secrets.DOCKER_USER != '' && secrets.DOCKER_PASSWORD != '' }}

Dockerfile

@@ -48,7 +48,7 @@ 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.1
+ARG MC_HELPER_VERSION=1.45.0
 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

docs/Dockerfile

@@ -1,4 +1,4 @@
-FROM python:3.11
+FROM python:3.9
 
 RUN pip install --upgrade pip
 

docs/commands.md

@@ -50,17 +50,9 @@ In order to attach and interact with the Minecraft server make sure to enable TT
         tty: true
     ```
 
-With that you can attach and interact at any time using the following, replacing the `{...}` placeholders.
+With that you can attach and interact at any time using
 
-...when container is created with `docker run`
+    docker attach mc
-```
-docker attach {container name or ID}
-```
-
-...or when declared using a compose file
-```
-docker compose attach {service name}
-```
 
 and then Control-p Control-q to **detach**.
 

docs/configuration/server-properties.md

@@ -84,19 +84,9 @@ To produce a multi-line MOTD, embed a newline character as `\n` in the string, s
     #      MOTD: "line one\nline two"
     ```
 
-The following example combines a multi-line MOTD with [placeholders](#placeholders) from the latest version of the installed modpack:
+!!! tip
 
-!!! example
+    You can also embed configured and resolved environment variables using [placeholders](#placeholders).
-
-    ```yaml
-    MOD_PLATFORM: AUTO_CURSEFORGE
-    CF_SLUG: craftoria
-    MOTD: |
-      A %TYPE% server on %VERSION%
-      running %MODPACK_NAME% %MODPACK_VERSION%
-    ```
-    
-    ![](../img/motd-with-placeholders.png)
 
 ### Difficulty
 
@@ -256,7 +246,7 @@ By default, the server listens for RCON on port 25575 within the container. It c
 
 ### Query
 
-Set the environment variable `ENABLE_QUERY` to "true" to enable the gamespy query protocol. Maps to the server property [enable-query](https://minecraft.wiki/w/Server.properties#enable-query). By default, the query port will be `25565` (UDP) but can be changed with the `QUERY_PORT` environment variable.
+Set the environment variable `QUERY_PORT` to "true" to enable the gamespy query protocol. Map to the server property [enable-query](https://minecraft.wiki/w/Server.properties#enable-query). By default, the query port will be `25565` (UDP) but can be changed with the `QUERY_PORT` environment variable.
 
 ### Level Seed
 
@@ -312,28 +302,29 @@ Example for a superflat world:
 - Desert biome
 
 ```yaml
-environment:
+LEVEL_TYPE: FLAT
-  LEVEL_TYPE: FLAT
+GENERATOR_SETTINGS: >-4
-  GENERATOR_SETTINGS: >-
+    {
-      {
+        "layers": [
-          "layers": [
+            {
-              {
+                "block": "minecraft:bedrock",
-                  "block": "minecraft:bedrock",
+                "height": 1
-                  "height": 1
+            },
-              },
+            {
-              {
+                "block": "minecraft:stone",
-                  "block": "minecraft:stone",
+                "height": 2
-                  "height": 2
+            },
-              },
+            {
-              {
+                "block": "minecraft:sandstone",
-                  "block": "minecraft:sandstone",
+                "height": 15
-                  "height": 15
+            }
-              }
+        ],
-          ],
+        "biome": "minecraft:desert"
-          "biome": "minecraft:desert"
+    }
-      }
+
+
 ```
-For more details, refer to the Minecraft Wiki sections for [Superflat Multiplayer](https://minecraft.wiki/w/Superflat#Multiplayer) and [generator options tag format](https://minecraft.wiki/w/Java_Edition_level_format#generatorOptions_tag_format).
+For more details, check the [official wiki](https://minecraft.wiki/w/Java_Edition_level_format#generatorOptions_tag_format).
 
 ### Custom Server Resource Pack
 
@@ -396,43 +387,41 @@ When using `docker run` from a bash shell, the entries must be quoted with the `
 
 ### Other server property mappings
 
-| Environment Variable              | Server Property                                                                                                   |
+| 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_FLIGHT                      | [allow-flight](https://minecraft.wiki/w/Server.properties#allow-flight)                                           |
+| ALLOW_NETHER                      | [allow-nether](https://minecraft.wiki/w/Server.properties#allow-nether)                 |
-| ALLOW_NETHER                      | [allow-nether](https://minecraft.wiki/w/Server.properties#allow-nether)                                           |
+| BROADCAST_CONSOLE_TO_OPS          | broadcast-console-to-ops                                                                |
-| 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                                                                   |
-| BROADCAST_RCON_TO_OPS             | [broadcast-rcon-to-ops](https://minecraft.wiki/w/Server.properties#broadcast-rcon-to-ops)                         |
+| BUG_REPORT_LINK                   | bug-report-link                                                                         |
-| 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_COMMAND_BLOCK              | [enable-command-block](https://minecraft.wiki/w/Server.properties#enable-command-block)                           |
+| ENABLE_STATUS                     | enable-status                                                                           |
-| ENABLE_STATUS                     | [enable-status](https://minecraft.wiki/w/Server.properties#enable-status)                                         |
+| ENFORCE_SECURE_PROFILE            | enforce-secure-profile                                                                  |
-| ENFORCE_SECURE_PROFILE            | [enforce-secure-profile](https://minecraft.wiki/w/Server.properties#enforce-secure-profile)                       |
+| ENTITY_BROADCAST_RANGE_PERCENTAGE | entity-broadcast-range-percentage                                                       |
-| 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)             |
-| FORCE_GAMEMODE                    | [force-gamemode](https://minecraft.wiki/w/Server.properties#force-gamemode)                                       |
+| FUNCTION_PERMISSION_LEVEL         | function-permission-level                                                               |
-| 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)   |
-| GENERATE_STRUCTURES               | [generate-structures](https://minecraft.wiki/w/Server.properties#generate-structures)                             |
+| HARDCORE                          | [hardcore](https://minecraft.wiki/w/Server.properties#hardcore)                         |
-| HARDCORE                          | [hardcore](https://minecraft.wiki/w/Server.properties#hardcore)                                                   |
+| HIDE_ONLINE_PLAYERS               | hide-online-players                                                                     |
-| HIDE_ONLINE_PLAYERS               | [hide-online-players](https://minecraft.wiki/w/Server.properties#hide-online-players)                             |
+| LOG_IPS                           | log-ips                                                                                 |
-| LOG_IPS                           | [log-ips](https://minecraft.wiki/w/Server.properties#log-ips)                                                     |
+| MAX_CHAINED_NEIGHBOR_UPDATES      | max-chained-neighbor-updates                                                            |
-| 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_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_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)             |
-| MAX_WORLD_SIZE                    | [max-world-size](https://minecraft.wiki/w/Server.properties#max-world-size)                                       |
+| NETWORK_COMPRESSION_THRESHOLD     | network-compression-threshold                                                           |
-| 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)                   |
-| ONLINE_MODE                       | [online-mode](https://minecraft.wiki/w/Server.properties#online-mode)                                             |
+| OP_PERMISSION_LEVEL               | op-permission-level                                                                     |
-| OP_PERMISSION_LEVEL               | [op-permission-level](https://minecraft.wiki/w/Server.properties#op-permission-level)                             |
+| PAUSE_WHEN_EMPTY_SECONDS          | pause-when-empty-seconds                                                                |
-| PAUSE_WHEN_EMPTY_SECONDS          | [pause-when-empty-seconds](https://minecraft.wiki/w/Server.properties#pause-when-empty-seconds)                   |
+| PLAYER_IDLE_TIMEOUT               | player-idle-timeout                                                                     |
-| PLAYER_IDLE_TIMEOUT               | [player-idle-timeout](https://minecraft.wiki/w/Server.properties#player-idle-timeout)                             |
+| PREVENT_PROXY_CONNECTIONS         | prevent-proxy-connections                                                               |
-| PREVENT_PROXY_CONNECTIONS         | [prevent-proxy-connections](https://minecraft.wiki/w/Server.properties#prevent-proxy-connections)                 |
+| PVP                               | [pvp](https://minecraft.wiki/w/Server.properties#pvp)                                   |
-| PVP                               | [pvp](https://minecraft.wiki/w/Server.properties#pvp)                                                             |
+| REGION_FILE_COMPRESSION           | region-file-compression                                                                 |   
-| RATE_LIMIT                        | [rate-limit](https://minecraft.wiki/w/Server.properties#rate-limit)                                               |
+| RESOURCE_PACK_ID                  | resource-pack-id                                                                        |
-| REGION_FILE_COMPRESSION           | [region-file-compression](https://minecraft.wiki/w/Server.properties#region-file-compression)                     |   
+| RESOURCE_PACK_PROMPT              | resource-pack-prompt                                                                    |
-| RESOURCE_PACK_ID                  | [resource-pack-id](https://minecraft.wiki/w/Server.properties#resource-pack-id)                                   |
+| SERVER_NAME                       | [server-name](https://minecraft.wiki/w/Server.properties#server-name)                   |
-| RESOURCE_PACK_PROMPT              | [resource-pack-prompt](https://minecraft.wiki/w/Server.properties#resource-pack-prompt)                           |
+| SIMULATION_DISTANCE               | simulation-distance                                                                     |
-| SERVER_NAME                       | [server-name](https://minecraft.wiki/w/Server.properties#server-name)                                             |
+| SPAWN_MONSTERS                    | [spawn-monsters](https://minecraft.wiki/w/Server.properties#spawn-monsters)             |
-| SIMULATION_DISTANCE               | [simulation-distance](https://minecraft.wiki/w/Server.properties#simulation-distance)                             |
+| SPAWN_PROTECTION                  | [spawn-protection](https://minecraft.wiki/w/Server.properties#spawn-protection)         |
-| SPAWN_MONSTERS                    | [spawn-monsters](https://minecraft.wiki/w/Server.properties#spawn-monsters)                                       |
+| SYNC_CHUNK_WRITES                 | sync-chunk-writes                                                                       |
-| SPAWN_PROTECTION                  | [spawn-protection](https://minecraft.wiki/w/Server.properties#spawn-protection)                                   |
+| USE_NATIVE_TRANSPORT              | use-native-transport                                                                    |
-| SYNC_CHUNK_WRITES                 | [sync-chunk-writes](https://minecraft.wiki/w/Server.properties#sync-chunk-writes)                                 |
+| VIEW_DISTANCE                     | [view-distance](https://minecraft.wiki/w/Server.properties#view-distance)               |
-| 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)                                         |

docs/index.md

@@ -29,7 +29,7 @@ where, in this case, the standard server port 25565, will be exposed on your hos
 
     **DO NOT** port forward RCON on 25575 without first setting `RCON_PASSWORD` to a secure value. It is highly recommended to only use RCON within the container, such as with `rcon-cli`. 
 
-By default, the container will download the latest version of the "vanilla" [Minecraft: Java Edition server](https://www.minecraft.net/en-us/download/server) provided by Mojang. The [`VERSION`](versions/minecraft.md) and the [`TYPE`](types-and-platforms/index.md) can be configured to create many variations of desired Minecraft server. 
+By default, the container will download the latest version of the "vanilla" [Minecraft: Java Edition server](https://www.minecraft.net/en-us/download/server) provided by Mojang. The [`VERSION`](versions/java.md) and the [`TYPE`](types-and-platforms/index.md) can be configured to create many variations of desired Minecraft server. 
 
 ## Using [Docker Compose](https://docs.docker.com/compose/)
 

docs/misc/autopause-autostop/autopause.md

@@ -1,9 +1,5 @@
 # Auto-Pause
 
-!!! important
-
-    As of [1.21.2](https://minecraft.wiki/w/Java_Edition_1.21.2) it is not recommend to use this feature since Minecraft server natively auto-pauses when the server is empty. That is configured via the enivironment variable `PAUSE_WHEN_EMPTY_SECONDS`, which maps to the `pause-when-empty-seconds` server property. 
-
 An auto-pause functionality is provided that monitors whether clients are connected to the server. If a client is not connected for a specified time, the Java process is put into a pause state. When a client attempts to connect while the process is paused, then process will be restored to a running state. The experience for the client does not change. This feature can be enabled by setting the environment variable `ENABLE_AUTOPAUSE` to "true".
 
 !!! important

docs/misc/contributing/building.md

@@ -1,13 +1,7 @@
 
-!!! tip "For advanced use only"
-
-    This page describes a capability that is not applicable to most users. It is only intended for rare cases when a very specific Java base image is needed or additional packages need to be installed that are not generally applicable or would bloat the image size.
-
-    Be sure to confirm that the desired [version and variant of Java isn't already provided](../versions/java.md).
-
 ## Building image locally with alternate Java base
 
-An alternate Java base image can be specified by setting the [docker build argument](https://docs.docker.com/reference/cli/docker/buildx/build/#build-arg) `BASE_IMAGE` to the desired base image. The following shows an example of using the base image `ghcr.io/graalvm/graalvm-ce:ol8-java11`:
+The following shows how to change the base Java image used by the build:
 
 ```shell
 docker build --build-arg BASE_IMAGE=ghcr.io/graalvm/graalvm-ce:ol8-java11 -t IMG_PREFIX/minecraft-server:java11-graalvm .

docs/mods-and-plugins/modrinth.md

@@ -42,25 +42,6 @@
     datapack:terralith
     ```
 
-## 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`.
-
-!!! example
-
-    Given the environment variables
-    
-    ```yaml
-        MODRINTH_PROJECTS: |
-          viaversion
-          viabackwards
-          griefprevention
-          discordsrv
-        VERSION_FROM_MODRINTH_PROJECTS: true
-    ```
-    
-    Let's say all are supported on Minecraft up to 1.21.8 except griefprevention, which is only supported up to 1.21.7. In that case, `VERSION` will be automatically set to 1.21.7.
-
 ## Extra options
 
 `MODRINTH_DOWNLOAD_DEPENDENCIES`
@@ -69,6 +50,3 @@ When the environment variable `VERSION_FROM_MODRINTH_PROJECTS` is set to "true"
 `MODRINTH_ALLOWED_VERSION_TYPE`
 : The version type is used to determine the newest version to use from each project. The allowed values are `release` (default), `beta`, `alpha`. Setting to `beta` will pick up both release and beta versions. Setting to `alpha` will pick up release, beta, and alpha versions.
 
-`MODRINTH_LOADER`
-: When using a custom server, set this to specify which loader type will be requested during lookups
-

docs/requirements.txt

@@ -1,6 +1,6 @@
-mkdocs-material == 9.6.16
+mkdocs-material == 9.6.14
 mkdocs-autorefs == 1.4.2
-mkdocstrings[python] == 0.30.0
+mkdocstrings[python] == 0.29.1
 mkdocs-literate-nav == 0.6.2
 mdx-gh-links == 0.4
 mkdocs-click == 0.9.0

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

@@ -41,27 +41,21 @@ A specific loader or launcher version other than the latest can be requested usi
       FABRIC_LOADER_VERSION: 0.13.1
     ```
 
-!!! note
+!!! note "Fabric API"
 
-    See the [Working with mods and plugins](../../mods-and-plugins/index.md) section to set up Fabric mods and configuration.
+    As [mentioned on the Fabric download page](https://fabricmc.net/use/installer/), most mods will require the Fabric API mod to be installed. That can be easily done by utilizing [the Modrinth downloads feature](../../mods-and-plugins/modrinth.md), such as adding this to the `environment` of a compose file service:
     
-## Fabric API
+    ```yaml
+          TYPE: FABRIC
+          MODRINTH_PROJECTS: |
+            fabric-api
+    ```
 
-As [mentioned on the Fabric download page](https://fabricmc.net/use/installer/), most mods will require the Fabric API mod to be installed. That can be easily done by utilizing [the Modrinth downloads feature](../../mods-and-plugins/modrinth.md), such as adding this to the `environment` of a compose file service:
+!!! note "Alternate launcher"
 
-```yaml
+    If you wish to use an alternative launcher you can:  
-      TYPE: FABRIC
-      MODRINTH_PROJECTS: |
-        fabric-api
-```
 
-## Alternate launcher
+    - Provide the path to a custom launcher jar available to the container with `FABRIC_LAUNCHER`, relative to `/data` (such as `-e FABRIC_LAUNCHER=fabric-server-custom.jar`)
+    - Provide the URL to a custom launcher jar with `FABRIC_LAUNCHER_URL` (such as `-e FABRIC_LAUNCHER_URL=http://HOST/fabric-server-custom.jar`)
 
-If you wish to use an alternative launcher you can:  
+See the [Working with mods and plugins](../../mods-and-plugins/index.md) section to set up Fabric mods and configuration.
-
-- Provide the path to a custom launcher jar available to the container with `FABRIC_LAUNCHER`, relative to `/data` (such as `-e FABRIC_LAUNCHER=fabric-server-custom.jar`)
-- Provide the URL to a custom launcher jar with `FABRIC_LAUNCHER_URL` (such as `-e FABRIC_LAUNCHER_URL=http://HOST/fabric-server-custom.jar`)
-
-## Force re-install
-
-If the Fabric launcher jar becomes corrupted you can temporarily set FABRIC_FORCE_REINSTALL to "true" to have it re-installed on next startup.

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

@@ -41,9 +41,7 @@ Configuration options with defaults:
 
 ## NanoLimbo
 
-A [NanoLimbo](https://github.com/BoomEaro/NanoLimbo) server can be run by setting `TYPE` to `NANOLIMBO`.
+A [NanoLimbo](https://github.com/Nan1t/NanoLimbo) server can be run by setting `TYPE` to `NANOLIMBO`.
-
-Note: it is a fork of the original [NanoLimbo](https://github.com/Nan1t/NanoLimbo) made by Nan1t
 
 An alternate Limbo server
 

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

@@ -126,7 +126,3 @@ If you have attached a host directory to the `/data` volume, then you can instal
 
 !!! note
     The Folia type inherits from the Paper type. Paper's variables will override the Folia ones.
-
-## Extra config
-
-- `SKIP_DOWNLOAD_DEFAULTS`: when set to "true" startup will entirely skip checking for default Paper/Bukkit/Spigot config files to download

docs/versions/java.md

@@ -10,29 +10,29 @@ or explicitly include the tag, such as
 
 where `<tag>` refers to the first column of this table:
 
-| Tag            | Java version | Linux  | JVM Type           | Architecture        | Note |
+| Tag              | Java version | Linux  | JVM Type           | Architecture        | Note |
-|----------------|--------------|--------|--------------------|---------------------|------|
+|------------------|--------------|--------|--------------------|---------------------|------|
-| latest         | 21           | Ubuntu | Hotspot            | amd64, arm64        |      |
+| latest           | 21           | Ubuntu | Hotspot            | amd64, arm64        |      |
-| stable         | 21           | Ubuntu | Hotspot            | amd64, arm64        |      |
+| stable           | 21           | Ubuntu | Hotspot            | amd64, arm64        |      |
-| java24         | 24           | Ubuntu | Hotspot            | amd64, arm64        | (2)  |
+| java24           | 24           | Ubuntu | Hotspot            | amd64, arm64        | (2)  |
-| java24-graalvm | 24           | Oracle | Oracle GraalVM (3) | amd64, arm64        | (2)  |   
+| java24-graalvm   | 24           | Oracle | Oracle GraalVM (3) | amd64, arm64        | (2)  |   
-| java21         | 21           | Ubuntu | Hotspot            | amd64, arm64        |      |
+| java21           | 21           | Ubuntu | Hotspot            | amd64, arm64        |      |
-| java21-jdk     | 21           | Ubuntu | Hotspot+JDK        | amd64, arm64        |      |
+| java21-jdk       | 21           | Ubuntu | Hotspot+JDK        | amd64, arm64        |      |
-| java21-alpine  | 21           | Alpine | Hotspot            | amd64, arm64        |      |
+| java21-alpine    | 21           | Alpine | Hotspot            | amd64, arm64        |      |
-| java21-graalvm | 21           | Oracle | Oracle GraalVM (3) | amd64, arm64        |      |   
+| java21-graalvm   | 21           | Oracle | Oracle GraalVM (3) | amd64, arm64        |      |   
-| java17         | 17           | Ubuntu | Hotspot            | amd64, arm64, armv7 |      |
+| java17           | 17           | Ubuntu | Hotspot            | amd64, arm64, armv7 |      |
-| java17-graalvm | 17           | Oracle | Oracle GraalVM (3) | amd64, arm64        |      |   
+| java17-graalvm   | 17           | Oracle | Oracle GraalVM (3) | amd64, arm64        |      |   
-| java17-alpine  | 17           | Alpine | Hotspot            | amd64  (1)          |      |
+| java17-alpine    | 17           | Alpine | Hotspot            | amd64  (1)          |      |
-| java16         | 16           | Ubuntu | Hotspot            | amd64, arm64, armv7 | (4)  |
+| java8            | 8            | Ubuntu | Hotspot            | amd64, arm64, armv7 |      |
-| java11         | 11           | Ubuntu | Hotspot            | amd64, arm64, armv7 |      |
+| java8-jdk        | 8            | Ubuntu | Hotspot+JDK        | amd64               |      |
-| java8          | 8            | Ubuntu | Hotspot            | amd64, arm64, armv7 |      |
+| java8-openj9     | 8            | Debian | OpenJ9             | amd64               |      |
+| java8-graalvm-ce | 8            | Oracle | GraalVM CE         | amd64               |      |
 
 Notes
 
 1. Why no arm64 for Java 17 Alpine? That is because the base images, such as [elipse-temurin](https://hub.docker.com/_/eclipse-temurin/tags?page=&page_size=&ordering=&name=17-jre-alpine) do not provide support for that. Use the Ubuntu based images instead.
 2. Short-term variant, subject to deprecation upon next version introduction
 3. Based on the [Oracle GraalMV images](https://blogs.oracle.com/java/post/new-oracle-graalvm-container-images), which as of JDK 17, are now under the [GraalVM Free License](https://blogs.oracle.com/java/post/graalvm-free-license) incorporating what used to be known as the GraalVM Enterprise.
-4. This version of Java is [recommended for PaperMC 1.16.5](https://docs.papermc.io/paper/getting-started/#requirements)
 
 !!! example "Example using java8"
 
@@ -131,11 +131,12 @@ The following image tags have been deprecated and are no longer receiving update
 - adopt15
 - openj9-nightly
 - multiarch-latest
-- java16-openj9
+- java11
+- java16/java16-openj9
 - java17-graalvm-ce
 - java17-openj9
 - java19
 - java20-graalvm, java20, java20-alpine
 - java23-*
 - java8-multiarch is still built and pushed, but please move to java8 instead
-- java8-alpine, java8-jdk, java8-openj9, java8-graalvm-ce
+- java8-alpine

examples/craftoria/docker-compose.yml

@@ -9,10 +9,12 @@ services:
       EULA: true
       ALLOW_FLIGHT: true
       MOD_PLATFORM: AUTO_CURSEFORGE
+      # Allocate API key from https://console.curseforge.com/
+      # and set in .env file making sure to double up dollar signs, such as
+      # CF_API_KEY=$$2a$$10$$....
+      # Refer to https://docker-minecraft-server.readthedocs.io/en/latest/types-and-platforms/mod-platforms/auto-curseforge/#api-key
+      CF_API_KEY: ${CF_API_KEY}
       CF_SLUG: craftoria
-      MOTD: |
-        A %TYPE% server on %VERSION%
-        running %MODPACK_NAME% %MODPACK_VERSION%
       MEMORY: 8G
     volumes:
       # Use managed volume by default, but can change to a relative path like

examples/modrinth/version-from-modrinth-projects/compose.yml

@@ -1,15 +0,0 @@
-services:
-  mc:
-    image: itzg/minecraft-server
-    environment:
-      EULA: true
-      TYPE: paper
-      MODRINTH_PROJECTS: |
-        viaversion
-        viabackwards
-        griefprevention
-        discordsrv
-      VERSION_FROM_MODRINTH_PROJECTS: true
-      SETUP_ONLY: true
-    ports:
-      - "25565:25565"

examples/packwiz/compose.yml

@@ -1,16 +0,0 @@
-services:
-  mc:
-    image: itzg/minecraft-server
-    tty: true
-    stdin_open: true
-    environment:
-      EULA: true
-      # Match loader from versions section of https://github.com/packwiz/packwiz-example-pack/blob/v1/pack.toml
-      TYPE: QUILT
-      VERSION: "1.19"
-      QUILT_LOADER_VERSION: "0.17.0"
-      PACKWIZ_URL: https://raw.githubusercontent.com/packwiz/packwiz-example-pack/refs/heads/v1/pack.toml
-    volumes:
-      - ./data:/data
-    ports:
-      - "25565:25565"

files/cf-exclude-include.json

@@ -18,7 +18,6 @@
     "better-tips-nbt-tag",
     "betterf3",
     "betterfps",
-    "bettergrassify",
     "biomeinfo",
     "block-drops-jei-addon",
     "blur-forge",
@@ -28,7 +27,6 @@
     "chunk-animator",
     "clickable-advancements",
     "compass-coords",
-    "config-menus-forge",
     "configured",
     "controllable",
     "controlling",
@@ -38,7 +36,6 @@
     "dark-mode-everywhere",
     "defensive-measures",
     "ding",
-    "distraction-free-recipes",
     "drippy-loading-screen",
     "dynamic-surroundings",
     "dynamic-view",
@@ -65,8 +62,6 @@
     "fancymenu",
     "farsight",
     "faster-ladder-climbing",
-    "fastquit",
-    "fastquit-forge",
     "flerovium",
     "foamfix-optimization-mod",
     "forgeskyboxes",
@@ -112,8 +107,6 @@
     "overloaded-armor-bar",
     "packmenu",
     "packmodemenu",
-    "particle-effects",
-    "particle-effects-reforged",
     "particular",
     "particular-reforged",
     "reauth",
@@ -159,7 +152,6 @@
     "waila-harvestability",
     "wakes-reforged",
     "wawla",
-    "welcome-screen",
     "xaeroplus",
     "yungs-menu-tweaks",
     "zume"

files/modrinth-exclude-include.json

@@ -10,7 +10,6 @@
     "axolotlbuckets",
     "BadOptimizations",
     "BetterAdvancements",
-    "BetterGrassify",
     "betterbeds",
     "BetterThirdPerson",
     "BHMenu",
@@ -26,11 +25,9 @@
     "compass-coords",
     "connectedness",
     "connector",
-    "continuity",
     "craftpresence",
     "cwb",
     "DisableCustomWorldsAdvice",
-    "distraction_free_recipes",
     "drippyloadingscreen",
     "eating-animation",
     "emiffect",
@@ -42,11 +39,9 @@
     "fallingleaves",
     "fancymenu",
     "fast-ip-ping",
-    "fastquit",
     "FauxCustomEntityData",
     "feytweaks",
     "figura",
-    "ForgeConfigScreens",
     "GeckoLibIrisCompat",
     "gpumemleakfix",
     "Highlighter",
@@ -84,7 +79,6 @@
     "sorted_enchantments",
     "visuality",
     "VR-Combat",
-    "welcomescreen",
     "YeetusExperimentus",
     "yungsmenutweaks",
     "Zoomify",

files/property-definitions.json

@@ -1,11 +1,10 @@
 {
-  "accepts-transfers": {"env": "ACCEPTS_TRANSFERS"},
   "allow-flight": {"env": "ALLOW_FLIGHT"},
   "allow-nether": {"env": "ALLOW_NETHER"},
+  "bug-report-link": {"env": "BUG_REPORT_LINK"},
   "announce-player-achievements": {"env": "ANNOUNCE_PLAYER_ACHIEVEMENTS"},
   "broadcast-console-to-ops": {"env": "BROADCAST_CONSOLE_TO_OPS"},
   "broadcast-rcon-to-ops": {"env": "BROADCAST_RCON_TO_OPS"},
-  "bug-report-link": {"env": "BUG_REPORT_LINK"},
   "difficulty": {"env": "DIFFICULTY"},
   "enable-command-block": {"env": "ENABLE_COMMAND_BLOCK"},
   "enable-jmx-monitoring": {"env": "ENABLE_JMX"},
@@ -43,15 +42,14 @@
   "previews-chat": {"env": "PREVIEWS_CHAT"},
   "pvp": {"env": "PVP"},
   "query.port": {"env": "QUERY_PORT"},
-  "rate-limit": {"env": "RATE_LIMIT"},
   "rcon.password": {"env": "RCON_PASSWORD"},
   "rcon.port": {"env": "RCON_PORT"},
   "region-file-compression": {"env": "REGION_FILE_COMPRESSION"},
-  "require-resource-pack": {"env": "RESOURCE_PACK_ENFORCE"},
+  "resource-pack": {"env": "RESOURCE_PACK"},
   "resource-pack-id": {"env": "RESOURCE_PACK_ID"},
   "resource-pack-prompt": {"env": "RESOURCE_PACK_PROMPT"},
   "resource-pack-sha1": {"env": "RESOURCE_PACK_SHA1"},
-  "resource-pack": {"env": "RESOURCE_PACK"},
+  "require-resource-pack": {"env": "RESOURCE_PACK_ENFORCE"},
   "server-ip": {"env": "SERVER_IP"},
   "server-name": {"env": "SERVER_NAME"},
   "server-port": {"env": "SERVER_PORT"},

scripts/start-configuration

@@ -139,15 +139,6 @@ cd /data || exit 1
 export DECLARED_TYPE=${TYPE^^}
 export DECLARED_VERSION="$VERSION"
 
-if isTrue "${VERSION_FROM_MODRINTH_PROJECTS:-}" && [[ ${MODRINTH_PROJECTS:-} ]]; then
-  if ! VERSION=$(mc-image-helper version-from-modrinth-projects --projects "${MODRINTH_PROJECTS}"); then
-    logError "failed to resolve version from MODRINTH_PROJECTS: ${MODRINTH_PROJECTS}"
-    exit 1
-  fi
-  log "Resolved Minecraft version $VERSION from Modrinth projects"
-  export VERSION
-fi
-
 if isTrue "${ENABLE_AUTOPAUSE}"; then
   "${SCRIPTS:-/}start-autopause"
 fi

scripts/start-deployFabric

@@ -9,24 +9,15 @@ export TYPE=FABRIC
 : "${FABRIC_LAUNCHER:=}"
 : "${FABRIC_LAUNCHER_URL:=}"
 : "${FABRIC_LOADER_VERSION:=LATEST}"
-: "${FABRIC_FORCE_REINSTALL:=false}"
 
 resultsFile=/data/.install-fabric.env
 
 isDebugging && set -x
 
-commonArgs=(
-  --results-file="${resultsFile}"
-)
-if isTrue "${FABRIC_FORCE_REINSTALL}"; then
-  log "Forcing re-install of Fabric"
-  commonArgs+=(--force-reinstall)
-fi
-
 # Custom fabric jar
 if [[ $FABRIC_LAUNCHER ]]; then
   if !   mc-image-helper install-fabric-loader \
-    "${commonArgs[@]}" \
+    --results-file=${resultsFile} \
     --from-local-file="$FABRIC_LAUNCHER"; then
     logError "Failed to use provided Fabric launcher"
     exit 1
@@ -35,7 +26,7 @@ if [[ $FABRIC_LAUNCHER ]]; then
 # Custom fabric jar url
 elif [[ $FABRIC_LAUNCHER_URL ]]; then
   if !   mc-image-helper install-fabric-loader \
-    "${commonArgs[@]}" \
+    --results-file=${resultsFile} \
     --from-url="$FABRIC_LAUNCHER_URL"; then
     logError "Failed to installFabric launcher from $FABRIC_LAUNCHER_URL"
     exit 1
@@ -44,7 +35,7 @@ elif [[ $FABRIC_LAUNCHER_URL ]]; then
 # Official fabric launcher
 else
   if !   mc-image-helper install-fabric-loader \
-    "${commonArgs[@]}" \
+    --results-file=${resultsFile} \
     --minecraft-version="${VERSION}" \
     --installer-version="${FABRIC_LAUNCHER_VERSION}" \
     --loader-version="${FABRIC_LOADER_VERSION}"; then

scripts/start-deployNanoLimbo

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

scripts/start-deployPaper

@@ -10,7 +10,7 @@ handleDebugMode
 : "${PAPER_CHANNEL:=default}"
 : "${PAPER_DOWNLOAD_URL:=}"
 : "${PAPER_CUSTOM_JAR:=}"
-: "${PAPER_CONFIG_DEFAULTS_REPO:=${PAPER_CONFIG_REPO:=https://raw.githubusercontent.com/Shonz1/minecraft-default-configs/main}}"
+: "${PAPER_CONFIG_DEFAULTS_REPO:=${PAPER_CONFIG_REPO:=https://raw.githubusercontent.com/dayyeeet/minecraft-default-configs/main}}"
 
 resultsFile=/data/.paper.env
 if [[ $PAPER_CUSTOM_JAR ]]; then

scripts/start-deployPufferfish

@@ -21,9 +21,7 @@ PUFFERFISH_BUILD_JSON=$(curl -X GET -s "https://ci.pufferfish.host/job/Pufferfis
 PUFFERFISH_BUILD_URL=$(jq -n "$PUFFERFISH_BUILD_JSON" | jq -jc '.url // empty' )
 # Example: "fileName": "pufferfish-paperclip-1.18.2-R0.1-SNAPSHOT-reobf.jar",
 PUFFERFISH_BUILD_FILENAME=$(jq -n "$PUFFERFISH_BUILD_JSON" | jq -jc '.artifacts[].fileName // empty' )
-# Example: "relativePath": "pufferfish-server/build/libs/pufferfish-paperclip-1.21.7-R0.1-SNAPSHOT-mojmap.jar",
+PUFFERFISH_BUILD_DOWNLOAD_URL="${PUFFERFISH_BUILD_URL}artifact/build/libs/${PUFFERFISH_BUILD_FILENAME}"
-PUFFERFISH_BUILD_PATH=$(jq -n "$PUFFERFISH_BUILD_JSON" | jq -jc '.artifacts[].relativePath // empty' )
-PUFFERFISH_BUILD_DOWNLOAD_URL="${PUFFERFISH_BUILD_URL}artifact/${PUFFERFISH_BUILD_PATH}"
 
 # Setting server to the Jar filename for export.
 export SERVER=$PUFFERFISH_BUILD_FILENAME

scripts/start-setupEnvVariables

@@ -14,9 +14,7 @@ handleDebugMode
 : "${REPLACE_ENV_VARIABLES_EXCLUDE_PATHS:=}"
 : "${PATCH_DEFINITIONS:=}"
 : "${DEBUG:=false}"
-: "${DOWNLOAD_DEFAULTS:=}"
 : "${DOWNLOAD_DEFAULT_CONFIGS:=}"
-: "${SKIP_DOWNLOAD_DEFAULTS:=false}"
 
 if isTrue "${REPLACE_ENV_IN_PLACE}"; then
   log "Replacing env variables in ${REPLACE_ENV_PATHS} that match the prefix '$REPLACE_ENV_VARIABLE_PREFIX' ..."
@@ -29,28 +27,22 @@ if isTrue "${REPLACE_ENV_IN_PLACE}"; then
     "${REPLACE_ENV_PATHS[@]}"
 fi
 
-if isFalse "$SKIP_DOWNLOAD_DEFAULTS"; then
+if [[ $DOWNLOAD_DEFAULT_CONFIGS ]]; then
-  commonArgs=(
+  log "Downloading default configs, if needed"
-    --skip-existing
+  if ! mc-image-helper mcopy \
-    --skip-up-to-date=false
+    --to /data/config \
-    --quiet-when-skipped
+    --skip-existing --skip-up-to-date=false \
-    --ignore-missing-sources
+    "$DOWNLOAD_DEFAULT_CONFIGS" 2> /dev/null; then
-  )
+    logWarning "One or more default config files were not available from $DOWNLOAD_DEFAULT_CONFIGS"
-  if [[ $DOWNLOAD_DEFAULT_CONFIGS ]]; then
-    if ! mc-image-helper mcopy \
-      --to /data/config \
-      "${commonArgs[@]}" \
-      "$DOWNLOAD_DEFAULT_CONFIGS"; then
-      logWarning "One or more default config files were not available from $DOWNLOAD_DEFAULT_CONFIGS"
-    fi
   fi
-  if [[ $DOWNLOAD_DEFAULTS ]]; then
+fi
-    if ! mc-image-helper mcopy \
+if [[ $DOWNLOAD_DEFAULTS ]]; then
-      --to /data \
+  log "Downloading default top-level configs, if needed"
-      "${commonArgs[@]}" \
+  if ! mc-image-helper mcopy \
-      "$DOWNLOAD_DEFAULTS"; then
+    --to /data \
-      logWarning "One or more default files were not available from $DOWNLOAD_DEFAULTS"
+    --skip-existing --skip-up-to-date=false \
-    fi
+    "$DOWNLOAD_DEFAULTS" 2> /dev/null; then
+    logWarning "One or more default files were not available from $DOWNLOAD_DEFAULTS"
   fi
 fi
 

scripts/start-setupModpack

@@ -12,7 +12,6 @@ set -e -o pipefail
 : "${REMOVE_OLD_MODS_DEPTH:=1} "
 : "${REMOVE_OLD_MODS_INCLUDE:=*.jar,*-version.json}"
 : "${CF_API_KEY_FILE:=}" # Path to file containing CurseForge API key
-: "${MODRINTH_LOADER:=}"
 sum_file=/data/.generic_pack.sum
 
 if [[ -n ${CF_API_KEY_FILE} ]]; then
@@ -264,21 +263,13 @@ function handleModrinthProjects() {
   fi
 
   if [[ $MODRINTH_PROJECTS ]]; then
-
+    if isFamily HYBRID; then
-    if isType CUSTOM; then
-      if ! [[ $MODRINTH_LOADER ]]; then
-        logError "MODRINTH_LOADER must be set when using TYPE=CUSTOM and MODRINTH_PROJECTS"
-        exit 1
-      fi
-      loader="${MODRINTH_LOADER,,}"
-    elif isFamily HYBRID; then
       loader=${HYBRIDTYPE}
     elif isFamily VANILLA; then
       loader=datapack
     else
       loader="${TYPE,,}"
     fi
-
     mc-image-helper modrinth \
       --output-directory=/data \
       --world-directory="${LEVEL:-world}" \

scripts/start-utils

@@ -411,7 +411,7 @@ function isFamily() {
 function isType() {
   for t in "${@}"; do
     # shellcheck disable=SC2153
-    if [[ ${TYPE^^} == "${t^^}" ]]; then
+    if [[ $TYPE == "$t" ]]; then
       return 0
     fi
   done

tests/setuponlytests/nanolimbo/docker-compose.yml

@@ -1,9 +0,0 @@
-services:
-  mc:
-    restart: "no"
-    image: ${IMAGE_TO_TEST:-itzg/minecraft-server}
-    environment:
-      EULA: "TRUE"
-      TYPE: NANOLIMBO
-    volumes:
-      - ./data:/data

tests/setuponlytests/nanolimbo/verify.sh

@@ -1 +0,0 @@
-mc-image-helper assert fileExists "/data/NanoLimbo-*.jar"