2026-03-26 13:13:23 +08:00
2 changed files with 514 additions and 52 deletions
--- a/README.md
+++ b/README.md
@ -54,16 +54,17 @@ docker run --pull=always \

 仓库根目录提供了 `start.sh`，适合“只能上传文件、编辑文件，然后点一个固定 shell 脚本启动”的面板服环境。

+这个脚本现在**直接复用官方 `packwiz-installer-bootstrap` / `packwiz-installer`**，而不是自己手动管理模组列表。
+
 它会自动完成这些事情：

 1. 选择一个具体服务端 pack（例如 `server-01-random-block`）
 2. 读取该 pack 的 `pack.toml` 中的 Minecraft / Fabric 版本
 3. 下载并执行 Fabric 官方 installer，生成服务端启动 jar
-4. 读取对应 `mods/*.pw.toml`
-5. 自动下载当前服务端需要的模组到运行目录 `mods/`
-6. 自动删除上一个服务端残留、但当前服务端不再需要的旧模组
-7. 自动写入 `eula.txt`
-8. 最后启动服务端
+4. 下载并执行 `packwiz-installer-bootstrap`
+5. 用 `packwiz-installer --side server` 根据远程 `pack.toml` 自动同步当前服务端需要的模组
+6. 自动写入 `eula.txt`
+7. 最后启动服务端

 这意味着以后仓库里新增更多目录，例如：

@ -75,22 +76,35 @@ docker run --pull=always \

 ## 方案一：你把整个仓库上传到面板服

-上传后，让面板执行：
+上传后，最简单的执行方式就是：

 ```bash
-PT_SERVER=server-01-random-block bash start.sh
+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="-Xms2G -Xmx4G" bash start.sh
+PT_SERVER="server-01-random-block" PT_JAVA_ARGS="-Xms1G -Xmx1G" bash start.sh
 ```

 ```bash
-PT_SERVER=server-02-xxx bash start.sh
+PT_SERVER="server-02-xxx" bash start.sh
+```
+
+### 什么时候需要 `PT_REPO_URL / PT_REPO_REF`
+
+如果你希望 `packwiz-installer` 始终以远程仓库中的 `pack.toml` 为准，而不是当前本地文件，也可以额外传：
+
+```bash
+PT_REPO_URL="https://gitea.service.jazzwhom.top/Passthem/pt-minecraft-modpack" \
+PT_REPO_REF="main" \
+PT_SERVER="server-01-random-block" \
+bash start.sh
 ```

 ## 方案二：面板服里只粘贴一个“远程拉取并运行”的脚本
@ -105,6 +119,7 @@ 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"
+PT_JAVA_ARGS="-Xms1G -Xmx1G"

 if command -v curl >/dev/null 2>&1; then
  DOWNLOAD() { curl -fL --retry 3 --retry-delay 2 -o "$1" "$2"; }
@ -131,7 +146,11 @@ mv "$EXTRACTED_DIR" "$INSTALL_DIR"
 rm -rf "$TMP_DIR" "$ARCHIVE_PATH"

 cd "$INSTALL_DIR"
-PT_SERVER="$PT_SERVER" bash start.sh
+PT_REPO_URL="$REPO_URL" \
+PT_REPO_REF="$REPO_REF" \
+PT_SERVER="$PT_SERVER" \
+PT_JAVA_ARGS="$PT_JAVA_ARGS" \
+bash start.sh
 ```

 ### 这个远程脚本怎么改
@ -141,6 +160,7 @@ PT_SERVER="$PT_SERVER" bash start.sh
 - `REPO_REF`：默认 `main`，也可以改成某个分支或 tag
 - `PT_SERVER`：你这次要开的服务端目录名
 - `INSTALL_DIR`：解压后的安装目录
+- `PT_JAVA_ARGS`：JVM 参数

 例如切换到另一个服务端：

@ -158,27 +178,38 @@ PT_SERVER="server-02-xxx"
 - 服务器需要能联网下载：
  - 你的 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 -Xmx2G`
+- `PT_JAVA_ARGS`：Java 内存等参数，默认 `-Xms1G -Xmx1G`
 - `PT_AUTO_EULA`：默认 `TRUE`，自动写入 `eula=true`
- `PT_FORCE_UPDATE=1`：强制重新安装 Fabric / 重新下载模组
+- `PT_FORCE_UPDATE=1`：强制重新下载 Fabric installer / bootstrap，并重新执行安装
 - `PT_SERVER_JAR`：手动指定启动的服务端 jar 路径
- `PT_MODS_DIR`：手动指定模组目录，默认运行目录下的 `mods/`
 - `PT_RUNTIME_DIR`：缓存下载内容与状态文件的目录，默认 `.pt-panel-runtime/`
- `PT_SKIP_HASH_CHECK=1`：跳过模组 hash 校验（不建议）
+- `PT_PACKWIZ_BOOTSTRAP_NO_UPDATE=1`：禁用 bootstrap 自更新
+- `PT_FABRIC_INSTALLER_VERSION`：手动指定 Fabric installer 版本
+- `PT_PACKWIZ_BOOTSTRAP_URL`：手动指定 bootstrap 下载地址

 ## 验证思路

-本脚本在本地已做过：
+本脚本已按真实链路验证过以下关键步骤：

 ```bash
 bash -n start.sh
-PT_DRY_RUN=1 JAVA_BIN=true PT_SERVER=server-01-random-block bash start.sh
+PT_DRY_RUN=1 PT_SERVER=server-01-random-block bash start.sh
 ```

-当前 agent 环境里没有 `java`，所以这里只做了 dry-run 验证；真实运行依赖目标面板服具备 Java 与联网下载能力。
+并且另外在独立测试目录里实际完成了端到端验证：
+
+- `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"`
--- a/start.sh
+++ b/start.sh
@ -6,19 +6,23 @@ 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 -Xmx2G}"
+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}"
-SKIP_HASH_CHECK="${PT_SKIP_HASH_CHECK:-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}"

 PACK_DIR=""
-MODS_DIR=""
+PACK_URL=""
+PACK_SLUG=""
 STAMP_FILE=""
-MOD_STATE_FILE=""

 log() {
  printf '[pt-panel] %s\n' "$*"
@ -77,32 +81,6 @@ toml_value() {
  trim_quotes "$line"
 }

-hash_cmd_for() {
-  case "$1" in
-    sha512) echo sha512sum ;;
-    sha256) echo sha256sum ;;
-    sha1) echo sha1sum ;;
-    md5) echo md5sum ;;
-    *) return 1 ;;
-  esac
-}
-
-verify_hash() {
-  local file="$1"
-  local expected="$2"
-  local format="$3"
-  local cmd actual
-
-  [ "$SKIP_HASH_CHECK" = "1" ] && return 0
-
-  cmd="$(hash_cmd_for "$format" || true)"
-  [ -n "$cmd" ] || return 0
-  command -v "$cmd" >/dev/null 2>&1 || return 0
-
-  actual="$($cmd "$file" | awk '{print $1}')"
-  [ "$actual" = "$expected" ]
-}
-
 list_available_servers() {
  find "$SCRIPT_DIR" -mindepth 1 -maxdepth 1 -type d -name 'server-*' -exec basename {} \; | sort
 }
@ -136,15 +114,11 @@ select_server() {

 ensure_dirs() {
  mkdir -p "$INSTALL_ROOT" "$RUNTIME_BASE_DIR" "$DOWNLOAD_DIR"
-  MODS_DIR="${PT_MODS_DIR:-$INSTALL_ROOT/mods}"
-  mkdir -p "$MODS_DIR"
 }

 prepare_server_paths() {
-  local safe_server_name
-  safe_server_name="$(printf '%s' "$SERVER_NAME" | tr '/' '_')"
-  STAMP_FILE="$RUNTIME_BASE_DIR/fabric-install-${safe_server_name}.stamp"
-  MOD_STATE_FILE="$RUNTIME_BASE_DIR/mods-${safe_server_name}.txt"
+  PACK_SLUG="$(printf '%s' "$SERVER_NAME" | tr '/' '_')"
+  STAMP_FILE="$RUNTIME_BASE_DIR/fabric-install-${PACK_SLUG}.stamp"
 }

 load_pack_versions() {
@ -157,7 +131,26 @@ load_pack_versions() {
  [ -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/')"
@ -165,6 +158,15 @@ load_latest_fabric_installer_version() {
  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

@ -193,80 +195,24 @@ install_fabric_server() {
  printf '%s\n' "$wanted_stamp" > "$STAMP_FILE"
 }

-cleanup_stale_mods() {
-  local current_file stale_name
+run_packwiz_installer() {
+  local args=( -jar "$BOOTSTRAP_JAR" -g --side server --pack-folder "$INSTALL_ROOT" --meta-file "$PACKWIZ_META_FILE" "$PACK_URL" )

-  [ -f "$MOD_STATE_FILE" ] || return 0
+  if [ "$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

-  while IFS= read -r stale_name; do
-    [ -n "$stale_name" ] || continue
-    current_file="$MODS_DIR/$stale_name"
-    if [ ! -f "$RUNTIME_BASE_DIR/current-mods.txt" ] || ! grep -Fxq "$stale_name" "$RUNTIME_BASE_DIR/current-mods.txt"; then
-      if [ -f "$current_file" ]; then
-        log "移除旧模组: $stale_name"
-        [ "$DRY_RUN" = "1" ] || rm -f "$current_file"
-      fi
-    fi
-  done < "$MOD_STATE_FILE"
-}
+  if [ "$DRY_RUN" = "1" ]; then
+    log "DRY RUN: 跳过执行 packwiz-installer"
+    log "pack.toml URL: $PACK_URL"
+    return 0
+  fi

-sync_mods() {
-  local meta file_name url hash_format hash dest tmp
-  local tmp_state_file="$RUNTIME_BASE_DIR/current-mods.txt"
-
-  : > "$tmp_state_file"
-
-  shopt -s nullglob
-  local files=("$PACK_DIR"/mods/*.pw.toml)
-  shopt -u nullglob
-
-  [ "${#files[@]}" -gt 0 ] || fail "在 $PACK_DIR/mods 下没有找到任何 .pw.toml 模组定义"
-
-  for meta in "${files[@]}"; do
-    file_name="$(toml_value 'filename' "$meta")"
-    url="$(toml_value 'url' "$meta")"
-    hash_format="$(toml_value 'hash-format' "$meta" || true)"
-    hash="$(toml_value 'hash' "$meta" || true)"
-
-    [ -n "$file_name" ] || fail "无法读取 $meta 中的 filename"
-    [ -n "$url" ] || fail "无法读取 $meta 中的 download.url"
-
-    printf '%s\n' "$file_name" >> "$tmp_state_file"
-    dest="$MODS_DIR/$file_name"
-
-    if [ "$FORCE_UPDATE" != "1" ] && [ -f "$dest" ]; then
-      if [ -n "$hash_format" ] && [ -n "$hash" ]; then
-        if verify_hash "$dest" "$hash" "$hash_format"; then
-          log "模组已存在且校验通过: $file_name"
-          continue
-        fi
-        log "模组校验失败，重新下载: $file_name"
-      else
-        log "模组已存在，跳过下载: $file_name"
-        continue
-      fi
-    else
-      log "下载模组: $file_name"
-    fi
-
-    if [ "$DRY_RUN" = "1" ]; then
-      log "DRY RUN: 跳过下载 $url"
-      continue
-    fi
-
-    tmp="$dest.part"
-    fetch "$url" "$tmp"
-
-    if [ -n "$hash_format" ] && [ -n "$hash" ] && ! verify_hash "$tmp" "$hash" "$hash_format"; then
-      rm -f "$tmp"
-      fail "模组校验失败: $file_name"
-    fi
-
-    mv "$tmp" "$dest"
-  done
-
-  cleanup_stale_mods
-  [ "$DRY_RUN" = "1" ] || mv "$tmp_state_file" "$MOD_STATE_FILE"
+  log "使用 packwiz-installer 同步服务端模组"
+  (
+    cd "$INSTALL_ROOT"
+    "$JAVA_BIN" "${args[@]}"
+  )
 }

 write_eula() {
@ -333,16 +279,19 @@ main() {
  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
-  sync_mods
+  run_packwiz_installer
  write_eula
  start_server
 }