diff --git a/README.md b/README.md index 2fb2848..e8e477b 100644 --- a/README.md +++ b/README.md @@ -50,192 +50,40 @@ docker run --pull=always \ 或者，需要从 [https://github.com/packwiz/packwiz-installer/releases](这里) 下载最新最热的 Installer，以安装需要的文件。 -## 面板服一键启动方案 +### 部署到 Simpfun -仓库根目录提供了： +在 Simpfun 申请一个服务器实例，选择多 JDK 版本的镜像。`B+.I.2XL.L` 规格的服务器是个不错的选择。因为我每次只开一天，所以天天签到拿到的积分会很够。 -- `start.sh`：仓库内真正负责安装与启动服务端的主脚本 -- `panel-start.sh`：专门给面板服上传使用的薄入口脚本 +在 `管理 - 实例端口` 处花 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}"` 一行为你需要的服务器配置文件文件夹名。 -1. 直接下载仓库里的 `panel-start.sh` -2. 上传到面板 -3. 如果面板要求固定入口文件名是 `start.sh`，就把它重命名成 `start.sh` -4. 按需要修改里面的变量 -5. 点击运行 +有可能会出现 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` 文件夹下。 -`start.sh` 现在**直接复用官方 `packwiz-installer-bootstrap` / `packwiz-installer`**，而不是自己手动管理模组列表。 +#### 配置一些文件 -它会自动完成这些事情： +在 `server.properties` 编辑 `server-port` 为主端口。编辑： -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 +```env +online-mode=true +spawn-protection=0 ``` -因为这时 `start.sh` 会直接使用仓库里的本地 `server-01-random-block/pack.toml`。 +在 `/pt-minecraft-modpack/config/voicechat/voicechat-server.properties` 编辑 `port` 为附端口。编辑： -如果仓库里只有一个 `server-*` 目录，不传 `PT_SERVER` 也可以自动选择；但只要有多个，建议明确传。 - -### 常用示例 - -```bash -PT_SERVER="server-01-random-block" PT_JAVA_ARGS="-Xms1G -Xmx1G" bash start.sh +```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 ``` -```bash -PT_SERVER="server-02-xxx" bash start.sh -``` +#### 运营时注意 -## 方案二：只下载并上传 `panel-start.sh` +在 `管理 - 当前实例信息` 右边的小问号，可以使用积分兑换上行流量。10 积分兑换 1G。 -如果你只想下载一个脚本文件再上传到面板，那么请直接使用： +这里的上行流量值，要时常刷新以了解流量消耗。 -- 仓库文件：`panel-start.sh` +如果积分不足以兑换流量，可以在控制台的 `积分` 值右边的加号充值。12CNY 兑换 600 积分。 -你上传后： - -- 如果面板固定执行文件名就是 `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"` +在 [这里](https://simp.host/status/simpfun) 可以查看 Simpfun 站点的 Uptime。