更新README.md,说明truemods和truegunpacks目录的用法

This commit is contained in:
root
2026-04-04 22:48:35 +08:00
parent 929f797233
commit 4ddf49e69b

104
README.md
View File

@ -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.)
如需进一步帮助,请联系服务器管理员。