手写 README 以指引如何开启服务器

Reviewed-on: #4

README.md

@@ -1,10 +1,89 @@
-# PT's Basic Modpack
+# PT's Basic Modpack
-
+
-一些最基础的功能的模组包，包括录制、光影、基本优化等。主打原版味道。
+一些最基础的功能的模组包，包括录制、光影、基本优化等。主打原版味道。
-
+
-## 使用
+## 开发
-
+
-分为服务端和客户端两部分。服务端会在不同时间，安装不同的娱乐性质的模组。客户端则会努力保持不变。
+分为服务端和客户端两部分。服务端会在不同时间，安装不同的娱乐性质的模组。客户端则会努力保持不变。
-
+
-使用 [packwiz](https://packwiz.infra.link) 进行模组包管理。
+使用 [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，以安装需要的文件。
+
+### 部署到 Simpfun
+
+在 Simpfun 申请一个服务器实例，选择多 JDK 版本的镜像。`B+.I.2XL.L` 规格的服务器是个不错的选择。因为我每次只开一天，所以天天签到拿到的积分会很够。
+
+在 `管理 - 实例端口` 处花 100 积分申请一个新的端口用于 Simple Voice Chat 模组。
+
+下载 [panel-start.sh](https://gitea.service.jazzwhom.top/Passthem/pt-minecraft-modpack/raw/branch/main/panel-start.sh) 到本地，编辑 `PT_SERVER="${PT_SERVER:-server-02-skygrid}"` 一行为你需要的服务器配置文件文件夹名。
+
+有可能会出现 packwiz 的各种包下不下来的情况（因为国内网络问题）所以，你可能需要手动下载 [packwiz-installer.jar](https://github.com/packwiz/packwiz-installer/releases/latest/download/packwiz-installer.jar) 和 [packwiz-installer-bootstrap.jar](https://github.com/packwiz/packwiz-installer-bootstrap/releases/latest/download/packwiz-installer-bootstrap.jar)，并放置到 `/pt-minecraft-modpack/.pt-panel-runtime/downloads` 文件夹下。
+
+#### 配置一些文件
+
+在 `server.properties` 编辑 `server-port` 为主端口。编辑：
+
+```env
+online-mode=true
+spawn-protection=0
+```
+
+在 `/pt-minecraft-modpack/config/voicechat/voicechat-server.properties` 编辑 `port` 为附端口。编辑：
+
+```env
+# The distance to which the voice can be heard
+max_voice_distance=64.0
+# The distance to which the voice can be heard when whispering
+whisper_distance=32.0
+```
+
+#### 运营时注意
+
+在 `管理 - 当前实例信息` 右边的小问号，可以使用积分兑换上行流量。10 积分兑换 1G。
+
+这里的上行流量值，要时常刷新以了解流量消耗。
+
+如果积分不足以兑换流量，可以在控制台的 `积分` 值右边的加号充值。12CNY 兑换 600 积分。
+
+在 [这里](https://simp.host/status/simpfun) 可以查看 Simpfun 站点的 Uptime。

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,109 @@
+#!/bin/sh
+set -eu
+
+############
+# 常量定义 #
+############
+
+REPO_URL="${REPO_URL:-https://gitea.service.jazzwhom.top/Passthem/pt-minecraft-modpack}"
+REPO_REF="${REPO_REF:-main}"
+PT_SERVER="${PT_SERVER:-server-02-skygrid}"
+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_VERSION="${PT_JAVA_VERSION:-17}"
+SERVER_MEMORY="${SERVER_MEMORY:-2048}"
+PACKWIZ_INSTALLER_URL="${PACKWIZ_INSTALLER_URL:-https://github.com/packwiz/packwiz-installer/releases/latest/download/packwiz-installer.jar}"
+
+openjdk8="/usr/bin/jdk/jdk1.8.0_361/bin/java"
+openjdk11="/usr/bin/jdk/jdk-11.0.18/bin/java"
+openjdk17="/usr/bin/jdk/jdk-17.0.6/bin/java"
+openjdk19="/usr/bin/jdk/jdk-19.0.2/bin/java"
+openjdk21="/usr/bin/jdk/jdk-21.0.2/bin/java"
+openjdk25="/usr/bin/jdk/jdk-25.0.2/bin/java"
+
+maxmem=$((SERVER_MEMORY - 1000))
+
+case "$PT_JAVA_VERSION" in
+  8)  JAVA_BIN="$openjdk8" ;;
+  11) JAVA_BIN="$openjdk11" ;;
+  17) JAVA_BIN="$openjdk17" ;;
+  19) JAVA_BIN="$openjdk19" ;;
+  21) JAVA_BIN="$openjdk21" ;;
+  25) JAVA_BIN="$openjdk25" ;;
+  *)  JAVA_BIN="java" ;;
+esac
+
+PT_JAVA_ARGS="${PT_JAVA_ARGS:--Xms1024M -Xmx${maxmem}M}"
+
+############
+# 辅助函数 #
+############
+
+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_JAVA_VERSION="$PT_JAVA_VERSION" \
+SERVER_MEMORY="$SERVER_MEMORY" \
+JAVA_BIN="$JAVA_BIN" \
+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

server-02-skygrid/index.toml

@@ -0,0 +1,50 @@
+hash-format = "sha256"
+
+[[files]]
+file = "mods/appleskin.pw.toml"
+hash = "1fc1e482945dff68e6aab34b22d61d054a6177869408ed4af3fef6117a33faab"
+metafile = true
+
+[[files]]
+file = "mods/c2me-fabric.pw.toml"
+hash = "4ee1808a7fb319d469dece5752cedb05dacb9afbe48021fa664f54b8c83fdc45"
+metafile = true
+
+[[files]]
+file = "mods/carpet.pw.toml"
+hash = "b6986c7bdec6840b8a344b4028b0a52be10460f2630223ca88db681b36cd5efa"
+metafile = true
+
+[[files]]
+file = "mods/easyauth.pw.toml"
+hash = "a2cf3825aa8d9cd727953a7496ce4ee781883e958bf0c7b0ae9d60f2c5ab2942"
+metafile = true
+
+[[files]]
+file = "mods/fabric-api.pw.toml"
+hash = "0345fbfa8542b5ec84535fe2aff0f5cc4e801ecc337f926d4e2310b53f458569"
+metafile = true
+
+[[files]]
+file = "mods/fabric-language-kotlin.pw.toml"
+hash = "e49f549eecbe502a3da6d731d6e28783631b14b0bba7bba9780a1075e7926776"
+metafile = true
+
+[[files]]
+file = "mods/lithium.pw.toml"
+hash = "84957275e9dc6f07f4244ce3303536e3d73b0e72eb1696ccd024168a52c29c98"
+metafile = true
+
+[[files]]
+file = "mods/no-chat-reports.pw.toml"
+hash = "70d7b2bca719eca2b3a1447228b868abdc633c38121652d49f4e34380c44339d"
+metafile = true
+
+[[files]]
+file = "mods/pt-skygrid-1.0.0.jar"
+hash = "7cee2610594e69489104ec4711b39d5eb370c0d91a1a8fb82d8e7af1644ffcad"
+
+[[files]]
+file = "mods/simple-voice-chat.pw.toml"
+hash = "44acdef628ff0435c751b93100dd1a3dfabd263039003d39b20cb6f35110060f"
+metafile = true

server-02-skygrid/mods/appleskin.pw.toml

@@ -0,0 +1,13 @@
+name = "AppleSkin"
+filename = "appleskin-fabric-mc1.21.9-3.0.7.jar"
+side = "both"
+
+[download]
+url = "https://cdn.modrinth.com/data/EsAfCjCV/versions/8sbiz1lS/appleskin-fabric-mc1.21.9-3.0.7.jar"
+hash-format = "sha512"
+hash = "79d0d0b4a09140cdb7cf74b1cd71554147c60648beb485ca647b149174e171660ec561ad329da58b78b5de439909b180e287b4b38bf068acfca20666100f4584"
+
+[update]
+[update.modrinth]
+mod-id = "EsAfCjCV"
+version = "8sbiz1lS"

server-02-skygrid/mods/c2me-fabric.pw.toml

@@ -0,0 +1,13 @@
+name = "Concurrent Chunk Management Engine (Fabric)"
+filename = "c2me-fabric-mc1.21.10-0.3.6+alpha.0.9.jar"
+side = "both"
+
+[download]
+url = "https://cdn.modrinth.com/data/VSNURh3q/versions/2EKX8Hiv/c2me-fabric-mc1.21.10-0.3.6%2Balpha.0.9.jar"
+hash-format = "sha512"
+hash = "71e193ecaa38e927a9f943eac6cac5b5dcb4ce6934aae994da9fe34cace5941fe25258056d8b9fdedbda87c5eb3787cad4c74e68ea39048cb6e86202a56dd7ec"
+
+[update]
+[update.modrinth]
+mod-id = "VSNURh3q"
+version = "2EKX8Hiv"

server-02-skygrid/mods/carpet.pw.toml

@@ -0,0 +1,13 @@
+name = "Carpet"
+filename = "fabric-carpet-1.21.10-1.4.188+v251016.jar"
+side = "both"
+
+[download]
+url = "https://cdn.modrinth.com/data/TQTTVgYE/versions/oiUqSOMA/fabric-carpet-1.21.10-1.4.188%2Bv251016.jar"
+hash-format = "sha512"
+hash = "dfab93784fcaa73b20854857063025d36a2f7c27397cc64b141fe2c85024993a87936016ac823c2c945f27314b9938aa57e06b55676a1c349c121b445ecfe213"
+
+[update]
+[update.modrinth]
+mod-id = "TQTTVgYE"
+version = "oiUqSOMA"

server-02-skygrid/mods/easyauth.pw.toml

@@ -0,0 +1,13 @@
+name = "EasyAuth"
+filename = "easyauth-mc1.21.9-3.4.2.jar"
+side = "server"
+
+[download]
+url = "https://cdn.modrinth.com/data/aZj58GfX/versions/JhU4S1jg/easyauth-mc1.21.9-3.4.2.jar"
+hash-format = "sha512"
+hash = "d51bc5781577e841f4ed7c5af211716d21175ba75a4f33ddc89d3dd48bfa6718d77399e00b1416278c4c7f83991e37a3a415dc0e1fdd3b1b447fbf5c81024742"
+
+[update]
+[update.modrinth]
+mod-id = "aZj58GfX"
+version = "JhU4S1jg"

server-02-skygrid/mods/fabric-api.pw.toml

@@ -0,0 +1,13 @@
+name = "Fabric API"
+filename = "fabric-api-0.138.4+1.21.10.jar"
+side = "both"
+
+[download]
+url = "https://cdn.modrinth.com/data/P7dR8mSH/versions/tV4Gc0Zo/fabric-api-0.138.4%2B1.21.10.jar"
+hash-format = "sha512"
+hash = "5e64c53391dfd1c059777d671c52be17a4e27a29d9bd7340ea9e3f55ce7a770b38db0a15e0966e981ee8c1b9372fb89543a278521624689268acebb85bd5c6e9"
+
+[update]
+[update.modrinth]
+mod-id = "P7dR8mSH"
+version = "tV4Gc0Zo"

server-02-skygrid/mods/fabric-language-kotlin.pw.toml

@@ -0,0 +1,13 @@
+name = "Fabric Language Kotlin"
+filename = "fabric-language-kotlin-1.13.10+kotlin.2.3.20.jar"
+side = "both"
+
+[download]
+url = "https://cdn.modrinth.com/data/Ha28R6CL/versions/21TRTKmh/fabric-language-kotlin-1.13.10%2Bkotlin.2.3.20.jar"
+hash-format = "sha512"
+hash = "e4eaf7594de08eb4f3ea8af2e939f3ee61d07597afb4d5f420c3fbadcb381c7bbad4b1afd5919b3087b73ed9636fb018b1c978858a112bd4f6acdcb42e9eedaa"
+
+[update]
+[update.modrinth]
+mod-id = "Ha28R6CL"
+version = "21TRTKmh"

server-02-skygrid/mods/lithium.pw.toml

@@ -0,0 +1,13 @@
+name = "Lithium"
+filename = "lithium-fabric-0.20.1+mc1.21.10.jar"
+side = "both"
+
+[download]
+url = "https://cdn.modrinth.com/data/gvQqBUqZ/versions/NsswKiwi/lithium-fabric-0.20.1%2Bmc1.21.10.jar"
+hash-format = "sha512"
+hash = "79b2892d123f3bb12649927dd8fccc25c955ff38a19f3aba7cd0180c4cf5506c2a76d49418b13050f90bba7bb59f3623af06e8a275e2ae8c63808084043902bb"
+
+[update]
+[update.modrinth]
+mod-id = "gvQqBUqZ"
+version = "NsswKiwi"

server-02-skygrid/mods/no-chat-reports.pw.toml

@@ -0,0 +1,13 @@
+name = "No Chat Reports"
+filename = "NoChatReports-FABRIC-1.21.10-v2.16.0.jar"
+side = "both"
+
+[download]
+url = "https://cdn.modrinth.com/data/qQyHxfxd/versions/78RjC1gi/NoChatReports-FABRIC-1.21.10-v2.16.0.jar"
+hash-format = "sha512"
+hash = "39b2f284f73f8290012b8b9cc70085d59668547fc7b4ec43ab34e4bca6b39a6691fbe32bc3326e40353ba9c16a06320e52818315be77799a5aad526370cbc773"
+
+[update]
+[update.modrinth]
+mod-id = "qQyHxfxd"
+version = "78RjC1gi"

server-02-skygrid/mods/simple-voice-chat.pw.toml

@@ -0,0 +1,13 @@
+name = "Simple Voice Chat"
+filename = "voicechat-fabric-1.21.10-2.6.12.jar"
+side = "both"
+
+[download]
+url = "https://cdn.modrinth.com/data/9eGKb6K1/versions/n7Kvch7B/voicechat-fabric-1.21.10-2.6.12.jar"
+hash-format = "sha512"
+hash = "5dc3946095adc241e78f186106c793bc046f45a1d7ad757712618ed6b30fca443dc78b42f646f352135a6f77f912dd54a3332798c8c8642f1963354c28cd09c4"
+
+[update]
+[update.modrinth]
+mod-id = "9eGKb6K1"
+version = "n7Kvch7B"

server-02-skygrid/pack.toml

@@ -0,0 +1,13 @@
+name = "PT's Server Modpack 1"
+author = "passthem"
+version = "1.0.0"
+pack-format = "packwiz:1.1.0"
+
+[index]
+file = "index.toml"
+hash-format = "sha256"
+hash = "21ed850a83cb38f7a29bbf18fd1c77a6631ff9c50e2e23de58d391941f06aa1d"
+
+[versions]
+fabric = "0.18.5"
+minecraft = "1.21.10"

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 "$@"