diff --git a/minecraft/fabric/.env.example b/minecraft/fabric/.env.example index 39b7cb7..08e197c 100644 --- a/minecraft/fabric/.env.example +++ b/minecraft/fabric/.env.example @@ -1,30 +1,16 @@ -# Copyright (C) 2020 Jef Roosens - -# This program is free software: you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation, either version 3 of the License, or -# (at your option) any later version. - -# This program is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -# GNU General Public License for more details. - -# You should have received a copy of the GNU General Public License -# along with this program. If not, see . - - # Build arguments +MC_VERSION= FABRIC_VERSION= # Environment variables -XMS=4 +# If XMS is left blank, it uses the same value as XMX +XMS= XMX=4 # Mount points -CONFIG_DIR= -MODS_DIR= -WORLDS_DIR= +# The mods should be placed inside the CONFIG_DIR under `mods` +CONFIG_DIR=config +WORLDS_DIR=worlds # Other PORT=25565 diff --git a/minecraft/fabric/Dockerfile b/minecraft/fabric/Dockerfile index 3558f9f..35926a5 100644 --- a/minecraft/fabric/Dockerfile +++ b/minecraft/fabric/Dockerfile @@ -1,69 +1,40 @@ -# Copyright (C) 2020 Jef Roosens - -# This program is free software: you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation, either version 3 of the License, or -# (at your option) any later version. - -# This program is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -# GNU General Public License for more details. - -# You should have received a copy of the GNU General Public License -# along with this program. If not, see . - - -FROM openjdk:8-slim +FROM openjdk:8-jre-slim # Build arguments +ARG MC_VERSION ARG FABRIC_VERSION +# Install mcstatus for healthchecks +RUN apt update && \ + apt install --no-install-recommends -y python3-minimal python3-setuptools python3-pip && \ + python3 -m pip install mcstatus && \ + apt --purge remove -y python3-pip python3-setuptools && \ + apt clean + # Create worlds and config directory -WORKDIR /mc +WORKDIR /app RUN mkdir worlds config # Download installer jar ADD "https://maven.fabricmc.net/net/fabricmc/fabric-installer/$FABRIC_VERSION/fabric-installer-$FABRIC_VERSION.jar" installer.jar # Install fabric & remove installer -RUN java -jar installer.jar server -downloadMinecraft && \ -rm installer.jar +RUN java -jar installer.jar server -downloadMinecraft -mcversion "$MC_VERSION" && \ + rm installer.jar # Store the cache in an anonymous volume, which means it won't get stored in the other volumes -VOLUME /mc/config/cache +VOLUME /app/config/cache -WORKDIR /mc/config # Default value to keep users from eating up all ram accidentally -ENV XMS=4 +ENV XMX=4 +ENV MC_VERSION="${MC_VERSION}" +ENV FABRIC_VERSION="${FABRIC_VERSION}" -# We copy over the server jar(s) as well to make the backup more reproducible to deploy -ENTRYPOINT mv -n /mc/*.jar /mc/config && \ -echo "eula=true" > /mc/config/eula.txt && \ -java \ --Xms"${XMS}G" \ --Xmx"${XMX:-$XMS}G" \ --XX:+UseG1GC \ --XX:+ParallelRefProcEnabled \ --XX:MaxGCPauseMillis=200 \ --XX:+UnlockExperimentalVMOptions \ --XX:+DisableExplicitGC \ --XX:+AlwaysPreTouch \ --XX:G1NewSizePercent="$([ $XMS -gt 12 ] && echo 40 || echo 30)" \ --XX:G1MaxNewSizePercent="$([ $XMS -gt 12 ] && echo 50 || echo 40)" \ --XX:G1HeapRegionSize="$([ $XMS -gt 12 ] && echo 16 || echo 8)"M \ --XX:G1ReservePercent="$([ $XMS -gt 12 ] && echo 15 || echo 20)" \ --XX:G1HeapWastePercent=5 \ --XX:G1MixedGCCountTarget=4 \ --XX:InitiatingHeapOccupancyPercent="$([ $XMS -gt 12 ] && echo 20 || echo 15)" \ --XX:G1MixedGCLiveThresholdPercent=90 \ --XX:G1RSetUpdatingPauseTimePercent=5 \ --XX:SurvivorRatio=32 \ --XX:+PerfDisableSharedMem \ --XX:MaxTenuringThreshold=1 \ --Dusing.aikars.flags=https://mcflags.emc.gs \ --Daikars.new.flags=true \ --jar fabric-server-launch.jar \ ---universe /mc/worlds \ ---nogui +# Entrypoint runs in /app/config +COPY entrypoint.sh /entrypoint.sh +WORKDIR /app/config +ENTRYPOINT /entrypoint.sh + +HEALTHCHECK --interval=30s --timeout=5s --start-period=15s --retries=3 \ + CMD mcstatus localhost:25565 ping diff --git a/minecraft/fabric/README.md b/minecraft/fabric/README.md index f4575f0..1d98505 100644 --- a/minecraft/fabric/README.md +++ b/minecraft/fabric/README.md @@ -1,41 +1,21 @@ - - - # Build arguments -Only one build argument is required, namely `FABRIC_VERSION`. This is the -version of Fabric you wish to install. You can find the list of versions -[here](https://fabricmc.net/use/). For example, you can then set +Two build arguments are required, namely `MC_VERSION` and `FABRIC_VERSION`. +The latter is the version of Fabric you wish to install. You can find the list +of versions [here](https://fabricmc.net/use/). For example, you can then set `FABRIC_VERSION=0.6.1.51` in the `.env` file. # Environment variables The two possible environment variables are `XMS` and `XMX`. These specify the -initial RAM & maximum RAM usage respectively. Only `XMS` is required; `XMX` is -just set to the same value as `XMS` if not specified. You must specify them as +initial RAM & maximum RAM usage respectively. Only `XMX` is required; `XMS` is +just set to the same value as `XMX` if not specified. You must specify them as a number, e.g. `XMS=4`. This number represents a quantity of gigabytes. # Mount points There a three useful mount points defined: -* `/mc/config`: this is where all server config files reside. -* `/mc/config/mods`: this is where all mods should be placed. -* `/mc/worlds`: this is where the world files are stored. +* `/app/config`: this is where all server config files reside, as well as the + mods. +* `/app/worlds`: this is where the world files are stored. You can mount these directories somewhere in the host file system by specifying the mount paths in the `.env` file. These can be both absolute or relative @@ -54,12 +34,22 @@ end of the `Dockerfile` to the following: ``` ENTRYPOINT java \ --Xms"${XMS}G" \ --Xmx"${XMX:-$XMS}G" \ +-Xms"${XMS:-$XMX}G" \ +-Xmx"${XMX}G" \ -jar fabric-server-launch.jar \ ---universe /mc/worlds \ +--universe /app/worlds \ --nogui ``` This will only use the flags absolutely necessary, while still allowing you to tweak the memory variables. + +# Broken symlink +You might've noticed a broken symlink called `server.jar` in your config +directory. This is an (admittedly ugly) fix for the issue where Fabric expects +the vanilla server jar to be in the current working directory. Considering a +server also has to run within its config directory, this would mean that the +vanilla jar should be in the config directory. As I wanted to keep any +version-specific data out of the config/worlds directories, I have opted to use +a symlink to the server jar in question instead. This symlink can be safely +deleted, and will just get re-created when needed. diff --git a/minecraft/fabric/docker-compose.yml b/minecraft/fabric/docker-compose.yml index bc2b81e..a0baa73 100644 --- a/minecraft/fabric/docker-compose.yml +++ b/minecraft/fabric/docker-compose.yml @@ -1,29 +1,14 @@ -# Copyright (C) 2020 Jef Roosens - -# This program is free software: you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation, either version 3 of the License, or -# (at your option) any later version. - -# This program is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -# GNU General Public License for more details. - -# You should have received a copy of the GNU General Public License -# along with this program. If not, see . - - version: '3.5' services: - fabric: + app: build: context: . args: - - 'FABRIC_VERSION=${FABRIC_VERSION}' - image: 'mc-fabric-server:${FABRIC_VERSION}' + - 'MC_VERSION' + - 'FABRIC_VERSION' + image: 'chewingbever/mc-fabric:${MC_VERSION}-${FABRIC_VERSION}' - restart: 'unless-stopped' + restart: 'always' stdin_open: true tty: true @@ -33,6 +18,10 @@ services: ports: - '$PORT:25565' volumes: - - '$CONFIG_DIR:/mc/config' - - '$MODS_DIR:/mc/config/mods' - - '$WORLDS_DIR:/mc/worlds' + - '$CONFIG_DIR:/app/config' + - '$WORLDS_DIR:/app/worlds' + +# These volumes only get created if you use them in the env file +volumes: + config: + worlds: diff --git a/minecraft/fabric/entrypoint.sh b/minecraft/fabric/entrypoint.sh new file mode 100755 index 0000000..bfe55f5 --- /dev/null +++ b/minecraft/fabric/entrypoint.sh @@ -0,0 +1,40 @@ +#!/usr/bin/env bash + +# Accept the EULA +echo "eula=true" > /app/config/eula.txt + +# Log the last-used version, so we know which version to use when running it again (e.g. loading the backup) +echo "${MC_VERSION}, Fabric v${FABRIC_VERSION}" >> /app/config/versions.txt + +XMS="${XMS:-$XMX}" + +# Create symlink for server jar +ln -sf ../server.jar server.jar + +# Launch the actual server +exec java \ + -Xms"${XMS}G" \ + -Xmx"${XMX:-$XMS}G" \ + -XX:+UseG1GC \ + -XX:+ParallelRefProcEnabled \ + -XX:MaxGCPauseMillis=200 \ + -XX:+UnlockExperimentalVMOptions \ + -XX:+DisableExplicitGC \ + -XX:+AlwaysPreTouch \ + -XX:G1NewSizePercent="$([ $XMS -gt 12 ] && echo 40 || echo 30)" \ + -XX:G1MaxNewSizePercent="$([ $XMS -gt 12 ] && echo 50 || echo 40)" \ + -XX:G1HeapRegionSize="$([ $XMS -gt 12 ] && echo 16 || echo 8)"M \ + -XX:G1ReservePercent="$([ $XMS -gt 12 ] && echo 15 || echo 20)" \ + -XX:G1HeapWastePercent=5 \ + -XX:G1MixedGCCountTarget=4 \ + -XX:InitiatingHeapOccupancyPercent="$([ $XMS -gt 12 ] && echo 20 || echo 15)" \ + -XX:G1MixedGCLiveThresholdPercent=90 \ + -XX:G1RSetUpdatingPauseTimePercent=5 \ + -XX:SurvivorRatio=32 \ + -XX:+PerfDisableSharedMem \ + -XX:MaxTenuringThreshold=1 \ + -Dusing.aikars.flags=https://mcflags.emc.gs \ + -Daikars.new.flags=true \ + -jar /app/fabric-server-launch.jar \ + --universe /app/worlds \ + --nogui diff --git a/minecraft/forge/README.md b/minecraft/forge/README.md index 01f563a..7677729 100644 --- a/minecraft/forge/README.md +++ b/minecraft/forge/README.md @@ -1,23 +1,3 @@ - - - # Build arguments Two build arguments are required, namely `MC_VERSION` and `FORGE_VERSION`. You can find your required versions [here](https://files.minecraftforge.net/). @@ -30,16 +10,16 @@ FORGE_VERSION=35.1.4 # Environment variables The two possible environment variables are `XMS` and `XMX`. These specify the -initial RAM & maximum RAM usage respectively. Only `XMS` is required; `XMX` is -just set to the same value as `XMS` if not specified. You must specify them as +initial RAM & maximum RAM usage respectively. Only `XMX` is required; `XMS` is +just set to the same value as `XMX` if not specified. You must specify them as a number, e.g. `XMS=4`. This number represents a quantity of gigabytes. # Mount points There a three useful mount points defined: -* `/mc/config`: this is where all server config files reside. -* `/mc/config/mods`: this is where all mods should be placed. -* `/mc/worlds`: this is where the world files are stored. +* `/app/config`: this is where all server config files reside, as well as the + mods. +* `/app/worlds`: this is where the world files are stored. You can mount these directories somewhere in the host file system by specifying the mount paths in the `.env` file. These can be both absolute or relative @@ -58,10 +38,10 @@ end of the `Dockerfile` to the following: ``` ENTRYPOINT java \ --Xms"${XMS}G" \ --Xmx"${XMX:-$XMS}G" \ +-Xms"${XMS:-$XMX}G" \ +-Xmx"${XMX}G" \ -jar "$FORGE_JAR" \ ---universe /mc/worlds \ +--universe /app/worlds \ --nogui ``` diff --git a/minecraft/papermc/README.md b/minecraft/papermc/README.md index bfcbed7..ffa5e79 100644 --- a/minecraft/papermc/README.md +++ b/minecraft/papermc/README.md @@ -43,11 +43,11 @@ end of the `Dockerfile` to the following: ``` ENTRYPOINT java \ --Xms"${XMS}G" \ --Xmx"${XMX:-$XMS}G" \ --jar /app/server.jar \ ---universe /app/worlds \ ---nogui + -Xms"${XMS:-$XMX}G" \ + -Xmx"${XMX}G" \ + -jar /app/server.jar \ + --universe /app/worlds \ + --nogui ``` This will only use the flags absolutely necessary, while still allowing you to diff --git a/minecraft/papermc/entrypoint.sh b/minecraft/papermc/entrypoint.sh index 1876d54..e64d31e 100755 --- a/minecraft/papermc/entrypoint.sh +++ b/minecraft/papermc/entrypoint.sh @@ -9,7 +9,7 @@ echo "${MC_VERSION}, PaperMC v${PAPERMC_VERSION}" >> /app/config/versions.txt XMS="${XMS:-$XMX}" # Launch the actual server -java \ +exec java \ -Xms"${XMS}G" \ -Xmx"${XMX:-$XMS}G" \ -XX:+UseG1GC \