#!/usr/bin/env bash # Downloads (if missing) and runs a Paper server via the Fill v3 API. # Server settings come from the project .env file. # # Env vars: # JAVA_OPTS Extra JVM args (default: -Xms2G -Xmx2G) set -euo pipefail TOOLS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" PROJECT_ROOT="$(cd "$TOOLS_DIR/.." && pwd)" if [[ ! -r "$PROJECT_ROOT/.env" ]]; then echo "Error: $PROJECT_ROOT/.env is missing or unreadable. Copy .env.example to .env and set its values." >&2 exit 1 fi load_project_env() { local env_line env_key env_value first_char last_char while IFS= read -r env_line || [[ -n "$env_line" ]]; do env_line="${env_line%$'\r'}" [[ "$env_line" =~ ^[[:space:]]*(#|$) ]] && continue [[ "$env_line" == *=* ]] || continue env_key="${env_line%%=*}" env_value="${env_line#*=}" env_key="${env_key#"${env_key%%[![:space:]]*}"}" env_key="${env_key%"${env_key##*[![:space:]]}"}" [[ "$env_key" =~ ^[A-Za-z_][A-Za-z0-9_]*$ ]] || continue env_value="${env_value#"${env_value%%[![:space:]]*}"}" env_value="${env_value%"${env_value##*[![:space:]]}"}" if (( ${#env_value} >= 2 )); then first_char="${env_value:0:1}" last_char="${env_value:$((${#env_value} - 1)):1}" if [[ "$first_char" == "$last_char" && ( "$first_char" == '"' || "$first_char" == "'" ) ]]; then env_value="${env_value:1:$((${#env_value} - 2))}" fi fi if [[ -z "${!env_key:-}" ]]; then export "$env_key=$env_value" fi done < "$PROJECT_ROOT/.env" } load_project_env PAPER_VERSION="${PAPER_VERSION:-}" PAPER_BUILD="${PAPER_BUILD:-}" MINECRAFT_SERVER_JAR="${MINECRAFT_SERVER_JAR:-}" MINECRAFT_SERVER_PATH="${MINECRAFT_SERVER_PATH:-MCServer}" MINECRAFT_SERVER_PATH="${MINECRAFT_SERVER_PATH/#\~/$HOME}" [[ "$MINECRAFT_SERVER_PATH" == /* ]] || MINECRAFT_SERVER_PATH="$PROJECT_ROOT/$MINECRAFT_SERVER_PATH" [[ -n "$PAPER_VERSION" ]] || { echo "Error: PAPER_VERSION is not set (see .env)." >&2; exit 1; } PAPER_PROJECT="paper" JAVA_OPTS="${JAVA_OPTS:--Xms2G -Xmx2G}" FILL_API="https://fill.papermc.io/v3/projects/${PAPER_PROJECT}/versions/${PAPER_VERSION}" # Fill requires a non-generic User-Agent with contact info. USER_AGENT="${PAPER_USER_AGENT:-majinnaibu-plugin-dev/1.0 (https://github.com/majinnaibu)}" for cmd in curl jq java shasum; do command -v "$cmd" >/dev/null || { echo "Error: '$cmd' is required." >&2; exit 1; } done api_get() { curl -fsSL -H "User-Agent: $USER_AGENT" "$1" } mkdir -p "$MINECRAFT_SERVER_PATH" cd "$MINECRAFT_SERVER_PATH" JAR_BUILD="${MINECRAFT_SERVER_JAR:-}" JAR_BUILD="${JAR_BUILD#paper-"$PAPER_VERSION"-}"; JAR_BUILD="${JAR_BUILD%.jar}" if [[ -z "$PAPER_BUILD" && "$JAR_BUILD" =~ ^[0-9]+$ ]]; then PAPER_BUILD="$JAR_BUILD" fi if [[ -z "$PAPER_BUILD" ]]; then echo "Resolving latest stable build for Paper $PAPER_VERSION..." PAPER_BUILD=$(api_get "$FILL_API/builds" \ | jq -r 'map(select(.channel == "STABLE")) | max_by(.id) | .id // empty') || true if [[ -z "$PAPER_BUILD" ]]; then # Offline or no stable build: fall back to the newest local jar for this version. for f in paper-"$PAPER_VERSION"-*.jar; do b="${f#paper-"$PAPER_VERSION"-}"; b="${b%.jar}" [[ "$b" =~ ^[0-9]+$ ]] && (( b > ${PAPER_BUILD:-0} )) && PAPER_BUILD="$b" done [[ -n "$PAPER_BUILD" ]] || { echo "Error: no stable build found for $PAPER_VERSION." >&2; exit 1; } echo "Could not resolve from API; using local build $PAPER_BUILD." fi fi EXPECTED_JAR="paper-${PAPER_VERSION}-${PAPER_BUILD}.jar" if [[ -n "${MINECRAFT_SERVER_JAR:-}" && "$MINECRAFT_SERVER_JAR" != "$EXPECTED_JAR" ]]; then echo "Error: MINECRAFT_SERVER_JAR=$MINECRAFT_SERVER_JAR does not match PAPER_VERSION/PAPER_BUILD ($EXPECTED_JAR)." >&2 exit 1 fi MINECRAFT_SERVER_JAR="$EXPECTED_JAR" if [[ ! -f "$MINECRAFT_SERVER_JAR" ]]; then echo "Downloading $MINECRAFT_SERVER_JAR..." BUILD_JSON=$(api_get "$FILL_API/builds/$PAPER_BUILD") DOWNLOAD_URL=$(jq -r '.downloads."server:default".url // empty' <<<"$BUILD_JSON") EXPECTED_SHA=$(jq -r '.downloads."server:default".checksums.sha256 // empty' <<<"$BUILD_JSON") [[ -n "$DOWNLOAD_URL" ]] || { echo "Error: no download for $PAPER_VERSION build $PAPER_BUILD." >&2; exit 1; } TMP_JAR="$MINECRAFT_SERVER_JAR.part" trap 'rm -f "$TMP_JAR"' EXIT curl -fL --progress-bar -H "User-Agent: $USER_AGENT" -o "$TMP_JAR" "$DOWNLOAD_URL" ACTUAL_SHA=$(shasum -a 256 "$TMP_JAR" | awk '{print $1}') if [[ -n "$EXPECTED_SHA" && "$ACTUAL_SHA" != "$EXPECTED_SHA" ]]; then echo "Error: checksum mismatch (expected $EXPECTED_SHA, got $ACTUAL_SHA)." >&2 exit 1 fi mv "$TMP_JAR" "$MINECRAFT_SERVER_JAR" trap - EXIT fi export MINECRAFT_SERVER_PATH MINECRAFT_SERVER_JAR "$TOOLS_DIR/stop-server.sh" if ! grep -qs '^eula=true' eula.txt; then echo "Note: accept the EULA by setting eula=true in $MINECRAFT_SERVER_PATH/eula.txt (server will exit until then)." fi echo "Starting $MINECRAFT_SERVER_JAR in $MINECRAFT_SERVER_PATH..." # shellcheck disable=SC2086 exec java $JAVA_OPTS -jar "$MINECRAFT_SERVER_JAR" --nogui