MC_Party_Pack

## 💻 本地环境搭建与配置 ### 1. Git 远程配置 (仅首次需要) 脚本会自动读取 `git_repository.txt` 中的内容并作为远程仓库地址。 你只需要将 Git 仓库链接（如 https://...）直接粘贴进 `git_repository.txt` 文件中即可。 > **注意**：无需再手动配置 SSH 私钥。 ### 🔧 常见问题修复：Git LFS 缺失 / 格式错误 如果你看到 `git-lfs: command not found` 或 `Exec format error` 错误，说明 Git LFS 未安装或版本错误（如下载了 Linux 版）。 **请务必下载 Windows 专用版本**： 1. **下载**： * 点击下载：[git-lfs-windows-amd64-v3.4.1.zip](https://github.com/git-lfs/git-lfs/releases/download/v3.4.1/git-lfs-windows-amd64-v3.4.1.zip) * 或者去 [GitHub Releases](https://github.com/git-lfs/git-lfs/releases) 找文件名包含 `windows` 和 `amd64` 的 zip 包。 2. **解压**：解压下载好的压缩包。 3. **覆盖安装**： * 找到解压出来的 `git-lfs.exe`。 * 将其复制到 `MC_Party_Pack\tools\git\cmd\` 文件夹内。 * 如果提示文件已存在，请选择**覆盖**。 4. **验证**：重新运行 `双击此处一键开服` 。 ### 2. 服务端安装 (Fabric 1.21.1) 1. **下载安装器**： * 访问 [Fabric 官网](https://fabricmc.net/use/server/)。 * 选择对应版本后点击 "Executable Server (.jar)"。 2. **⚠️ 关键步骤：重命名** * 下载完成后，你的下载文件夹里会多出一个 jar 文件（通常叫 `fabric-server-mc.1.21.1-loader...jar`）。 * **请务必把它重命名为 `server.jar` 并且把它移动到 `server/` 文件夹内，覆盖原有的 `server.jar`**。 ### 3. 服务端初始化与配置 1. **自动初始化**： * 首次启动时，脚本会自动生成 `server.properties` 和 `libraries` 文件夹。 2. **修改关键配置 (`server/server.properties`)**： * `server-port=25565` (必须是这个，不要改) * `online-mode=false` (如果朋友里有非正版，必须改为 false) * `allow-flight=true` (防止跑图因为网络延迟被踢) 3. **预装优化模组**： * 请确保以下模组已放入 `server/mods` 文件夹： * **Fabric API** (基础前置库) * **Lithium (锂)** (大幅优化服务端性能) --- ## 📂 目录结构说明 请确保最终的文件夹结构如下所示： ```text MC_Party_Pack/ │ ├── .git/ <-- (Git 仓库核心数据) ├── 双击此处一键开服.bat <-- (启动脚本，请双击运行) ├── core_script.ps1 <-- (PowerShell 核心逻辑) ├── git_repository.txt <-- (Git 仓库地址配置) ├── client_id.txt <-- (身份ID，自动生成) ├── server.lock <-- (⚠️ 锁文件，存在即代表有人在玩) ├── README.md <-- (本文档) │ ├── server/ <-- (服务端核心目录，包含存档和模组) │ ├── server.jar │ ├── mods/ │ └── world/ │ └── tools/ <-- (工具箱) ├── Radmin_Setup.exe <-- (Radmin VPN 安装包) ├── java/ <-- (便携版 Java) └── git/ <-- (便携版 Git) ``` --- ## ✨ 自动化功能说明 ### 🧠 自动内存管理 脚本会根据你电脑的物理内存大小，自动计算最合适的分配方案： - **>16GB 内存**：分配 10GB 给服务器。 - **8GB - 16GB**：预留 3GB 给系统，其余给服务器。 - **4GB - 8GB**：预留 1.5GB 给系统。 - **<4GB**：保底分配 2GB (可能会卡顿)。 *(无需再手动修改配置文件)* ### 🌐 自动网络检测 脚本会自动检测 Radmin VPN 的状态： - 如果未启动，尝试自动启动服务和 GUI。 - 如果未上线 (无 IP)，会等待其上线。 - **注意**：首次运行时可能需要手动点击 Radmin 界面上的“开机”按钮。 --- ## 🚀 使用流程 ### 场景一：正常开服 1. **A** 点击 `双击此处一键开服` 。 2. 脚本自动检测环境、同步云端状态。 3. 脚本向 Git 仓库推送 `server.lock`。 4. **A** 打开游戏连接 `localhost`。 5. **关服**：**A** 在黑窗口输入 `stop` 回车。 6. 脚本自动上传存档，删除 `server.lock`。 ### 场景二：朋友 B 想玩，但 A 正在玩 1. **B** 点击 `双击此处一键开服` 。 2. 显示：“**🔒 服务器正在被占用！**”。 3. 脚本自动把 A 的 IP 复制到 **B** 的剪贴板。 4. **B** 直接打开游戏粘贴 IP 进去联机。 --- ## ⚠️ 管理员打包清单 - [ ] **Tools**：确保 Java/Git/Radmin 都在 tools 文件夹。 - [ ] **Server**：确保 server 文件夹里有 server.jar。 - [ ] **清理**：删除 `client_id.txt` 和`.git` 文件夹（让朋友自己生成）。