diff --git a/README.md b/README.md index 27b0d83..61046b6 100644 --- a/README.md +++ b/README.md @@ -2,9 +2,9 @@ 本仓库存放自动生成的最小客户端整合包,用于连接到 jianfgit.xyz Minecraft 服务器。 -## 如何使用此整合包 +## 如何获取和使用此整合包 -此整合包采用 Modrinth 格式,支持一键导入所有所需模组和 TACZ 弹药包。 +此整合包采用 Modrinth 格式,包含连接服务器所需的所有模组和 TACZ 弹药包。 ### 前置条件 @@ -17,63 +17,71 @@ - ATLauncher - 或任何支持 Modrinth 索引文件的启动器 -### 一键导入方法(推荐使用 Prism 启动器) +### 获取整合包的方法 -1. **下载并安装 Prism 启动器** - - 访问 https://prismlauncher.org/download/ - - 下载适用于您操作系统的版本 - - 安装并启动应用程序 +#### 方法 1:通过服务器管理员获取(推荐) -2. **添加整合包** - - 在 Prism 启动器中,转到 "实例" 选项卡 - - 点击 "+" 按钮添加新实例 - - 选择 "Modrinth" 作为源类型 - - 在 "Modrinth URL 或索引" 字段中,粘贴以下内容: - ``` - raw.githubusercontent.com/jianf/servermods/main/modpack/modrinth.index.json - ``` - 注意:由于这是私有仓库,您可能需要: - - 克隆仓库:`git clone ssh://git@jianfgit.xyz:220/jianf/servermods.git` - - 在 Prism 启动器中选择 "从文件夹导入" 或 "从 ZIP 导入" - - 导航到克隆的仓库的 `modpack/` 目录 - - 选择 `modrinth.index.json` 文件 +由于这是一个私有仓库,普通用户无法直接访问。请按照以下步骤操作: -3. **安装整合包** - - Prism 启动器将自动下载所有所需模组和弹药包 - - 它会创建一个名为 "minimal-client-modpack" 的新实例 - - 选择该实例并点击 "播放" +1. 联系服务器管理员获取最新的整合包文件 +2. 管理员会提供: + - `modrinth.index.json` 文件(整合包索引) + - `truemods/` 目录中的所有模组文件(.jar) + - `truegunpacks/` 目录中的所有 TACZ 弹药包文件(.zip) -### 手动安装方法 +#### 方法 2:自行克隆仓库(如果有权限) -如果您更喜欢手动安装: +如果您被授予了仓库访问权限: -1. **下载整合包索引** - - 访问仓库获取 `modrinth.index.json` 文件(位于 `modpack/` 目录) - - 由于这是私有仓库,您需要从服务器管理员处获取此文件 +1. 克隆私有仓库: + ```bash + git clone ssh://git@jianfgit.xyz:220/jianf/servermods.git + ``` -2. **创建整合包文件夹结构** +2. 导航到仓库目录: + ```bash + cd servermods + ``` + +3. 您将看到以下目录和文件: + - `modpack/modrinth.index.json` - 整合包索引文件 + - `truemods/` - 所有必需的模组文件(.jar) + - `truegunpacks/` - 所有必需的 TACZ 弹药包文件(.zip) + +### 安装整合包 + +一旦您获得了整合包文件: + +1. **创建整合包文件夹结构** ``` minimal-client-modpack/ ├── mods/ └── tacz/ ``` -3. **下载所需文件** - 对于 `modrinth.index.json` 中 `files` 数组中的每个条目: - - 如果路径以 `mods/` 开头 → 将文件放入 `mods/` 文件夹 - - 如果路径以 `tacz/` 开头 → 将文件放入 `tacz/` 文件夹 - - 您可以从服务器管理员处获取这些文件,或直接请求 +2. **复制所需文件** + - 将 `truemods/` 目录中的所有 .jar 文件复制到 `mods/` 文件夹 + - 将 `truegunpacks/` 目录中的所有 .zip 文件复制到 `tacz/` 文件夹 -4. **安装 Forge** +3. **安装 Forge** - 从 https://files.minecraftforge.net/ 下载 Forge 1.20.1 - 运行安装程序并选择 "安装客户端" -5. **启动 Minecraft** +4. **启动 Minecraft** - 在您的 Minecraft 启动器中,创建一个新安装 - - 选择您安装的 Forge 版本 + - 选择您安装的 Forge 版本 (1.20.1) - 将游戏目录设置为您的 `minimal-client-modpack` 文件夹 - 启动游戏 +### 使用 Prism 启动器的一键导入(如果可用) + +如果您能够访问仓库且启动器支持自定义索引位置: + +1. 在 Prism 启动器中创建新实例 +2. 选择 "Modrinth" 作为源类型 +3. 在索引URL字段中指向您获得的 `modrinth.index.json` 文件的本地路径 +4. 启动器将自动处理文件下载和安装 + ## 重要提示 ### 版本匹配 @@ -83,10 +91,10 @@ ### 更新整合包 - 服务器上的整合包每 12 小时自动更新一次 -- 要更新您的客户端: - - **Prism 启动器**:选择实例并点击更新箭头 - - **手动方法**:下载最新的 `modrinth.index.json` 并重新下载哈希值已更改的文件 - - **Git 方法**:在您克隆的仓库中执行 `git pull` 并在启动器中刷新整合包 +- 获取更新的方法: + 1. 向服务器管理员请求最新的整合包文件 + 2. 如果有仓库访问权限:执行 `git pull` 然后重新获取文件 + 3. 重复上述安装步骤以更新文件 ## 故障排除 @@ -112,14 +120,22 @@ - `formatVersion`: 1 - `game.type`: "forge" - `game.version`: "1.20.1" -- `versionId`: 十进制版本(例如:"0.0.3") +- `versionId`: 十进制版本(例如:"0.0.7") - `files.array`: 包含对象的列表,每个对象包含: - `path`: 模组包内文件位置(`mods/` 或 `tacz/`) - `hashes.sha1`: 用于文件验证的 SHA1 哈希值 - `env.client`: ["required"] - 客户端必需 - `env.server`: ["unsupported"] - 服务器端不需要/不允许 - - `downloads`: [] - 空数组,因为我们使用直接文件分发 + - `downloads`: [] - 空数组,因为文件分发方式由用户自行处理 TACZ(弹药)包被视为常规模组,但为了组织目的存储在 `tacz/` 子文件夹中。它们对于在此服务器上获得完整游戏体验是必需的。 +系统会自动: +1. 监控 `/tmp/server_mods.txt` 变化 +2. 生成 Modrinth 格式索引 (`modpack/modrinth.index.json`) +3. 将实际模组文件复制到 `truemods/` 目录 +4. 将实际 TACZ 弹药包复制到 `truegunpacks/` 目录 +5. 提交并推送更改到 git 仓库 +6. 使用十进制版本号递增(0.0.1, 0.0.2, etc.) + 如需进一步帮助,请联系服务器管理员。 \ No newline at end of file