refactor: use packwiz installer for server setup

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"`