Merge pull request 'fix: preserve panel install directory' (#4) from pi-agent/pt-minecraft-modpack:fix/preserve-panel-install-dir into main

Reviewed-on: #4

README.md

@@ -1,10 +1,241 @@
-# PT's Basic Modpack
-
-一些最基础的功能的模组包，包括录制、光影、基本优化等。主打原版味道。
-
-## 使用
-
-分为服务端和客户端两部分。服务端会在不同时间，安装不同的娱乐性质的模组。客户端则会努力保持不变。
-
-使用 [packwiz](https://packwiz.infra.link) 进行模组包管理。
-
+# PT's Basic Modpack
+
+一些最基础的功能的模组包，包括录制、光影、基本优化等。主打原版味道。
+
+## 开发
+
+分为服务端和客户端两部分。服务端会在不同时间，安装不同的娱乐性质的模组。客户端则会努力保持不变。
+
+使用 [packwiz](https://packwiz.infra.link) 进行模组包管理。
+
+首先你要安装 packwiz。建议的是用 Golang 技术栈来直接安装：
+
+```bash
+go install github.com/packwiz/packwiz@latest
+```
+
+然后，进入对应的目录开始工作。例如要更改客户端相关：
+
+```bash
+cd client
+```
+
+### 添加模组
+
+```bash
+packwiz add https://modrinth.com/mod/create
+```
+
+### 构建 .mrpack 文件
+
+```bash
+packwiz modrinth export
+```
+
+## 服务端部署
+
+参见 [该文档](https://packwiz.infra.link/tutorials/installing/packwiz-installer/)。
+
+可以直接使用 Docker 来测试运行：
+
+```bash
+docker run --pull=always \
+    -e TYPE=FABRIC \
+    -e "PACKWIZ_URL=https://gitea.service.jazzwhom.top/Passthem/pt-minecraft-modpack/raw/branch/main/server-01-random-block/pack.toml" \
+    -e "EULA=TRUE" \
+    -e "VERSION=1.21.10" \
+    -p 25565:25565 \
+    itzg/minecraft-server
+```
+
+或者，需要从 [https://github.com/packwiz/packwiz-installer/releases](这里) 下载最新最热的 Installer，以安装需要的文件。
+
+## 面板服一键启动方案
+
+仓库根目录提供了：
+
+- `start.sh`：仓库内真正负责安装与启动服务端的主脚本
+- `panel-start.sh`：专门给面板服上传使用的薄入口脚本
+
+推荐你在面板服里这样用：
+
+1. 直接下载仓库里的 `panel-start.sh`
+2. 上传到面板
+3. 如果面板要求固定入口文件名是 `start.sh`，就把它重命名成 `start.sh`
+4. 按需要修改里面的变量
+5. 点击运行
+
+`start.sh` 现在**直接复用官方 `packwiz-installer-bootstrap` / `packwiz-installer`**，而不是自己手动管理模组列表。
+
+它会自动完成这些事情：
+
+1. 选择一个具体服务端 pack（例如 `server-01-random-block`）
+2. 读取该 pack 的 `pack.toml` 中的 Minecraft / Fabric 版本
+3. 下载并执行 Fabric 官方 installer，生成服务端启动 jar
+4. 下载并执行 `packwiz-installer-bootstrap`
+5. 用 `packwiz-installer --side server` 根据远程或本地 `pack.toml` 自动同步当前服务端需要的模组
+6. 自动写入 `eula.txt`
+7. 最后启动服务端
+
+## 方案一：上传整个仓库后直接运行
+
+如果你的面板允许你上传整个仓库，那么直接运行：
+
+```bash
+PT_SERVER="server-01-random-block" bash start.sh
+```
+
+因为这时 `start.sh` 会直接使用仓库里的本地 `server-01-random-block/pack.toml`。
+
+如果仓库里只有一个 `server-*` 目录，不传 `PT_SERVER` 也可以自动选择；但只要有多个，建议明确传。
+
+### 常用示例
+
+```bash
+PT_SERVER="server-01-random-block" PT_JAVA_ARGS="-Xms1G -Xmx1G" bash start.sh
+```
+
+```bash
+PT_SERVER="server-02-xxx" bash start.sh
+```
+
+## 方案二：只下载并上传 `panel-start.sh`
+
+如果你只想下载一个脚本文件再上传到面板，那么请直接使用：
+
+- 仓库文件：`panel-start.sh`
+
+你上传后：
+
+- 如果面板固定执行文件名就是 `start.sh`，请把 `panel-start.sh` 重命名为 `start.sh`
+- 然后编辑这几个变量：
+
+```sh
+REPO_URL="https://gitea.service.jazzwhom.top/Passthem/pt-minecraft-modpack"
+REPO_REF="main"
+PT_SERVER="server-01-random-block"
+PT_JAVA_ARGS="-Xms1G -Xmx1G"
+```
+
+`panel-start.sh` 默认会额外下载 `packwiz-installer.jar`，并通过本地文件方式交给 bootstrap 使用，适合 GitHub API 受限（例如 403）的面板环境。
+另外，它不会在每次启动时删除整个 `INSTALL_DIR`；如果目录已存在，只会覆盖仓库脚本与 pack 文件，尽量保留你已经配置好的文件。
+
+这个脚本会：
+
+1. 从 Gitea 下载整个仓库归档
+2. 解压到当前目录下的 `pt-minecraft-modpack/`
+3. 额外下载 `packwiz-installer.jar`
+4. 自动调用仓库里的 `start.sh`
+
+### 直接下载链接
+
+你可以直接下载这个文件：
+
+- `panel-start.sh`：
+  `https://gitea.service.jazzwhom.top/Passthem/pt-minecraft-modpack/raw/branch/main/panel-start.sh`
+
+## 方案三：直接复制 `panel-start.sh` 内容到面板里
+
+如果你的面板不能单独下载文件，但允许你粘贴脚本内容，也可以把下面这段直接保存成面板入口脚本：
+
+> 注意：请确保保存为 **LF 换行**，不要是 Windows 的 CRLF。
+
+```sh
+#!/bin/sh
+set -eu
+
+REPO_URL="https://gitea.service.jazzwhom.top/Passthem/pt-minecraft-modpack"
+REPO_REF="main"
+PT_SERVER="server-01-random-block"
+INSTALL_DIR="$(pwd)/pt-minecraft-modpack"
+ARCHIVE_PATH="$(pwd)/pt-minecraft-modpack.tar.gz"
+TMP_DIR="$(pwd)/pt-minecraft-modpack.__tmp"
+PT_JAVA_ARGS="-Xms1G -Xmx1G"
+
+rm -rf "$TMP_DIR"
+mkdir -p "$TMP_DIR"
+
+if command -v curl >/dev/null 2>&1; then
+  curl -fL --retry 3 --retry-delay 2 -o "$ARCHIVE_PATH" "$REPO_URL/archive/$REPO_REF.tar.gz"
+elif command -v wget >/dev/null 2>&1; then
+  wget -O "$ARCHIVE_PATH" "$REPO_URL/archive/$REPO_REF.tar.gz"
+else
+  echo "缺少 curl 或 wget" >&2
+  exit 1
+fi
+
+tar -xzf "$ARCHIVE_PATH" -C "$TMP_DIR"
+
+EXTRACTED_DIR="$(find "$TMP_DIR" -mindepth 1 -maxdepth 1 -type d | head -n 1)"
+if [ -z "$EXTRACTED_DIR" ]; then
+  echo "解压失败" >&2
+  exit 1
+fi
+
+rm -rf "$INSTALL_DIR"
+mv "$EXTRACTED_DIR" "$INSTALL_DIR"
+rm -rf "$TMP_DIR" "$ARCHIVE_PATH"
+
+cd "$INSTALL_DIR"
+PT_REPO_URL="$REPO_URL" \
+PT_REPO_REF="$REPO_REF" \
+PT_SERVER="$PT_SERVER" \
+PT_JAVA_ARGS="$PT_JAVA_ARGS" \
+bash ./start.sh
+```
+
+## 环境兼容性说明
+
+有些面板不是用 `bash start.sh`，而是直接用 `sh start.sh`。因此：
+
+- 面板入口脚本建议使用 `panel-start.sh` 这种 `sh` 兼容的薄脚本
+- 仓库内真正运行 Minecraft 的脚本继续使用 `bash`
+- 如果你是从 Windows 编辑/复制脚本，请务必使用 **LF** 换行，不要用 **CRLF**
+
+## 环境要求
+
+- 面板入口脚本需要：`sh`
+- 仓库主脚本 `start.sh` 需要：`bash`
+- 必须有 `java`
+- 必须有 `curl` 或 `wget`
+- 远程拉取方案还需要 `tar`
+- 建议有常见基础命令：`grep`、`sed`、`awk`、`find`
+- 服务器需要能联网下载：
+  - 你的 Gitea 仓库归档
+  - Fabric installer
+  - `packwiz-installer-bootstrap`
+  - Modrinth 模组文件
+
+## `start.sh` 可选环境变量
+
+- `PT_SERVER`：选择要安装/启动的服务端目录名，例如 `server-01-random-block`
+- `PT_REPO_URL`：仓库地址，例如 `https://gitea.service.jazzwhom.top/Passthem/pt-minecraft-modpack`
+- `PT_REPO_REF`：仓库分支或 tag，例如 `main`
+- `PT_PACK_URL`：如果你想完全手动指定远程 `pack.toml` 地址，也可以直接传这个
+- `PT_INSTALL_ROOT`：实际运行目录，默认是脚本所在目录
+- `PT_JAVA_ARGS`：Java 内存等参数，默认 `-Xms1G -Xmx1G`
+- `PT_AUTO_EULA`：默认 `TRUE`，自动写入 `eula=true`
+- `PT_FORCE_UPDATE=1`：强制重新下载 Fabric installer / bootstrap，并重新执行安装
+- `PT_SERVER_JAR`：手动指定启动的服务端 jar 路径
+- `PT_RUNTIME_DIR`：缓存下载内容与状态文件的目录，默认 `.pt-panel-runtime/`
+- `PT_PACKWIZ_BOOTSTRAP_NO_UPDATE=1`：禁用 bootstrap 自更新
+- `PT_PACKWIZ_BOOTSTRAP_MAIN_JAR`：手动指定本地 `packwiz-installer.jar` 路径（适合 GitHub API 受限环境）
+- `PT_FABRIC_INSTALLER_VERSION`：手动指定 Fabric installer 版本
+- `PT_PACKWIZ_BOOTSTRAP_URL`：手动指定 bootstrap 下载地址
+
+## 验证思路
+
+本脚本已按真实链路验证过以下关键步骤：
+
+```bash
+bash -n start.sh
+PT_DRY_RUN=1 PT_SERVER=server-01-random-block bash start.sh
+```
+
+并且另外在独立测试目录里实际完成了端到端验证：
+
+- `packwiz-installer-bootstrap` 可以直接读取该仓库的 `server-01-random-block/pack.toml`
+- `--side server` 会正确安装服务端所需模组
+- Fabric 官方 installer 能正确安装 `Minecraft 1.21.10 + Loader 0.18.5`
+- 使用 Java 21、`-Xms1G -Xmx1G` 成功启动服务器
+- 服务器日志已出现：`Done (...)! For help, type "help"`

client/config/flashback/flashback.json

@@ -2,15 +2,15 @@
   "configVersion": 2,
   "recordingControls": {
     "controlsLocation": "RIGHT",
-    "automaticallyStart": true,
+    "automaticallyStart": false,
     "automaticallyFinish": true,
     "showRecordingToasts": true,
-    "quicksave": true
+    "quicksave": false
   },
   "recording": {
     "markDimensionChanges": true,
     "recordHotbar": true,
-    "localPlayerUpdatesPerSecond": 120,
+    "localPlayerUpdatesPerSecond": 60,
     "recordVoiceChat": true
   },
   "exporting": {
@@ -98,4 +98,4 @@
     "stereoAudio": false
   },
   "forceDefaultExportSettings": {}
-}
+}

client/index.toml

@@ -2,7 +2,7 @@ hash-format = "sha256"
 
 [[files]]
 file = "config/flashback/flashback.json"
-hash = "e87d234ed112fe00988e2bb8e8b019dd3d6c7842c5680d468a21507c7343e6f1"
+hash = "2303330c04e7ac1b4070bf3bc181e6db2241c0679c9c6f2b4f887626a2e01398"
 
 [[files]]
 file = "config/minihud.json"

client/pack.toml

@@ -1,12 +1,12 @@
 name = "PT's Basic Modpack"
 author = "passthem"
-version = "1.0.0"
+version = "1.0.1"
 pack-format = "packwiz:1.1.0"
 
 [index]
 file = "index.toml"
 hash-format = "sha256"
-hash = "74c317c3afd3443572a4afcb86847d4ed43758d2c2d08c9c906c34fe8651de38"
+hash = "290e6849aa435a004b728046f75f93474d6cd501760ee7dd87d20ad30a9f9e55"
 
 [versions]
 fabric = "0.18.5"

justfile

@@ -1,5 +1,2 @@
 build-client:
     cd client && packwiz modrinth export
-
-serve:
-    cd server && packwiz serve

panel-start.sh

@@ -0,0 +1,83 @@
+#!/bin/sh
+set -eu
+
+# 面板入口脚本：适合“面板固定执行 start.sh，但只能上传文件/编辑文件”的环境。
+# 用法：
+# 1. 下载本文件
+# 2. 上传到面板，并按需要重命名为面板要求的固定入口名（通常就是 start.sh）
+# 3. 修改下面几个变量
+# 4. 点击运行
+
+REPO_URL="${REPO_URL:-https://gitea.service.jazzwhom.top/Passthem/pt-minecraft-modpack}"
+REPO_REF="${REPO_REF:-main}"
+PT_SERVER="${PT_SERVER:-server-01-random-block}"
+INSTALL_DIR="${INSTALL_DIR:-$(pwd)/pt-minecraft-modpack}"
+ARCHIVE_PATH="${ARCHIVE_PATH:-$(pwd)/pt-minecraft-modpack.tar.gz}"
+TMP_DIR="${TMP_DIR:-$(pwd)/pt-minecraft-modpack.__tmp}"
+PT_JAVA_ARGS="${PT_JAVA_ARGS:--Xms1G -Xmx1G}"
+PACKWIZ_INSTALLER_URL="${PACKWIZ_INSTALLER_URL:-https://github.com/packwiz/packwiz-installer/releases/latest/download/packwiz-installer.jar}"
+
+log() {
+  printf '[panel-entry] %s\n' "$*"
+}
+
+fail() {
+  printf '[panel-entry] ERROR: %s\n' "$*" >&2
+  exit 1
+}
+
+need_cmd() {
+  command -v "$1" >/dev/null 2>&1 || fail "缺少命令: $1"
+}
+
+need_cmd sh
+need_cmd tar
+need_cmd find
+
+rm -rf "$TMP_DIR"
+mkdir -p "$TMP_DIR"
+
+log "下载仓库归档: $REPO_URL ($REPO_REF)"
+if command -v curl >/dev/null 2>&1; then
+  curl -fL --retry 3 --retry-delay 2 -o "$ARCHIVE_PATH" "$REPO_URL/archive/$REPO_REF.tar.gz"
+elif command -v wget >/dev/null 2>&1; then
+  wget -O "$ARCHIVE_PATH" "$REPO_URL/archive/$REPO_REF.tar.gz"
+else
+  fail "缺少 curl 或 wget"
+fi
+
+log "解压仓库归档"
+tar -xzf "$ARCHIVE_PATH" -C "$TMP_DIR"
+
+EXTRACTED_DIR="$(find "$TMP_DIR" -mindepth 1 -maxdepth 1 -type d | head -n 1)"
+[ -n "$EXTRACTED_DIR" ] || fail "解压失败"
+
+if [ ! -d "$INSTALL_DIR" ]; then
+  mv "$EXTRACTED_DIR" "$INSTALL_DIR"
+else
+  log "保留现有安装目录，仅覆盖仓库文件"
+  cp -r "$EXTRACTED_DIR"/. "$INSTALL_DIR"/
+  rm -rf "$EXTRACTED_DIR"
+fi
+rm -rf "$TMP_DIR" "$ARCHIVE_PATH"
+
+cd "$INSTALL_DIR"
+mkdir -p .pt-panel-runtime/downloads
+
+log "下载 packwiz-installer"
+if command -v curl >/dev/null 2>&1; then
+  curl -fL --retry 3 --retry-delay 2 -o .pt-panel-runtime/downloads/packwiz-installer.jar "$PACKWIZ_INSTALLER_URL"
+elif command -v wget >/dev/null 2>&1; then
+  wget -O .pt-panel-runtime/downloads/packwiz-installer.jar "$PACKWIZ_INSTALLER_URL"
+else
+  fail "缺少 curl 或 wget"
+fi
+
+log "调用仓库内 start.sh"
+PT_REPO_URL="$REPO_URL" \
+PT_REPO_REF="$REPO_REF" \
+PT_SERVER="$PT_SERVER" \
+PT_JAVA_ARGS="$PT_JAVA_ARGS" \
+PT_PACKWIZ_BOOTSTRAP_NO_UPDATE="${PT_PACKWIZ_BOOTSTRAP_NO_UPDATE:-1}" \
+PT_PACKWIZ_BOOTSTRAP_MAIN_JAR="$(pwd)/.pt-panel-runtime/downloads/packwiz-installer.jar" \
+bash ./start.sh

start.sh

@@ -0,0 +1,304 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+
+SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+INSTALL_ROOT="${PT_INSTALL_ROOT:-$SCRIPT_DIR}"
+SERVER_NAME="${PT_SERVER:-${1:-}}"
+RUNTIME_BASE_DIR="${PT_RUNTIME_DIR:-$INSTALL_ROOT/.pt-panel-runtime}"
+DOWNLOAD_DIR="$RUNTIME_BASE_DIR/downloads"
+BOOTSTRAP_JAR="$DOWNLOAD_DIR/packwiz-installer-bootstrap.jar"
+PACKWIZ_META_FILE="packwiz-installer.json"
+
+JAVA_BIN="${JAVA_BIN:-java}"
+JAVA_ARGS="${PT_JAVA_ARGS:--Xms1G -Xmx1G}"
+SERVER_JAR_OVERRIDE="${PT_SERVER_JAR:-}"
+FORCE_UPDATE="${PT_FORCE_UPDATE:-0}"
+DRY_RUN="${PT_DRY_RUN:-0}"
+AUTO_EULA="${PT_AUTO_EULA:-TRUE}"
+PACKWIZ_BOOTSTRAP_NO_UPDATE="${PT_PACKWIZ_BOOTSTRAP_NO_UPDATE:-0}"
+FABRIC_INSTALLER_VERSION="${PT_FABRIC_INSTALLER_VERSION:-}"
+PACKWIZ_BOOTSTRAP_URL="${PT_PACKWIZ_BOOTSTRAP_URL:-https://github.com/packwiz/packwiz-installer-bootstrap/releases/latest/download/packwiz-installer-bootstrap.jar}"
+PACKWIZ_BOOTSTRAP_MAIN_JAR="${PT_PACKWIZ_BOOTSTRAP_MAIN_JAR:-}"
+
+PACK_DIR=""
+PACK_URL=""
+PACK_SLUG=""
+STAMP_FILE=""
+
+log() {
+  printf '[pt-panel] %s\n' "$*"
+}
+
+fail() {
+  printf '[pt-panel] ERROR: %s\n' "$*" >&2
+  exit 1
+}
+
+need_cmd() {
+  command -v "$1" >/dev/null 2>&1 || fail "缺少命令: $1"
+}
+
+fetch() {
+  local url="$1"
+  local dest="$2"
+
+  if command -v curl >/dev/null 2>&1; then
+    curl -fL --retry 3 --retry-delay 2 -o "$dest" "$url"
+  elif command -v wget >/dev/null 2>&1; then
+    wget -O "$dest" "$url"
+  else
+    fail "缺少 curl 或 wget，无法下载文件"
+  fi
+}
+
+fetch_to_stdout() {
+  local url="$1"
+
+  if command -v curl >/dev/null 2>&1; then
+    curl -fL --retry 3 --retry-delay 2 "$url"
+  elif command -v wget >/dev/null 2>&1; then
+    wget -O - "$url"
+  else
+    fail "缺少 curl 或 wget，无法下载文件"
+  fi
+}
+
+trim_quotes() {
+  local value="$1"
+  value="${value#\"}"
+  value="${value%\"}"
+  printf '%s' "$value"
+}
+
+toml_value() {
+  local key="$1"
+  local file="$2"
+  local line
+
+  line="$(grep -E "^${key}[[:space:]]*=" "$file" | head -n 1 || true)"
+  [ -n "$line" ] || return 1
+  line="${line#*=}"
+  line="${line#${line%%[![:space:]]*}}"
+  trim_quotes "$line"
+}
+
+list_available_servers() {
+  find "$SCRIPT_DIR" -mindepth 1 -maxdepth 1 -type d -name 'server-*' -exec basename {} \; | sort
+}
+
+select_server() {
+  local available count first
+
+  if [ -n "$SERVER_NAME" ]; then
+    PACK_DIR="$SCRIPT_DIR/$SERVER_NAME"
+    [ -f "$PACK_DIR/pack.toml" ] || fail "指定的服务端不存在: $SERVER_NAME"
+    return 0
+  fi
+
+  available="$(list_available_servers || true)"
+  count="$(printf '%s\n' "$available" | sed '/^$/d' | wc -l | awk '{print $1}')"
+
+  if [ "$count" = "1" ]; then
+    first="$(printf '%s\n' "$available" | sed -n '1p')"
+    SERVER_NAME="$first"
+    PACK_DIR="$SCRIPT_DIR/$SERVER_NAME"
+    return 0
+  fi
+
+  if [ "$count" = "0" ]; then
+    fail "仓库中没有找到任何 server-* 服务端目录"
+  fi
+
+  printf '[pt-panel] 可选服务端：\n%s\n' "$(printf '%s\n' "$available" | sed 's/^/  - /')" >&2
+  fail "检测到多个服务端，请通过 PT_SERVER=<目录名> 或第一个参数指定，例如：PT_SERVER=server-01-random-block bash start.sh"
+}
+
+ensure_dirs() {
+  mkdir -p "$INSTALL_ROOT" "$RUNTIME_BASE_DIR" "$DOWNLOAD_DIR"
+}
+
+prepare_server_paths() {
+  PACK_SLUG="$(printf '%s' "$SERVER_NAME" | tr '/' '_')"
+  STAMP_FILE="$RUNTIME_BASE_DIR/fabric-install-${PACK_SLUG}.stamp"
+}
+
+load_pack_versions() {
+  [ -f "$PACK_DIR/pack.toml" ] || fail "找不到 $PACK_DIR/pack.toml，请确认服务端 pack 存在"
+
+  MINECRAFT_VERSION="$(toml_value 'minecraft' "$PACK_DIR/pack.toml")"
+  FABRIC_LOADER_VERSION="$(toml_value 'fabric' "$PACK_DIR/pack.toml")"
+
+  [ -n "$MINECRAFT_VERSION" ] || fail "无法从 $PACK_DIR/pack.toml 读取 minecraft 版本"
+  [ -n "$FABRIC_LOADER_VERSION" ] || fail "无法从 $PACK_DIR/pack.toml 读取 fabric 版本"
+}
+
+compute_pack_url() {
+  if [ -n "${PT_PACK_URL:-}" ]; then
+    PACK_URL="$PT_PACK_URL"
+    return 0
+  fi
+
+  if [ -n "${PT_REPO_URL:-}" ] && [ -n "${PT_REPO_REF:-}" ]; then
+    PACK_URL="${PT_REPO_URL%/}/raw/branch/${PT_REPO_REF}/${SERVER_NAME}/pack.toml"
+    return 0
+  fi
+
+  PACK_URL="$PACK_DIR/pack.toml"
+}
+
+load_latest_fabric_installer_version() {
+  if [ -n "$FABRIC_INSTALLER_VERSION" ]; then
+    printf '%s' "$FABRIC_INSTALLER_VERSION"
+    return 0
+  fi
+
+  local meta version
+  meta="$(fetch_to_stdout 'https://meta.fabricmc.net/v2/versions/installer')"
+  version="$(printf '%s\n' "$meta" | grep '"version"' | head -n 1 | sed 's/.*"version": *"\([^"]*\)".*/\1/')"
+  [ -n "$version" ] || fail "无法获取最新 Fabric installer 版本"
+  printf '%s' "$version"
+}
+
+ensure_packwiz_bootstrap() {
+  if [ -f "$BOOTSTRAP_JAR" ] && [ "$FORCE_UPDATE" != "1" ]; then
+    return 0
+  fi
+
+  log "下载 packwiz-installer-bootstrap"
+  fetch "$PACKWIZ_BOOTSTRAP_URL" "$BOOTSTRAP_JAR"
+}
+
+install_fabric_server() {
+  local installer_version installer_jar wanted_stamp current_stamp
+
+  installer_version="$(load_latest_fabric_installer_version)"
+  installer_jar="$DOWNLOAD_DIR/fabric-installer-${installer_version}.jar"
+  wanted_stamp="server=$SERVER_NAME mc=$MINECRAFT_VERSION loader=$FABRIC_LOADER_VERSION installer=$installer_version"
+  current_stamp="$(cat "$STAMP_FILE" 2>/dev/null || true)"
+
+  if [ "$FORCE_UPDATE" != "1" ] && [ -f "$INSTALL_ROOT/fabric-server-launch.jar" ] && [ "$wanted_stamp" = "$current_stamp" ]; then
+    log "Fabric 服务端已就绪，跳过重复安装"
+    return 0
+  fi
+
+  log "准备安装 Fabric 服务端：$SERVER_NAME (Minecraft $MINECRAFT_VERSION / Loader $FABRIC_LOADER_VERSION)"
+  fetch "https://maven.fabricmc.net/net/fabricmc/fabric-installer/${installer_version}/fabric-installer-${installer_version}.jar" "$installer_jar"
+
+  if [ "$DRY_RUN" = "1" ]; then
+    log "DRY RUN: 跳过执行 Fabric installer"
+    return 0
+  fi
+
+  (
+    cd "$INSTALL_ROOT"
+    "$JAVA_BIN" -jar "$installer_jar" server -mcversion "$MINECRAFT_VERSION" -loader "$FABRIC_LOADER_VERSION" -downloadMinecraft
+  )
+  printf '%s\n' "$wanted_stamp" > "$STAMP_FILE"
+}
+
+run_packwiz_installer() {
+  local args=( -jar "$BOOTSTRAP_JAR" -g --side server --pack-folder "$INSTALL_ROOT" --meta-file "$PACKWIZ_META_FILE" "$PACK_URL" )
+
+  if [ -n "$PACKWIZ_BOOTSTRAP_MAIN_JAR" ] && [ "$PACKWIZ_BOOTSTRAP_NO_UPDATE" = "1" ]; then
+    args=( -jar "$BOOTSTRAP_JAR" --bootstrap-no-update --bootstrap-main-jar "$PACKWIZ_BOOTSTRAP_MAIN_JAR" -g --side server --pack-folder "$INSTALL_ROOT" --meta-file "$PACKWIZ_META_FILE" "$PACK_URL" )
+  elif [ -n "$PACKWIZ_BOOTSTRAP_MAIN_JAR" ]; then
+    args=( -jar "$BOOTSTRAP_JAR" --bootstrap-main-jar "$PACKWIZ_BOOTSTRAP_MAIN_JAR" -g --side server --pack-folder "$INSTALL_ROOT" --meta-file "$PACKWIZ_META_FILE" "$PACK_URL" )
+  elif [ "$PACKWIZ_BOOTSTRAP_NO_UPDATE" = "1" ]; then
+    args=( -jar "$BOOTSTRAP_JAR" --bootstrap-no-update -g --side server --pack-folder "$INSTALL_ROOT" --meta-file "$PACKWIZ_META_FILE" "$PACK_URL" )
+  fi
+
+  if [ "$DRY_RUN" = "1" ]; then
+    log "DRY RUN: 跳过执行 packwiz-installer"
+    log "pack.toml URL: $PACK_URL"
+    return 0
+  fi
+
+  log "使用 packwiz-installer 同步服务端模组"
+  (
+    cd "$INSTALL_ROOT"
+    "$JAVA_BIN" "${args[@]}"
+  )
+}
+
+write_eula() {
+  if [ "$AUTO_EULA" = "TRUE" ] || [ "$AUTO_EULA" = "true" ] || [ "$AUTO_EULA" = "1" ]; then
+    printf 'eula=true\n' > "$INSTALL_ROOT/eula.txt"
+    log "已写入 eula.txt"
+  else
+    log "已跳过自动写入 EULA（PT_AUTO_EULA=$AUTO_EULA）"
+  fi
+}
+
+find_server_jar() {
+  if [ -n "$SERVER_JAR_OVERRIDE" ]; then
+    printf '%s' "$SERVER_JAR_OVERRIDE"
+    return 0
+  fi
+
+  if [ -f "$INSTALL_ROOT/fabric-server-launch.jar" ]; then
+    printf '%s' "$INSTALL_ROOT/fabric-server-launch.jar"
+    return 0
+  fi
+
+  local candidate
+  candidate="$(find "$INSTALL_ROOT" -maxdepth 1 -type f \( -name 'fabric-server-launch.jar' -o -name 'fabric-server-*.jar' -o -name 'server.jar' \) | sort | head -n 1 || true)"
+  [ -n "$candidate" ] || return 1
+  printf '%s' "$candidate"
+}
+
+start_server() {
+  local server_jar
+  server_jar="$(find_server_jar || true)"
+
+  if [ "$DRY_RUN" = "1" ]; then
+    if [ -n "$server_jar" ]; then
+      log "使用服务端文件: $server_jar"
+    else
+      log "DRY RUN: 当前尚未生成服务端 jar；正式运行时会先执行 Fabric installer"
+    fi
+    log "安装目录: $INSTALL_ROOT"
+    log "启动参数: $JAVA_ARGS"
+    log "DRY RUN: 跳过实际启动"
+    return 0
+  fi
+
+  [ -n "$server_jar" ] || fail "找不到可启动的服务端 jar，请检查 Fabric 安装是否成功"
+
+  log "使用服务端: $SERVER_NAME"
+  log "使用服务端文件: $server_jar"
+  log "安装目录: $INSTALL_ROOT"
+  log "启动参数: $JAVA_ARGS"
+
+  cd "$INSTALL_ROOT"
+  exec "$JAVA_BIN" $JAVA_ARGS -jar "$server_jar" nogui
+}
+
+main() {
+  need_cmd "$JAVA_BIN"
+  need_cmd grep
+  need_cmd sed
+  need_cmd awk
+  need_cmd find
+
+  select_server
+  ensure_dirs
+  prepare_server_paths
+  load_pack_versions
+  compute_pack_url
+  ensure_packwiz_bootstrap
+
+  log "脚本目录: $SCRIPT_DIR"
+  log "安装目录: $INSTALL_ROOT"
+  log "选择服务端: $SERVER_NAME"
+  log "Pack 目录: $PACK_DIR"
+  log "Pack URL: $PACK_URL"
+  log "Minecraft 版本: $MINECRAFT_VERSION"
+  log "Fabric Loader 版本: $FABRIC_LOADER_VERSION"
+
+  install_fabric_server
+  run_packwiz_installer
+  write_eula
+  start_server
+}
+
+main "$@"