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 \