mirror of
https://github.com/itzg/docker-minecraft-server.git
synced 2026-02-18 15:36:22 +00:00
Compare commits
13 Commits
2021.12.0-
...
2021.7.0-j
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
42a5131b19 | ||
|
|
624f6a210f | ||
|
|
1c63cd18b7 | ||
|
|
6266a7e3cc | ||
|
|
871ecd4d9d | ||
|
|
c572c95161 | ||
|
|
f7b58fbbb1 | ||
|
|
eccfa444a9 | ||
|
|
e831d25706 | ||
|
|
12e931332b | ||
|
|
ceee9eddc9 | ||
|
|
60ba668743 | ||
|
|
fd1b15e01f |
7
.github/dependabot.yml
vendored
7
.github/dependabot.yml
vendored
@@ -1,7 +0,0 @@
|
|||||||
version: 2
|
|
||||||
updates:
|
|
||||||
# Maintain dependencies for GitHub Actions
|
|
||||||
- package-ecosystem: "github-actions"
|
|
||||||
directory: "/"
|
|
||||||
schedule:
|
|
||||||
interval: "weekly"
|
|
||||||
57
.github/workflows/build-multiarch.yml
vendored
57
.github/workflows/build-multiarch.yml
vendored
@@ -3,50 +3,56 @@ on:
|
|||||||
push:
|
push:
|
||||||
branches:
|
branches:
|
||||||
- multiarch
|
- multiarch
|
||||||
|
- java8-multiarch
|
||||||
- multiarch-latest
|
- multiarch-latest
|
||||||
- java15
|
- java15
|
||||||
- java16
|
- java15-openj9
|
||||||
- test/multiarch/*
|
- test/multiarch/*
|
||||||
tags:
|
tags:
|
||||||
- "[0-9]+.[0-9]+.[0-9]+-multiarch"
|
- "[0-9]+.[0-9]+.[0-9]+-multiarch"
|
||||||
- "[0-9]+.[0-9]+.[0-9]+-multiarch-latest"
|
- "[0-9]+.[0-9]+.[0-9]+-multiarch-latest"
|
||||||
- "[0-9]+.[0-9]+.[0-9]+-java15"
|
- "[0-9]+.[0-9]+.[0-9]+-java15"
|
||||||
- "[0-9]+.[0-9]+.[0-9]+-java16"
|
|
||||||
paths-ignore:
|
|
||||||
- "*.md"
|
|
||||||
- "docs/**"
|
|
||||||
- "examples/**"
|
|
||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
docker-buildx:
|
docker-buildx:
|
||||||
runs-on: ubuntu-20.04
|
runs-on: ubuntu-20.04
|
||||||
steps:
|
steps:
|
||||||
- name: Checkout
|
- name: Checkout
|
||||||
uses: actions/checkout@v2.3.4
|
uses: actions/checkout@v2.2.0
|
||||||
|
|
||||||
- name: Docker meta
|
- name: Prepare
|
||||||
id: meta
|
id: prep
|
||||||
uses: docker/metadata-action@v3
|
run: |
|
||||||
with:
|
DOCKER_IMAGE=itzg/minecraft-server
|
||||||
images: |
|
VERSION=edge
|
||||||
itzg/minecraft-server
|
if [[ $GITHUB_REF == refs/tags/* ]]; then
|
||||||
tags: |
|
VERSION=${GITHUB_REF#refs/tags/}
|
||||||
type=ref,event=branch
|
fi
|
||||||
type=ref,event=tag
|
if [[ $GITHUB_REF == refs/heads/* ]]; then
|
||||||
|
VERSION=${GITHUB_REF#refs/heads/}
|
||||||
|
if [[ $VERSION == master ]]; then
|
||||||
|
VERSION=latest
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
TAGS="${DOCKER_IMAGE}:${VERSION//\//-}"
|
||||||
|
echo ::set-output name=tags::${TAGS}
|
||||||
|
echo ::set-output name=cache_from::${TAGS}
|
||||||
|
echo ::set-output name=version::${VERSION//\//-}
|
||||||
|
echo ::set-output name=cache_version::${VERSION//\//-}
|
||||||
|
|
||||||
- name: Setup Docker Buildx
|
- name: Setup Docker Buildx
|
||||||
uses: docker/setup-buildx-action@v1
|
uses: docker/setup-buildx-action@v1
|
||||||
|
|
||||||
- name: Cache Docker layers
|
- name: Cache Docker layers
|
||||||
uses: actions/cache@v2.1.5
|
uses: actions/cache@v2
|
||||||
with:
|
with:
|
||||||
path: /tmp/.buildx-cache
|
path: /tmp/.buildx-cache
|
||||||
key: ${{ runner.os }}-buildx-${{ steps.meta.outputs.version }}-${{ github.sha }}
|
key: ${{ runner.os }}-buildx-${{ steps.prep.outputs.cache_version }}-${{ github.sha }}
|
||||||
restore-keys: |
|
restore-keys: |
|
||||||
${{ runner.os }}-buildx-${{ steps.meta.outputs.version }}-
|
${{ runner.os }}-buildx-${{ steps.prep.outputs.cache_version }}-
|
||||||
|
|
||||||
- name: Set up QEMU
|
- name: Set up QEMU
|
||||||
uses: docker/setup-qemu-action@v1.1.0
|
uses: docker/setup-qemu-action@v1
|
||||||
|
|
||||||
- name: Login to DockerHub
|
- name: Login to DockerHub
|
||||||
uses: docker/login-action@v1
|
uses: docker/login-action@v1
|
||||||
@@ -56,17 +62,22 @@ jobs:
|
|||||||
|
|
||||||
- name: Build and push
|
- name: Build and push
|
||||||
id: docker_build
|
id: docker_build
|
||||||
uses: docker/build-push-action@v2.4.0
|
uses: docker/build-push-action@v2
|
||||||
with:
|
with:
|
||||||
context: .
|
context: .
|
||||||
|
file: ./Dockerfile
|
||||||
platforms: linux/amd64,linux/arm/v7,linux/arm64
|
platforms: linux/amd64,linux/arm/v7,linux/arm64
|
||||||
push: ${{ github.event_name != 'pull_request' }}
|
push: ${{ github.event_name != 'pull_request' }}
|
||||||
tags: ${{ steps.meta.outputs.tags }}
|
tags: ${{ steps.prep.outputs.tags }}
|
||||||
# ensure latest base image is used
|
# ensure latest base image is used
|
||||||
pull: true
|
pull: true
|
||||||
cache-from: type=local,src=/tmp/.buildx-cache
|
cache-from: type=local,src=/tmp/.buildx-cache
|
||||||
cache-to: type=local,dest=/tmp/.buildx-cache
|
cache-to: type=local,dest=/tmp/.buildx-cache
|
||||||
labels: ${{ steps.meta.outputs.labels }}
|
labels: |
|
||||||
|
org.opencontainers.image.documentation=https://github.com/itzg/docker-minecraft-server
|
||||||
|
org.opencontainers.image.source=https://github.com/itzg/docker-minecraft-server
|
||||||
|
org.opencontainers.image.version=${{ steps.prep.outputs.version }}
|
||||||
|
org.opencontainers.image.revision=${{ github.sha }}
|
||||||
|
|
||||||
- name: Image digest
|
- name: Image digest
|
||||||
run: echo ${{ steps.docker_build.outputs.digest }}
|
run: echo ${{ steps.docker_build.outputs.digest }}
|
||||||
|
|||||||
20
.github/workflows/generate-toc.yml
vendored
20
.github/workflows/generate-toc.yml
vendored
@@ -1,20 +0,0 @@
|
|||||||
name: Generate README table of contents
|
|
||||||
on:
|
|
||||||
push:
|
|
||||||
branches:
|
|
||||||
- master
|
|
||||||
paths:
|
|
||||||
- README.md
|
|
||||||
jobs:
|
|
||||||
generate:
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
timeout-minutes: 5
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v2.3.4
|
|
||||||
- run: |
|
|
||||||
curl https://raw.githubusercontent.com/ekalinin/github-markdown-toc/master/gh-md-toc -o gh-md-toc
|
|
||||||
chmod a+x gh-md-toc
|
|
||||||
./gh-md-toc --insert --no-backup README.md
|
|
||||||
- uses: stefanzweifel/git-auto-commit-action@v4.11.0
|
|
||||||
with:
|
|
||||||
commit_message: Auto update markdown TOC
|
|
||||||
8
.github/workflows/main.yml
vendored
8
.github/workflows/main.yml
vendored
@@ -22,7 +22,7 @@ jobs:
|
|||||||
runs-on: ubuntu-20.04
|
runs-on: ubuntu-20.04
|
||||||
|
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v2.3.4
|
- uses: actions/checkout@v2
|
||||||
|
|
||||||
- name: Run tests
|
- name: Run tests
|
||||||
run: |
|
run: |
|
||||||
@@ -33,7 +33,7 @@ jobs:
|
|||||||
runs-on: ubuntu-20.04
|
runs-on: ubuntu-20.04
|
||||||
|
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v2.3.4
|
- uses: actions/checkout@v2
|
||||||
|
|
||||||
- name: Prepare
|
- name: Prepare
|
||||||
id: prep
|
id: prep
|
||||||
@@ -59,7 +59,7 @@ jobs:
|
|||||||
uses: docker/setup-buildx-action@v1
|
uses: docker/setup-buildx-action@v1
|
||||||
|
|
||||||
- name: Cache Docker layers
|
- name: Cache Docker layers
|
||||||
uses: actions/cache@v2.1.5
|
uses: actions/cache@v2
|
||||||
with:
|
with:
|
||||||
path: /tmp/.buildx-cache
|
path: /tmp/.buildx-cache
|
||||||
key: ${{ runner.os }}-buildx-${{ steps.prep.outputs.cache_version }}-${{ github.sha }}
|
key: ${{ runner.os }}-buildx-${{ steps.prep.outputs.cache_version }}-${{ github.sha }}
|
||||||
@@ -75,7 +75,7 @@ jobs:
|
|||||||
|
|
||||||
- name: Build and push
|
- name: Build and push
|
||||||
id: docker_build
|
id: docker_build
|
||||||
uses: docker/build-push-action@v2.4.0
|
uses: docker/build-push-action@v2
|
||||||
with:
|
with:
|
||||||
context: .
|
context: .
|
||||||
file: ./Dockerfile
|
file: ./Dockerfile
|
||||||
|
|||||||
2
.github/workflows/pr.yml
vendored
2
.github/workflows/pr.yml
vendored
@@ -9,7 +9,7 @@ jobs:
|
|||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
|
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v2.3.4
|
- uses: actions/checkout@v2
|
||||||
|
|
||||||
- name: Run tests
|
- name: Run tests
|
||||||
run: |
|
run: |
|
||||||
|
|||||||
3
.gitignore
vendored
3
.gitignore
vendored
@@ -1,4 +1,3 @@
|
|||||||
/data/
|
/data/
|
||||||
/.idea/
|
/.idea/
|
||||||
*.iml
|
*.iml
|
||||||
/gh-md-toc
|
|
||||||
@@ -1,10 +1,11 @@
|
|||||||
FROM adoptopenjdk:15-jre
|
FROM ubuntu:18.04
|
||||||
|
|
||||||
LABEL org.opencontainers.image.authors="Geoff Bourne <itzgeoff@gmail.com>"
|
LABEL org.opencontainers.image.authors="Geoff Bourne <itzgeoff@gmail.com>"
|
||||||
|
|
||||||
RUN apt-get update \
|
RUN apt-get update \
|
||||||
&& DEBIAN_FRONTEND=noninteractive \
|
&& DEBIAN_FRONTEND=noninteractive \
|
||||||
apt-get install -y \
|
apt-get install -y \
|
||||||
|
openjdk-8-jre-headless \
|
||||||
imagemagick \
|
imagemagick \
|
||||||
gosu \
|
gosu \
|
||||||
sudo \
|
sudo \
|
||||||
@@ -66,8 +67,6 @@ COPY server.properties /tmp/server.properties
|
|||||||
COPY log4j2.xml /tmp/log4j2.xml
|
COPY log4j2.xml /tmp/log4j2.xml
|
||||||
WORKDIR /data
|
WORKDIR /data
|
||||||
|
|
||||||
STOPSIGNAL SIGTERM
|
|
||||||
|
|
||||||
ENV UID=1000 GID=1000 \
|
ENV UID=1000 GID=1000 \
|
||||||
MEMORY="1G" \
|
MEMORY="1G" \
|
||||||
TYPE=VANILLA VERSION=LATEST \
|
TYPE=VANILLA VERSION=LATEST \
|
||||||
|
|||||||
374
README.md
374
README.md
@@ -38,115 +38,6 @@ With that you can easily view the logs, stop, or re-start the container:
|
|||||||
|
|
||||||
> Be sure to always include `-e EULA=TRUE` in your commands, as Mojang/Microsoft requires EULA acceptance.
|
> Be sure to always include `-e EULA=TRUE` in your commands, as Mojang/Microsoft requires EULA acceptance.
|
||||||
|
|
||||||
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) and the [`TYPE`](#server-types) can be configured to create many variations of desired Minecraft server.
|
|
||||||
|
|
||||||
**TABLE OF CONTENTS**
|
|
||||||
|
|
||||||
<!--ts-->
|
|
||||||
* [Looking for a Bedrock Dedicated Server](#looking-for-a-bedrock-dedicated-server)
|
|
||||||
* [Interacting with the server](#interacting-with-the-server)
|
|
||||||
* [Data Directory](#data-directory)
|
|
||||||
* [Attaching data directory to host filesystem](#attaching-data-directory-to-host-filesystem)
|
|
||||||
* [Converting anonymous /data volume to named volume](#converting-anonymous-data-volume-to-named-volume)
|
|
||||||
* [Versions](#versions)
|
|
||||||
* [Running Minecraft server on different Java version](#running-minecraft-server-on-different-java-version)
|
|
||||||
* [Deprecated Image Tags](#deprecated-image-tags)
|
|
||||||
* [Healthcheck](#healthcheck)
|
|
||||||
* [Deployment Templates and Examples](#deployment-templates-and-examples)
|
|
||||||
* [Helm Charts](#helm-charts)
|
|
||||||
* [Examples](#examples)
|
|
||||||
* [Amazon Web Services (AWS) Deployment](#amazon-web-services-aws-deployment)
|
|
||||||
* [Server types](#server-types)
|
|
||||||
* [Running a Forge Server](#running-a-forge-server)
|
|
||||||
* [Running a Bukkit/Spigot server](#running-a-bukkitspigot-server)
|
|
||||||
* [Running a Paper server](#running-a-paper-server)
|
|
||||||
* [Running a Tuinity server](#running-a-tuinity-server)
|
|
||||||
* [Running an Airplane server](#running-an-airplane-server)
|
|
||||||
* [Running a Purpur server](#running-a-purpur-server)
|
|
||||||
* [Running a Yatopia server](#running-a-yatopia-server)
|
|
||||||
* [Running a Magma server](#running-a-magma-server)
|
|
||||||
* [Running a Mohist server](#running-a-mohist-server)
|
|
||||||
* [Running a Catserver type server](#running-a-catserver-type-server)
|
|
||||||
* [Running an Canyon server](#running-an-canyon-server)
|
|
||||||
* [Running a SpongeVanilla server](#running-a-spongevanilla-server)
|
|
||||||
* [Running a Fabric Server](#running-a-fabric-server)
|
|
||||||
* [Running a server with a Feed the Beast modpack](#running-a-server-with-a-feed-the-beast-modpack)
|
|
||||||
* [Environment Variables:](#environment-variables)
|
|
||||||
* [Upgrading](#upgrading)
|
|
||||||
* [Example](#example)
|
|
||||||
* [Running a server with a CurseForge modpack](#running-a-server-with-a-curseforge-modpack)
|
|
||||||
* [Modpack data directory](#modpack-data-directory)
|
|
||||||
* [Buggy start scripts](#buggy-start-scripts)
|
|
||||||
* [Fixing "unable to launch forgemodloader"](#fixing-unable-to-launch-forgemodloader)
|
|
||||||
* [Optional plugins, mods, and config attach points](#optional-plugins-mods-and-config-attach-points)
|
|
||||||
* [Auto-downloading SpigotMC/Bukkit/PaperMC plugins](#auto-downloading-spigotmcbukkitpapermc-plugins)
|
|
||||||
* [Replacing variables inside configs](#replacing-variables-inside-configs)
|
|
||||||
* [Running with a custom server JAR](#running-with-a-custom-server-jar)
|
|
||||||
* [Force re-download of the server file](#force-re-download-of-the-server-file)
|
|
||||||
* [Using Docker Compose](#using-docker-compose)
|
|
||||||
* [Server configuration](#server-configuration)
|
|
||||||
* [Server name](#server-name)
|
|
||||||
* [Server port](#server-port)
|
|
||||||
* [Difficulty](#difficulty)
|
|
||||||
* [Whitelist Players](#whitelist-players)
|
|
||||||
* [Op/Administrator Players](#opadministrator-players)
|
|
||||||
* [Server icon](#server-icon)
|
|
||||||
* [Rcon](#rcon)
|
|
||||||
* [Query](#query)
|
|
||||||
* [Max players](#max-players)
|
|
||||||
* [Max world size](#max-world-size)
|
|
||||||
* [Allow Nether](#allow-nether)
|
|
||||||
* [Announce Player Achievements](#announce-player-achievements)
|
|
||||||
* [Enable Command Block](#enable-command-block)
|
|
||||||
* [Force Gamemode](#force-gamemode)
|
|
||||||
* [Generate Structures](#generate-structures)
|
|
||||||
* [Hardcore](#hardcore)
|
|
||||||
* [Snooper](#snooper)
|
|
||||||
* [Max Build Height](#max-build-height)
|
|
||||||
* [Max Tick Time](#max-tick-time)
|
|
||||||
* [Spawn Animals](#spawn-animals)
|
|
||||||
* [Spawn Monsters](#spawn-monsters)
|
|
||||||
* [Spawn NPCs](#spawn-npcs)
|
|
||||||
* [Set spawn protection](#set-spawn-protection)
|
|
||||||
* [View Distance](#view-distance)
|
|
||||||
* [Level Seed](#level-seed)
|
|
||||||
* [Game Mode](#game-mode)
|
|
||||||
* [Message of the Day](#message-of-the-day)
|
|
||||||
* [PVP Mode](#pvp-mode)
|
|
||||||
* [Level Type and Generator Settings](#level-type-and-generator-settings)
|
|
||||||
* [Custom Server Resource Pack](#custom-server-resource-pack)
|
|
||||||
* [World Save Name](#world-save-name)
|
|
||||||
* [Downloadable world](#downloadable-world)
|
|
||||||
* [Cloning world from a container path](#cloning-world-from-a-container-path)
|
|
||||||
* [Overwrite world on start](#overwrite-world-on-start)
|
|
||||||
* [Downloadable mod/plugin pack for Forge, Bukkit, and Spigot Servers](#downloadable-modplugin-pack-for-forge-bukkit-and-spigot-servers)
|
|
||||||
* [Remove old mods/plugins](#remove-old-modsplugins)
|
|
||||||
* [Online mode](#online-mode)
|
|
||||||
* [Allow flight](#allow-flight)
|
|
||||||
* [Other server property mappings](#other-server-property-mappings)
|
|
||||||
* [Miscellaneous Options](#miscellaneous-options)
|
|
||||||
* [Running as alternate user/group ID](#running-as-alternate-usergroup-id)
|
|
||||||
* [Memory Limit](#memory-limit)
|
|
||||||
* [JVM Options](#jvm-options)
|
|
||||||
* [Interactive and Color Console](#interactive-and-color-console)
|
|
||||||
* [OpenJ9 Specific Options](#openj9-specific-options)
|
|
||||||
* [Enabling rolling logs](#enabling-rolling-logs)
|
|
||||||
* [Timezone Configuration](#timezone-configuration)
|
|
||||||
* [Enable Remote JMX for Profiling](#enable-remote-jmx-for-profiling)
|
|
||||||
* [Enable Aikar's Flags](#enable-aikars-flags)
|
|
||||||
* [HTTP Proxy](#http-proxy)
|
|
||||||
* [Using "noconsole" option](#using-noconsole-option)
|
|
||||||
* [Explicitly disable GUI](#explicitly-disable-gui)
|
|
||||||
* [Stop Duration](#stop-duration)
|
|
||||||
* [Autopause](#autopause)
|
|
||||||
* [Description](#description)
|
|
||||||
* [Enabling Autopause](#enabling-autopause)
|
|
||||||
* [Running on RaspberryPi](#running-on-raspberrypi)
|
|
||||||
|
|
||||||
<!-- Added by: runner, at: Thu May 20 01:17:11 UTC 2021 -->
|
|
||||||
|
|
||||||
<!--te-->
|
|
||||||
|
|
||||||
## Looking for a Bedrock Dedicated Server
|
## Looking for a Bedrock Dedicated Server
|
||||||
|
|
||||||
For Minecraft clients running on consoles, mobile, or native Windows, you'll need to
|
For Minecraft clients running on consoles, mobile, or native Windows, you'll need to
|
||||||
@@ -210,7 +101,7 @@ When attached in this way you can stop the server, edit the configuration under
|
|||||||
With Docker Compose, setting up a host attached directory is even easier since relative paths can be configured. For example, with the following `docker-compose.yml` Docker will automatically create/attach the relative directory `minecraft-data` to the container.
|
With Docker Compose, setting up a host attached directory is even easier since relative paths can be configured. For example, with the following `docker-compose.yml` Docker will automatically create/attach the relative directory `minecraft-data` to the container.
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
version: "3.8"
|
version: "3"
|
||||||
|
|
||||||
services:
|
services:
|
||||||
mc:
|
mc:
|
||||||
@@ -268,8 +159,6 @@ the server jar remain in the `/data` directory. It is safe to remove those._
|
|||||||
|
|
||||||
## Running Minecraft server on different Java version
|
## Running Minecraft server on different Java version
|
||||||
|
|
||||||
> **NOTE** [as of snapshot 21W19A](https://www.minecraft.net/en-us/article/minecraft-snapshot-21w19a), Java 16 is now required. Please use `itzg/minecraft-server:java16` for that version and newer. Consideration of changing the `latest` will be made after 1.17 releases.
|
|
||||||
|
|
||||||
To use a different version of Java, please use a docker tag to run your Minecraft server.
|
To use a different version of Java, please use a docker tag to run your Minecraft server.
|
||||||
|
|
||||||
| Tag name | Java version | Linux | JVM Type | Architecture |
|
| Tag name | Java version | Linux | JVM Type | Architecture |
|
||||||
@@ -279,7 +168,6 @@ To use a different version of Java, please use a docker tag to run your Minecraf
|
|||||||
| java8-multiarch | 8 | Debian | Hotspot | amd64,arm64,armv7 |
|
| java8-multiarch | 8 | Debian | Hotspot | amd64,arm64,armv7 |
|
||||||
| java15 | 15 | Debian | Hotspot | amd64,arm64,armv7 |
|
| java15 | 15 | Debian | Hotspot | amd64,arm64,armv7 |
|
||||||
| java15-openj9 | 15 | Debian | OpenJ9 | amd64,arm64 |
|
| java15-openj9 | 15 | Debian | OpenJ9 | amd64,arm64 |
|
||||||
| java16 | 16 | Debian | Hotspot | amd64,arm64,armv7 |
|
|
||||||
| adopt11 | 11 | Alpine | Hotspot | amd64 |
|
| adopt11 | 11 | Alpine | Hotspot | amd64 |
|
||||||
| openj9 | 8 | Alpine | OpenJ9 | amd64 |
|
| openj9 | 8 | Alpine | OpenJ9 | amd64 |
|
||||||
| openj9-11 | 11 | Alpine | OpenJ9 | amd64 |
|
| openj9-11 | 11 | Alpine | OpenJ9 | amd64 |
|
||||||
@@ -324,9 +212,7 @@ Some orchestration systems, such as Portainer, don't allow for disabling the def
|
|||||||
|
|
||||||
### Helm Charts
|
### Helm Charts
|
||||||
|
|
||||||
- itzg Helm Chart:
|
- [stable/minecraft](https://hub.helm.sh/charts/stable/minecraft) ([chart source](https://github.com/helm/charts/tree/master/stable/minecraft))
|
||||||
- [GitHub repo](https://github.com/itzg/minecraft-server-charts)
|
|
||||||
- [Helm Chart repo](https://itzg.github.io/minecraft-server-charts/)
|
|
||||||
- [mcsh/server-deployment](https://github.com/mcserverhosting-net/charts)
|
- [mcsh/server-deployment](https://github.com/mcserverhosting-net/charts)
|
||||||
|
|
||||||
### Examples
|
### Examples
|
||||||
@@ -337,15 +223,13 @@ The [examples directory](https://github.com/itzg/docker-minecraft-server/tree/ma
|
|||||||
|
|
||||||
If you're looking for a simple way to deploy this to the Amazon Web Services Cloud, check out the [Minecraft Server Deployment (CloudFormation) repository](https://github.com/vatertime/minecraft-spot-pricing). This repository contains a CloudFormation template that will get you up and running in AWS in a matter of minutes. Optionally it uses Spot Pricing so the server is very cheap, and you can easily turn it off when not in use.
|
If you're looking for a simple way to deploy this to the Amazon Web Services Cloud, check out the [Minecraft Server Deployment (CloudFormation) repository](https://github.com/vatertime/minecraft-spot-pricing). This repository contains a CloudFormation template that will get you up and running in AWS in a matter of minutes. Optionally it uses Spot Pricing so the server is very cheap, and you can easily turn it off when not in use.
|
||||||
|
|
||||||
## Server types
|
## Running a Forge Server
|
||||||
|
|
||||||
### Running a Forge Server
|
|
||||||
|
|
||||||
Enable [Forge server](http://www.minecraftforge.net/wiki/) mode by adding a `-e TYPE=FORGE` to your command-line.
|
Enable [Forge server](http://www.minecraftforge.net/wiki/) mode by adding a `-e TYPE=FORGE` to your command-line.
|
||||||
|
|
||||||
The overall version is specified by `VERSION`, [as described in the section above](#versions) and will run the recommended Forge version by default. You can also choose to run a specific Forge version with `FORGEVERSION`, such as `-e FORGEVERSION=14.23.5.2854`.
|
The overall version is specified by `VERSION`, [as described in the section above](#versions) and will run the recommended Forge version by default. You can also choose to run a specific Forge version with `FORGEVERSION`, such as `-e FORGEVERSION=14.23.5.2854`.
|
||||||
|
|
||||||
docker run -d -v /path/on/host:/data \
|
$ docker run -d -v /path/on/host:/data \
|
||||||
-e TYPE=FORGE \
|
-e TYPE=FORGE \
|
||||||
-e VERSION=1.12.2 -e FORGEVERSION=14.23.5.2854 \
|
-e VERSION=1.12.2 -e FORGEVERSION=14.23.5.2854 \
|
||||||
-p 25565:25565 -e EULA=TRUE --name mc itzg/minecraft-server
|
-p 25565:25565 -e EULA=TRUE --name mc itzg/minecraft-server
|
||||||
@@ -353,18 +237,36 @@ The overall version is specified by `VERSION`, [as described in the section abov
|
|||||||
To use a pre-downloaded Forge installer, place it in the attached `/data` directory and
|
To use a pre-downloaded Forge installer, place it in the attached `/data` directory and
|
||||||
specify the name of the installer file with `FORGE_INSTALLER`, such as:
|
specify the name of the installer file with `FORGE_INSTALLER`, such as:
|
||||||
|
|
||||||
docker run -d -v /path/on/host:/data ... \
|
$ docker run -d -v /path/on/host:/data ... \
|
||||||
-e FORGE_INSTALLER=forge-1.11.2-13.20.0.2228-installer.jar ...
|
-e FORGE_INSTALLER=forge-1.11.2-13.20.0.2228-installer.jar ...
|
||||||
|
|
||||||
To download a Forge installer from a custom location, such as your own file repository, specify
|
To download a Forge installer from a custom location, such as your own file repository, specify
|
||||||
the URL with `FORGE_INSTALLER_URL`, such as:
|
the URL with `FORGE_INSTALLER_URL`, such as:
|
||||||
|
|
||||||
docker run -d -v /path/on/host:/data ... \
|
$ docker run -d -v /path/on/host:/data ... \
|
||||||
-e FORGE_INSTALLER_URL=http://HOST/forge-1.11.2-13.20.0.2228-installer.jar ...
|
-e FORGE_INSTALLER_URL=http://HOST/forge-1.11.2-13.20.0.2228-installer.jar ...
|
||||||
|
|
||||||
In both of the cases above, there is no need for the `VERSION` or `FORGEVERSION` variables.
|
In both of the cases above, there is no need for the `VERSION` or `FORGEVERSION` variables.
|
||||||
|
|
||||||
### Running a Bukkit/Spigot server
|
### Managing mods
|
||||||
|
|
||||||
|
In order to manage mods, you have two options:
|
||||||
|
|
||||||
|
1. [Attach a host directory to the /data path](#attaching-data-directory-to-host-filesystem) and manage the contents of the `mods` subdirectory
|
||||||
|
|
||||||
|
2. Using a mods-mount
|
||||||
|
|
||||||
|
If the container paths `/mods` and/or `/config` exist, such as by attaching a docker volume or host path, then any files in either of these directories will be copied over to the respective `/data` subdirectory before starting Minecraft.
|
||||||
|
|
||||||
|
If you want old mods to be removed as the `/mods` content is updated, then add `-e REMOVE_OLD_MODS=TRUE`. You can fine tune the removal process by specifying the `REMOVE_OLD_MODS_INCLUDE` and `REMOVE_OLD_MODS_EXCLUDE` variables. By default, everything will be removed. You can also specify the `REMOVE_OLD_MODS_DEPTH` (default is 16) variable to only delete files up to a certain level.
|
||||||
|
|
||||||
|
For example: `-e REMOVE_OLD_MODS=TRUE -e REMOVE_OLD_MODS_INCLUDE="*.jar" -e REMOVE_OLD_MODS_DEPTH=1` will remove all old jar files that are directly inside the `plugins/` or `mods/` directory.
|
||||||
|
|
||||||
|
You can specify the destination of the files that are copied from `/config` by setting the `COPY_CONFIG_DEST` variable, where the default is `/data/config`. For example, `-v ./config:/config -e COPY_CONFIG_DEST=/data` will allow you to copy over files like `bukkit.yml` and so on directly into the server directory.
|
||||||
|
|
||||||
|
> NOTE: If a file was updated in the destination path and is newer than the source file from `/config`, then it will not be overwritten.
|
||||||
|
|
||||||
|
## Running a Bukkit/Spigot server
|
||||||
|
|
||||||
Enable Bukkit/Spigot server mode by adding a `-e TYPE=BUKKIT` or `-e TYPE=SPIGOT` to your command-line.
|
Enable Bukkit/Spigot server mode by adding a `-e TYPE=BUKKIT` or `-e TYPE=SPIGOT` to your command-line.
|
||||||
|
|
||||||
@@ -385,7 +287,7 @@ Plugins can either be managed within the `plugins` subdirectory of the [data dir
|
|||||||
|
|
||||||
> NOTE some of the `VERSION` values are not as intuitive as you would think, so make sure to click into the version entry to find the **exact** version needed for the download. For example, "1.8" is not sufficient since their download naming expects `1.8-R0.1-SNAPSHOT-latest` exactly.
|
> NOTE some of the `VERSION` values are not as intuitive as you would think, so make sure to click into the version entry to find the **exact** version needed for the download. For example, "1.8" is not sufficient since their download naming expects `1.8-R0.1-SNAPSHOT-latest` exactly.
|
||||||
|
|
||||||
### Running a Paper server
|
## Running a Paper server
|
||||||
|
|
||||||
Enable Paper server mode by adding a `-e TYPE=PAPER` to your command-line.
|
Enable Paper server mode by adding a `-e TYPE=PAPER` to your command-line.
|
||||||
|
|
||||||
@@ -407,7 +309,7 @@ If you have attached a host directory to the `/data` volume, then you can instal
|
|||||||
|
|
||||||
[You can also auto-download plugins using `SPIGET_RESOURCES`.](#auto-downloading-spigotmcbukkitpapermc-plugins)
|
[You can also auto-download plugins using `SPIGET_RESOURCES`.](#auto-downloading-spigotmcbukkitpapermc-plugins)
|
||||||
|
|
||||||
### Running a Tuinity server
|
## Running a Tuinity server
|
||||||
|
|
||||||
A [Tuinity](https://github.com/Spottedleaf/Tuinity) server, which is a fork of Paper aimed at improving server performance at high playercounts.
|
A [Tuinity](https://github.com/Spottedleaf/Tuinity) server, which is a fork of Paper aimed at improving server performance at high playercounts.
|
||||||
|
|
||||||
@@ -415,23 +317,9 @@ A [Tuinity](https://github.com/Spottedleaf/Tuinity) server, which is a fork of P
|
|||||||
|
|
||||||
> **NOTE** only `VERSION=LATEST` is supported
|
> **NOTE** only `VERSION=LATEST` is supported
|
||||||
|
|
||||||
### Running an Airplane server
|
## Running a Purpur server
|
||||||
|
|
||||||
An [Airplane](https://github.com/TECHNOVE/Airplane) server, which is a fork of Tuinity aimed at further improving server performance at high playercounts.
|
A [Purpur](https://purpur.pl3x.net/) server, which is "a fork of Paper and Tuinity with the goal of providing new and interesting configuration options".
|
||||||
|
|
||||||
-e TYPE=AIRPLANE
|
|
||||||
|
|
||||||
> **NOTE** only `VERSION=LATEST` is supported
|
|
||||||
|
|
||||||
> **NOTE** only Java 8 and 11 are supported
|
|
||||||
|
|
||||||
Extra variables:
|
|
||||||
- `FORCE_REDOWNLOAD=false` : set to true to force the located server jar to be re-downloaded
|
|
||||||
- `USE_FLARE_FLAGS=false` : set to true to add appropriate flags for the [Flare](https://blog.airplane.gg/flare) profiler
|
|
||||||
|
|
||||||
### Running a Purpur server
|
|
||||||
|
|
||||||
A [Purpur](https://purpur.pl3x.net/) server, which is "a fork of Paper, Tuinity, Airplane with the goal of providing new and interesting configuration options".
|
|
||||||
|
|
||||||
-e TYPE=PURPUR
|
-e TYPE=PURPUR
|
||||||
|
|
||||||
@@ -440,9 +328,8 @@ A [Purpur](https://purpur.pl3x.net/) server, which is "a fork of Paper, Tuinity,
|
|||||||
Extra variables:
|
Extra variables:
|
||||||
- `PURPUR_BUILD=LATEST` : set a specific Purpur build to use
|
- `PURPUR_BUILD=LATEST` : set a specific Purpur build to use
|
||||||
- `FORCE_REDOWNLOAD=false` : set to true to force the located server jar to be re-downloaded
|
- `FORCE_REDOWNLOAD=false` : set to true to force the located server jar to be re-downloaded
|
||||||
- `USE_FLARE_FLAGS=false` : set to true to add appropriate flags for the [Flare](https://blog.airplane.gg/flare) profiler
|
|
||||||
|
|
||||||
### Running a Yatopia server
|
## Running a Yatopia server
|
||||||
|
|
||||||
A [Yatopia](https://github.com/YatopiaMC/Yatopia) server, which is a "blazing fast Tuinity fork with best in class performance".
|
A [Yatopia](https://github.com/YatopiaMC/Yatopia) server, which is a "blazing fast Tuinity fork with best in class performance".
|
||||||
|
|
||||||
@@ -453,9 +340,8 @@ A [Yatopia](https://github.com/YatopiaMC/Yatopia) server, which is a "blazing fa
|
|||||||
Extra variables:
|
Extra variables:
|
||||||
- `RELEASE=stable` : set to `stable` or `latest`
|
- `RELEASE=stable` : set to `stable` or `latest`
|
||||||
- `FORCE_REDOWNLOAD=false` : set to true to force the located server jar to be re-downloaded
|
- `FORCE_REDOWNLOAD=false` : set to true to force the located server jar to be re-downloaded
|
||||||
- `USE_FLARE_FLAGS=false` : set to true to add appropriate flags for the [Flare](https://blog.airplane.gg/flare) profiler
|
|
||||||
|
|
||||||
### Running a Magma server
|
## Running a Magma server
|
||||||
|
|
||||||
A [Magma](https://magmafoundation.org/) server, which is a combination of Forge and PaperMC, can be used with
|
A [Magma](https://magmafoundation.org/) server, which is a combination of Forge and PaperMC, can be used with
|
||||||
|
|
||||||
@@ -464,7 +350,7 @@ A [Magma](https://magmafoundation.org/) server, which is a combination of Forge
|
|||||||
> **NOTE** there are limited base versions supported, so you will also need to set `VERSION`, such as "1.12.2"
|
> **NOTE** there are limited base versions supported, so you will also need to set `VERSION`, such as "1.12.2"
|
||||||
|
|
||||||
|
|
||||||
### Running a Mohist server
|
## Running a Mohist server
|
||||||
|
|
||||||
A [Mohist](https://github.com/Mohist-Community/Mohist) server can be used with
|
A [Mohist](https://github.com/Mohist-Community/Mohist) server can be used with
|
||||||
|
|
||||||
@@ -476,7 +362,7 @@ By default the latest build will be used; however, a specific build number can b
|
|||||||
|
|
||||||
-e VERSION=1.16.5 -e MOHIST_BUILD=374
|
-e VERSION=1.16.5 -e MOHIST_BUILD=374
|
||||||
|
|
||||||
### Running a Catserver type server
|
## Running a Catserver type server
|
||||||
|
|
||||||
A [Catserver](http://catserver.moe/) type server can be used with
|
A [Catserver](http://catserver.moe/) type server can be used with
|
||||||
|
|
||||||
@@ -484,63 +370,6 @@ A [Catserver](http://catserver.moe/) type server can be used with
|
|||||||
|
|
||||||
> **NOTE** Catserver only provides a single release stream, so `VERSION` is ignored
|
> **NOTE** Catserver only provides a single release stream, so `VERSION` is ignored
|
||||||
|
|
||||||
### Running an Canyon server
|
|
||||||
|
|
||||||
[Canyon](https://github.com/canyonmodded/canyon) is a fork of CraftBukkit for Minecraft Beta 1.7.3. It includes multiple enhancements whilst also retaining compatibility with old Bukkit plugins and mods as much as possible.
|
|
||||||
|
|
||||||
-e VERSION=b1.7.3 -e TYPE=CANYON
|
|
||||||
|
|
||||||
> **NOTE** only `VERSION=b1.7.3` is supported
|
|
||||||
|
|
||||||
> **NOTE** only Java 8 is supported
|
|
||||||
|
|
||||||
By default the latest build will be used; however, a specific build number can be selected by setting `CANYON_BUILD`, such as
|
|
||||||
|
|
||||||
-e CANYON_BUILD=11
|
|
||||||
|
|
||||||
### Running a SpongeVanilla server
|
|
||||||
|
|
||||||
Enable SpongeVanilla server mode by adding a `-e TYPE=SPONGEVANILLA` to your command-line.
|
|
||||||
By default the container will run the latest `STABLE` version.
|
|
||||||
If you want to run a specific version, you can add `-e SPONGEVERSION=1.11.2-6.1.0-BETA-19` to your command-line.
|
|
||||||
|
|
||||||
docker run -d -v /path/on/host:/data -e TYPE=SPONGEVANILLA \
|
|
||||||
-p 25565:25565 -e EULA=TRUE --name mc itzg/minecraft-server
|
|
||||||
|
|
||||||
You can also choose to use the `EXPERIMENTAL` branch.
|
|
||||||
Just change it with `SPONGEBRANCH`, such as:
|
|
||||||
|
|
||||||
$ docker run -d -v /path/on/host:/data ... \
|
|
||||||
-e TYPE=SPONGEVANILLA -e SPONGEBRANCH=EXPERIMENTAL ...
|
|
||||||
|
|
||||||
### Running a Fabric Server
|
|
||||||
|
|
||||||
Enable [Fabric server](http://fabricmc.net/use/) mode by adding a `-e TYPE=FABRIC` to your command-line. By default, the container will run the latest version, but you can also choose to run a specific version with `VERSION`.
|
|
||||||
|
|
||||||
```
|
|
||||||
docker run -d -v /path/on/host:/data \
|
|
||||||
-e TYPE=FABRIC \
|
|
||||||
-p 25565:25565 -e EULA=TRUE --name mc itzg/minecraft-server
|
|
||||||
```
|
|
||||||
|
|
||||||
A specific installer version can be requested using `FABRIC_INSTALLER_VERSION`.
|
|
||||||
|
|
||||||
To use a pre-downloaded Fabric installer, place it in a directory attached into the container, such as the `/data` volume and specify the name of the installer file with `FABRIC_INSTALLER`, such as:
|
|
||||||
|
|
||||||
```
|
|
||||||
docker run -d -v /path/on/host:/data ... \
|
|
||||||
-e FABRIC_INSTALLER=fabric-installer-0.5.0.32.jar ...
|
|
||||||
```
|
|
||||||
|
|
||||||
To download a Fabric installer from a custom location, such as your own file repository, specify the URL with `FABRIC_INSTALLER_URL`, such as:
|
|
||||||
|
|
||||||
```
|
|
||||||
docker run -d -v /path/on/host:/data ... \
|
|
||||||
-e FABRIC_INSTALLER_URL=http://HOST/fabric-installer-0.5.0.32.jar ...
|
|
||||||
```
|
|
||||||
|
|
||||||
In order to add mods, you have two options:
|
|
||||||
|
|
||||||
## Running a server with a Feed the Beast modpack
|
## Running a server with a Feed the Beast modpack
|
||||||
|
|
||||||
> **NOTE** requires one of the Debian based images listed in [the Java versions section](#running-minecraft-server-on-different-java-version).
|
> **NOTE** requires one of the Debian based images listed in [the Java versions section](#running-minecraft-server-on-different-java-version).
|
||||||
@@ -612,28 +441,94 @@ then you apply a workaround by adding this to the run invocation:
|
|||||||
|
|
||||||
-e FTB_LEGACYJAVAFIXER=true
|
-e FTB_LEGACYJAVAFIXER=true
|
||||||
|
|
||||||
## Optional plugins, mods, and config attach points
|
## Running a SpongeVanilla server
|
||||||
|
|
||||||
There are optional volume paths that can be attached to supply content to be copied into the data area:
|
Enable SpongeVanilla server mode by adding a `-e TYPE=SPONGEVANILLA` to your command-line.
|
||||||
|
By default the container will run the latest `STABLE` version.
|
||||||
|
If you want to run a specific version, you can add `-e SPONGEVERSION=1.11.2-6.1.0-BETA-19` to your command-line.
|
||||||
|
|
||||||
`/plugins`
|
docker run -d -v /path/on/host:/data -e TYPE=SPONGEVANILLA \
|
||||||
: contents are copied into `/data/plugins` for Bukkit related server types. Set `PLUGINS_SYNC_UPDATE=false` if you want files from `/plugins` to take precedence over newer files in `/data/plugins`.
|
-p 25565:25565 -e EULA=TRUE --name mc itzg/minecraft-server
|
||||||
|
|
||||||
`/mods`
|
You can also choose to use the `EXPERIMENTAL` branch.
|
||||||
: contents are copied into `/data/mods` for Forge related server types
|
Just change it with `SPONGEBRANCH`, such as:
|
||||||
|
|
||||||
`/config`
|
$ docker run -d -v /path/on/host:/data ... \
|
||||||
: contents are copied into `/data/config` by default, but can be changed with `COPY_CONFIG_DEST`
|
-e TYPE=SPONGEVANILLA -e SPONGEBRANCH=EXPERIMENTAL ...
|
||||||
|
|
||||||
If you want old mods/plugins to be removed before the content is brought over from those attach points, then add `-e REMOVE_OLD_MODS=TRUE`. You can fine tune the removal process by specifying the `REMOVE_OLD_MODS_INCLUDE` and `REMOVE_OLD_MODS_EXCLUDE` variables. By default, everything will be removed. You can also specify the `REMOVE_OLD_MODS_DEPTH` (default is 16) variable to only delete files up to a certain level.
|
## Running a Fabric Server
|
||||||
|
|
||||||
For example: `-e REMOVE_OLD_MODS=TRUE -e REMOVE_OLD_MODS_INCLUDE="*.jar" -e REMOVE_OLD_MODS_DEPTH=1` will remove all old jar files that are directly inside the `plugins/` or `mods/` directory.
|
Enable [Fabric server](http://fabricmc.net/use/) mode by adding a `-e TYPE=FABRIC` to your command-line. By default, the container will run the latest version, but you can also choose to run a specific version with `VERSION`.
|
||||||
|
|
||||||
You can specify the destination of the files that are copied from `/mods` and `/config` by setting the `COPY_MODS_DEST` and `COPY_CONFIG_DEST`, where the default is `/data/mods` and `/data/config`. For example, `-v ./config:/config -e COPY_CONFIG_DEST=/data` will allow you to copy over files like `bukkit.yml` and so on directly into the server directory.
|
```
|
||||||
|
docker run -d -v /path/on/host:/data \
|
||||||
|
-e TYPE=FABRIC \
|
||||||
|
-p 25565:25565 -e EULA=TRUE --name mc itzg/minecraft-server
|
||||||
|
```
|
||||||
|
|
||||||
These paths work well if you want to have a common set of modules in a separate location, but still have multiple worlds with different server requirements in either persistent volumes or a downloadable archive.
|
A specific installer version can be requested using `FABRIC_INSTALLER_VERSION`.
|
||||||
|
|
||||||
> For more flexibility with mods/plugins preparation, you can declare directories to use in [the `MODS` variable](#downloadable-modplugin-pack-for-forge-bukkit-and-spigot-servers)
|
To use a pre-downloaded Fabric installer, place it in a directory attached into the container, such as the `/data` volume and specify the name of the installer file with `FABRIC_INSTALLER`, such as:
|
||||||
|
|
||||||
|
```
|
||||||
|
docker run -d -v /path/on/host:/data ... \
|
||||||
|
-e FABRIC_INSTALLER=fabric-installer-0.5.0.32.jar ...
|
||||||
|
```
|
||||||
|
|
||||||
|
To download a Fabric installer from a custom location, such as your own file repository, specify the URL with `FABRIC_INSTALLER_URL`, such as:
|
||||||
|
|
||||||
|
```
|
||||||
|
docker run -d -v /path/on/host:/data ... \
|
||||||
|
-e FABRIC_INSTALLER_URL=http://HOST/fabric-installer-0.5.0.32.jar ...
|
||||||
|
```
|
||||||
|
|
||||||
|
In order to add mods, you have two options:
|
||||||
|
|
||||||
|
### Using the /data volume
|
||||||
|
|
||||||
|
This is the easiest way if you are using a persistent `/data` mount.
|
||||||
|
|
||||||
|
To do this, you will need to attach the container's `/data` directory
|
||||||
|
(see "Attaching data directory to host filesystem”).
|
||||||
|
Then, you can add mods to the `/path/on/host/mods` folder you chose. From the example above,
|
||||||
|
the `/path/on/host` folder contents look like:
|
||||||
|
|
||||||
|
```
|
||||||
|
/path/on/host
|
||||||
|
├── mods
|
||||||
|
│ └── ... INSTALL MODS HERE ...
|
||||||
|
├── config
|
||||||
|
│ └── ... CONFIGURE MODS HERE ...
|
||||||
|
├── ops.json
|
||||||
|
├── server.properties
|
||||||
|
├── whitelist.json
|
||||||
|
└── ...
|
||||||
|
```
|
||||||
|
|
||||||
|
If you add mods while the container is running, you'll need to restart it to pick those
|
||||||
|
up:
|
||||||
|
|
||||||
|
docker stop mc
|
||||||
|
docker start mc
|
||||||
|
|
||||||
|
### Using separate mounts
|
||||||
|
|
||||||
|
This is the easiest way if you are using an ephemeral `/data` filesystem,
|
||||||
|
or downloading a world with the `WORLD` option.
|
||||||
|
|
||||||
|
There are two additional volumes that can be mounted; `/mods` and `/config`.
|
||||||
|
Any files in either of these filesystems will be copied over to the main
|
||||||
|
`/data` filesystem before starting Minecraft.
|
||||||
|
|
||||||
|
This works well if you want to have a common set of modules in a separate
|
||||||
|
location, but still have multiple worlds with different server requirements
|
||||||
|
in either persistent volumes or a downloadable archive.
|
||||||
|
|
||||||
|
## Deploying plugins from attached volume
|
||||||
|
|
||||||
|
If the `/plugins` directory exists in the container, such as from an attached volume, any files in this directory will be copied over to `/data/plugins` before starting Minecraft. Set `PLUGINS_SYNC_UPDATE=false` if you want files from `/plugins` to take precedence over newer files in `/data/plugins`.
|
||||||
|
|
||||||
|
This works well if you want to have a common set of plugins in a separate location, but still have multiple worlds with different server requirements in either persistent volumes or a downloadable archive.
|
||||||
|
|
||||||
## Auto-downloading SpigotMC/Bukkit/PaperMC plugins
|
## Auto-downloading SpigotMC/Bukkit/PaperMC plugins
|
||||||
|
|
||||||
@@ -705,7 +600,7 @@ database:
|
|||||||
This is how your `docker-compose.yml` file could look like:
|
This is how your `docker-compose.yml` file could look like:
|
||||||
|
|
||||||
```yml
|
```yml
|
||||||
version: "3.8"
|
version: "3"
|
||||||
# Other docker-compose examples in /examples
|
# Other docker-compose examples in /examples
|
||||||
|
|
||||||
services:
|
services:
|
||||||
@@ -780,9 +675,7 @@ every time you want to create new Minecraft server, you can now use
|
|||||||
[Docker Compose](https://docs.docker.com/compose/). Start with a
|
[Docker Compose](https://docs.docker.com/compose/). Start with a
|
||||||
`docker-compose.yml` file like the following:
|
`docker-compose.yml` file like the following:
|
||||||
|
|
||||||
```yml
|
```
|
||||||
version: "3.8"
|
|
||||||
|
|
||||||
minecraft-server:
|
minecraft-server:
|
||||||
image: itzg/minecraft-server
|
image: itzg/minecraft-server
|
||||||
|
|
||||||
@@ -1111,7 +1004,7 @@ The world will only be downloaded or copied if it doesn't exist already. Set `FO
|
|||||||
|
|
||||||
### Downloadable mod/plugin pack for Forge, Bukkit, and Spigot Servers
|
### Downloadable mod/plugin pack for Forge, Bukkit, and Spigot Servers
|
||||||
|
|
||||||
Like the `WORLD` option above, you can specify the URL or path of a "mod pack"
|
Like the `WORLD` option above, you can specify the URL of a "mod pack"
|
||||||
to download and install into `mods` for Forge or `plugins` for Bukkit/Spigot.
|
to download and install into `mods` for Forge or `plugins` for Bukkit/Spigot.
|
||||||
To use this option pass the environment variable `MODPACK`, such as
|
To use this option pass the environment variable `MODPACK`, such as
|
||||||
|
|
||||||
@@ -1121,12 +1014,10 @@ To use this option pass the environment variable `MODPACK`, such as
|
|||||||
top level of the zip archive. Make sure the jars are compatible with the
|
top level of the zip archive. Make sure the jars are compatible with the
|
||||||
particular `TYPE` of server you are running.
|
particular `TYPE` of server you are running.
|
||||||
|
|
||||||
You may also download or copy over individual mods using the `MODS` environment variable. `MODS` contains a comma-separated list of
|
You may also download individual mods using the `MODS` environment variable and supplying the URL
|
||||||
- URL of a jar file
|
to the jar files. Multiple mods/plugins should be comma separated.
|
||||||
- container path to a jar file
|
|
||||||
- container path to a directory containing jar files
|
|
||||||
|
|
||||||
docker run -d -e MODS=https://www.example.com/mods/mod1.jar,/plugins/common,/plugins/special/mod2.jar ...
|
docker run -d -e MODS=https://www.example.com/mods/mod1.jar,https://www.example.com/mods/mod2.jar ...
|
||||||
|
|
||||||
### Remove old mods/plugins
|
### Remove old mods/plugins
|
||||||
|
|
||||||
@@ -1206,35 +1097,6 @@ via a `JVM_XX_OPTS` environment variable.
|
|||||||
For some cases, if e.g. after removing mods, it could be necessary to startup minecraft with an additional `-D` parameter like `-Dfml.queryResult=confirm`. To address this you can use the environment variable `JVM_DD_OPTS`, which builds the params from a given list of values separated by space, but without the `-D` prefix. To make things running under systems (e.g. Plesk), which doesn't allow `=` inside values, a `:` (colon) could be used instead. The upper example would look like this:
|
For some cases, if e.g. after removing mods, it could be necessary to startup minecraft with an additional `-D` parameter like `-Dfml.queryResult=confirm`. To address this you can use the environment variable `JVM_DD_OPTS`, which builds the params from a given list of values separated by space, but without the `-D` prefix. To make things running under systems (e.g. Plesk), which doesn't allow `=` inside values, a `:` (colon) could be used instead. The upper example would look like this:
|
||||||
`JVM_DD_OPTS=fml.queryResult:confirm`, and will be converted to `-Dfml.queryResult=confirm`.
|
`JVM_DD_OPTS=fml.queryResult:confirm`, and will be converted to `-Dfml.queryResult=confirm`.
|
||||||
|
|
||||||
### Interactive and Color Console
|
|
||||||
|
|
||||||
If you would like to attach to the Minecraft server console with color and interactive capabilities, then add
|
|
||||||
|
|
||||||
```
|
|
||||||
-e EXEC_DIRECTLY=true
|
|
||||||
```
|
|
||||||
|
|
||||||
> **NOTE** this will bypass graceful server shutdown handling when using `docker stop`, so be sure to use `rcon-cli` or console commands to `stop` the server.
|
|
||||||
|
|
||||||
### 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
|
## Timezone Configuration
|
||||||
|
|
||||||
You can configure the timezone to match yours by setting the `TZ` environment variable:
|
You can configure the timezone to match yours by setting the `TZ` environment variable:
|
||||||
|
|||||||
@@ -9,7 +9,6 @@ branches_list=(
|
|||||||
'adopt11'
|
'adopt11'
|
||||||
'java15'
|
'java15'
|
||||||
'java15-openj9'
|
'java15-openj9'
|
||||||
'java16'
|
|
||||||
'multiarch'
|
'multiarch'
|
||||||
'multiarch-latest'
|
'multiarch-latest'
|
||||||
)
|
)
|
||||||
|
|||||||
Binary file not shown.
|
Before Width: | Height: | Size: 65 KiB |
@@ -1,4 +1,4 @@
|
|||||||
version: '3.8'
|
version: '3'
|
||||||
|
|
||||||
services:
|
services:
|
||||||
minecraft:
|
minecraft:
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
version: '3.8'
|
version: '3.2'
|
||||||
|
|
||||||
services:
|
services:
|
||||||
mc:
|
mc:
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
version: "3.8"
|
version: "3.7"
|
||||||
|
|
||||||
services:
|
services:
|
||||||
mc:
|
mc:
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
version: "3.8"
|
version: "3.7"
|
||||||
|
|
||||||
services:
|
services:
|
||||||
mc:
|
mc:
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
version: '3.8'
|
version: '3.7'
|
||||||
|
|
||||||
services:
|
services:
|
||||||
mc:
|
mc:
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
version: '3.8'
|
version: '3'
|
||||||
|
|
||||||
services:
|
services:
|
||||||
mc:
|
mc:
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
version: "3.8"
|
version: "3"
|
||||||
|
|
||||||
services:
|
services:
|
||||||
mc:
|
mc:
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
version: '3.8'
|
version: '3'
|
||||||
# Forge with Sponge API support. THIS REQUIRES DOWNLOADING SPONGEFORGE.
|
# Forge with Sponge API support. THIS REQUIRES DOWNLOADING SPONGEFORGE.
|
||||||
# Place the SpongeForge jar file in /data/mods. Other Forge mods go here as well.
|
# Place the SpongeForge jar file in /data/mods. Other Forge mods go here as well.
|
||||||
# Place Sponge mods in /data/mods/plugins. Yes, this is a directory inside the Forge mod directory. Do NOT use /data/plugins.
|
# Place Sponge mods in /data/mods/plugins. Yes, this is a directory inside the Forge mod directory. Do NOT use /data/plugins.
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
version: "3.8"
|
version: "3.7"
|
||||||
|
|
||||||
services:
|
services:
|
||||||
mc:
|
mc:
|
||||||
|
|||||||
2
start
2
start
@@ -5,7 +5,7 @@
|
|||||||
umask 0002
|
umask 0002
|
||||||
chmod g+w /data
|
chmod g+w /data
|
||||||
|
|
||||||
if ! isTrue "${SKIP_SUDO:-false}" && [ $(id -u) = 0 ]; then
|
if [ $(id -u) = 0 ]; then
|
||||||
runAsUser=minecraft
|
runAsUser=minecraft
|
||||||
runAsGroup=minecraft
|
runAsGroup=minecraft
|
||||||
|
|
||||||
|
|||||||
@@ -56,7 +56,7 @@ fi
|
|||||||
|
|
||||||
if ! which java > /dev/null; then
|
if ! which java > /dev/null; then
|
||||||
log "Fixing PATH to include java"
|
log "Fixing PATH to include java"
|
||||||
PATH="${PATH}:/opt/java/openjdk/bin"
|
PATH="${PATH}:/usr/bin"
|
||||||
fi
|
fi
|
||||||
|
|
||||||
export VERSIONS_JSON=https://launchermeta.mojang.com/mc/game/version_manifest.json
|
export VERSIONS_JSON=https://launchermeta.mojang.com/mc/game/version_manifest.json
|
||||||
@@ -98,12 +98,6 @@ case "${TYPE^^}" in
|
|||||||
;;
|
;;
|
||||||
|
|
||||||
FORGE)
|
FORGE)
|
||||||
log "**********************************************************************"
|
|
||||||
log "WARNING: The image tag itzg/minecraft-server:java8 is recommended"
|
|
||||||
log " since some mods require Java 8"
|
|
||||||
log " Exception traces reporting ClassCastException: class jdk.internal.loader.ClassLoaders\$AppClassLoader"
|
|
||||||
log " can be fixed with java8"
|
|
||||||
log "**********************************************************************"
|
|
||||||
exec ${SCRIPTS:-/}start-deployForge "$@"
|
exec ${SCRIPTS:-/}start-deployForge "$@"
|
||||||
;;
|
;;
|
||||||
|
|
||||||
@@ -115,13 +109,7 @@ case "${TYPE^^}" in
|
|||||||
exec ${SCRIPTS:-/}start-deployFTBA "$@"
|
exec ${SCRIPTS:-/}start-deployFTBA "$@"
|
||||||
;;
|
;;
|
||||||
|
|
||||||
FTB|CURSEFORGE)
|
CURSEFORGE|FTB)
|
||||||
log "**********************************************************************"
|
|
||||||
log "WARNING: The image tag itzg/minecraft-server:java8 is recommended"
|
|
||||||
log " since some mods require Java 8"
|
|
||||||
log " Exception traces reporting ClassCastException: class jdk.internal.loader.ClassLoaders\$AppClassLoader"
|
|
||||||
log " can be fixed with java8"
|
|
||||||
log "**********************************************************************"
|
|
||||||
exec ${SCRIPTS:-/}start-deployCF "$@"
|
exec ${SCRIPTS:-/}start-deployCF "$@"
|
||||||
;;
|
;;
|
||||||
|
|
||||||
@@ -161,19 +149,11 @@ case "${TYPE^^}" in
|
|||||||
exec ${SCRIPTS:-/}start-deployYatopia "$@"
|
exec ${SCRIPTS:-/}start-deployYatopia "$@"
|
||||||
;;
|
;;
|
||||||
|
|
||||||
AIRPLANE)
|
|
||||||
exec ${SCRIPTS:-/}start-deployAirplane "$@"
|
|
||||||
;;
|
|
||||||
|
|
||||||
CANYON)
|
|
||||||
exec ${SCRIPTS:-/}start-deployCanyon "$@"
|
|
||||||
;;
|
|
||||||
|
|
||||||
*)
|
*)
|
||||||
log "Invalid type: '$TYPE'"
|
log "Invalid type: '$TYPE'"
|
||||||
log "Must be: VANILLA, FORGE, BUKKIT, SPIGOT, PAPER, FTBA (multiarch-only),"
|
log "Must be: VANILLA, FORGE, BUKKIT, SPIGOT, PAPER, FTBA (multiarch-only),"
|
||||||
log " CURSE_INSTANCE, CURSEFORGE, SPONGEVANILLA, TUINITY, PURPUR"
|
log " CURSE_INSTANCE, CURSEFORGE, SPONGEVANILLA, TUINITY, PURPUR"
|
||||||
log " CUSTOM, MAGMA, MOHIST, CATSERVER, YATOPIA, AIRPLANE, CANYON"
|
log " CUSTOM, MAGMA, MOHIST, CATSERVER, YATOPIA"
|
||||||
exit 1
|
exit 1
|
||||||
;;
|
;;
|
||||||
|
|
||||||
|
|||||||
@@ -1,36 +0,0 @@
|
|||||||
#!/bin/bash
|
|
||||||
set -euo pipefail
|
|
||||||
IFS=$'\n\t'
|
|
||||||
|
|
||||||
. ${SCRIPTS:-/}start-utils
|
|
||||||
isDebugging && set -x
|
|
||||||
|
|
||||||
JAVA_VER=$(java -version 2>&1 | head -1 | cut -d'"' -f2 | sed '/^1\./s///' | cut -d'.' -f1)
|
|
||||||
|
|
||||||
if [ "${JAVA_VER}" != "8" ] && [ "${JAVA_VER}" != "11" ]; then
|
|
||||||
log "ERROR: Airplane server type only supports Java versions 8 and 11"
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
if [ "${VERSION}" != "LATEST" ]; then
|
|
||||||
log "ERROR: Airplane server type only supports VERSION=LATEST"
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
export SERVER=airplane-${VANILLA_VERSION}-jdk${JAVA_VER}.jar
|
|
||||||
|
|
||||||
if [ ! -f "$SERVER" ] || isTrue "$FORCE_REDOWNLOAD"; then
|
|
||||||
downloadUrl="https://dl.airplane.gg/latest/Airplane-JDK${JAVA_VER}/launcher-airplane.jar"
|
|
||||||
log "Downloading Airplane from $downloadUrl ..."
|
|
||||||
curl -fsSL -o "$SERVER" "$downloadUrl"
|
|
||||||
if [ ! -f "$SERVER" ]; then
|
|
||||||
log "ERROR: failed to download from $downloadUrl (status=$?)"
|
|
||||||
exit 3
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Normalize on Spigot for later operations
|
|
||||||
export TYPE=SPIGOT
|
|
||||||
export SKIP_LOG4J_CONFIG=true
|
|
||||||
|
|
||||||
exec ${SCRIPTS:-/}start-spiget "$@"
|
|
||||||
@@ -60,7 +60,7 @@ if ! isTrue ${USE_MODPACK_START_SCRIPT:-true}; then
|
|||||||
mkdir -p ${FTB_BASE_DIR}
|
mkdir -p ${FTB_BASE_DIR}
|
||||||
unzip -o "${FTB_SERVER_MOD}" -d ${FTB_BASE_DIR} | awk '{printf "."} END {print ""}'
|
unzip -o "${FTB_SERVER_MOD}" -d ${FTB_BASE_DIR} | awk '{printf "."} END {print ""}'
|
||||||
|
|
||||||
serverJar=$(find ${FTB_BASE_DIR} -type f \( -path "*/libraries/*" -o -path "*/mods/*" \) -prune -o -name "forge*.jar" -not -name "forge*installer.jar" -print)
|
serverJar=$(find ${FTB_BASE_DIR} -path "*/libraries/*" -prune -type f -o -not -name "forge*installer.jar" -name "forge*.jar")
|
||||||
if [[ -z "$serverJar" ]]; then
|
if [[ -z "$serverJar" ]]; then
|
||||||
|
|
||||||
if [ -f "${FTB_BASE_DIR}/settings.cfg" ]; then
|
if [ -f "${FTB_BASE_DIR}/settings.cfg" ]; then
|
||||||
@@ -91,7 +91,7 @@ if ! isTrue ${USE_MODPACK_START_SCRIPT:-true}; then
|
|||||||
echo "${FTB_SERVER_MOD}" > $installMarker
|
echo "${FTB_SERVER_MOD}" > $installMarker
|
||||||
fi
|
fi
|
||||||
|
|
||||||
export SERVER=$(find ${FTB_BASE_DIR} -type f \( -path "*/libraries/*" -o -path "*/mods/*" \) -prune -o -name "forge*.jar" -not -name "forge*installer.jar" -print)
|
export SERVER=$(find ${FTB_BASE_DIR} -path "*/libraries/*" -prune -type f -o -not -name "forge*installer.jar" -name "forge*.jar")
|
||||||
if [[ -z "${SERVER}" || ! -f "${SERVER}" ]]; then
|
if [[ -z "${SERVER}" || ! -f "${SERVER}" ]]; then
|
||||||
log "ERROR unable to locate installed forge server jar"
|
log "ERROR unable to locate installed forge server jar"
|
||||||
isDebugging && find ${FTB_BASE_DIR} -name "forge*.jar"
|
isDebugging && find ${FTB_BASE_DIR} -name "forge*.jar"
|
||||||
@@ -109,7 +109,6 @@ entryScriptExpr="
|
|||||||
-o -name ServerStartLinux.sh
|
-o -name ServerStartLinux.sh
|
||||||
-o -name LaunchServer.sh
|
-o -name LaunchServer.sh
|
||||||
-o -name server-start.sh
|
-o -name server-start.sh
|
||||||
-o -name start-server.sh
|
|
||||||
-o -name startserver.sh
|
-o -name startserver.sh
|
||||||
-o -name StartServer.sh
|
-o -name StartServer.sh
|
||||||
"
|
"
|
||||||
@@ -168,16 +167,6 @@ if [[ $startScriptCount = 0 ]]; then
|
|||||||
log "Unpacking FTB server modpack ${srv_modpack} ..."
|
log "Unpacking FTB server modpack ${srv_modpack} ..."
|
||||||
mkdir -p ${FTB_BASE_DIR}
|
mkdir -p ${FTB_BASE_DIR}
|
||||||
unzip -o "${srv_modpack}" -d ${FTB_BASE_DIR} | awk '{printf "."} END {print ""}'
|
unzip -o "${srv_modpack}" -d ${FTB_BASE_DIR} | awk '{printf "."} END {print ""}'
|
||||||
|
|
||||||
installScript=$(find "${FTB_BASE_DIR}" -maxdepth 2 -type f -name install.sh)
|
|
||||||
if [[ "$installScript" ]]; then
|
|
||||||
(
|
|
||||||
cd "$(dirname "${installScript}")"
|
|
||||||
chmod +x ./install.sh
|
|
||||||
log "Running included install.sh"
|
|
||||||
./install.sh
|
|
||||||
)
|
|
||||||
fi
|
|
||||||
fi
|
fi
|
||||||
|
|
||||||
if [[ $(find ${FTB_BASE_DIR} $entryScriptExpr | wc -l) = 0 ]]; then
|
if [[ $(find ${FTB_BASE_DIR} $entryScriptExpr | wc -l) = 0 ]]; then
|
||||||
|
|||||||
@@ -1,54 +0,0 @@
|
|||||||
#!/bin/bash
|
|
||||||
set -euo pipefail
|
|
||||||
IFS=$'\n\t'
|
|
||||||
|
|
||||||
. ${SCRIPTS:-/}start-utils
|
|
||||||
isDebugging && set -x
|
|
||||||
|
|
||||||
: ${CANYON_BUILD:=lastSuccessfulBuild}
|
|
||||||
JAVA_VER=$(java -version 2>&1 | head -1 | cut -d'"' -f2 | sed '/^1\./s///' | cut -d'.' -f1)
|
|
||||||
|
|
||||||
if [ "${JAVA_VER}" != "8" ]; then
|
|
||||||
log "ERROR: Canyon server type only supports Java version 8"
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
if [ "${VERSION}" != "b1.7.3" ]; then
|
|
||||||
log "ERROR: Canyon server type only supports VERSION=b1.7.3"
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
canyonJob="https://ci.velocitypowered.com/job/Canyon"
|
|
||||||
|
|
||||||
buildRelPath=$(
|
|
||||||
curl -fsSL "${canyonJob}/${CANYON_BUILD}/api/json" |
|
|
||||||
jq -r '.artifacts[0].relativePath'
|
|
||||||
)
|
|
||||||
buildNumber=$(
|
|
||||||
curl -fsSL "${canyonJob}/${CANYON_BUILD}/api/json" |
|
|
||||||
jq -r '.number'
|
|
||||||
)
|
|
||||||
baseName=$(basename "${buildRelPath}")
|
|
||||||
|
|
||||||
# Add build tag to non-tagged builds for version detection
|
|
||||||
if [ ${baseName%.*} = 'canyon-server' ]; then
|
|
||||||
export SERVER=${baseName%.*}_build${buildNumber}.jar
|
|
||||||
else
|
|
||||||
export SERVER="${baseName}"
|
|
||||||
fi
|
|
||||||
|
|
||||||
if [ ! -f "$SERVER" ]; then
|
|
||||||
downloadUrl="${canyonJob}/${CANYON_BUILD}/artifact/${buildRelPath}"
|
|
||||||
log "Downloading Canyon build ${buildNumber} from $downloadUrl ..."
|
|
||||||
curl -fsSL -o "$SERVER" "$downloadUrl"
|
|
||||||
if [ ! -f "$SERVER" ]; then
|
|
||||||
log "ERROR: failed to download from $downloadUrl (status=$?)"
|
|
||||||
exit 3
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Normalize on Spigot for later operations
|
|
||||||
export TYPE=SPIGOT
|
|
||||||
export SKIP_LOG4J_CONFIG=true
|
|
||||||
|
|
||||||
exec ${SCRIPTS:-/}start-spiget "$@"
|
|
||||||
@@ -34,4 +34,5 @@ fi
|
|||||||
export TYPE=SPIGOT
|
export TYPE=SPIGOT
|
||||||
export SKIP_LOG4J_CONFIG=true
|
export SKIP_LOG4J_CONFIG=true
|
||||||
|
|
||||||
exec ${SCRIPTS:-/}start-spiget "$@"
|
# Continue to Final Setup
|
||||||
|
exec ${SCRIPTS:-/}start-finalSetupWorld $@
|
||||||
|
|||||||
@@ -23,4 +23,5 @@ fi
|
|||||||
# Normalize on Spigot for later operations
|
# Normalize on Spigot for later operations
|
||||||
export TYPE=SPIGOT
|
export TYPE=SPIGOT
|
||||||
|
|
||||||
exec ${SCRIPTS:-/}start-spiget "$@"
|
# Continue to Final Setup
|
||||||
|
exec ${SCRIPTS:-/}start-finalSetupWorld $@
|
||||||
|
|||||||
@@ -42,7 +42,7 @@ if isTrue "${REPLACE_ENV_VARIABLES}"; then
|
|||||||
$dirExcludes \
|
$dirExcludes \
|
||||||
-type f \
|
-type f \
|
||||||
\( -name "*.yml" -or -name "*.yaml" -or -name "*.txt" -or -name "*.cfg" \
|
\( -name "*.yml" -or -name "*.yaml" -or -name "*.txt" -or -name "*.cfg" \
|
||||||
-or -name "*.conf" -or -name "*.properties" -or -name "*.hjson" -or -name "*.json" \) \
|
-or -name "*.conf" -or -name "*.properties" \) \
|
||||||
$fileExcludes \
|
$fileExcludes \
|
||||||
-exec sed -i 's#${'"$name"'}#'"$value"'#g' {} \;
|
-exec sed -i 's#${'"$name"'}#'"$value"'#g' {} \;
|
||||||
done
|
done
|
||||||
|
|||||||
@@ -11,9 +11,21 @@ fi
|
|||||||
CURSE_URL_BASE=${CURSE_URL_BASE:-https://minecraft.curseforge.com/projects}
|
CURSE_URL_BASE=${CURSE_URL_BASE:-https://minecraft.curseforge.com/projects}
|
||||||
|
|
||||||
# Remove old mods/plugins
|
# Remove old mods/plugins
|
||||||
if isTrue ${REMOVE_OLD_MODS:-false}; then
|
if isTrue ${REMOVE_OLD_MODS}; then
|
||||||
removeOldMods /data/mods
|
remove_mods_dest="/data/mods"
|
||||||
removeOldMods /data/plugins
|
case ${TYPE} in
|
||||||
|
SPIGOT|BUKKIT|PAPER)
|
||||||
|
remove_mods_dest="/data/plugins"
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
# only try to remove existing mods dir
|
||||||
|
if [ -d "$remove_mods_dest" ]; then
|
||||||
|
log "Removing old mods in $remove_mods_dest..."
|
||||||
|
find $remove_mods_dest -mindepth 1 -maxdepth ${REMOVE_OLD_MODS_DEPTH:-16} -wholename "${REMOVE_OLD_MODS_INCLUDE:-*}" -not -wholename "${REMOVE_OLD_MODS_EXCLUDE}" -delete
|
||||||
|
else
|
||||||
|
log "Directory $remove_mods_dest does not exist; removing nothing."
|
||||||
|
fi
|
||||||
fi
|
fi
|
||||||
|
|
||||||
# If supplied with a URL for a modpack (simple zip of jars), download it and unpack
|
# If supplied with a URL for a modpack (simple zip of jars), download it and unpack
|
||||||
@@ -25,39 +37,35 @@ if [[ "$MODPACK" ]]; then
|
|||||||
downloadUrl=$(curl -Ls -o /dev/null -w %{effective_url} $MODPACK)
|
downloadUrl=$(curl -Ls -o /dev/null -w %{effective_url} $MODPACK)
|
||||||
if ! [[ $downloadUrl == *.zip ]]; then
|
if ! [[ $downloadUrl == *.zip ]]; then
|
||||||
log "ERROR Invalid URL given for MODPACK: $downloadUrl resolved from $MODPACK"
|
log "ERROR Invalid URL given for MODPACK: $downloadUrl resolved from $MODPACK"
|
||||||
log " Must be HTTP, HTTPS or FTP and a ZIP file"
|
log " Must be HTTP or HTTPS and a ZIP file"
|
||||||
exit 1
|
exit 1
|
||||||
fi
|
fi
|
||||||
fi
|
fi
|
||||||
|
|
||||||
log "Downloading mod/plugin pack"
|
log "Downloading mod/plugin pack via HTTP"
|
||||||
log " from $downloadUrl ..."
|
log " from $downloadUrl ..."
|
||||||
if ! curl -sSL -o /tmp/modpack.zip "$downloadUrl"; then
|
if ! curl -sSL -o /tmp/modpack.zip "$downloadUrl"; then
|
||||||
log "ERROR: failed to download from $downloadUrl"
|
log "ERROR: failed to download from $downloadUrl"
|
||||||
exit 2
|
exit 2
|
||||||
fi
|
fi
|
||||||
elif [[ "$MODPACK" =~ .*\.zip ]]; then
|
|
||||||
if ! cp $MODPACK /tmp/modpack.zip; then
|
if [ "$TYPE" = "SPIGOT" ]; then
|
||||||
log "ERROR: failed to copy from $MODPACK"
|
mkdir -p /data/plugins
|
||||||
exit 2
|
if ! unzip -o -d /data/plugins /tmp/modpack.zip; then
|
||||||
|
log "ERROR: failed to unzip the modpack from $downloadUrl"
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
mkdir -p /data/mods
|
||||||
|
if ! unzip -o -d /data/mods /tmp/modpack.zip; then
|
||||||
|
log "ERROR: failed to unzip the modpack from $downloadUrl"
|
||||||
|
fi
|
||||||
fi
|
fi
|
||||||
|
rm -f /tmp/modpack.zip
|
||||||
|
|
||||||
else
|
else
|
||||||
log "ERROR Invalid URL or Path given for MODPACK: $MODPACK"
|
log "ERROR Invalid URL given for MODPACK: $MODPACK"
|
||||||
exit 1
|
exit 1
|
||||||
fi
|
fi
|
||||||
|
|
||||||
if [ "$TYPE" = "SPIGOT" ]; then
|
|
||||||
mkdir -p /data/plugins
|
|
||||||
if ! unzip -o -d /data/plugins /tmp/modpack.zip; then
|
|
||||||
log "ERROR: failed to unzip the modpack from $downloadUrl"
|
|
||||||
fi
|
|
||||||
else
|
|
||||||
mkdir -p /data/mods
|
|
||||||
if ! unzip -o -d /data/mods /tmp/modpack.zip; then
|
|
||||||
log "ERROR: failed to unzip the modpack from $downloadUrl"
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
rm -f /tmp/modpack.zip
|
|
||||||
fi
|
fi
|
||||||
|
|
||||||
# If supplied with a URL for a plugin download it.
|
# If supplied with a URL for a plugin download it.
|
||||||
@@ -91,18 +99,8 @@ if [[ "$MODS" ]]; then
|
|||||||
exit 2
|
exit 2
|
||||||
fi
|
fi
|
||||||
fi
|
fi
|
||||||
elif [[ -f "$i" && "$i" =~ .*\.jar ]]; then
|
|
||||||
log "Copying plugin located at $i ..."
|
|
||||||
out_file=$(basename "$i")
|
|
||||||
if ! cp "$i" "${out_dir}/$out_file"; then
|
|
||||||
log "ERROR: failed to copy from $i into $out_dir"
|
|
||||||
exit 2
|
|
||||||
fi
|
|
||||||
elif [[ -d "$i" ]]; then
|
|
||||||
log "Copying plugin jars from $i ..."
|
|
||||||
cp "$i"/*.jar "${out_dir}"
|
|
||||||
else
|
else
|
||||||
log "ERROR Invalid URL or path given in MODS: $i"
|
log "ERROR Invalid URL given in MODS: $i"
|
||||||
exit 2
|
exit 2
|
||||||
fi
|
fi
|
||||||
done
|
done
|
||||||
|
|||||||
@@ -21,12 +21,10 @@ if [ -d /plugins ]; then
|
|||||||
fi
|
fi
|
||||||
|
|
||||||
# If any modules have been provided, copy them over
|
# If any modules have been provided, copy them over
|
||||||
: ${COPY_MODS_DEST:="/data/mods"}
|
|
||||||
|
|
||||||
if [ -d /mods ]; then
|
if [ -d /mods ]; then
|
||||||
log "Copying any mods over..."
|
log "Copying any mods over..."
|
||||||
mkdir -p $COPY_MODS_DEST
|
mkdir -p /data/mods
|
||||||
rsync -a --out-format="update:%f:Last Modified %M" "${rsyncArgs[@]}" --prune-empty-dirs --update /mods/ $COPY_MODS_DEST
|
rsync -a --out-format="update:%f:Last Modified %M" "${rsyncArgs[@]}" --prune-empty-dirs --update /mods /data
|
||||||
fi
|
fi
|
||||||
|
|
||||||
: ${COPY_CONFIG_DEST:="/data/config"}
|
: ${COPY_CONFIG_DEST:="/data/config"}
|
||||||
|
|||||||
@@ -181,8 +181,8 @@ function customizeServerProps {
|
|||||||
}
|
}
|
||||||
|
|
||||||
# Deploy server.properties file
|
# Deploy server.properties file
|
||||||
if [[ ${TYPE} == "CURSEFORGE" ]]; then
|
if [[ ${TYPE} == "FEED-THE-BEAST" ]]; then
|
||||||
export SERVER_PROPERTIES="${FTB_DIR}/server.properties"
|
export SERVER_PROPERTIES=${FTB_DIR}/server.properties
|
||||||
log "detected FTB, changing properties path to ${SERVER_PROPERTIES}"
|
log "detected FTB, changing properties path to ${SERVER_PROPERTIES}"
|
||||||
fi
|
fi
|
||||||
|
|
||||||
@@ -214,7 +214,7 @@ fi
|
|||||||
|
|
||||||
if isDebugging; then
|
if isDebugging; then
|
||||||
log "DEBUG Dumping server.properties"
|
log "DEBUG Dumping server.properties"
|
||||||
cat "${SERVER_PROPERTIES}"
|
cat /data/server.properties
|
||||||
fi
|
fi
|
||||||
|
|
||||||
exec ${SCRIPTS:-/}start-finalSetupEnvVariables $@
|
exec ${SCRIPTS:-/}start-finalSetupEnvVariables $@
|
||||||
|
|||||||
@@ -7,7 +7,7 @@ isDebugging && set -x
|
|||||||
: ${LEVEL:=world}
|
: ${LEVEL:=world}
|
||||||
export LEVEL
|
export LEVEL
|
||||||
|
|
||||||
if [ $TYPE = "CURSEFORGE" ]; then
|
if [ $TYPE = "FEED-THE-BEAST" ]; then
|
||||||
worldDest=$FTB_DIR/$LEVEL
|
worldDest=$FTB_DIR/$LEVEL
|
||||||
else
|
else
|
||||||
worldDest=/data/$LEVEL
|
worldDest=/data/$LEVEL
|
||||||
|
|||||||
@@ -38,16 +38,16 @@ if [ -n "$ICON" ]; then
|
|||||||
fi
|
fi
|
||||||
fi
|
fi
|
||||||
|
|
||||||
if isTrue ${ENABLE_ROLLING_LOGS:-false}; then
|
if ! isTrue ${SKIP_LOG4J_CONFIG}; then
|
||||||
# Set up log configuration
|
# Set up log configuration
|
||||||
LOGFILE="/data/log4j2.xml"
|
LOGFILE="/data/log4j2.xml"
|
||||||
if [ ! -e "$LOGFILE" ]; then
|
if [ ! -e "$LOGFILE" ]; then
|
||||||
log "Creating log4j2.xml in ${LOGFILE}"
|
log "Creating log4j2.xml in ${LOGFILE}"
|
||||||
cp /tmp/log4j2.xml "$LOGFILE"
|
cp /tmp/log4j2.xml "$LOGFILE"
|
||||||
else
|
else
|
||||||
log "log4j2.xml already created, skipping"
|
log "log4j2.xml already created, skipping"
|
||||||
fi
|
fi
|
||||||
JVM_OPTS="-Dlog4j.configurationFile=/data/log4j2.xml ${JVM_OPTS}"
|
JVM_OPTS="-Dlog4j.configurationFile=/data/log4j2.xml ${JVM_OPTS}"
|
||||||
fi
|
fi
|
||||||
|
|
||||||
# Make sure files exist and are valid JSON (for pre-1.12 to 1.12 upgrades)
|
# Make sure files exist and are valid JSON (for pre-1.12 to 1.12 upgrades)
|
||||||
@@ -144,13 +144,6 @@ if isTrue "${USE_LARGE_PAGES}"; then
|
|||||||
"
|
"
|
||||||
fi
|
fi
|
||||||
|
|
||||||
if isTrue "${USE_FLARE_FLAGS}"; then
|
|
||||||
JVM_XX_OPTS="${JVM_XX_OPTS}
|
|
||||||
-XX:+UnlockDiagnosticVMOptions
|
|
||||||
-XX:+DebugNonSafepoints
|
|
||||||
"
|
|
||||||
fi
|
|
||||||
|
|
||||||
if isTrue "${DEBUG_MEMORY}"; then
|
if isTrue "${DEBUG_MEMORY}"; then
|
||||||
log "Memory usage and availability (in MB)"
|
log "Memory usage and availability (in MB)"
|
||||||
uname -a
|
uname -a
|
||||||
@@ -207,19 +200,10 @@ EOF
|
|||||||
|
|
||||||
cd "${FTB_DIR}"
|
cd "${FTB_DIR}"
|
||||||
log "Running FTB ${FTB_SERVER_START} in ${FTB_DIR} ..."
|
log "Running FTB ${FTB_SERVER_START} in ${FTB_DIR} ..."
|
||||||
|
|
||||||
finalArgs=(
|
|
||||||
"${FTB_SERVER_START}"
|
|
||||||
)
|
|
||||||
|
|
||||||
if isTrue ${DEBUG_EXEC}; then
|
if isTrue ${DEBUG_EXEC}; then
|
||||||
set -x
|
set -x
|
||||||
fi
|
fi
|
||||||
if isTrue ${EXEC_DIRECTLY:-false}; then
|
exec mc-server-runner ${mcServerRunnerArgs} "${FTB_SERVER_START}"
|
||||||
"${finalArgs[@]}"
|
|
||||||
else
|
|
||||||
exec mc-server-runner ${mcServerRunnerArgs} "${finalArgs[@]}"
|
|
||||||
fi
|
|
||||||
else
|
else
|
||||||
# If we have a bootstrap.txt file... feed that in to the server stdin
|
# If we have a bootstrap.txt file... feed that in to the server stdin
|
||||||
if [ -f /data/bootstrap.txt ]; then
|
if [ -f /data/bootstrap.txt ]; then
|
||||||
@@ -227,22 +211,8 @@ else
|
|||||||
fi
|
fi
|
||||||
|
|
||||||
log "Starting the Minecraft server..."
|
log "Starting the Minecraft server..."
|
||||||
|
|
||||||
finalArgs=(
|
|
||||||
$JVM_XX_OPTS
|
|
||||||
$JVM_OPTS
|
|
||||||
$expandedDOpts
|
|
||||||
-jar $SERVER
|
|
||||||
"$@" $EXTRA_ARGS
|
|
||||||
)
|
|
||||||
|
|
||||||
if isTrue ${DEBUG_EXEC}; then
|
if isTrue ${DEBUG_EXEC}; then
|
||||||
set -x
|
set -x
|
||||||
fi
|
fi
|
||||||
|
exec mc-server-runner ${bootstrapArgs} ${mcServerRunnerArgs} java $JVM_XX_OPTS $JVM_OPTS $expandedDOpts -jar $SERVER "$@" $EXTRA_ARGS
|
||||||
if isTrue ${EXEC_DIRECTLY:-false}; then
|
|
||||||
exec java "${finalArgs[@]}"
|
|
||||||
else
|
|
||||||
exec mc-server-runner ${bootstrapArgs} ${mcServerRunnerArgs} java "${finalArgs[@]}"
|
|
||||||
fi
|
|
||||||
fi
|
fi
|
||||||
|
|||||||
12
start-spiget
12
start-spiget
@@ -16,7 +16,7 @@ containsJars() {
|
|||||||
if [[ $line =~ $pat ]]; then
|
if [[ $line =~ $pat ]]; then
|
||||||
return 0
|
return 0
|
||||||
fi
|
fi
|
||||||
done <<<$(unzip -l "$file")
|
done <<< $(unzip -l "$file")
|
||||||
|
|
||||||
return 1
|
return 1
|
||||||
}
|
}
|
||||||
@@ -46,14 +46,10 @@ getResourceFromSpiget() {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if [[ ${SPIGET_RESOURCES} ]]; then
|
if [[ ${SPIGET_RESOURCES} ]]; then
|
||||||
if isTrue ${REMOVE_OLD_MODS:-false}; then
|
|
||||||
removeOldMods /data/plugins
|
|
||||||
REMOVE_OLD_MODS=false
|
|
||||||
fi
|
|
||||||
|
|
||||||
log "Getting plugins via Spiget"
|
log "Getting plugins via Spiget"
|
||||||
IFS=',' read -r -a resources <<<"${SPIGET_RESOURCES}"
|
IFS=',' read -r -a resources <<< "${SPIGET_RESOURCES}"
|
||||||
for resource in "${resources[@]}"; do
|
for resource in "${resources[@]}"
|
||||||
|
do
|
||||||
getResourceFromSpiget "${resource}"
|
getResourceFromSpiget "${resource}"
|
||||||
done
|
done
|
||||||
fi
|
fi
|
||||||
|
|||||||
@@ -11,7 +11,7 @@ function join_by() {
|
|||||||
function isURL() {
|
function isURL() {
|
||||||
local value=$1
|
local value=$1
|
||||||
|
|
||||||
if [[ ${value:0:8} == "https://" || ${value:0:7} == "http://" || ${value:0:6} == "ftp://" ]]; then
|
if [[ ${value:0:8} == "https://" || ${value:0:7} == "http://" ]]; then
|
||||||
return 0
|
return 0
|
||||||
else
|
else
|
||||||
return 1
|
return 1
|
||||||
@@ -174,9 +174,3 @@ eula=${EULA,,}
|
|||||||
exit 2
|
exit 2
|
||||||
fi
|
fi
|
||||||
}
|
}
|
||||||
|
|
||||||
function removeOldMods {
|
|
||||||
if [ -d "$1" ]; then
|
|
||||||
find "$1" -mindepth 1 -maxdepth ${REMOVE_OLD_MODS_DEPTH:-16} -wholename "${REMOVE_OLD_MODS_INCLUDE:-*}" -not -wholename "${REMOVE_OLD_MODS_EXCLUDE:-}" -delete
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|||||||
Reference in New Issue
Block a user