服务器整合包使用指南

本仓库存放自动生成的最小客户端整合包，用于连接到 jianfgit.xyz Minecraft 服务器。

如何获取和使用此整合包

此整合包采用 Modrinth 格式，包含连接服务器所需的所有模组和 TACZ 弹药包。

前置条件

1. Minecraft Java Edition 1.20.1
2. Forge 加载器 (1.20.1 版本)
3. 支持 Modrinth 整合包格式的启动器：
   • Prism 启动器 (推荐)
   • Modrinth 应用程序
   • PolyMC
   • ATLauncher
   • 或任何支持 Modrinth 索引文件的启动器

获取整合包的方法

方法 1：通过服务器管理员获取（推荐）

由于这是一个私有仓库，普通用户无法直接访问。请按照以下步骤操作：

1. 联系服务器管理员获取最新的整合包文件
2. 管理员会提供：
   • modrinth.index.json 文件（整合包索引）
   • truemods/ 目录中的所有模组文件（.jar）
   • truegunpacks/ 目录中的所有 TACZ 弹药包文件（.zip）

方法 2：自行克隆仓库（如果有权限）

如果您被授予了仓库访问权限：

1. 克隆私有仓库：

   git clone ssh://git@jianfgit.xyz:220/jianf/servermods.git
   

2. 导航到仓库目录：

   cd servermods
   

3. 您将看到以下目录和文件：

   • modpack/modrinth.index.json - 整合包索引文件
   • truemods/ - 所有必需的模组文件（.jar）
   • truegunpacks/ - 所有必需的 TACZ 弹药包文件（.zip）

安装整合包

一旦您获得了整合包文件：

1. 创建整合包文件夹结构

   minimal-client-modpack/
   ├── mods/
   └── tacz/
   

2. 复制所需文件

   • 将 truemods/ 目录中的所有 .jar 文件复制到 mods/ 文件夹
   • 将 truegunpacks/ 目录中的所有 .zip 文件复制到 tacz/ 文件夹

3. 安装 Forge

   • 从 https://files.minecraftforge.net/ 下载 Forge 1.20.1
   • 运行安装程序并选择 "安装客户端"

4. 启动 Minecraft

   • 在您的 Minecraft 启动器中，创建一个新安装
   • 选择您安装的 Forge 版本 (1.20.1)
   • 将游戏目录设置为您的 minimal-client-modpack 文件夹
   • 启动游戏

使用 Prism 启动器的一键导入（如果可用）

如果您能够访问仓库且启动器支持自定义索引位置：

1. 在 Prism 启动器中创建新实例
2. 选择 "Modrinth" 作为源类型
3. 在索引URL字段中指向您获得的 modrinth.index.json 文件的本地路径
4. 启动器将自动处理文件下载和安装

重要提示

版本匹配

• 整合包版本 必须 完全匹配服务器期望的版本
• 如果您看到 "服务器握手失败" 或 "无效会话" 错误，这通常表示版本不匹配
• 请始终确保您拥有最新版本通过定期更新整合包

更新整合包

• 服务器上的整合包每 12 小时自动更新一次
• 获取更新的方法：
  1. 向服务器管理员请求最新的整合包文件
  2. 如果有仓库访问权限：执行 git pull 然后重新获取文件
  3. 重复上述安装步骤以更新文件

故障排除

"缺失模组" 错误

1. 验证 modrinth.index.json 中列出的所有文件都存在于您的 mods/ 和 tacz/ 文件夹中
2. 检查文件名是否完全匹配（区分大小写）
3. 验证您下载了正确的版本（高级用户可检查 SHA1 哈希值）

"模组加载错误" 或崩溃

1. 确保您使用的是 Forge 1.20.1，而不是其他版本
2. 检查是否有与整合包冲突的其他模组安装在外部
3. 尝试删除所有模组，然后从零开始使用索引重新安装

连接问题

1. 确认服务器地址正确
2. 验证您的互联网连接
3. 检查服务器是否在线且未维护
4. 确保您的整合包版本与服务器当前版本匹配

技术细节

此整合包采用官方 Modrinth 索引格式版本 1：

• formatVersion: 1
• game.type: "forge"
• game.version: "1.20.1"
• versionId: 十进制版本（例如："0.0.12"）
• files.array: 包含对象的列表，每个对象包含：
  • path: 模组包内文件位置（mods/ 或 tacz/）
  • hashes.sha1: 用于文件验证的 SHA1 哈希值
  • env.client: ["required"] - 客户端必需
  • env.server: ["unsupported"] - 服务器端不需要/不允许
  • downloads: [] - 空数组，因为文件分发方式由用户自行处理

TACZ（弹药）包被视为常规模组，但为了组织目的存储在 tacz/ 子文件夹中。它们对于在此服务器上获得完整游戏体验是必需的。

系统会自动：

1. 监控 /tmp/server_mods.txt 变化
2. 生成 Modrinth 格式索引 (modpack/modrinth.index.json)
3. 将实际模组文件复制到 truemods/ 目录（排除客户端-only 视觉mod）
4. 将实际 TACZ 弹药包复制到 truegunpacks/ 目录
5. 提交并推送更改到 git 仓库
6. 使用十进制版本号递增（0.0.1, 0.0.2, etc.）
7. 通过 QQ 机器人自动推送更新公告到群（群号: 814734369）

如需进一步帮助，请联系服务器管理员。