# 纹理替换功能说明

## 目录结构

```
resource/local-files/textures/
├── asset_mapping.txt       # 资源映射配置文件
├── comic/                  # 漫画图片
│   ├── 1ko/               # 一格漫画
│   └── 4ko/               # 四格漫画
├── general_report/        # 好感度偶像档案
│   ├── amao/             # 麻央
│   └── hmsz/             # 美铃
├── ui/                    # UI按钮图片
└── tutorial/              # 教程图片
```

## 配置文件说明

`asset_mapping.txt` 文件用于配置资源ID与本地文件的映射关系。

格式: `assetId=本地文件路径`

示例:
```
# 一格漫画
img_general_comic_0001=comic/1ko/img_general_comic_0001.png

# 四格漫画
img_general_comic4_0000=comic/4ko/img_general_comic4_0000.png

# 好感度偶像档案
img_general_report_akapen_amao-001=general_report/amao/img_general_report_akapen_amao-001.png
```

## 启用方式

在 `resource/config.json` 中添加:
```json
{
  "enableTextureReplace": true
}
```

## 注意事项

1. 路径使用正斜杠 `/` 或反斜杠 `\` 均可
2. 路径相对于 `resource/local-files/textures/` 目录
3. 支持 PNG、JPG 等常见图片格式
4. 只有在配置文件中映射的资源才会被替换
5. 如果本地文件不存在,将使用游戏原始资源

## 迁移说明

如果你之前使用 xinput1_3.dll 版本的纹理替换插件:

1. 将 `gakumas-local-texture/asset_mapping.txt` 复制到此目录
2. 将所有图片文件复制到对应的子目录中
3. 在 `config.json` 中启用 `enableTextureReplace`
4. 删除 xinput1_3.dll 文件
5. 只保留 version.dll 即可
