# game mods

**Repository Path**: ztmz/game-mods

## Basic Information

- **Project Name**: game mods
- **Description**: 用来存放 各种游戏的 Mods
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-03
- **Last Updated**: 2026-09-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ZTMZ 游戏 Mod 目录

本仓库保存 ZTMZ 路书工具可发现的游戏 Mod 元数据。客户端读取根目录的 `repo.json`，因此新增或更新 Mod 时无需修改游戏 DLL。

- 在线查看：`https://gitee.com/ztmz/game-mods/blob/master/repo.json`
- 客户端数据源：`https://gitee.com/ztmz/game-mods/raw/master/repo.json`

客户端必须使用 `raw` 地址获取 JSON；`blob` 地址是供人在浏览器中查看的 HTML 页面。

## 目录规则

- `schemaVersion` 当前固定为 `1`。
- `games[].id` 必须与游戏插件公开的目录 ID 一致。
- `author` 使用适合列表展示的简短署名；完整分工通过可选的 `credits[].roles` 和 `credits[].names` 记录。旧版客户端会忽略 `credits`。
- 所有下载地址和发布页必须使用 HTTPS。
- `sha256` 必须对应发布页当前附件；替换附件后必须同步更新。
- `packageRootDirectory` 是 ZIP 内需要安装的顶层目录；若文件直接位于 ZIP 根目录，则使用空字符串。
- `externalFolderName` 指定复制到 JSGME Mod 仓库时创建的目录，根目录包必须填写。
- `archiveEntryCodePage` 仅用于没有 UTF-8 文件名标记的旧 ZIP，例如简体中文文件名使用 `936`。
- `preserveExistingPaths` 只列出安装或升级时必须保留的用户配置文件。不要使用“保留所有 INI”一类宽泛规则。
- 同一 `conflictGroup` 中只能启用一个 Mod。

ZTMZ 会在安装前验证目录结构和 SHA256，并在直接安装时备份被覆盖文件。存在 JSGME 时，用户也可以只把包加入 JSGME，再由 JSGME 启用或停用。